MES Model & Refactor® (MES MoRe) - Installation Instructions

System Requirements

The following system requirements must be in place to use MES MoRe:

Update

To update to a new version of MoRe, please follow these steps:

  1. Uninstall old version
  2. If updating from the old toolbox version to the new toolbox version

    If updating from the old manually installed version to any new version

    1. Call path_MoRe(false) in the MATLAB command line.
    2. If you added a call to init_MoRe to your startup.m, then remove this call.
    3. Delete the directory of the old installation or keep it as a backup.

    If updating from the old toolbox version to the new manual installation version

    1. Navigate to the MATLAB Home tab. In the Environment or Resources section, open the Add-On Manager.
    2. Find the old MoRe toolbox entry and select "Uninstall" in the context menu.
      Please note: MATLAB may ask you to delete some directories manually. However, this is not mandatory.

  3. Install new version
  4. Import old configuration files (optional)
  5. After installation, you can import all configuration files of the old version via "Import Previous Preferences" from the "Preferences" submenu of MoRe. This import action requires the old version to be 2.9 or newer. This import is only necessary if you have changed any configuration files from the "Preferences" submenu in the old version.

Installation

MoRe can be installed either as a toolbox or manually. We strongly recommend the toolbox option because it is much easier to install and update.

Install as toolbox (recommended)

NOTE: Do not install the toolbox on a network drive! Installing a MATLAB toolbox on a network drive can severely slow down MATLAB. To check the toolbox installation path, please open MATLAB's "Preferences" and navigate to the submenu "Add-Ons" or "Apps". Here you can check the installation path in the "Installation Folder" field and change it if necessary.
  1. Extract the MES MoRe zip file (e.g., MES_MoRe_3_0.zip).
  2. In MATLAB, navigate to the directory where you extracted the MES MoRe zip file.
  3. In the "Current Folder" section of the MATLAB editor, double click the "MES_MoRe.mltbx" toolbox.
  4. Wait until MATLAB has finished installing the toolbox.
  5. Call sl_refresh_customizations in the MATLAB command line. There should be an MES MoRe menu entry in the Simulink editor now.
  6. (Optional) Some actions from the "Analyze" submenu require Graphviz to be installed:
    1. Download and install Graphviz from http://www.graphviz.org/
    2. Add the folder containing the dot.exe of Graphviz to the PATH environment variable of Windows (e.g., C:\Program Files (x86)\Graphviz 2.28\bin).

Install manually (not recommended)

  1. Extract the MES MoRe zip file (e.g. MES_MoRe_3_0.zip) into a target folder with write access. Suggestions: Please keep all the subdirectories.
  2. If you extracted the zip file to the MATLAB toolbox folder (%MATLAB_ROOT%\toolbox), then call rehash toolboxcache once in the MATLAB command line.
  3. For permanent installation (recommended):
    1. Add a call to the MoRe\init_MoRe.m script from the target folder to your MATLAB startup.m file. Example call: run('C:\Program Files\MES_MoRe\MoRe\init_MoRe');
      Please make sure that there is no call to init_MoRe of an old installation left!
      If you are not sure whether you have any startup.m file yet, type which startup.m in MATLAB command line.
      If result is not empty, add the call from above to this file.
      If result is empty, create a new startup.m file in your userpath. Type userpath in MATLAB command line to get your userpath. Add the call from above to the newly created file (type also doc startup in MATLAB command line for help).
    2. Restart MATLAB. There should be an MES MoRe menu entry in the Simulink editor now.
  4. For temporary usage (not recommended): Call init_MoRe from the MoRe subfolder of the target folder in the MATLAB command line. This might throw warnings like "Objects of XXX class exist - not clearing java", if other tools are holding locked references to java objects. In that case, please follow the instructions for permanent installation above.
  5. (Optional) Some actions from the "Analyze" submenu require Graphviz to be installed:
    1. Download and install Graphviz from http://www.graphviz.org/
    2. Add the folder containing the dot.exe of Graphviz to the PATH environment variable of Windows (e.g. C:\Program Files (x86)\Graphviz 2.28\bin).

License Configuration

Evaluation version

Usually no license configuration is necessary here. However, if you have received a separate license file (.lic), please copy the license file (.lic) into the "license" subfolder of your tool installation.
For the toolbox installation you can locate the installation directory using MATLAB's Add-On Manager. Alternatively, you can call fileparts(which('path_MoRe')) in the MATLAB command line to get the path.

Purchased version

Installation (Server)

For detailed information on server installation, please refer to the MES License Setup Guide.

Activation (Client)

  1. Ask for the host address (IP or domain name) of the license server and optionally the port to use.
  2. If not already open, open Matlab. Please check if you correctly installed MES MoRe as described above.
  3. Use the installFloatingLicense_MoRe() Matlab function and give the port and host as string parameter ('port@host'), e.g.:

    The function copies the lismo.config file to the tool's AppData directory and creates the port@host entry. In case you are interested, you can get the directory with the created lismo.config file by launching path_MoRe() and mes.more.ToolAppData.ToolAppDataDir.

Support

If you have any questions or suggestions which can help us to improve MES Model&Refactor® (MES MoRe) please do not hesitate to contact us: Email: more@model-engineers.com Phone: +49(0) 30 20916463 60