IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Creating a default configuration

Use the Default Configuration wizard to create and test a basic broker configuration.

Before you run the Default Configuration wizard, complete the following steps:

By using the Default Configuration wizard, you create a default configuration on your local computer so that you can explore the product and run the samples. You can also remove the default configuration, if it exists, that has been created on your logon account.

The default configuration is described in more detail in Verifying your IBM Integration Bus installation. This topic describes how to verify your installation on Linux on x86, Linux on x86-64, or Windows by using either the IBM Integration Toolkit or the IBM Integration Explorer.

Creating the default configuration

The wizard creates the following resources:

  • A sample broker named IB9NODE.
  • A WebSphere® MQ queue manager named IB9QMGR.
  1. Start the Default Configuration wizard from the IBM Integration Toolkit Welcome page, which is displayed the first time you start the IBM Integration Toolkit. If the Welcome page is not displayed, open it in the IBM Integration Toolkit by clicking Help > Welcome.
  2. Click Get Started on the Welcome page, then click Create the Default Configuration.
  3. Click Start the Default Configuration wizard. The Default Configuration wizard is displayed.
  4. The Welcome page of the wizard describes what is about to happen, 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 created.

  5. The Default Configuration Summary page lists the resources that will be created. Click Next to continue.
  6. 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 by clicking Cancel. The wizard backs out all the configuration tasks and displays the progress and success of the process. The configuration process is written to a log file in the Eclipse workspace directory:
    • Linux platform/home/user_name/IBM/IntegrationToolkit90/workspace/.metadata/DefaultConfigurationWizard.log
    • Windows platformC:\Documents and settings\user_name\IBM\IntegrationToolkit90\workspace\.metadata\DefaultConfigurationWizard.log

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

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

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

    If you are viewing this information from within the IBM Integration Toolkit, you can open the samples manually by clicking the following sample: Alternatively, click Product Overview > Samples in the IBM Integration Bus information center in the IBM Integration Toolkit, to display a list of the available samples.

    You can view information about samples only when you use the product documentation that is integrated with the IBM Integration Toolkit or the online product documentation. You can run samples only when you use the product documentation that is integrated with the IBM Integration Toolkit.

Removing the default configuration

  1. Start the Default Configuration wizard from the IBM Integration Toolkit Welcome page, which is displayed after you start the IBM Integration Toolkit. If the Welcome page is not displayed, open it in the IBM Integration Toolkit by clicking Help > Welcome.
  2. Click Get Started on the Welcome page, then click Create the Default Configuration.
  3. Click Remove the Default Configuration wizard. The Default Configuration wizard is displayed.
  4. The Welcome page of the wizard describes what is about to happen. You can click Cancel at any time to cancel the removal of the default configuration.

    The wizard checks that the default configuration is already created.

  5. The Remove Default Configuration Summary page lists the resources that will be removed. Click Next to continue.
  6. 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/home/user_name/IBM/IntegrationToolkit90/workspace/.metadata/DefaultConfigurationWizard.log
    • Windows platformC:\Documents and settings\user_name\IBM\IntegrationToolkit90\workspace\.metadata\DefaultConfigurationWizard.log
  7. 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.

ae20200_.htm | Last updated Friday, 21 July 2017