Install Datastore Client web application in WebSphere

To install Datastore Client web application in WebSphere, you must:

  1. Create resource environment entries and custom properties:
  2. Configure log4j logging:
  3. Install the new application
  4. Change the module class loading policy

Create resource environment entries and custom properties:

  1. On the Integrated Solutions console, in the left side menu, select Resources > Resource > Environment > Resource Environment Providers.
  2. In the General Properties section enter, for example:
    • Provider: DSClientResourceProvider
    • Name: DatastoreApplicationConfiguration
    • JNDI name: bean/DatastoreApplicationConfiguration
    • Referenceables: com.axway.ais.jndires.factories.ConfigFactory, com.axway.ais.jndires.AppConfig
  3. In the Additional Properties section, click Custom properties.
  4. The Custom properties screen is displayed.

The custom properties defined for the AppConfig entry must correspond with the attributes of bean/ApplicationConfiguration from the file aisclient-web.xml.

For the Datastore Client application, the following resources can be configured.

Field Description

ComponentName

Set to DatastoreClient component name, or othercomponent name set at installation time for the Datastore Client.

Verify that no trailing spaces are present and that the value is the exact component name.

Respect the case of the Field name : ComponentName.

Log4jFilePath

Path to the log4j.properties file, usually located in [Install_Path]/Datastore//DatastoreClient/configuration/log4j.properties

Use the slash character as separator : “/”.

TrustStorePath Path to the passport/reporting truststore. The default truststore can be found in [Install_Folder]/AIS/Tools/config/certs.
TrustStoreType Trust store type. The delivered trust store is of type jks.
DatabaseSecuredPassword Set to true by default.
DocumentationPath Path to the documentation, usually located in: [Install_Folder]\Datastore\documentation
WorkDirectory

Work folder used to save temporary files.

Default value is set to [Install_Folder]\Datastore\DatastoreClient\extra\work

Configure log4j logging:

  1. Make sure the Log4jFilePath property set on the previous step is set to the full path of the log4j.properties file.
  2. This file can be found in the folder Datastore/DatastoreClient/configuration.
  3. Set the property log4j.appender.R.File to the location where you want to store the log file.
  4. The log4j.appender.R.File is a file located inside the log4j.properties file: log4j.appender.R.File=${catalina.home}/logs/datastore.log
  5. By default, the log4j.appender.R.File is set to write the log file using a tomcat system variable.
  6. Restart the application from WebSphere
  • Note Use the "/" as path separator to avoid path evaluation issues, and ensure that the folder where the log file will be stored is writable
  • Install the new application

    To install Datastore Client in WebSphere, go to the Integrated Solutions console and open the application installation screen: Application > Application Types > WebSphere Enterprise Applications.

    1. In the Enterprise Applications screen, click Install.
    2. In the Preparing for the application installation screen:
      1. In the Path to the new application section, select Local file system, select dsclient-web.war file, and click Next.
      2. In the How do you want to install the application section, select Detailed installation and click Next.
    3. Caution: From now on, the list of steps is not complete. Only the screens where modifications must be made are described.
    4. In the Select installation options screen, accept the default settings and click Next.
    5. In the Map shared libraries screen, select the module Datastore and click Reference shared libraries.
    6. The Enterprise Applications screen is displayed.
    7. Add the reference to the previously created jndiRes and click OK.
    8. In the Map resource references to resources screen, browse your files to set the reference to:
      • commonj.timers.TimerManager: DefaultTimeManager
      • commonj.work.WorkManager: DefaultWorkManager
      • javax.sql.Datasource:
        • For jdbc/ApplicationDataSource, select the datasource that you created for Datastore Client.
        • For jdbc/ConfigurationDataSource, select the datasource that defined for the Repository.
    9. In the Map resource environment references to resources screen, set the Target Resource JNDI Name to bean/DatastoreApplicationConfiguration and click Next.
    10. In the Map context roots for Web modules screen, set the context root. For example, /dsclient-web. Click Next.
    11. Click Finish on the last page.

    Change the module class loading policy

    To change the module class loading policy:

    1. Open the Configuration screen of the application you installed: dsclient-web.war
    2. Go to the Integrated Solutions console and open the application installation page: Application > Application Types > WebSphere Enterprise Applications. Locate the application you installed and click its name. The Configuration screen opens.
    3. In the Modules section, click Manage Modules.
    4. The Manage Modules screen is displayed.
    5. Select the Datastore Web Application module.
    6. The Configuration screen for the Datastore Web Application module is displayed.
    7. In the Class loaded order drop-down menu, select Classes loaded with local class loader first (parent last).
    8. In the Detail Properties section of the Configuration screen, click Class loading and update detection to update the Class loader order.
    9. In the Class loader order section, select Classes loaded with local class loader first (parent last).
    10. Start the application by selecting the application and clicking Start in the Enterprise Applications page.
    11. You should be able to go to the URL. For example:http://<websphereHost>:9080/dsclient-web.

    Related Links