-
(JBoss 5.1) Open the application server run file
[
JBoss root]
/bin/run.conf.bat
in a text editor.
-
Add the location of the FileNet Configuration files as a
Java option to the application server start command, and then save
the file.
Note:
If JBoss is running as a service,
add the Java option in the registry where other JVM arguments are
defined.
-
-Dwasp.location= <configuration files location>
For
example, using a default FileNet Application Engine installation
on a Windows operating system, add this Java option:
-Dwasp.location=C:/Progra~1/FileNet/AE/CE_API/wsi
-
If your deployment uses the Process Engine Connector service,
copy the file
[JBoss root]
\client\logkit.jar to the following
directory:
-
Locate the adobe-component-ext.properties file in the
[JBoss root]
/bin folder (if
the file does not exist, create it).
-
Add a new system property that provides the location of these
FileNet Application Engine JAR files:
For Filenet 4.x add
following JAR files.
For Filenet 5.0 add following
JAR files
-
Jace.jar
-
javaapi.jar
-
log4j.jar
-
mailapi.jar
-
pe.jar
-
stax-api.jar
-
xlxpScanner.jar
-
xlxpScannerUtils.jar
-
xml.jar
Note:
Add the pe.jar
file only if your deployment uses the IBMFileNetProcessEngineConnector
service. The new system property should reflect this structure:
[component id].ext=[JAR files and/or folders]
Note:
Do not overwrite the
existing contents of the properties file. Simply append the new
system property to the contents.
For example, using a default FileNet
Application Engine installation on a Windows operating system, add
the following system property on a new line with no line breaks
and end the line with a carriage return:
Note:
The
following text contains formatting characters for line breaks. If
you copy this text to a location outside this document, remove the
formatting characters when you paste it to the new location.
Note:
Add
C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/pe.jar
only if your deployment uses the IBMFileNetProcessEngineConnector service.
Note:
For FileNet 5.0, add the following jar files
C:/Program Files/FileNet/AE/CE_API/lib/Jace.jar,
C:/Program Files/FileNet/AE/CE_API/lib2/javaapi.jar,
C:/Program Files/FileNet/AE/CE_API/lib2/log4j.jar,
C:/Program Files/FileNet/AE/Router/lib/mailapi.jar,
C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/pe.jar,
C:/Program Files/FileNet/AE/CE_API/lib/stax-api.jar,
C:/Program Files/FileNet/AE/CE_API/lib/xlxpScanner.jar,
C:/Program Files/FileNet/AE/CE_API/lib/xlxpScannerUtils.jar,
C:/Program Files/FileNet/AE/Router/java/jre/lib/xml.jar
-
(FileNet Process Engine Connector only) Configure the connection
properties for the process engine as follows:
-
Using
a text editor, create a file with the following content as a single
line and end the line with a carriage return:
RemoteServerUrl = cemp:http://[contentserver_IP]:[contentengine_port]/
wsi/FNCEWS40DIME/
-
Save the file as WcmApiConfig.properties in a separate folder,
and add the location of the folder that contains the WcmApiConfig.properties
file to the adobe-component-ext.properties file.
For example,
if you save the file as c:/pe_config/WcmApiConfig.properties, add
the path c:/pe_config to the adobe-component-ext.properties file.
Note:
The filename is case-sensitive.
-
Locate the login-config.xml file in the following
folder and add the following application policy as a child of the
<policy> node:
<application-policy name = "FileNetP8WSI">
<authentication>
<login-module code = "com.filenet.api.util.WSILoginModule" flag =
"required" />
</authentication>
</application-policy>
-
(FileNet Process Engine Connector only) If your deployment
uses the process engine, add the following node to the login-config
file:
<application-policy name = "FileNetP8">
<authentication>
<login-module code = "com.filenet.api.util.WSILoginModule" flag =
"required" />
</authentication>
</application-policy>
-
If the application server is not currently running, start
the service. Otherwise, stop and then restart the server.
-
If JBoss runs as a service, start (or restart) the JBoss
for Adobe Experience Manager froms service.
-
Open a web browser and enter this URL:
http://
[host]:[port]
/adminui
-
Log in using the default user name and password:
User name
:
administrator
Password
: password
-
Click
Services
>
Connector for IBM FileNet
.
-
Provide all of the required FileNet repository information
and, under Repository Service Provider Information, select
IBM FileNet Repository Provider
.
If
your deployment uses the optional process engine service, under
Process Engine Settings, select
Use Process Engine Connector Service
and
specify the process engine settings. For more information, click
the
Help
link in the upper-right corner of the page.
Note:
The credentials that you provide in this step
are validated later when you start the IBM FileNet repository services.
If the credentials are not valid, an error is thrown and the services
will not start.
-
Click
Save
and navigate to
Services
>
Applications and Services
>
Service Management
.
-
Select the check box next to
IBMFileNetProcessEngineConnector
(if configured)
and then click
Start.
-
Select the check box next to each of these services and then
click
Start
:
-
IBMFileNetAuthProviderService
-
IBMFileNetContentRepositoryConnector
-
IBMFileNetRepositoryProvider
-
IBMFileNetProcessEngineConnector (if configured)
If
any of the services do not start correctly, verify the settings
entered in step 15.
-
Do one of the following tasks:
-
To use the FileNet
Authorization service (IBMFileNetAuthProviderService) to display
content from a FileNet object store in the Resources view of Workbench,
continue with this procedure. Using the FileNet Authorization service
overrides the default AEM forms on JEE authorization and must be configured
to log in to Workbench by using FileNet credentials.
-
To use the AEM forms on JEE repository, log in to Workbench
by using the AEM forms on JEE super administrator credentials (by
default,
Administrator
and
password
). The credentials
provided in step 15 use the default AEM forms on JEE authorization
service for accessing the default repository in this case.
-
Enable the Remoting and EJB endpoints by doing these tasks:
-
Log in to Administration Console and click
Home > Services > Application and Services > Service Management
.
-
Filter the category
Connector for IBM FileNet
and
click
IBMFileNetContentRepositoryConnector:1.0.
-
Select the disabled endpoints and enable them.
-
Restart your application server.
-
Log in to Administration Console and click
Settings
>
User Management
>
Domain Management
.
-
Click
New Enterprise Domain
and then type a domain
ID and name. The domain ID is the unique identifier for the domain.
The name is a descriptive name for the domain.
Note:
When
using MySQL for your AEM forms on JEE database, use only single-byte
(ASCII) characters for the ID. (See “Adding enterprise domains”
in Administration Help
.)
-
Add a custom authentication provider:
-
Click
Add Authentication
.
-
In the
Authentication Provider
list, select
Custom
.
-
Select
IBMFileNetAuthProviderService
and then click
OK
.
-
Add an LDAP authentication provider:
-
Add an LDAP directory:
-
Click
Add Directory
and,
in the
Profile Name
box, type a unique name, and then click
Next
.
-
Specify values for the
Server
,
Port
,
SSL
,
Binding
,
and
Populate page with
options. If you select
User
for
the
Binding
option, you must also specify values for the
Name
and
Password
fields.
-
(Optional) Select
Retrieve Base DN
to retrieve base
domain names, as required. When finished, click
Next
.
-
Configure the user settings, click
Next
, configure
group settings as required, and then click
Next
.
For
details about the settings, click
Help
linkin the
upper-right corner of the page.
-
Click
OK
to exit the Add Directory page, and then
click
OK
again.
-
Select the new enterprise domain and click
Sync Now
.
Depending on the number of users and groups in your LDAP network
and the speed on your connection, the synchronization process may
take several minutes.
(Optional) To verify the status of the
synchronization, click
Refresh
and view the status in the
Current Sync State
column.
-
Navigate to
Settings
>
User Management
>
Users and Groups
.
-
Search for users that were synchronized from LDAP and perform
these tasks:
-
Select one or more users and click
Assign Role
.
-
Select one or more AEM forms on JEE roles and click
OK
.
-
Click
OK
a second time to confirm the role assignment.
Repeat
this step for all users you want to assign roles to. For more information, click
the
Help
link in the upper-right corner of the page.
-
Start Workbench and log in using the following credentials
for the IBM FileNet repository:
User name:
[username]@[repository_name]
Password:
[password]
The
FileNet object store should now be visible in the Resources view
within Workbench. If you do not log in using the
username
@
repository name
, Workbench
attempts to log in to the default repository specified in step 15.
-
(Optional) If you intend to install the AEM forms on JEE
Samples for Connector for IBM FileNet, create a FileNet object store
named
Samples
and install the samples in that object store.
After you configure your Connector for IBM FileNet service, it
is recommended that you see AEM forms on JEE Administration Help.
for information about configuring Workbench functions properly with
your FileNet repository.