Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows
Verifying database connections for i5/OS
This section provides information on how to test your database connection to ensure that it operates correctly.
After IBM® WebSphere® Portal Express is configured to work with your preferred database, test the database connection to ensure that it operates correctly. You can do this by:
- logging into WebSphere Portal Express from a Web browser
- verifying from a command prompt
Verify WebSphere Portal Express is running from a browser
Verify that the WebSphere Portal Express application server is running by opening the portal in a Web browser: http://hostname.yourco.com:port_number/wps/portal where hostname.yourco.com is the fully qualified host name of the machine where WebSphere Portal Express 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 may 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 login. WebSphere Portal Express will indicate you entered an invalid user ID and password even though you know it is valid.
Verifying the connection from a command line
You can also verify the database connection from a command line by performing the following steps:
- Start a 5250 session on the local machine where WebSphere Portal Express is installed.
- Type STRQSH or SBMJOB CMD(STRQSH) on the command line.
Use SBMJOB to submit the Qshell script as a batch job to run in *BASE pool when *INTERACT pool does not have 1GB or more of allocated memory.
- Press Enter.
- For WebSphere Portal Express on WebSphere Application Server (UserData path), type the following on the command line:
cd portal_server_root/config
- Press Enter.
- Type in the following information:
WPSconfig.sh -profileName profile_root validate-database-connection-schema_name -DDbPassword=password
where profile_root is the name of your WebSphere Application Server profile, schema_name is the name of your database schema, and password is the database administrator password.
- Press Enter.
Note on passwords: For security reasons, you should not leave passwords in the wpconfig_dbdomain.properties file. IBM recommends that you edit the wpconfig_dbdomain.properties file prior to running a configuration task, and insert the passwords that are needed for that task. After the task has run, you should delete all passwords from the wpconfig_dbdomain.properties file. For more information, see Deleting passwords from configuration scripts.
Alternatively, you can specify the password on the command line rather than update the wpconfig_dbdomain.properties file. For example:
WPSconfig.sh -profileName profile_root -DPortalAdminPwd=password validate-wps-admin-login
If you select the Install and Configure option when installing WebSphere Portal Express the passwords in the wpconfig_dbdomain.properties file are automatically removed after configuration.
Parent topic:
Configuring DB2 for i5/OS