Install Administration web application in WebSphere

To install Administration 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 entries.
  2. Click New.
  3. In the General Properties section enter:
    • Provider: ResourceEnvironmentProvider
    • Name: AdministrationApplicationConfiguration
    • JNDI name: bean/AdministrationApplicationConfiguration
    • Referenceables: com.axway.ais.jndires.factories.ConfigFactory, com.axway.ais.jndires.AppConfig
  4. In the Additional Properties section, click Custom properties.
  5. 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 aisadmin-web.xml.

For the Administration application, the following resources can be configured.

Field Description


Set to AISAdministration component name, or othercomponent name set at installation time Administration.

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

Respect the case of the Field name : ComponentName.


Path to the file, usually located in [Install_Path]/AIS/Administration/

Use the slash character as separator : “/”.

TrustStorePath Path to the passport truststore.
TrustStorePassword Password to the passport truststore
DocumentationPath Path to the documentation, usually located in: AIS\documentation\Datastore\UserGuide

Work folder used to save temporary files.

Default value is set to [Install_Folder]/AIS/Administration/extra/aisadmin-tools

Configure log4j logging:

  1. Make sure the Log4jFilePath property set on the previous step is set to the full path of the file.
  2. This file can be found in the folder AIS/Administration.
  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 file: log4j.appender.R.File=${catalina.home}/logs/admin-ui.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 Administration 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 aisadmin-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 InterPlay 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:
      • javax.sql.Datasource: 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/AdministrationApplicationConfiguration and click Next.
    10. In the Map context roots for Web modules screen, set the context root. For example, /admin-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: aisadmin-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 Administration Web Application module.
    6. The Configuration screen for the Administration 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. Save the configuration.
    9. In the Detail Properties section of the Configuration screen, click Class loading and update detection to update the Class loader order.
    10. In the Class loader order section, select Classes loaded with local class loader first (parent last).
    11. Start the application by selecting the application and clicking Start in the Enterprise Applications page.
    12. You should be able to go to the URL. For example:http://<websphereHost>:9080/admin-web.

    Related Links