Installation Guide

The delivery includes an installer (.exe) and the documentation. This page describes how to install it manually, and gives some examples to install it by scripting.

Install with wizard.

The M2M installer setup.exe must be launched, and the wizard steps must be followed to complete the installation.
To launch setup.exe, right-click on it to open the context menu, and click on "Run as administrator":
Run as admin

Then, follow the steps bellow:

  1. The following welcome window is displayed:
    Setup Welcome Page

    Click on "Next".

  2. The License Agreement Page is now displayed:
    Setup License Agreement page
    Read the agreement, select "I accept the terms in the license agreement" and click on "Next".

  3. The Setup Type Page is now displayed:
    Setup Type page
    Select "Complete" and click on "Next" if you want to install the M2M on C:/Program Files/SOWI/M2M_X.X.X by default.

    If you want to choose where to install the M2M, select "Custom" and click on "Next".

  4. The Custom Setup Page is now displayed:
    Custom Setup page
    Click on "Browse..." to select another M2M installation path.

    The M2M is installed on the selected folder, but a symbolic link named "M2M" is also created in the folders Share/Profiles (OMROOT) of all Rhapsody installations:
    Symbolic link

    It will share the same M2M installation to all Rhapsody installed on the machine in the OMROOT folder.

    Then, click on "Next".

  5. The License Page is now displayed. (This step is only available for the SodiusWillert installer, not the IBM one)
    Either you enter a license server address:
    License server

    Or you select a License file (*.lic) by clicking on "Browse..." :
    License file

    Then click on "Next"

  6. The Ready to install Page is now displayed:
    Ready to install page
    Click on "Install" to complete the installation.

  7. The Completed Page is now displayed:
    Completed page
    Click on "Finish" to close the installer.

Install with a script.

Some examples of scripts that can be used to install and remove the M2M tool, are given here.

Install

To be sure that the installer will work properly, you must take care to launch it as administrator.

The following script can be used to launch the installer in silent mode.

SET M2M_LICENSE_FILE=C:\M2M\license.lic
SET OPTIONS=AgreeToLicense=Yes IS_BROWSE_FILEBROWSED=%M2M_LICENSE_FILE%

setup.exe /S /V"%OPTIONS% /q/l log.txt"

To install a program as administrator from a batch file, the "start-process" powershell command can be used.

SET SETUP_PATH=%1
SET LOG_FILE=install.log
SET M2M_LICENSE_FILE=C:\M2M\license.lic
SET OPTIONS=AgreeToLicense=Yes IS_BROWSE_FILEBROWSED=%M2M_LICENSE_FILE%

powershell -Command "Start-Process" -FilePath "%SETUP_PATH%\setup.exe" -ArgumentList '/S /V"""%OPTIONS% /q/l*v %LOG_FILE%"""' -Verb "RunAs" -Wait
Uninstall

To uninstall a program, it is easer to use msiexec tool with the product code of the program.

SET LOG_FILE=remove.log
SET PRODUCT_CODE=09A75525-B8BB-40D6-80C7-8E63C6E5F473

msiexec /x {%PRODUCT_CODE%} /qb /l*v %LOG_FILE%

Symbolic link

The M2M is installed by default at this location: C:\Program Files\SOWI\M2M_X.X.X\M2M, where X.X.X is the version number.

In order to integrate the tool inside Rhapsody, a symbolic link is created in the <Rhp_instal_folder>\Share\Profiles folder.

It can happen in some specific context, that the installer has not the permission to create this symbolic link. In this case, it is possible to create the link afterwards, by using the "mklink" DOS command:

Create a DOS script with the following script, and launch it with the necessary privilege to create the link in the Share\Profiles folder of your Rhapsody install.

SET TARGET="C:\Program Files\SOWI\M2M_X.X.X\M2M"
    SET LINK="C:\Program Files\IBM\Rhapsody\9.0.1\Share\Profiles\M2M"
    
    mklink /d %LINK% %TARGET%

License management.

The M2M installer creates a new Windows environment variable "M2M_LICENSE_FILE". It contains the license file path or the license server address. If you need to modify the license location, you can modify the value of this environment variable.