Configuring Package for Microsoft .NET

Overview

This chapter explains how to configure/modify some basic settings for the Package for Microsoft .NET. These basic settings are configured by modifying the wmSystem.exe.config file, part of the IBMwebMethods_directory/DotNetHost folder. IBM recommends that you must modify only the properties mentioned in the below sections. You must not modify any of the other options in the wmSystem.exe.config file.

Specifying white-listed directories

About this task

To use Designer and create services to invoke .NET methods, the required .NET methods must be imported to Designer. Before importing the required .NET methods, you must specify the directories that Designer is allowed to access.

By default, C:\ is the configured white-listed directory. You can specify multiple directories as white-listed directories. You can also specify a UNC Path as part of the white-listed directories.

To use UNC Path, the Package for Microsoft .NET and the specified UNC Path must be running under the same user-account. Use two slashes (//) or backslashes (\\) to indicate the machine name and one slash or backslash to indicate the path or shared directory on the machine.

For example, //test1/MyFolder/MyAssemblies provides the UNC path to the MyAssemblies directory on the machine test1.

Note: You cannot specify mapped drives as white-listed directories.

IBM recommends that you add only a restricted set of directories, as white-listed directories.

To specify white-listed directories

Procedure

  1. Go to IBMwebMethods_directory/DotNetHost folder.
  2. Open wmSystem.exe.config file.
  3. Modify the parameter value of the WhitelistDirectories element.

    You can specify multiple directories, separated by the ; symbol.

  4. Restart the Package for Microsoft .NET windows service.

Modifying CLR Version

About this task

CLR 2.0 is the default version of CLR specified with the Package for Microsoft .NET. You can modify it, and use the required version of CLR.

To modify the version of CLR

Procedure

  1. Go to IBMwebMethods_directory/DotNetHost folder.
  2. Open wmSystem.exe.config file.
  3. Change the CLR version value by commenting the already set value, and un-commenting the required CLR version in startup section as displayed below:
    <startup>  
     <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>  
     <!-- <supportedRuntime version="v2.0.50727"/>  -->  
    </startup>
  4. Restart the Package for Microsoft .NET windows service.

Modifying HTTP port

About this task

You can modify the HTTP port specified at the time of installation of Package for Microsoft .NET.

To modify HTTP port

Procedure

  1. Go to IBMwebMethods_directory/DotNetHost folder.
  2. Open wmSystem.exe.config file.
  3. Change the HTTP port by modifying the port number specified in the baseAddress element.

    For example, to set the port number as 9842, set the value of baseAddress element as: http://localhost:9842/msnethost

    Note: You must specify only a port number that is available and not already in use.
  4. Go to Integration Server_directory\packages\WmDotNet\config directory.
  5. Open properties.cnf file.
  6. Modify the value of port.
    Note: If the properties.cnf file does not exist, create the file and add the port=9842
  7. Restart the Package for Microsoft .NET windows service.
  8. Go to Integration Server Administrator and reload the WmDotNet package.

Manually installing DotNetHost as Windows Service

About this task

In some cases, you might have to manually install the DotNetHost as Windows Service. For example, if the DotNetHost installation was not completed successfully through the IBM webMethods Installer, you must manually install the DotNetHost as Windows Service.

To manually install DotNetHost as Windows Service :

Procedure

  1. Open the command prompt.
  2. At the command line, type the following command to switch over to the resources directory:
    cd Integration Server_directory\packages\WmDotNet\resources
  3. Type the following command:

    msiexec /i MSNETPackageInstaller.msi /l* log_file ALLUSERS=1 TARGETDIR=" IBMwebMethods_directory\DotNetHost" MIPPORT=HTTP port

    For example, when the log_file is D:\webMethods\IS90\install\logs\MSNETPackageInstaller.msi_install_log.txt, Integration Server_directory is D:\webMethods\IS90 and the HTTP port is 50000, type the command as follows:

    msiexec /i MSNETPackageInstaller.msi /l* 
    "D:\webMethods\IS90\install\logs\MSNETPackageInstaller.msi_install_log.txt" 
    ALLUSERS=1 TARGETDIR="D:\webMethods\IS90\DotNetHost" MIPPORT=50000
    Note: The port number specified must be the same port number specified in the in properties.cnf file in Integration Server_directory\packages\WmDotNet\config directory.
  4. The MSNETPackageInstaller.msi installer window opens with the values automatically specified. Continue with the installation.

Results

The DotNetHost windows service is successfully installed and started.