To upgrade the Application Engine IBM®
FileNet® Image Services Resource Adapter (ISRA) servlet, you must
run its installation program. You must also complete additional configuration
and deployment steps.
Before you begin
Be sure that you have available
the Installation and Upgrade Worksheet that was completed during your
planning activities.
About this task
The Application Engine installation
packages contain the ISRA servlet installation programs for the supported Application Engine platforms.
Procedure
- Open your completed Installation and Upgrade Worksheet
file.
Tip: In the worksheet file, verify
that the command is enabled.
To view only Application Engine ISRA
servlet values, filter by ISRA Installer in
the Installation or Configuration Program column.
- Log on to the application server machine:
Option |
Description |
AIX®, HPUX, Linux, Linux for System z, Solaris |
Log on as a user with write access to the /bin directory
and read, write, execute access to the directory where you plan to
install ISRA servlet. |
Windows |
Log on as a member of the local Administrators group or as
a user with equivalent permissions. |
- (WebSphere® Application Server and WebLogic Server only) Back up and undeploy
the ISRA servlet application on the application server.
- Stop the application server instance if it is running.
- (JBoss Application Server only)
Back up and undeploy the ISRA servlet application.
- Access the Application Engine ISRA
installation package.
- Start the Application Engine ISRA
servlet installation program, which is also covers upgrades:
Option |
Description |
AIX, HPUX, Linux, Linux for System z, Solaris |
AE-ISRA-Servlet-4.0.2.0-operating_system.bin |
Windows |
AE-ISRA-Servlet-4.0.2.0-WIN.exe |
- Complete the installation program screens by using the
values in your worksheet.
- Check the file AE_ISRA_Servlet_install_log-4_0_2_0.txt ,
located in the AE_israservlet_install path/FileNet directory,
to see if any errors occurred during the installation.
- Install unlimited strength jar files.
Perform
this step only if your site is generating or accepting unlimited strength
user tokens. Your system must be configured as follows:
- The Application Engine ISRA servlet
is deployed on a different application server from the Application Engine server.
- The Create unlimited strength key option was selected in the Application Engine User Token Security step
of the Application Engine installation.
If you do not install the unlimited strength jar files,
and your site generates or accepts unlimited strength user tokens,
cause an EncryptionException occurs when you log in to the IS Server.
- (WebSphere Application Server and WebLogic Server only) Start the application
server instance.
- Deploy AE_israservlet_install_path/FileNet/ApplicationEngineISRAServlet/ae_isra.war in
the same way you deployed the app_engine.war file
for Workplace.
- (JBoss Application Server only) Start the application
server instance.
- Verify the Application Engine ISRA
servlet installation. Do the following to use an available diagnostic
tool to verify that the ISRA servlet is installed and deployed correctly.
- Launch your browser.
- Enter the URL for the Application Engine ISRA servlet. For example, http://ApplicationEngineISRAServlet_servername:port/ApplicationEngineISRAServlet/ISRA
ApplicationEngineISRAservlet is the default context root.
If you specified a different name for the context root when deploying
the Application Engine ISRA servlet,
change the URL to match your configuration.
If the ISRA servlet is installed and deployed correctly,
a Congratulations message displays. For example:
Congratulations! ISRA Interface Servlet is configured at this URL.
WcmApiConfigFile = D:\ISRAInterface\jsp\WEB-INF\WcmApiConfig.properties
WcmApiConfig file exists
CryptoKeyFile/UserToken = C:\Program
Files\FileNet\Authentication\UTCryptoKeyFile.properties
CryptoKeyFile/UserToken exists
FileNet ISRA classes are in the classpath
com.filenet.is.ra.cci.FN_IS_CciConnectionSpec