FileNet P8 Application Engine, Version 5.2.1              

Installing and deploying the Application Engine Image Services Resource Adapter servlet

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

  1. Open your completed Installation and Upgrade Worksheet file.
    Tip: In the worksheet file, verify that the Data > Filter > AutoFilter command is enabled. To view only Content Platform Engine values, filter by ISRA Installer in the Installation or Configuration Program column.
  2. 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.
  3. Stop the application server instance if it is running.
  4. 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
  5. Complete the installation program screens by using the values from your worksheet.
  6. 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.
  7. 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.
  8. (WebSphere® Application Server and WebLogic Server only) Start the application server instance.
  9. Deploy AE_israservlet_install_path/FileNet/ApplicationEngineISRAServlet/ae_isra.war in the same way you deployed the app_engine.war file for Workplace.
  10. (JBoss only) Start the application server instance.
  11. 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.
    1. Open your web browser.
    2. 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


Last updated: March 2016
p8pin087.htm

© Copyright IBM Corporation 2013, 2016.