1. IBM WebSphere Portal for IBM i for Power Systems Guide
  2. Verifying Database Connections

Verifying Database Connections

After WebSphere Portal is configured to work with your database, test the database connection to ensure that it operates correctly. You can verify the connection from a browser or from a command line.

To verify that WebSphere Portal is running from a browser, open the portal in a Web browser: http://hostname.yourco.com:port_number/wps/portal, where hostname.yourco.com is the fully qualifiedhost name of the machine where WebSphere Portal is running and port_number is the transport port that is created by IBM® WebSphere® Application Server.

There may be an error if any of the following conditions appear:

  • When trying to access the portal you get a 503 error.

  • If you had any locale problems with your database, you could see invalid characters, such as ????, after logging in. This may happen if the character set of the database is not UTF-8 compliant.

  • If something went wrong with the data that was transferred, you may not be able to log in. WebSphere Portal will indicate you entered an invalid user ID and password even though you know it is valid.

Verify the connection from a command line by completing the following steps:

  1. Open a command line on the local machine where WebSphere Portal is installed.

  2. For WebSphere Portal on WebSphere Application Server (UserData path), enter the following on the command line: cd wp_profile_root/ConfigEngine.

  3. Enter the following command:

    ConfigEngine.sh validate-database-connection -DTransferDomainList=release,community,customization,jcr,feedback,likeminds -DWasPassword=password

    For security reasons, you should not leave passwords in the wkplc_dbdomain.properties file. Edit the file before running a configuration task and insert the passwords that are needed for that task. After the task has run, delete all passwords from the file. Alternatively, you can specify the password on the command line rather than update the wkplc_dbdomain.properties file. For example: ConfigEngine.sh -DPortalAdminPwd=password -DWasPassword=password validate-database When installing WebSphere Portal, the passwords in the wkplc_dbdomain.properties file are automatically removed after configuration.