Configure WebSphere MQ with the Prepare WebSphere MQ wizard

The Prepare WebSphere MQ wizard helps you to configure WebSphere MQ files and a user account for your network, migrate any queue managers and data from a previous installation, and migrate WebSphere MQ clients and queue managers that have been set up to use Secure Sockets Layer (SSL).

The Prepare WebSphere MQ wizard window will be displayed when WebSphere MQ installation completes. Follow the instructions given by the wizard to configure WebSphere MQ. At any time while the wizard is running we can click the More Information button in the wizard to view online help about the task you are doing.

When WebSphere MQ installation completes, the Prepare WebSphere MQ Wizard window is displayed with a welcome message. To continue, click Next.
If you have run the Prepare WebSphere MQ wizard before, this step is skipped. If you have not run the Prepare WebSphere MQ wizard before, the Prepare WebSphere MQ Wizard window displays a progress bar with the following message:
Status: Setting up WebSphere MQ Configuration
Wait until the progress bar completes.
The Prepare WebSphere MQ Wizard window displays a progress bar with the following message:
Status: Setting up the WebSphere MQ Service.
Wait until the progress bar completes.
WebSphere MQ will attempt to detect whether we need to configure WebSphere MQ for use with Windows 2000 or later domain users. Depending on the results of the detection, WebSphere MQ will do one of the following:
- If WebSphere MQ detects that you need to configure WebSphere MQ for Windows 2000 or later domain users, the Prepare WebSphere MQ Wizard window displays a message that starts:
```
WebSphere MQ does not have the authority to query information about
your user account
```
  Optionally, to see online help about configuring the domain account, select More Information. When you are finished, close the WebSphere MQ Help Center window to return to the current window.
  Click Next, and go to step 5.
- If you are not installing on a Windows 2000 or later domain controller and WebSphere MQ cannot detect whether we need to configure WebSphere MQ for Windows 2000 or later domain users, the Prepare WebSphere MQ Wizard window displays the following message:
```
Are any of the domain controllers in your network running 
Windows 2000 or later domain server?
```
  If you select Yes, click Next, then go to step 5.
  If you select No, click Next, then go to step 8.
  If you select Don't know, we cannot continue. Either select one of the other options, or click Cancel and contact your domain administrator.
- If WebSphere MQ detects that you do not need to configure WebSphere MQ for Windows 2000 or later domain users, go to step 7.
At any time, we can click More Information to view online help about configuring the domain account, or see Configuring WebSphere MQ accounts. When you are finished, close the WebSphere MQ Help Center window to return to the current window.
The Prepare WebSphere MQ Wizard window displays the following message:
```
Do we need to configure WebSphere MQ for users defined on Windows 2000 
or later domain controllers?
```
If you select Yes, click Next, then go to step 6.
If you select No, click Next, then go to step 8.
If you select Don't know, we cannot continue. Either select one of the other options, or click Cancel and contact your domain administrator.
At any time, we can click More Information to view online help about configuring the domain account, or see Configuring WebSphere MQ accounts. When you are finished, close the WebSphere MQ Help Center window to return to the current window.
In the next window, enter the Domain and User name of the domain user account that you obtained from your domain administrator. Either enter the Password for this account, or select the option This account does not have a password. Click Next.
The Prepare WebSphere MQ Wizard window displays a progress bar with the following message:
```
Status: Configuring WebSphere MQ with the special domain user account
```
Wait until the progress bar completes.
If there are any problems with the domain user account, a further window is displayed. Follow the advice on this window before you continue with this procedure.
If you do not have any queue managers or WebSphere MQ clients on this computer that have been set up to use Secure Sockets Layer (SSL) connections, this step is missed, go to step 15.
If you have queue managers or WebSphere MQ clients on this computer that have been set up to use SSL connections, the Migration of SSL connections window is displayed. The queue managers and clients with SSL connections were identified when you used the Check WebSphere MQ Certificate Stores wizard in the installation launchpad. Read the information then click Next.
At any time, we can click More Information to view online help about identifying if migration is required. When you are finished, close the WebSphere MQ Help Center window to return to the current window.
A list of the certificate store files, which were validated earlier in the install process, is displayed. Select the certificate stores you want to schedule for migration and click Next. If you did not validate any certificate stores, or if you have not selected any, click Next then go to step 13.
The next panel asks you about passwords and password expiry intervals.
- If want to use a single password and expiry interval for all key databases files, select Use a single password and expiry interval for all key database files, enter a password and expiry interval, then click Next.
- If you want to use different passwords and expiry intervals for each database file, select Prompt for individual passwords and expiry intervals, then click Next.
A progress dialog is displayed while the certificate store files chosen in step 9 are scheduled for migration. If you selected "Prompt for individual passwords and expiry intervals" in step 10, a panel requesting this information will be displayed for each certificate store file you selected. Complete the information in each of the panels displayed, then click Next.
A panel is displayed showing a summary of the store files that have been scheduled for migration. Click Next to continue.
Now the wizard asks you to confirm that your Certificate Revocation Lists (CRLs) and Authority Revocation Lists (ARLs) are in a format supported by WebSphere MQ for Windows, V6.0.
- If CRLs and ARLs are not used, select Not Used and click Next.
- If CRLs and ARLs are used, when you have them in a format supported by WebSphere MQ for Windows, V6.0 select Yes and click Next.
At any time, we can click More Information to view online help about converting the CRLs and ARLs into a supported format. When you are finished, close the WebSphere MQ Help Center window to return to the current window.
Next ensure that SSL connections that use the SSLPEER channel parameter have any multiple Organizational Unit entries ordered correctly.
- If the SSLPEER value is not used, or if the SSLPEER value is used but multiple Organizational Unit entries are not used, select Not Used and click Next.
- If the SSLPEER value is used with multiple Organizational Unit entries , check the ordering of the SSLPEER fields and select Yes when they are correctly ordered. Click Next.
At any time, we can click More Information to view online help about how to check SSLPEER fields. When you are finished, close the WebSphere MQ Help Center window to return to the current window.
The Prepare WebSphere MQ Wizard window displays a progress bar with the following message:
```
Status: Starting WebSphere MQ services
```
Wait until the progress bar completes.
If there are further tasks to complete, the Prepare WebSphere MQ Wizard window displays the following message:
```
It is recommended that the following tasks are completed now
```
It displays one or more of the following options, which depend on whether a default configuration or queue managers already exist from a previous installation. If the previous installation is such that none of these tasks apply, this window is not displayed. Go to step 17.
- Setup the Default Configuration.
  This option is displayed only if there are no queue managers and there is no Default Configuration already on the system. This action launches the Default Configuration wizard
  In this situation, to verify the installation by using the Postcard application, select this option and use the Default Configuration wizard to create the default queue manager for the Postcard application to use.
- Migrate the existing Default Configuration.
  This option is displayed if a Default Configuration already exists from MQSeries V5.1. This action launches the Default Configuration wizard
  If a Default Configuration already exists from a version of WebSphere MQ later than V5.1 we can use this without any migration.
To launch a wizard to complete a task, select the required option. When all required tasks are complete and you return to this window, click Next.
To continue without completing any of these tasks, click Next. We can complete these tasks later:
- To set up the Default Configuration, or migrate an existing Default Configuration, select...
  Start | Programs | IBM WebSphere MQ | Default Configuration
Next we need to select the options that you require. The Prepare WebSphere MQ Wizard window displays the following message:
```
You have completed the Prepare WebSphere MQ Wizard
```
Select the options that you require, then click Finish. Select one or more from:
- Remove the shortcut to this wizard from the desktop
  This option is available only if you have previously attempted installation, but we cancelled the procedure from the Prepare WebSphere MQ wizard and you created a desktop shortcut to this wizard. Select this option to remove the shortcut. You do not need it now that you have completed the Prepare WebSphere MQ wizard.
- Launch WebSphere MQ Getting Started Help
  The Help gives you quick access to all task-oriented help information, the Web-based online books and home pages, and if you have installed WebSphere MQ from the WebSphere MQ Documentation CD, the Information Center.
- Launch WebSphere MQ Explorer
  The WebSphere MQ Explorer allows you to view and administer your WebSphere MQ network.
- Launch Notepad to view the release notes
  The release notes contain information on installing WebSphere MQ and also late-breaking news that is available after the published documentation is produced.
Follow the procedure described in Final Installation tasks.

Parent topic:

Configuring a WebSphere MQ Server