Using the Default Configuration wizard

Before you run the Default Configuration wizard:

The Default Configuration wizard allows you to set up a simple 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.

Creating the 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 manager is available and you are informed of the database manager used after it has been created in 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 Event Broker. You can launch the wizard manually from the Message Brokers Toolkit Welcome page, which is displayed the first time that 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 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 checks 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. The 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.

  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 Prepare the Samples wizard.

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

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

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 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 checks 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. The 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.
  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.
Related concepts
Broker domains
Brokers