IBM Content Navigator, Version 2.0.3 Supports: CMIS for Content Manager

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 Content Navigator Configuration and Deployment tool to configure and build IBM CMIS for Content Manager before you can use the configuration tools.

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.

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

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.

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.

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 ICN_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 ICN_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	Set the CLASSPATH environment variable by running the following command from the directory ICN_INSTALL_DIR/configure/files/config/cmcmis/configTools: `. ./setupToolsCmdLine.sh` Important: There is a space between the periods at the beginning of the command. 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	Set the CLASSPATH environment variable by running the following command from the directory ICN_INSTALL_DIR\configure\files\config\cmcmis\configTools: `setupToolsCmdLine.bat` 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`

Optional: Update configuration parameters in the cmpathservice.properties file by following the steps in Configuring additional IBM CMIS for Content Manager settings.