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, and LikeMinds. 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, you must transfer your data using the command line.
- 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.1/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, you must perform configuration by typing configuration tasks at a command line.
Disable security. Select this option to turn off WebSphere Application Server Global Security. If this is a cluster environment, you must 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.

Starting the wizard on Linux and Windows

To start the configuration wizard, you must type the appropriate command at a command line.

delete me You can also launch the wizard from the First Steps Launcher.

The location of the script is:

Linux: portal_server_root/config/wizard/configwizard.sh
Windows: portal_server_root\config\wizard\configwizard.bat
Note: 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

Note: 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 you must 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.

Note: 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.

Note: 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.
Note: 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.
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.
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.
Note: If you want to use a different help file, you must 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.