Administer > Utility Tools > Maintenance Tools

Maintenance Tools

The Maintenance Tool helps you (the Administrator) change the Glassfish password, change the domain name, update the Vertica Connection, link to BOE, update the ITBA License, update ITBA IP number, backup and restore Postgres, update the AutoPass host, anc collect Logs and ITBA information.

Once the Administrator has updated the relevant parameters and executed the process, the system updates the relevant parameters in the DB tables (if needed) and performs a restart of ITBA (if needed).

ClosedTo access:

Open a Unix console (bash) and go to the following $HPBA_HOME/Tools/ directory and input the command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

ClosedLaunch the Maintenance Tool and validate

  1. Prerequisite: Before running the Maintenance Tool, make sure the glassfish service is started. To check the service status, run ./hpba-status.sh in
    $HPBA_HOME/supervisor/bin.

    If the glassfish service is down, start it manually using ./startGlassfishBA.sh in $HPBA_HOME/bin.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools/ directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.
  3. The authentication window opens.

  4. The default user name is admin,the password is set when you installing ITBA. Once the authentication is successful, go to the main menu page and perform the required operation.

ClosedChange the Glassfish password

You can update the Glassfish (ITBA Admin password) using the Maintenance Tool.

  1. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools/ directory and input the command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  2. Enter 1 in Enter a number (0-9) to change the Glassfish/Admin Password, and then input the old password and new password to change it.

ClosedChange ITBA FQDN

You can update ITBA FQDN using the Maintenance Tool.

  1. Make sure you check out the step detailed in the Maintenance Tool.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools/ directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  3. Enter 2 in Enter a number (0-9) to change the hostname. The current hostname is displayed, and users are asked to input his new hostname.

  4. After the hostname updates successfully, restart ITBA manually.

ClosedUpdate the Vertica Connection

You can update the Vertica connection using the Maintenance Tool.

  1. Make sure you check out the step detailed in the Maintenance Tool.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools/ directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  3. Enter 3 in Enter a number (0-9) to update the Vertica Connection.

  4. Once the Connection is updated successfully, users need to restart ITBA manually.

ClosedUpdate the BOE Linkage

You can update the BOE linkage using the Maintenance Tool.

  1. Make sure you check out the step detailed in the Maintenance Tool.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools/ directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  3. Enter 4 in Enter a number (0-9) to create the BOE linkage. Additional BOE information is required.

  4. Once the link is successful, users need to manually create ITBA users in BOE.

ClosedUpdate ITBA Licenses

You can update the ITBA license using the Maintenance Tool.

  1. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools/ directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  2. Enter 5 in Enter a number (0-9) to update the license.

  3. The user licenses information (license type and capacity) is automatically displayed in the shell.

  4. Enter the license key.

ClosedUpdate ITBA IP number

You can update ITBA IP number using the Maintenance Tool.

  1. Make sure you check out the step detailed in the Maintenance Tool.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  3. Enter 6 in Enter a number (0-9) to change the IP number.

Note If you try to change the IP address when ITBA is down, the glassfish service fails to start and you cannot change the IP address. The solution is to start glassfish manually using $HPBA_HOME/bin/startGlassfishBA.sh and then to run the maintenanceTool.sh to change the IP address.

ClosedBackup and Restore Postgres

You can backup or restore using the Maintenance Tool.

  1. Make sure you check out the step detailed in the Maintenance Tool.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  3. Enter 7 in Enter a number (0-9) to backup or restore postgres.

    1. Enter 1 in Enter a number (0-2) to backup postgres.

    2. Enter 1 in Enter a number (0-2) and select backup.tar to restore postgres.

ClosedUpdate AutoPass Host

You can update Usage Hub host using the Maintenance Tool.

  1. Make sure you check out the step detailed in the Maintenance Tool.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  3. Enter 8 in Enter a number (0-9) to update Usage Hub Host.

  4. The Usage Hub Host information is automatically displayed in the shell.

  5. Enter the Usage Hub Host.

ClosedCollect Logs and ITBA Information

You can collect logs and BA environment information using the Maintenance Tool.

  1. Make sure you check out the step detailed in the Maintenance Tool.

  2. Open a Unix console (bash) and go to the following $HPBA_HOME/Tools directory and input command ./maintenanceTool.sh to start the ITBA Maintenance Tool.

  3. Enter 9 in Enter a number (0-9) to collect logs and ITBA environment information.