1. Installation and Configuration Guide
  2. Installation Wizard
  3. Installation Wizard Display Requirements

Installation Wizard Display Requirements

The wizard requires X Window System, version 11 (X11). The X11 service must be running on the STA server and configured to allow X11 forwarding.

X11 configuration is outside the scope of this guide, contact your system administrator.

If Linux was installed as instructed in Install and Configure Linux on the STA Server X11 should already be configured properly. However, you may need to set X11 authorizations and display correctly for the Oracle user. The procedures for this depend on the type of connection to the STA server.

Set DISPLAY Variable for Direct Connections

For direct connections to the STA server, you must log in as the Oracle user and then set the DISPLAY variable manually.

For example:

$ export DISPLAY=hostname:0.0

You may also need to verify that the Oracle user has the proper X11 authorization. Contact your Linux administrator for assistance.

Set X11 for Remote Connections Using a Secure Shell (SSH)

If you use a secure shell (SSH) with X11 forwarding enabled, the STA server automatically sets up the proper X11 authorization and display for the login user.

Enable X11 Forwarding on Linux

To enable X11 forwarding on a Linux machine, use the ssh command with the –X or –Y options. For example: 

$ ssh –X oracle@sta_server

Enable X11 Forwarding on Windows

Your PC must be running an X11 server, such as Xming or Cygwin/X, and an SSH client, such as PuTTY or WinSCP.

  1. Verify that the X11 server is running on your PC. Contact your system administrator for assistance, if necessary.
  2. Start PuTTY, in the main Session window, make the following entries

    • In the Host Name field, type the name or IP address of the STA server.

    • In the SSH Connection type field, select SSH.

  3. In the Category menu tree, expand Connection, then expand SSH, then select X11. In this window, make the following selections:

    • In the X11 forwarding field, select the Enable X11 forwarding check box.

    • In the Remote X11 authentication protocol field, select MIT-Magic-Cookie-1.

    • Leave the other fields blank.

Example A-1 Manually Enable the DISPLAY Variable If Not Logged In as the Oracle User

If you log in as oracle, the SSH service on the STA server automatically sets up the proper X11 authorization and display for the oracle user. You should not need to set the DISPLAY variable manually.

However, if you log in as a different user (for example root) and then su to oracle, the X11 authorizations and display will not be set correctly for the oracle user and you must set them manually. Instructions for doing this are outside the scope of this guide; contact your Linux administrator for assistance.