IBM Support

Configuring Unix servers to use the FileNet Content Manager and IBM Content Foundation Configuration Manager tool in GUI mode

How To


Summary

A new Swing-based Configuration Manager is introduced in the 5.5.12 releases of FileNet Content Manager and IBM Content Foundation. In all Unix environments, configure x11 forwarding. On Red Hat Linux and SUSE Linux environments, there are some additional required libraries and packages. No additional libraries are required on AIX servers. This technote describes the prerequisite steps for using the new Swing-based Configuration Manager GUI.

Steps

Ensure that the server on which the Configuration Manager is run can display a user interface. It is likely that x11 forwarding needs to be configured.

Configure x11 forwarding

  1. On all Unix-based P8 servers, install X Windows or similar technology that supports x11 forwarding.
  2. Install an X Window terminal emulator on any remote machines used to access tools that run on the P8 servers.
  3. If x11 forwarding is already enabled, set the DISPLAY environment variable to point to the server containing the x11 application.
  4. If x11 forwarding is not enabled, complete the following steps:
    1. Edit the SSH daemon configuration file at /etc/ssh/sshd_config
    2. Open the SSH daemon configuration file.

      $ sudo vi /etc/ssh/sshd_config

    3. Ensure that the following line is set:

      X11Forwarding yes

    4. Optionally, add the following line. In your environment, the value might need to be set to something other than 10.

      X11DisplayOffset 10

  5. Restart the SSH daemon

    On Linux servers: $ service sshd restart

    On AIX servers: # startsrc -s sshd

  6. Once the servers and remote machines are configured, open a new x11 session and use a sample x11 application, such as xclock, to verify the setup before launching the Configuration Manager User Interface (CMUI).

Red Hat Linux and SUSE Linux Operating Systems Required Libraries

  1. Install the following packages by using yum or dnf:

    xorg-x11-xauth
    webkit
    webkit2gtk

  2. Ensure that the following libraries are installed. If they are not present, install them using either yum or dnf:

    libX11.so.6 (libc6)
    libX11-xcb.so.1 (libc6,x86-64)
    libXv.so.1 (libc6,x86-64)
    libXtst.so.6 (libc6,x86-64)
    libXrender.so.1 (libc6,x86-64)
    libXrender.so.1 (libc6)
    libXrandr.so.2 (libc6,x86-64)
    libXrandr.so.2 (libc6)
    libXpm.so.4 (libc6,x86-64)
    libXinerama.so.1 (libc6,x86-64)
    libXinerama.so.1 (libc6)
    libXi.so.6 (libc6,x86-64)
    libXi.so.6 (libc6)
    libXft.so.2 (libc6,x86-64)
    libXft.so.2 (libc6)
    libXfixes.so.3 (libc6,x86-64)
    libXfixes.so.3 (libc6)
    libXext.so.6 (libc6)
    libXdamage.so.1 (libc6,x86-64)
    libXdamage.so.1 (libc6)
    libXcursor.so.1 (libc6,x86-64)
    libXcursor.so.1 (libc6)
    libXcomposite.so.1 (libc6,x86-64)
    libXcomposite.so.1 (libc6)
    libXau.so.6 (libc6)

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSNVNV","label":"FileNet Content Manager"},"ARM Category":[{"code":"a8m0z0000001hGAAAY","label":"Content Engine-\u003EConfiguration Manager"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF055","label":"zLinux"}],"Version":"5.5.12"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSGLW6","label":"IBM Content Foundation"},"ARM Category":[{"code":"a8m0z0000001hGAAAY","label":"Content Engine-\u003EConfiguration Manager"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF055","label":"zLinux"}],"Version":"5.5.12"}]

Document Information

Modified date:
15 December 2023

UID

ibm17090365