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