Using the Default Configuration wizard

Before you run the Default Configuration wizard:

Start of changeEnd of change

The Default Configuration wizard allows you to set up a simple default configuration on your local machine so that you can explore the product and run the samples that are supplied. It also allows you to remove an existing default configuration that has been set up on your logon account.

This topic contains the following sections:

Creating a default configuration

The wizard creates the following resources:
  • A broker domain
  • A sample broker
  • A database to be used by the broker. The wizard defaults to whatever database is available and you are informed of the database used after it has been created in the Default Configuration Summary page. The text message also confirms which database manager will be used (details of the default database manager are also written to the wizard's log file.
  • A WebSphere MQ queue manager.
  1. On Windows, the Default Configuration wizard launches automatically at the end of the installation of WebSphere Event Broker. You can launch the wizard manually from Getting started or from the Welcome page for the Message Brokers Toolkit application, which appears after you launch the Message Brokers Toolkit.
  2. The Welcome panel 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 performs a verification test to check that the default configuration is not already installed.

  3. The Default Configuration Summary panel lists the resources that will be created. The information field in this panel confirms whether or not Derby has been set as the default broker database. It also suggests an alternative option of installing and configuring an enterprise database server instead. Click Next to continue.
  4. Start of changeThe Default Configuration Progress panel lists the background configuration actions as they happen 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 install_dir/eclipse/workspace/defaultConfiguration.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.

    End of change
  5. You can use the samples to verify the default configuration. The Launch Samples Wizard when finished check box is selected by default. Click Finish to launch the sample preparation wizard.

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

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

Removing a default configuration

  1. Launch the wizard from Getting started or from the Welcome page for the Message Brokers Toolkit application, which appears after you launch the Message Brokers Toolkit.
  2. The Welcome panel 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 performs a verification test to check that the default configuration is already installed.

  3. The Remove Default Configuration Summary panel lists the resources that will be removed. Click Next to continue.
  4. Start of changeThe Default Configuration Progress panel lists the removal actions as they happen and indicates successful completion. The removal process is written to a log file in the Eclipse workspace directory install_dir/eclipse/workspace/defaultConfiguration.log.End of change
  5. If the default configuration is removed successfully, you see an appropriate message. 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.
Related concepts
Broker domains
Brokers