6.1.3. Set Up an X Server (Linux)

Engineering Knowledge Manager

Installation Guide | Chapter 6: Post-Setup | 6.1. Post-Setup Instructions |

6.1.2. Set the Location of ANSYS 18.2 Applications |  | 6.2. Configure the MySQL Connector/J JDBC Driver (Optional)
Prev |  | Next

### 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.

Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Prev | Up / Contents | Next

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