WebSphere Message Brokers
File: ae20200_
Writer: Kate Hostler

Task topic

This build: July 31, 2007 21:28:00

Using the Default Configuration wizard

Use the Default Configuration wizard to set up and test a basic broker domain configuration.

Before you run the Default Configuration wizard:

The Default Configuration wizard allows you to set up a basic configuration on your local machine so that you can explore the product and run the samples that are supplied in the Samples Gallery. It also allows you to remove the default configuration, if it already exists, that has been set up on your logon account.

The default configuration is described in more detail in the Installation Guide, which also describes how you can verify your installation using the sample programs.

Creating the default configuration

The wizard creates the following resources:

  • A broker domain.
  • A sample broker.
  • A database to be used by the broker.

    On Windows, the wizard defaults to whatever database manager is available. The database that has been used is recorded on the Default Configuration Summary page. Details of the database manager are also written to the wizard's log file.

  • A WebSphere MQ queue manager.
  1. On Windows, the Default Configuration wizard starts automatically at the end of the installation of WebSphere Message Broker. You can launch the wizard manually from the Message Broker Toolkit Welcome page, which is displayed the first time that you launch the Message Broker Toolkit. If the Welcome page is not displayed, open it in the Message Broker Toolkit by clicking Help > Welcome.
  2. The Welcome page of the wizard describes what is about to happen. Enter your password to log on and click Next to continue. You can click Cancel at any time to cancel the creation of the default configuration.

    The wizard checks that the default configuration is not already installed.

  3. The Default Configuration Summary page lists the resources that will be created. The information field in this page confirms whether Derby has been set as the default broker database on Windows. It also suggests an alternative option of installing and configuring an enterprise database server instead. Click Next to continue.
  4. The Default Configuration Progress page lists the background configuration actions as they occur, and indicates successful completion. You can cancel the creation of the default configuration at this point by clicking Cancel. The wizard backs out all configuration tasks and the displays the progress and success of the process. The configuration process is written to a log file in the Eclipse workspace directory:
    • Linux platform user_home_directory/IBM/wmbt/610/workspace/.metadata/DefaultConfigurationWizard.log
    • Windows platform user_home_directory\eclipse\workspace\.metadata\DefaultConfigurationWizard.log
    .

    If the default configuration is set up successfully, you see an appropriate message. If there are errors during the setup of the default configuration, you see an appropriate message and the wizard backs out all configuration tasks. If an error occurs during the back out process, the wizard displays a list of resources that you must remove manually.

  5. You can use the samples to verify the default configuration. Launch Samples Wizard when finished is selected by default. Click Finish to launch the Prepare the Samples wizard.

    If you do not need to launch the Prepare the Samples wizard, clear Launch Samples Wizard when finished before clicking Finish.

    If you are viewing this information from within the Message Broker Toolkit, launch the samples manually by clicking Pager samples. Alternatively, click Help > Samples Gallery, and expand Application samples > Message Broker - Getting Started samples.

    You can view samples only when you use the information center that is integrated with the Message Brokers Toolkit.

Removing the default configuration

  1. Launch the Default Configuration wizard from the Message Broker Toolkit Welcome page, which is displayed after you launch the Message Broker Toolkit. If the Welcome page is not displayed, open it in the Message Broker Toolkit by clicking Help > Welcome.
  2. The Welcome page of the wizard describes what is about to happen. Enter your password to log on and click Next to continue. You can click Cancel at any time to cancel the removal of the default configuration.

    The wizard checks that the default configuration is already installed.

  3. The Remove Default Configuration Summary page lists the resources that will be removed. Click Next to continue.
  4. The Default Configuration Progress page lists the removal actions as they occur, and indicates successful completion. The removal process is written to a log file in the Eclipse workspace directory:
    • Linux platform user_home_directory/IBM/wmbt/610/workspace/.metadata/DefaultConfigurationWizard.log
    • Windows platform user_home_directory\eclipse\workspace\.metadata\DefaultConfigurationWizard.log
    .
  5. A message confirms that the default configuration has been removed successfully. Click Finish to close the wizard.

    If errors occur during the removal of the default configuration, the wizard displays the errors and also writes them to the log file. Follow the advice in the log and retry each step.

If you experience problems using the wizard to remove the default configuration, you might need to remove the default configuration manually. For more information see You experience problems with the default configuration.
Related concepts
Broker domains
Brokers
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:28:00

ae20200_ This topic's URL is: