This post describes preparing an X11 graphical display system on a Linux 7 compute instance running on Oracle Cloud Infrastructure (OCI). A graphical interface is a requirement of The Oracle Analytics Cloud (OAC) Remote Data Gateway (RDG) installer. This post is also useful for preparing the 1.5 version of Remote Data Connector.
X11 is the simplest graphical display system to provision in a compute instance. Other options include installing a VNC server or a full desktop environment such as GNOME or KDE.
It also describes configuring an X11 server running on a MAC-OS or Windows client to display a graphical user interface (GUI).
This post is not intended for those who currently have a Linux environment with a Graphical Display system available for RDG.
Published on June 28, 2019
OAC Remote Data Gateway 105.3, 105.4
OAC 105.3, 105.4
MAC OS 10.13.6
Before you Begin
Preparing the X11 Graphical Display System
Preparing the X11 Server
Validating the Graphical User Interface
Preparing Ports for RDC and RDG
In this post, the term "instance" refers to the Linux compute instance hosting a RDG agent.
Preparing the graphical user interface for RDG requires the following:
The IP address or host name of the compute instance.
The SSH private key associated with the instance's public key.
A SSH utility with X11 tunneling capability to access the instance.
Administration privileges on a MAC-OS or Windows client.
This section describes configuring an X11 graphical display system for the RDG Linux installer.
Use an SSH utility to connect to the linux instance as the opc user. This require the IP address / host name of the instance and the private key. The SSH syntax is:
sudo su -
Set the X11UseLocalHost parameter for correct creation of the DISPLAY environment variable. Edit the sshd_config file, uncomment the X11UseLocalHost parameter and change the value from yes to no.
cp /etc/ssh/sshd_config /etc/ssh/sshd_config.orig
systemctl restart sshd
This is accomplished by installing the xauth application.
yum -y install xauth
The xterm application may be used to open an X11 terminal on a user's client machine. This post uses it to validate the graphical user interface.
yum -y install xterm
This library is required for the RDG installer.
yum -y install libXtst.x86_64
This post uses MAC-OS and XQuartz.
Download the XQuartz .dmg file and install it using the default values.
Also required is an SSH client that supports X11 tunneling. For MAC-OS the terminal application is sufficient. For Windows, PuTTY is the most widely used: https://www.putty.org
This post uses MAC-OS and the terminal application.
The configuration is validated by starting the X11 Server on the MAC-OS. This is done by starting the XQuartz application.
Use Finder to open the Applications>Utilities folder and double-click XQuartz. An xterm window opens on the MAC.
Now this terminal session or another remote terminal session can be used to SSH into the Linux instance to run an X11 application.
Use the SSH utility with the -X option to set up an X11 tunnel session on the Linux instance. Connect as the opc user.
This require the IP address / host name of the instance and the private key. The SSH syntax is:
ssh -X -i < private key path > opc@< IP address or host name >
As a test, run the Linux xterm application.
You may have to wait up to a minute, then a new Xterm window appears on your desktop from the Linux instance validating the configuration.
The Remote Data Gateway requires a http port (default 8080) to be opened for ingress by the browser-based agent configuration utility. After the agent is configured, the ingress is not required and access can be removed.
The Remote Data Connector requires a http(s) port (default 8080/443) to be opened for ingress for all operations..
You can now proceed to install and configure an OAC Remote Data Gateway agent on a Linux compute instance.
This post described preparing an X11 graphical display system on a Linux 7 compute instance running on Oracle Cloud Infrastructure and an X11 server running on a MAC-OS client to display an X11 graphical user interface (GUI).
For other posts relating to analytics and data integration visit http://www.ateam-oracle.com/dayne-carley.