Administering IBM CMIS for Content Manager

IBM® CMIS for Content Manager can be tuned for your environment so that the data model is aligned with your library server for better performance.

Before you begin

You must use the IBM ECM CMIS and Collaboration services Configuration and Deployment tool to configure and build IBM ECM CMIS for Content Manager repositories.

About this task

IBM CMIS for Content Manager provides services that are used by CMIS client applications. These services implement the CMIS specifications model by using the Content Manager EE Java APIs to manage content on the Content Manager EE library server.

IBM CMIS for Content Manager provides a set of tools that help you configure the data model in the Content Manager EE library server that is used by IBM CMIS for Content Manager. The tools are built into the product libraries or JAR files. You can run the tools by using their fully qualified Java program name. The setupToolsCmdLine batch script sets the CLASSPATH environment variable to point the Java program to the tools, the libraries, and the configuration files. You can run the tools without parameters, and the tools prompt for necessary information. If you do not want to be prompted, you can specify the information as command parameters.

You can also run the tools by their short name if you use the configure-repository batch script to run the tools interactively. The tools prompt you when more information is needed.

To run the tools, you need a compatible Java Runtime Environment (JRE) enabled to run Java commands in your environment. For compatible JRE versions, see the software requirements information. The JRE installed with WebSphere® Application Server works with the configuration tools.

The setupToolsCmdLine and configure-repository batch scripts search for the JRE in a specific order.
  1. If the JAVA_HOME environment variable is defined, the scripts search for the JRE in JAVA_HOME\bin. If not found, the scripts report the error and exit.
  2. If the JAVA_HOME environment variable is not defined, the scripts try to use the JRE installed by WebSphere Application Server, which is in WAS_HOME\java\bin, where the WAS_HOME environment variable points to the WebSphere Application Server installation home.
  3. If WAS_HOME\java\bin\ is not found, the scripts search for the JRE in the PATH environment variable.

Procedure

To run a configuration tool:

  1. For Oracle databases only: Copy the Oracle JDBC driver from your Content Manager EE system and set the ORACLE_JDBC_DRIVER_PATH environment variable to the full path of the Oracle JDBC driver.
  2. Decide which tool you want to run.
    Tool name Description
    PathModelCreate Defines a minimum set of item types that enable the path-based model and other Clb-enabled model features.
    PathModelDestroy Deletes all definitions and items in item types that are defined specifically for the path-based model and the Clb model extensions.
    DocumentTypeEnable Extends, optimizes, and enables document types with metadata extensions for better behavior and performance with CMIS.
    LibraryCreate Creates a library.
    LibraryDelete Deletes an existing library.
    LibraryGroupCreate Creates a library group.
    LibraryGroupDelete Deletes an existing library group.
    SavedSearchAdmin Manages saved searches. For example, you can create, edit, list, run, and delete saved searches.
    Browser Browse repository content, view item details that might not be easily viewable through applications, and manage items.
  3. Run the tool in interactive mode or silent mode:
    Mode Steps
    Interactive mode on Linux or UNIX systems Run the following command from the directory CMIS_INSTALL_DIR/configure/files/config/cmcmis/configTools where tool_name is the name of the tool that you want to run: 
    ./configure-repository.sh tool_name
    Interactive mode on Windows Run the following command from the directory CMIS_INSTALL_DIR\configure\files\config\cmcmis\configTools where tool_name is the name of the tool that you want to run: 
    configure-repository.bat tool_name
    Silent mode on Linux or UNIX systems
    1. Set the CLASSPATH environment variable by running the following command from the directory CMIS_INSTALL_DIR/configure/files/config/cmcmis/configTools: 
      . ./setupToolsCmdLine.sh
      Important: There is a space between the periods at the beginning of the command.
    2. Using the fully qualified Java program name, including the Java package, run the following Java command where tool_name is the name of the tool that you want to run:
      java com.ibm.content.cm.tools.
tool_name
    Silent mode on Windows
    1. Set the CLASSPATH environment variable by running the following command from the directory CMIS_INSTALL_DIR\configure\files\config\cmcmis\configTools: 
      setupToolsCmdLine.bat
    2. Using the fully qualified Java program name, including the Java package, run the following Java command where tool_name is the name of the tool that you want to run:
      java com.ibm.content.cm.tools.
tool_name
  4. Optional: Update configuration parameters in the cmpathservice.properties file by following the steps in Configuring additional IBM CMIS for Content Manager settings.