Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Data Highway - Server Configuration and Administration Guide


B. Changing the Database Communication Port Number

This appendix describes how to change the database communication port number.

Before performing the following steps, you must log in to the JP1/DH - Server machine as a built-in Administrator user (for Windows) or a root user (for Linux).

  1. Stop JP1/DH - Server.

    Stop the services of the JP1/DH Web application server and database, as described in 6. Starting and Stopping.

  2. Change the communication port number that the database uses.

    File path

    installation-folder#\PostgreSQL\9.2\data\postgresql.conf
    #

    In Linux, change installation-folder to /opt/jp1dh/server.

    • Setting database communication port number

      Change the communication port number that the database uses.

      port = port-number           # (change requires restart)

      Example: To set the port number to 56789

      port = 56789               # (change requires restart)
  3. Start the database.

    Start the database, as described in 6. Starting and Stopping.

  4. Change the environment configuration of the JP1/DH Web application server.

    Edit the configuration file of the JP1/DH Web application server to change the port number that the application server uses to communicate with the database.

    File path

    installation-folder#\misc\digikatsuwide\digikatsuwide\WEB-INF\digikatsuwide.xml
    #

    In Linux, change installation-folder to /opt/jp1dh/server.

    • Setting the port number that is used to communicate with the database

      Change the port number used by the application server to communicate with the database.

      <biz-connect id="bizconnect">
          <persistence>
              <database >
                  ...
                  <url>jdbc:postgresql://localhost:communication-port-number/bcdb</url>
              </database>
          </persistence>
      </biz-connect>

      Example: To set the port number to 56789

      <biz-connect id="bizconnect">
          <persistence>
              <database >
                  ...
                  <url>jdbc:postgresql://localhost:56789/bcdb</url>
              </database>
          </persistence>
      </biz-connect>
  5. Start the JP1/DH Web application server.

    Follow the steps in 5.3.2(1) Starting the JP1/DH Web application server.

  6. Prepare for changing the application configuration.

    Follow the steps in 5.3.2(2) Preparing to change the application configuration.

  7. Restart the JP1/DH Web application server.

    Follow the steps in 5.3.2(3) Restarting the JP1/DH Web application server.

  8. Change the configuration of the application.

    Start the command prompt (in Windows) or console (in Linux), and then perform the following:

    • In Windows:

      set PGPORT=database-communication-port-number
      installation-folder\setup_util\deploy_app.bat
    • In Linux (if tcsh is used as a login shell):

      setenv PGPORT=database-communication-port-number
      /opt/jp1dh/server/setup_util/deploy_app.sh
    • In Linux (if bash

    • is used as a login shell):

      export PGPORT=database-communication-port-number
      /opt/jp1dh/server/setup_util/deploy_app.sh

      Follow the given instructions.

  9. Stop the JP1/DH Web application server.

    Follow the steps in 5.3.2(5) Stopping the JP1/DH Web application server.

  10. Start the service of the JP1/DH Web application server.

    Start the service of the JP1/DH Web application server, as described in 6. Starting and Stopping.

    Important note

    If you change the database communication port number from the initial value, you must set the new database communication port number in the environment variable before executing the following commands:

    • installation-folder/setup_util/deploy_app.bat

    • installation-folder/bin/dbbackup.bat

    • installation-folder/bin/dbchangepassword.bat

    • installation-folder/bin/dbrestore.bat

    • installation-folder/bin/getdetaillog_server.bat

    • installation-folder/bin/regist_users_number.bat

    Important note

    In Linux, change installation-folder to /opt/jp1dh/server and the extension .bat to .sh.