Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows
Configure WebSphere Portal Express with the configuration wizard
Configuration tasks
The initial panel of the configuration wizard provides you with a list of configuration tasks that you can perform. You can select one task to perform at a time. To perform more than one task with the configuration wizard, choose a task from the initial panel and complete it; at the end of the task, a panel displays to enable you to return to the initial panel to choose another task. You can use the configuration wizard to perform the following tasks:
Transfer data to a different database Transfer data from one supported database to another. IBM WebSphere Portal Express stores configuration, access control such as user identities, credentials, and permissions for accessing portal resources, and user data in a database. By default, WebSphere Portal Express installs and uses the IBM DB2 Universal Database Express Edition database. Data can only be transferred to a DB2 for i5/OS database from the default database. Data cannot be transferred from a DB2 for i5/OS database.
To transfer Feedback using the configuration wizard, Feedback must first be enabled. By default, Feedback comes disabled out of the box. To enable Feedback, edit...
portal_server_root/pzn/v6.0/install.properties...and set pznFeedback.configured to true.
Enable LDAP Security Configure WebSphere Portal Express to use an LDAP user registry to store user information and to authenticate users. If you enable LDAP security with the configuration wizard, note that you can enable LDAP security without realm support only. If you want to enable LDAP security with realm support, you cannot use the configuration wizard. Instead, perform configuration by typing configuration tasks at a command line.
If you do not use the configuration wizard, you can perform configuration manually.
Before you begin
If you plan to transfer to a different database, that database software must be installed and the appropriate databases and users must be created before you can use the configuration wizard.
The configuration wizard will not run properly if the prerequisites for this task have not been met.
If you plan to configure LDAP security, the LDAP software must be installed and set up appropriately before you can use the configuration wizard.
The configuration wizard will not run properly if the prerequisites for this task have not been met.
Start the wizard on Linux and Windows
To start the configuration wizard, type the appropriate command at a command line.
The location of the script is:
- Linux:
portal_server_root/config/wizard/configwizard.sh
- Windows:
portal_server_root\config\wizard\configwizard.bat
After installation, open a new command prompt to start the configuration wizard with the updated environment variables.
The command syntax is:
- Linux:
./configwizard.sh
- Windows:
configwizard.bat
You can launch the program in console mode to run the configuration without the graphical user interface. To run the wizard in console mode, type -console after the command:
- Linux:
./configwizard.sh -console
- Windows:
configwizard.bat -console
Starting the wizard on i5/OS
Only database transfer is supported on i5/OS. To enable LDAP, it is recommended to use the web administration utility. To start the configuration wizard type the appropriate command at a command line.
The location of the script is portal_server_root_user/config/wizard/configwizard.sh.
The command syntax is configwizard.sh.
The configwizard.sh command for i5/OS only runs in console mode and the -console option should not be used. You can run the configuration wizard from your Windows workstation by enabling a Network share on your i5/OS system.
To run the configuration wizard from your Windows workstation:
- Enter the following command all on one line to connect to the shared directory:
net use z: \\Systemi5_system_name.domain\share1 /u:user password
- From your Windows workstation go to...
portal_server_root\config\wizard
...and enter...
configwizard400.bat
In this example, share1 points to...
portal_server_root
Log files
- Windows and Linux:
- portal_server_root/log/configwizardlog.txt
- portal_server_root/log/configwizard.log
- i5/OS:
- portal_server_root/log/configwizardlog.log
- From the UserData directory: portal_server_root_user/log/configwizardlog.log
Log files are also generated that reflect the name of the task ran. These files are generated after the task has completed. They contain task-specific copies of the output in the configwizard log file and can be used to track output for one specific task when multiple tasks are run. The configwizard log file is generated during task execution and remains in the PortalServer/logs directory after the additional files that reflect the name of the task run are created. Each log file is backed up if a task is run again.
- PortalServer/logs/disable-security.log
- PortalServer/logs/enable-ldap-security.log
- PortalServer/logs/portal-database-transfer.log
- PortalServer/logs/portal-connect-database.log
Usage tips
The configuration wizard contains help panels with information specific to the task and activity being performed.
For some fields that require input, you might have to enter a value that represents a new entity, such as a new database. For other fields, you might have to enter a value that represents an existing entity, such as a user ID and password that you have already created.
Passwords should not contain spaces.
If you update the properties files with the information for source database before using the configuration wizard, the values in those files will be shown in the configuration wizard.
The configuration wizard uses help files located in the portal_server_root/config/helpers directory.
The wizard finds the correct help file based on the selected LDAP server, loads the values from the file, and prefills the related fields in the wizard.
If you want to use a different help file, specify the file and location on the command line, for example:
- Linux:
configwizard.sh -W setLdapProperties.propertiesFile=/Helper/patty-ids.properties
- Windows:
configwizard.bat -W setLdapProperties.propertiesFile=d:\Helper\patty-ids.properties
If you run the configuration wizard for System i5, you can ignore the following error message if it appears in the configwizard.log file:
ERROR:Unable to update properties file portal_server_root/config/wpconfig.properties
If you run the configuration wizard to transfer data to another database, you can ignore the following error message if it appears in the configwizardlog.txt file:
Unexpected file error: ServiceException: (error code = 305; message = "setFileAttributes requires native support. "; severity = 0)
If you click the Help button, you may see a message logged to the command line indicating that a Javax function was created. This is an information-only message and can be safely ignored.