You can use the configuration tool to build and deploy
the IBM® Content
Management Interoperability Services for FileNet® Content Manager (IBM CMIS) web application EAR file.
The configuration tool validates the information that you specify
about your IBM FileNet Content Manager system
and your WebSphere® Application
Server environment
before you deploy the IBM CMIS web
application.
Before you can configure the web application,
you must install the Content Engine Client
API files in the IBM CMIS installation
directory.
In addition, it
is recommended that you complete the Installation and configuration worksheets.
Tip: The configuration tool retains your configuration
and deployment information, except for user IDs and passwords, across
sessions. If you need to modify your configuration, you can rerun
the configuration tool without having to enter each configuration
option again.
Only the most recent configuration information is
retained. To back up a previous configuration, you must save a copy
of the following files, which are located in
profiles/profile1 subdirectory
of the
IBM CMIS installation
directory:
- configure-fncmis.properties
- fncmis.properties
After you Configure and Deploy,
if any change has to be done to the configuration, the configuration
wizard can be re-run. All values (except IDs and passwords) will be
retained in the configuration wizard.
To configure IBM CMIS:
- Start the configuration tool:
| Operating system |
Installation command |
|---|
| AIX® |
At a command prompt, change to the config subdirectory
of the IBM CMIS
for FileNet Content Manager installation
directory and enter: ./config.sh. |
| Linux |
At a command prompt, change to the config subdirectory
of the IBM CMIS
for FileNet Content Manager installation
directory and enter: ./config.sh. |
| Windows |
At a command prompt, change to the config subdirectory
of the IBM CMIS
for FileNet Content Manager installation
directory and enter: config.bat. |
- Specify the information to connect to the Content Engine server:
- Specify the Content Engine URL. The URL is case-sensitive and has the format iiop:host_name:2809/FileNet/Engine.
- Specify the FileNet P8 domain
name. If you do not specify a domain, IBM CMIS uses the default domain.
- Optional: Test the connection to the Content Engine server to ensure that you
entered the Content Engine URL
and FileNet P8 domain name
correctly. To test the connection, you must provide the
following information:
- Content Engine user name
- Password
- WebSphere Application
Server installation
directory
- Specify the authentication method that client applications
use when sending requests to the IBM CMIS web services:
- HTTP Basic Authentication - Select
this option if you want client applications to use an HTTP header
that contains an encoded user name and password to authenticate.
- WS-Security Authentication - Select
this option if you want client applications to use a WS-Security SOAP
header to authenticate.
- Verify your IBM CMIS configuration
information.
- Specify how you are deploying IBM CMIS:
- Automatically deploy IBM CMIS - If you select
this option, the configuration tool automatically deploys IBM CMIS to the selected instance
of WebSphere Application
Server. This option
is recommended for most users.
- Manually deploy IBM CMIS - If you select
this option, the configuration tool does not deploy IBM CMIS. You must manually deploy IBM CMIS to a supported instance
of WebSphere Application
Server. This option
is recommended only for expert WebSphere Application
Server users.
- Specify the instance of WebSphere Application
Server to which to deploy IBM CMIS.
Important: You must deploy IBM CMIS to an existing WebSphere Application
Server profile that has WebSphere Application
Server security enabled.
- If prompted, specify the WebSphere Application
Server installation directory. If you tested the connection to the Content Engine server, the configuration
tool uses the installation directory that you specified in the Content
Engine Connection Information window.
- Specify the application server profile to which to deploy IBM CMIS.
- Specify the administrator user name and password for
the selected application server profile.
- If the application server profile contains application
servers and application server clusters, specify the type of server
to which you plan to deploy IBM CMIS.
- Specify the cluster or application server to which to
deploy IBM CMIS.
Remember: It is recommended that you deploy IBM CMIS to a dedicated application
server or application server cluster.
- Optional: Specify the name to display for
the IBM CMIS application
in WebSphere Application
Server. The
default display name for the application is FN_CMIS.
- Verify your WebSphere Application
Server deployment information
and click Next.
To validate that IBM CMIS was successfully deployed,
start the IBM CMIS application
on WebSphere Application
Server and open the IBM CMIS index page, index.jsp.
