FileNet P8 Application Engine, Version 5.2.1              

Upgrading the Application Engine Image Services Resource Adapter servlet

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

  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 Application Engine ISRA servlet values, filter by ISRA Installer in the Installation or Configuration Program column.
  2. 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.
  3. (WebSphere® Application Server and WebLogic Server only) Back up and undeploy the ISRA servlet application on the application server.
  4. Stop the application server instance if it is running.
  5. (JBoss Application Server only) Back up and undeploy the ISRA servlet application.
  6. Access the Application Engine ISRA installation package.
  7. 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
  8. Complete the installation program screens by using the values in your worksheet.
  9. 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.
  10. 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.

  11. (WebSphere Application Server and WebLogic Server only) Start the application server instance.
  12. Deploy AE_israservlet_install_path/FileNet/ApplicationEngineISRAServlet/ae_isra.war in the same way you deployed the app_engine.war file for Workplace.
  13. (JBoss Application Server only) Start the application server instance.
  14. 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.
    1. Launch your browser.
    2. 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


Last updated: October 2015
p8pup185.htm

© Copyright IBM Corporation 2013, 2015.