To install and deploy the Image Services Resource Adapter Servlet on the operating
systems supported by Application Engine,
run the associated Image Services Resource Adapter setup
program found in the Application Engine software
package.
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
software contains the Image Services Resource Adapter servlet
installation programs for the supported Application Engine operating systems.
To
install and deploy the Application Engine Image Services Resource Adapter servlet:
Procedure
- Open your completed Installation and Upgrade Worksheet
file.
Tip: In the worksheet file, verify
that the command is enabled.
To view only Content Platform Engine values,
filter by ISRA Installer in the Installation
or Configuration Program column.
- Log on to the application server by using the following
account, depending on your operating system:
Option |
Description |
AIX®, HPUX, Linux, Linux for System z, Solaris |
User account with write access to the /bin directory
and read, write, and execute access to the directory where you plan
to install Image Services Resource Adapter Servlet. |
Windows |
A member of the local Administrators group or as a user account
with equivalent permissions. |
- Stop
the application server instance if it is running.
- Access the Image Services Resource Adapter installation
package, and start the following Application Engine Image Services Resource Adapter Servlet setup program,
depending on your operating system:
Option |
Description |
AIX, HPUX, Linux, Linux on 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 from 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 the following are true:
- You selected the option to create Strong keys in the Application Engine User Token Security step
of the Application Engine installation.
- Application Engine Image Services Resource Adapter Servlet is deployed
on a different application server than Application Engine.
Important: If these conditions are true, failure
to perform this step causes an EncryptionException when you log on
to the Image Services 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
only) Start the application server instance.
- Verify the Application Engine Image Services Resource Adapter Servlet is installed
and deployed correctly, as follows. This step launches a diagnostic
tool that does the verification.
- Open your web browser.
- Enter the URL for the Application Engine Image Services Resource AdapterA 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 Image Services Resource Adapter Servlet, change the
URL to match your configuration.
If the
Image Services Resource Adapter Servlet is set up 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