Setting up WebSphere Application Server

You can set up IBM® Rational® Focal Point™ to work with IBM WebSphere® Application Server.

Before you begin

Procedure

  1. On the WebSphere Integrated Solutions Console, update the JVM arguments, which can be set to control some aspects of the server behavior.
    1. Click Servers > WebSphere Application Servers.
    2. Click server1.
    3. Click Server Infrastructure > Java and Process Management > Process definition.
    4. Click Java Virtual Machine.
    5. In the Initial Heap and Maximum Heap Size fields, specify the required values.
      Note: Ensure that the required memory space is available on the computer. If memory space is insufficient, the application server cannot start.
    6. In the Generic JVM argument field, add the following Java™ arguments based on your platform:
      • On Windows® -32 bit: -Dclient.encoding.override=UTF-8 -Djava.awt.headless=true -Dfile.encoding=UTF-8 -Djava.library.path= <Focal Point installation directory>/Focalpoint/artifacts/licenselib/windows/32 -DJAZZ_HOME=file:///<Focal Point installation directory in the encoded URL format>/Focalpoint/artifacts/wars/jazzwebui/conf/
      • On Windows -64 bit: -Dclient.encoding.override=UTF-8 -Djava.awt.headless=true -Dfile.encoding=UTF-8 -Djava.library.path= <Focal Point installation directory>/Focalpoint/artifacts/licenselib/windows/64 -DJAZZ_HOME=file:///<Focal Point installation directory in the encoded URL format>/Focalpoint/artifacts/wars/jazzwebui/conf/
      • On Linux® -32 bit:-Dclient.encoding.override=UTF-8 -Djava.awt.headless=true -Dfile.encoding=UTF-8 -Djava.library.path= <Focal Point installation directory>/Focalpoint/artifacts/licenselib/linux -DJAZZ_HOME=file:///<Focal Point installation directory in the encoded URL format>/Focalpoint/artifacts/wars/jazzwebui/conf/
      • On Linux -64 bit: -Dclient.encoding.override=UTF-8 -Djava.awt.headless=true -Dfile.encoding=UTF-8 -d64 -Djava.library.path=<Focal Point installation directory>/Focalpoint/artifacts/licenselib/linux/64 -DJAZZ_HOME=file:///<Focal Point installation directory in the encoded URL format>/Focalpoint/artifacts/wars/jazzwebui/conf/
      • On Solaris -32 bit: -Dclient.encoding.override=UTF-8 -Djava.awt.headless=true -Dfile.encoding=UTF-8 -Djava.library.path=<Focal Point installation directory>/Focalpoint/artifacts/licenselib/solaris -DJAZZ_HOME=file:///<Focal Point installation directory in the encoded URL format>/Focalpoint/artifacts/wars/jazzwebui/conf/
      • On Solaris -64 bit: -Dclient.encoding.override=UTF-8 -Djava.awt.headless=true -Dfile.encoding=UTF-8 -d64 -Djava.library.path=<Focal Point installation directory>/Focalpoint/artifacts/licenselib/solaris/64 -DJAZZ_HOME=file:///<Focal Point installation directory in the encoded URL format>/Focalpoint/artifacts/wars/jazzwebui/conf/
    7. Optional: If you have set Rational Focal Point installation for a single locale, add -Duser.language=<locale code> to address case sensitive sorting based on the locale. For example: -Duser.language=en
    8. Click Apply, and then click OK.
    9. If you are using an IBM DB2® or Oracle database, specify the table space details that you created for Rational Focal Point. Click Custom Properties and add the table space details.
      Table 1. Table space details
      Database Details
      DB2 Object storage:
      • Name: focalpoint/bigObjStorage
      • Value: IN FP_BIGOBJ
      Data storage:
      • Name: focalpoint/dataStorage
      • Value: IN FP_DATA
      Index storage:
      • Name: focalpoint/indexStorage
      • Value: IN FP_INDEX
      Oracle Object storage:
      • Name: focalpoint/bigObjStorage
      • Value: TABLESPACE FP_BIGOBJ STORAGE (initial 1m next 1m pctincrease 0)
      Data storage:
      • Name: focalpoint/dataStorage
      • Value: TABLESPACE FP_DATA STORAGE (initial 1m next 1m pctincrease 0)
      Index storage:
      • Name: focalpoint/indexStorage
      • Value: TABLESPACE FP_INDEX STORAGE (initial 1m next 1m pctincrease 0)
    10. To specify the location of the Rational Focal Point license file, on the Custom Properties page, add the following details:
      • Name: focalpoint/licenseLocation
      • Value: Type the location of the license server in the format port@host; for example, 19353@licenseserver.
    11. To enable a non-IBM JAX-WS web services engine in WebSphere Application Server, add the following details on the Custom Properties page:
      • Name: com.ibm.websphere.webservices.DisableIBMJAXWSEngine
      • Value: true
    12. To enable Rational Publishing Engine for report generation add the following details on the Custom Properties page:
      • Name: org.eclipse.emf.common.util.URI.archiveSchemes
      • Value: wsjar wszip jar zip
    13. To enable the required locales environment to Rational Focal Point users, specify the required locale code separated by vertical bars (|). On the Custom Properties page, add the locale details:
      • For focalpoint/installSelectedLocales, the values are en|de|es|fr|it|pt,BR|ja|ko|zh,CN|zh,TW|ar|he|cs|hu|pl|ru
      • For focalpoint/defaultLocale, only one value can be specified from en|de|es|fr|it|pt,BR|ja|ko|zh,CN|zh,TW|ar|he|cs|hu|pl|ru
    14. Add the property values for focalpoint/fontFile, focalpoint/hostName, and focalpoint/defaultLocale.
    15. Click Apply, and then click OK.
  2. Specify the class path of the Rational Focal Point library files.
    1. Click Environment > Shared Libraries.
    2. Specify the required scope for the library.
    3. Click New.
    4. Specify a name for the library; for example, fpjars
    5. Specify the class path of the Rational Focal Point library files. These files are in the installation location of Rational Focal Point: <Focal Point installation directory>\Focal Point\artifacts\jars.
    6. Click Apply, and then click OK.
  3. Configure the resource environment to specify the file storage.
    1. Click Resources > Resource Environment > Resource Environment Providers.
    2. Specify the required scope for the library.
    3. Click New.
    4. For the name of the data storage, type filestorageProvider. Enter the description for the data storage and click OK.
    5. Select filestorageProvider and provide the reference details by clicking Referenceables.
      1. Click New.
      2. In the Factory class name field, type com.telelogic.focalpoint.tools.filestorage.FileStorageFactory.
      3. In the Class name field, type com.telelogic.focalpoint.tools.filestorage.FileStorage
      4. Click OK.
    6. Create the environment entries by clicking Resource environment entries.
      1. Specify the required scope for the library.
      2. Click New.
      3. In the Name field, type filestorage.
      4. In the JNDI name field, type focalpoint/filestorage.
      5. Click OK.
    7. Select filestorage and specify whether the file storage is a database or a file system. Click Custom Properties.
      1. Click New.
      2. In the Name field, type storageClassName.
      3. In the Value field, if the file storage is a database, type com.telelogic.focalpoint.tools.filestorage.FileStorageDB. If the file storage is a file system, type com.telelogic.focalpoint.tools.filestorage.FileStorageFS
      4. Ensure that the type is java.lang.String
      5. Click OK.
    8. Specify the base path information of the file storage. Click New.
      1. In the Name field, type basePath.
      2. If the file storage is an application server, specify the value for the base path. For the database file storage, do not specify a value.
      3. Click OK.
  4. Configure the JDBC provider to point to the JAR files of the database. For information about configuring the JDBC provider, see the WebSphere Application Server documentation.
    While you configure the data source, use the following parameters:
    Table 2. Data source details
    Database Parameters
    PostgreSQL
    • Database Type: User Defined
    • Implementation class name: org.postgresql.jdbc2.optional.ConnectionPool
    • Class path: <Focal Point installation directory>\Focal Point\artifacts\fpjars\postgresql-8.1-405.jdbc3.jar
    • JNDI name: jdbc/focalpoint
    • For Connection Pool Properties, set the websphereDefaultIsolationLevel as 2
    Oracle
    • Database Type: Oracle
    • Class path: Location of ojdbc*.jar that is copied to Websphere install directory/lib location.
    • JNDI name: jdbc/focalpoint
    • For Connection Pool Properties, add a custom property named SetBigStringTryClob and set the value as true. Set the websphereDefaultIsolationLevel as 2.
    IBM DB2
    • Database Type: IBM DB2
    • Class path: Location of db2jcc-9.5.jar and db2jcc_license_cu-9.5.jar
    • JNDI name: jdbc/focalpoint
    • For Connection Pool Properties, set the websphereDefaultIsolationLevel as 2

What to do next

Install the Rational Focal Point application on WebSphere Application Server. For details, see Installing Rational Focal Point on WebSphere Application Server

Feedback