FileNet P8 Application Engine, Version 5.0.+              

Installing and deploying the Application Engine ISRA servlet

To install and deploy the ISRA Servlet on the operating systems supported by Application Engine, run the associated ISRA setup program found in the Application Engine software package.

Be sure that you have available the Installation and Upgrade Worksheet that was completed during your planning activities.

The Application Engine installation software contains the ISRA servlet installation programs for the supported Application Engine operating systems.

To install and deploy the Application Engine ISRA servlet:

  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 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
    UNIX® User account with write access to the /bin directory and read, write, and execute access to the directory where you plan to install ISRA Servlet.
    Windows® A member of the local Administrators group or as a user account with equivalent permissions.
  3. Stop the application server if it is running.
  4. Access the ISRA installation package, and start the following Application Engine ISRA Servlet setup program, depending on your operating system:
    Option Description
    UNIX 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 ISRA 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 IS server.
  8. (WebSphere® Application Server and WebLogic Server only) Start the application server.
  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.
  11. Verify the Application Engine ISRA 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 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 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


Feedback

Last updated: November 2010


© Copyright IBM Corporation 2010.
This information center is powered by Eclipse technology. (http://www.eclipse.org)