Deploy on WebSphere Liberty - assure_dq - 10.2.0

Assure DQ Server Installation
Product type
Software
Portfolio
Verify
Product family
Assure
Product
Assure DQ
Version
10.2.0
ft:locale
en-US
Product name
Assure DQ, ER, Insight and Perceive
ft:title
Assure DQ Server Installation
Copyright
2026
First publish date
2005
ft:lastEdition
2026-07-27
ft:lastPublication
2026-07-27T06:58:29.702000
L1_Product_Gateway
Verify
L2_Product_Segment
Data Quality
L3_Product_Brand
Precisely Infogix
L4_Investment_Segment
Legacy Infogix DQ
L5_Product_Group
Legacy Infogix DQ
L6_Product_Name
Product Feature
Assure DQ

To begin, download the WebSphere Liberty installer package from IBM's official support page:

IBM Website for WebSphere Liberty for Developers

Warning: Older versions of Liberty (prior to 26.0.0.3) are no longer supported. Customers upgrading from earlier Liberty versions may experience issues, particularly related to password encryption. Install and use Liberty version 26.0.0.3 exclusively.

For Windows: WebSphere Liberty Jakarta EE 8, Network Deployment Version 26.0.0.3

For Linux or Unix: WebSphere Liberty Network Deployment wlp-nd-all-26.0.0.3.jar

To install WebSphere Liberty, unzip the downloaded installer package.

Server configuration

To create and manage a new server:

  1. Open a Command-Line Interface (CLI) and navigate to the wlp/bin directory.
  2. Create a new server named server1 by executing the following command:
    • For Windows OS: server create server1
    • For Linux or Unix: ./server create server1

    This will create a server named server1 in the wlp/usr/servers directory.

  3. Ensure that Java 17 is configured and available before starting the server.
    Important: Liberty must be started using Java 17. If any other Java version is used, compilation errors will appear in the server logs and the application may fail to start. This is a mandatory prerequisite.
  4. Start the server by executing the following command:
    • For Windows OS: server start server1
    • For Linux or Unix: ./server start server1
  5. To stop the server, execute the following command:
    • For Windows OS: server stop server1
    • For Linux or Unix: ./server stop server1
Tip: To delete a server, first stop the server, then manually delete the server folder. WebSphere Liberty does not provide a delete command.

Key locations for server files

  • Server Log: Located in the logs folder within the created server directory. It is named as messages.log.
  • server.xml: Contains all the configurations required for application installation.
  • bootstrap.properties: Holds property values to be used in server.xml and other server-level configurations, such as formatting server logs and enabling trace logging.

Liberty feature installation

Attention: If nd-all version of Liberty is being used, this step can be ignored.

The Liberty server does not come pre-packaged with features for installation. Instead, each feature required by an application must be added to the server.xml file and installed before it can be used.

To install individual features, execute the following command:

  • For Windows OS: installUtility install <featureName>
  • For Linux or Unix: ./installUtility install <featureName>

    For example:

    installUtility install jdbc-4.1

To install all features specified in server.xml at once, execute the following command:

  • In Windows OS: installUtility install <serverName>
  • In Linux or Unix: ./installUtility install <serverName>

For example:

installUtility install server1
Tip: This is a one-time operation per WebSphere Liberty installation. There is no need to repeat this step for new servers unless new features are added to server.xml.

Application deployment on WebSphere Liberty

  1. Extract the downloaded build product builds. Run the following script to extract the files to the installation folder:
    • For Windows: infogixextract.bat
    • For UNIX or Linux: ./infogixextract.sh
  2. Execute Init-config and choose option 2 (websphereLiberty) for appserver.
  3. If required, create a new SQL/Oracle Server database to verify the populate-db command. Skip this step if the database is already created and populated.
  4. Manually configure the installer properties (located in Infogix/config).
    • Update the appserver and appserver.advance files with the necessary changes such as port, host, liberty home, and other required settings.
  5. Execute the clean command.
  6. Execute Validate-config-values.
  7. Optionally, execute populate-db.
  8. Execute deploy.
  9. Start the server and review the server log to confirm successful deployment.
  10. Launch the application.