Installing Message Service Client for .NET using the installation wizard

The installation uses an InstallShield X/Windows MSI installer. Two setup options are available, so that you can choose either a complete or a custom installation.

About this task

To install Message Service Client for .NET on Windows, follow this procedure.

Procedure

  1. If you are installing from a SupportPac complete the following steps, otherwise proceed directly to step 2.
    1. On Windows, log on as an administrator.
    2. Run the dotNETClientsetup.exe installer.
  2. Wait for the installation wizard to open and display the following message:
    
    Welcome to IBM Message Service Client for
    .NET installation wizard
    

    Click Next.

    The wizard might ask you to read the license agreement.

  3. If you are asked to read the license agreement and you accept the terms of the license agreement, click I accept the terms in the license agreement, and then click Next.

    The installation wizard asks you to choose the setup type that best suits your needs.

  4. Select the type of setup you require:
    • To install all program features, and install them in the default installation directory, click Complete.
    • To choose which features you want to install, and specify where they are installed, click Custom.
  5. Click Next.

    If you select the complete installation option, the installation wizard displays a message that it is ready to begin installation, as described in step 8. If you select the custom installation option, the installation wizard asks you to select the features that you want to install and you must complete step 6 and step 7 before moving on to step 8.

  6. For a custom installation only, click an icon in the list of features to specify any changes to how you want the Message Service Client for .NET features to be installed. If you do not want to install Message Service Client for .NET in the directory suggested, choose another directory.

    If you choose to install Message Service Client for .NET in a directory that does not currently exist, the installation wizard creates the directory for you.

    If you want to develop XMS applications, ensure that the Development Tools and Samples feature is selected. This feature provides the sample applications, and the libraries and any other files required to compile .NET applications. If you do not select this feature, only the files required to run XMS applications are installed.

  7. If you are using the custom installation option, click Next after selecting the options you require as described in step 6.

    The installation wizard displays a message that it is ready to begin installation.

  8. Click Install to start the installation.
    The installation wizard displays a bar showing the progress of the installation. Wait for the progress bar to complete. When the installation completes successfully, the window displays the following message:
    
    The installation wizard has successfully installed IBM Message Service Client 
    for .NET. Click Finish to exit the wizard.
    
  9. Click Finish to close the installation wizard.

Results

You have successfully installed Message Service Client for .NET, which is ready to use.

What to do next

Before running any XMS applications, including the sample applications provided with XMS, you must set up the messaging server environment, for details see: Setting up the messaging server environment.