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:

Using the Default Configuration wizard, you 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. You can also 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 by using the sample programs; see Installation Guide.

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 Brokers Toolkit Welcome page, which is displayed the first time you launch the Message Brokers Toolkit. If the Welcome page is not displayed, open it in the Message Brokers 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 of the configuration tasks and then 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/wmbt6.0/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 errors occur, you see an appropriate message and the wizard backs out all of the 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 want 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 Brokers Toolkit, you can launch the samples manually by clicking on the following sample: Alternatively, click Help > Samples Gallery, and expand Application samples > Message Broker.

    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 Brokers Toolkit Welcome page, which is displayed after you launch the Message Brokers Toolkit. If the Welcome page is not displayed, open it in the Message Brokers 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/wmbt6.0/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 try each step again.

If you experience problems when you are using the wizard to remove the default configuration, you might have 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, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:21:40

ae20200_