Start of change

Using the Default Configuration wizard

Before you run the Default Configuration wizard for the first time:

  • You must have administration privileges.
  • Your account must have the 'Act as part of the operating system' privilege set.

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.

The wizard creates the following resources:
  • A broker domain
  • A sample broker
  • A database to be used by the broker
  • A WebSphere MQ queue manager.
This topic contains the following sections:

Creating a default configuration

  1. The Default Configuration wizard launches automatically at the end of the installation of WebSphere Business Integration Message Broker. You can launch the wizard manually from Getting started or from the Welcome page for the WebSphere Studio application, which appears after you launch the Message Brokers Toolkit for WebSphere Studio.
  2. The Welcome panel of the wizard describes what is about to happen.
    1. Choose the option to create a default configuration.
    2. If you want to create a publish/subscribe broker as part of the default configuration, tick the Create Pub/Sub broker as part of this configuration checkbox.
    3. 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. 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/DefaultConfigurationWizard.log).
  5. If the default configuration is set up successfully, you see an appropriate message.
    1. If you want to launch the samples, click the Launch Samples Wizard when finished checkbox. Using the samples allows you to verify the default configuration. To launch the samples manually, see Getting started samples.
    2. Click Finish to close the wizard.
    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.

Removing a default configuration

  1. Launch the wizard from Getting started or from the Welcome page for the WebSphere Studio application, which appears after you launch the Message Brokers Toolkit for WebSphere Studio.
  2. The Welcome panel of the wizard describes what is about to happen.
    1. Choose the option to remove a default configuration.
    2. 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. 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/removeDefaultConfiguration.log).
  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 write them to the log file.
Related concepts
Broker domain
Broker


End of change