Install the Designer web application in WebSphere

To install the Designer 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:
    • Provider: ResourceEnvironmentProvider
    • Name: DesignerApplicationConfiguration
    • JNDI name: bean/DesignerApplicationConfiguration
    • 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 this environment entry must correspond with the attributes of bean/ApplicationConfiguration from the file designer-web.xml.

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

Caution   Respect the case of the field name
Field Description

ComponentName

Set to AISDesigner component name, or othercomponent name set at installation time for Designer.

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]/AIS/Designer/log4j.properties

Use the slash character as separator : “/”.

AdminDatabaseUser In case the installation has been performed using two users, a functional one and an administration one, the value of this field must be set with the name of the administration user.
IndexTableSpace Index tablespace name
LobTableSpace Lob tablespace name
TrustStorePath Path to the passport truststore.
TrustStorePassword Password to the passport truststore
DatabaseSecuredPassword Set to true by default.
DocumentationPath Path to the documentation, usually located in: [Install_Folder]/AIS/documentation/AccountingIntegration/UserGuide folder.
WorkDirectory

Work folder used to save temporary files.

Default value is set to [Install_Folder]/AIS/Designer/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. Set the property log4j.appender.R.File to the location where you want to store the log file.
  3. The log4j.appender.R.File is a file located inside the log4j.properties file: log4j.appender.R.File=${catalina.home}/logs/designer.log
  4. By default, the log4j.appender.R.File is set to write the log file using a tomcat system variable.
  5. 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 designer-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 Initialize parameters for servlets screenaccept the default settings and click Next.
    9. 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 have created for Designer.
        • For jdbc/ConfigurationDataSource, select the datasource that defined for the Repository.
    10. Click Next.
    11. In the Map resource environment references to resources screen, set the Target Resource JNDI Name to bean/DesignerApplicationConfiguration and click Next.
    12. In the Map context roots for Web modules screen, set the context root. For example, /designer-web. Click Next.
    13. 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: designer-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 Designer Web Application module.
    6. The Configuration screen for the Designer 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/designer-web.

    Related Links