Use the IBM® Content Navigator Configuration and Deployment tool to reconfigure FileNet® Collaboration Services 2.0.3 to support changes to Connections Content Manager. For example, reconfigure FileNet Collaboration Services when a host or port that is used to connect to Connections Content Manager is changed. This version of FNCS is a component of IBM Content
Navigator 2.0.3.
Before you begin
Set any relevant properties and respective values in the
<FNCS_Install_Location>\configure\explodedformat\fncs\WEB-INF\classes\fncs-sitePrefs.properties
as described in Site preference parameters of the IBM
FileNet Collaboration Services IBM Knowledge Center. In particular, set anonymousAccessEnabled=true
and
enablePropertySheetTemplateMinMax=true
.Important: Set the properties
fncsServerURL and fncsServerURLSecure to the base URL
used to address FileNet Collaboration Services, for
example, http://example.com and https://example.com.
Set the icURI property to the base URL used to address HCL Connections, for example, http://example.com. These
values might need to change if you configured a security proxy such as Tivoli® Access Manager. Security proxies change the URL or host name that
users use to access your deployment.
About this task
The following procedure explains how to reconfigure FileNet Collaboration Services that are embedded with a new installation of FileNet from Connections Content Manager.For an existing FileNet installation, refer to the FileNet Collaboration Services Information Center for a complete list of configuration options available.
With Connections Content Manager and a new FileNet
deployment, these configuration options are available in
<connections_install_root>\addons\ccm\FNCS\configure\profiles\CCM.
For example:
<connections_install_root>/addons/ccm/FNCS/configure/profiles/CCM
on Linux™.
Note: The path might be
<connections_install_root>\FNCS...
Procedure
-
Run the Enterprise Content Manager Client configuration and deployment tool (Configuration
Manager UI or CMUI):
-
Ensure that the Content Platform Engine is installed and running and then click
Next.To verify that Content Platform Engine is installed and running, take
the following steps:
-
Start the WebSphere Integrated Solutions Console in a web browser.
-
Browse to .
-
Verify that FileNetEngine is listed in the Enterprise
Applications list.
-
Load the CCM profile:
- Load the default CCM profile; browse to .
- Browse to <FNCS home>\configure\profiles\CCM.
- Select CCM.cfgp.
-
There are six default tasks. You can reconfigure the tasks that you want and then rerun the
tasks by double-clicking each task, entering values, and then saving your updates. Reconfigure
tasks as follows:
- Task 1 Updating the FileNet P8 Client Connectors files
(TaskName: downloadcejarstask)
This task downloads the
Jace.jar file from the FileNet Content Engine server. The WebSphere® Application Server Community Edition server must be running before you run this task. Enter the FileNet Content Engine server host name and the HTTP port (usually 9080 or
80). These values are used only once to download the client libraries from
the server. If you have a cluster, you can use the host name for a single server if wanted.
- Task 2: Configuring the connection to your LDAP server (TaskName:
configureldap)
This task is necessary only if you are deploying to a new WebSphere Application Server server that is not yet configured for LDAP-based security. On most CCM target systems, this task is already done.
- Task 3: Importing your Content Engine LTPA Keys (TaskName: importltpakey)
This task is required only if Connections and/or Content Engine are running on separate WebSphere Application Server cells and you did not previously import keys from those servers. On a typical CCM target system, CE and FNCS run in a single cell alongside Connections so this task is not necessary.
- Task 4: Configuring FileNet Collaboration Services
(TaskName: configurefncstask)
Choose the new feature Collocated
with Content Engine if FNCS runs on the same WebSphere Application Server server as CE and you want to use a local EJB connection.
Note: This option is recommended for most CCM deployments.
- If you specify "True" for this value, you do not have to enter a CE URL.
The field is hidden.
- If your FNCS is not collocated with CE, enter the CE EJB URL here. The typical format is
http://<hostname>:<ejb port>/FileNet/Engine
, for
example:http://ccv01233.usca.example.com:2809/FileNet/Engine.
HA-clustered URLs are supported, for example:corbaloc::cm-cfgsvr59vm2.usca.example.com:9810,:cm-cfgsvr59vm4.usca.example.com:9810/cell/clusters/cecluster/FileNet/Engine
- Enter the community library object store, community HTTP URL, and community HTTPS URL.
- If you want to change the additional custom properties to FNCS, use the included template
properties file connections_root\IBM\Connections\addons\ccm\FNCS\configure\explodedformat\fncs\WEB-INF\classes\fncs-sitePrefs.properties.
- The property that is needed for CCM is anonymousAccessEnabled=true.
- The property that is needed if you use IBM Docs in the
library widget: enableSharedDrafts=true.
- Task 5: Building the web application (TaskName: rebuildear) is required
if you perform any of the reconfiguration tasks 1 - 4.
This task generates an
.ear file based on the options you specified in the earlier tasks. The default
application name is
navigator, and the default ear name is
navigatorEAR.ear. In a plain CCM profile, this
.ear file
contains the FNCS application only.
Note: Do not change the context root.
- Provide the correct Build script path, such as connections_root\addons\ccm\FNCS\configure\explodedformat\create_ear.bat,
and the correct tmp path, such as connections_root\addons\ccm\FNCS\configure\tmp.
- When this task is finished, you have a completed .ear file that is ready
for deployment to WebSphere Application Server. You can
deploy it manually using the WebSphere Application
Server administrative console or use the Deploy the web application task in CMUI. The
navigatorEAR.ear file is located it in the connections_root\addons\ccm\FNCS\configure\deploy directory.
- Task 6: Deploying the web application (TaskName: deployapplication)
If
you created a new .ear file in Task 5, then you need to deploy it to WebSphere Application Server again to use it. Choose the
Deployment type, Application server node, and
Application server name and then run it.
-
Configure WebSphere Application Server as follows:
-
In the Content Navigator Task view, right click CCM , then select
Edit Profile Properties.
-
Complete the WebSphere Application Server parameters. Note the following parameter settings:
- Application Server version: Must be 8.5.
- Profile: Must be <WebSphere Application Server
pathname>/Dmgr01.
- DMGR Administrator user name, password, and confirmation of password.
- SOAP connector port: Must be the DMGR port.
- Host name: Must be the DMGR host.
- Deployment session timeout: Must be the default value (180).
-
Click Finish. You might need to reenter the WebSphere Application Server admin password whenever your restart the FNCS configuration manager session.
When you complete the WebSphere Application Server properties and reconfigure the tasks that you need, you can run these tasks. If you do not need to configure some tasks, you can right-click the task and choose to disable the task.
-
When the Deployed successfully summary is displayed, close the
CMUI.
- Log in to the WebSphere Application
Server Integrated Solutions Console for the Deployment Manager, and
click .
- Select the check boxes for the nodes and click Full
Resynchronize.
-
Install the authentication filter code as follows. You must reinstall the authentication filter
every time FNCS is reconfigured.
- In WebSphere Application Server administrative
console, browse to WebSphere Enterprise Applications.
- Select the FileNet Collaboration Services option.
Note: With the 2.0.3
release, the default application name is navigator.
- Click Update.
- For Application update options, select the Replace, add, or
delete multiple files option.
- If you are running the browser on the Deployment Manager node, select local file system and then
locate the auth_filter_patch.zip file.
Note: The
auth_filter_patch.zip file is in one of two directories, depending on your
system configuration:
Note: If the browser is not running on the Deployment Manager (DM) node, then select
remote file system and choose the DM file system, locating the
auth_filter_patch.zip file in the directory previously stated.
- Click Next and OK to update the application.
-
Reset the OAuthClient security role to user/group mapping:
Note: You must reset the OAuthClient mapping every time FNCS is reconfigured.
-
In the WebSphere Application Server administrative
console, browse to WebSphere Enterprise
Applications.
-
Click the FileNet Collaboration Services
(navigator).
-
Click Security role to user/group mapping under Detail
Properties, .
-
Select the OAuthClient option.
-
Under Map Special Subjects, click All Authenticated in
Application's Realm and click OK to save changes.
-
Click Save to save directly to the master configuration
- Verify the class loader policy for FNCS. Take the following
steps:
- Open the Integrated Solutions Console of the WebSphere Application Server hosting the navigator application.
- Click and select WebSphere
enterprise applications.
- Click .
- In the Class loader order section,
ensure that Classes loaded with local class loader first
(parent last) is selected.
- Click OK.
- Click .
-
In the General properties section, ensure that Classes loaded
with local class loader first (parent last) is selected in Class loader
order.
- Click OK and save your changes.
- Restart the navigator application.
-
You might need to update the HTTP server mappings when you complete reconfiguring FileNet Collaboration Services. For more information, see
Mapping applications to IBM
HTTP server.
Results
A summary supplies suggestions of how to confirm that the
service is up and running.