Configuring WebSphere Portal Express with the configuration wizard

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

Configuring WebSphere Portal Express with the configuration wizard

The configuration wizard is a post-installation ease-of-use tool that you can use to perform some typical configuration tasks. This topic provides information that you should read before you start the wizard, instructions on how to start the wizard, and usage tips.

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. Select this option to transfer data from one supported database to another. This option can be used to transfer all domains or individual domains. The domains included are Release, Customization, Community, Java Content Repository, Feedback, LikeMinds, and Member Manager. IBM^® WebSphere^® Portal Express stores configuration, access control such as user identities, credentials, and permissions for accessing site resources, and user data in a database.
Notes:

Data can be transferred from a Cloudscape database, but cannot be transferred to a Cloudscape database.
Data can only be transferred to a DB2 for i5/OS database from a Cloudscape database. Data cannot be transferred from a DB2 for i5/OS database.
Data can only be transferred to a DB2 for z/OS database using the configuration wizard when using a JDBC type 2 connection. If you are transferring to a DB2 for z/OS database with a JDBC type 4 connection, transfer your data using the command line. See Transferring DB2 for z/OS for more information on transferring manually.
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 the file portal_server_root/pzn/v6.0/install.properties and set pznFeedback.configured to true.

Connect additional node to a database. Select this option to connect the database for clustered installation by removing the old datasources and JDBC provider and creating new datasources and JDBC provider.
Enable LDAP Security. Select this option to 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. For more information, see LDAP user registry.
Disable security. Select this option to turn off WebSphere Application Server Global Security. If this is a cluster environment, stop all cluster members before disabling security.

If you do not use the configuration wizard, you can perform configuration by typing configuration tasks at a command line. For more information on running configuration tasks at a command line, see the Configuring section.

Before you begin

If you plan to transfer or connect 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. For more information, see Configuring databases.
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. For more information, see the section on Planning for LDAP.
The configuration wizard will not run properly if the prerequisites for this task have not been met.

Starting 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
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 the portal_server_root directory. Refer to the Network File System (NFS) topic in the System i5 information center for more information.

Log files

The configuration wizard generates log files each time you run it. The log files for the configuration wizard are located in the following directory:

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. Consult the help panels for additional information.
Passwords should not contain spaces. See Special characters in user IDs and passwords for more information.
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.
If you use a configuration template to pre-fill the property values when enabling security, use the IBM-provided configuration template to ensure that all required values are entered into the wizard. See Configuration program for additional information on configuration templates. 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 enable security and your environment is configured with a database other than the default database, do not run the Transfer data to a different database task again. This task will not transfer the data inserted during the Enable LDAP security task, and will cause the site to become inoperable. To recover from this situation, you would have to disable and then re-enable security.
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.
Related concepts
Domino-WebSphere Portal Express Integration wizard overview