Installing the IBM ECM CMIS software

You can install the IBM® ECM CMIS software on the server by running the installation program or by running a silent installation.

  • Running the installation program
    • You must install the prerequisite software on the server where you plan to host IBM ECM CMIS. For more information, see Prerequisites for installing IBM ECM CMIS.
    • You should complete the Installation and configuration worksheets before you install IBM ECM CMIS.
    • You should review Getting IBM ECM CMIS up and running to ensure that you understand all of the tasks that you must complete before users can access the IBM ECM CMIS.

    If you plan to deploy IBM ECM CMIS on IBM WebSphere® Application Server Network Deployment, you do not need to install IBM ECM CMIS on the deployment manager.

    Important: If you plan to deploy IBM ECM CMIS in a clustered environment, install the software on at least one server in the cluster. However, it is easier to achieve high availability if you install the IBM ECM CMIS software on some or all of the servers in the cluster.

    Installing on all of the nodes in the cluster has the following benefits:
    • IBM ECM CMIS configuration directory that you specify when you configure theIBM ECM CMIS exists on all of the nodes in the cluster.
    • The IBM ECM CMIS Configuration and Deployment Tool remains available from multiple locations if the original system fails.
    • An installed IBM ECM CMIS instance remains available to apply upgrades or fixes if the original system fails.
    • The IBM ECM CMIS shared libraries are installed in the correct locations without needing to be copied over from another node.

    If you installed your web application server as a user other than the root user, you must use the same user account when you install IBM ECM CMIS on AIX®, Linux, or Linux for System z®. If you do not, the IBM ECM CMIS Configuration and Deployment Tool does not work properly.

    To install IBM ECM CMIS, complete the following steps:

    1. Log on to the IBM ECM CMIS server with the IBM ECM CMIS installer account.
    2. Start the installation program:
      Table 1. Installation Commands by Operating System
      Operating system Installation command
      AIX At a command prompt with root access, change to the directory where you downloaded the product and enter: ./IBM_ECM_CMIS_FNCS-x.x.x-AIX.bin, where x.x.x is the product version.
      Linux At a command prompt with root access, change to the directory where you downloaded the product and enter: ./IBM_ECM_CMIS_FNCS-x.x.x-LINUX.bin, where x.x.x is the product version.
      Linux for System Z At a command prompt with root access, change to the directory where you downloaded the product and enter: ./IBM_ECM_CMIS_FNCS-x.x.x-ZLINUX.bin, where x.x.x is the product version.
      Windows Complete one of the following actions:
      • Launch the command prompt by using the Run as Administrator option, and then change to the directory where you downloaded the product: and enter: IBM_ECM_CMIS_FNCS-x.x.x-WIN.exe, where x.x.x is the product version.
      Go to the directory where you downloaded the product and right click on IBM_ECM_CMIS_FNCS-x.x.x-WIN.exe and select Run as Administrator, where x.x.x is the product version.
    3. Follow the instructions in the installation tool to complete the installation.
  • Running a silent installation

    Before you install IBM ECM CMIS silently:

    A silent installation uses a response file that contains the installation parameters that you specify. When you run a silent installation, the installation program does not display any installation windows or messages. Instead, any messages and errors are written to the IBM_CMIS_x.x.x_InstallLog.log file (x.x.x is the IBM Content Navigator version), which is in the logs subdirectory of the IBM ECM CMIS installation directory.

    If you plan to deploy IBM ECM CMIS on IBM WebSphere® Application Server Network Deployment, you do not need to install IBM ECM CMIS on the deployment manager.

    Important: If you plan to deploy IBM ECM CMIS in a clustered environment, install the software on at least one server in the cluster. However, it is easier to achieve high availability if you install the IBM ECM CMIS software on some or all of the servers in the cluster.

    Installing on all of the nodes in the cluster has the following benefits:
    • IBM ECM CMIS configuration directory that you specify when you configure theIBM ECM CMIS exists on all of the nodes in the cluster.
    • The IBM ECM CMIS Configuration and Deployment Tool remains available from multiple locations if the original system fails.
    • An installed IBM ECM CMIS instance remains available to apply upgrades or fixes if the original system fails.
    • The IBM ECM CMIS shared libraries are installed in the correct locations without needing to be copied over from another node.

    If you installed your web application server as a user other than the root user, you must use the same user account when you install IBM ECM CMIS on AIX®, Linux, or Linux for System z®. If you do not, the IBM ECM CMIS Configuration and Deployment Tool does not work properly.

    To install IBM ECM CMIS silently, complete the following steps:
    1. Open the response file, cmis_fncs_silent_install.txt.
    2. Edit the following values in the response file:
      1. Set the value of the INSTALLER_UI parameter to SILENT.
      2. Set the value of the LICENSE_ACCEPTED parameter to true.
      3. If you want to install IBM ECM CMIS in a directory other than the default installation directory, specify a value for the USER_INSTALL_DIR parameter.
        Note: USER_INSTALL_DIR can have any custom install path with CMIS being the installation directory. It is advisable not to change the name of the CMIS folder. Also, the custom install path should not contain IBM Content Navigator's default installation folder (ECMClient) to avoid cross installation problems.

        Important: On Windows, you must escape colons (:) and backslashes (\) by adding a backslash before each colon or backslash in the installation directory file path. For example, C:\Program Files (x86)\IBM\CMIS would have the following format: C\:\\Program Files (x86)\\IBM\\CMIS

        By default, IBM ECM CMIS is installed in the following directory:

        Operating system Directory
        AIX /opt/IBM/CMIS
        Linux /opt/IBM/CMIS
        Linux for System z /opt/IBM/CMIS
        Windows C:\Program Files (x86)\IBM\CMIS
    3. At a minimum, the silent installation response file must contain the following text: INSTALLER_UI=SILENT LICENSE_ACCEPTED=true
    4. Save your changes to the response file.
      1. At a command prompt, change to the directory that contains the installation program and run the following command:
      Operating system Command
      AIX

      IBM_ECM_CMIS_FNCS-3.0.3-AIX.bin -f In this example, you must change 3.0.3 to the version of IBM Content Navigator that you are on.

      fully_qualified_path_of_the_response_file

      /CMIS_FNCS_silent_install.txt
      Linux

      IBM_ECM_CMIS_FNCS-3.0.3-LINUX.bin -f In this example, you must change 3.0.3 to the version of IBM Content Navigator that you are on.

      fully_qualified_path_of_the_response_file

      /CMIS_FNCS_silent_install.txt
      Linux for System z

      IBM_ECM_CMIS_FNCS-3.0.3-ZLINUX.bin -f In this example, you must change 3.0.3 to the version of IBM Content Navigator that you are on.

      fully_qualified_path_of_the_response_file

      /CMIS_FNCS_silent_install.txt
      Windows

      IBM_ECM_CMIS_FNCS-3.0.3-WIN.exe -f In this example, you must change 3.0.3 to the version of IBM Content Navigator that you are on.

      fully_qualified_path_of_the_response_file

      /CMIS_FNCS_silent_install.txt