6.1.3. Set Up an X Server (Linux)

Complete this step before starting EKM for the first time. This step is performed on the primary cluster node only.

When EKM is set up on Linux, an X server is required by EKM in order to perform various tasks, including metadata and report extraction.

The X server must be configured to allow connections from the EKM server.

To set up EKM to use an X server on Linux, perform the following steps. These steps are required for an EKM server running on Linux:

  1. Configure an X server for use by EKM. An X server can be configured to allow connections from EKM in a variety of ways, including:

    • Granting host-based access to the EKM server host using xhost.

    • Granting user-based access to the EKM server account used to run EKM using xauth.

    • Disabling access control to the X server by executing the X server with a special argument (-ac on some X servers).


    Important:  The X server for EKM must be a real X server with a hardware frame buffer, or a VNC server. Virtual X servers such as Xvfb are not fully compatible with EKM.

    It is also important that the X server used by EKM remains unlocked, as locking the screen can cause certain tasks to fail.


    The X server for EKM should be configured to run as a service (controlled by the init subsystem), following the model used by your Linux distribution. Consult with your IT department for assistance in configuring an X server for use with EKM.


    Note:  If using a VNC server, the VNC server must accept TCP connections. For example:

    vncserver :1 -listen TCP

  2. On the primary cluster node, edit EKM_ROOT182/bin/ekm_env.sh to set the DISPLAY environment variable (shown in bold) to the X server configured in step 1. This environment variable is commented out; remove the comment and set it to the correct value.

    # X11 DISPLAY
    export DISPLAY=localhost:0
    

    In the example above, DISPLAY is set to a local X display :0 on the local system. It is also possible to set DISPLAY to a remote X server running on another host. The X server must be configured to allow access by EKM in either case.


Release 18.2 - © ANSYS, Inc. All rights reserved.