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

System Requirements

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

• Windows (XP, Vista, Windows 7+8+10 - 32 and 64-bit versions)
• MATLAB® R2014b ... R2021b
• Simulink

Update

Uninstall old version

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

• Skip this step.

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.

Install new version

• Depending on whether you want to install the new version manually or as a toolbox, proceed as described in the following "Installation" section.
• You can skip the "License configuration" part if a floating license is already installed in the old version.

Import old configuration files (optional)

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

Install as toolbox (recommended)

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:
   • C:\Program Files\MES_MoRe
   • %MATLAB_ROOT%\toolbox\MES_MoRe_3_0
   • %MATLAB_ROOT%\toolbox\MES_MoRe
   • x:\project\matlab\MES_MoRe_3_0
   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

Purchased version

Installation (Server)

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.:
   • installFloatingLicense_MoRe('3421@192.168.1.107') (port and IP)
   • installFloatingLicense_MoRe('3421@myserver.comp.com') (port and domain name)
   • installFloatingLicense_MoRe('3421@myserver') (port and intranet host name)
   • installFloatingLicense_MoRe('192.168.1.107') (only IP)
   • installFloatingLicense_MoRe('myserver.comp.com') (only domain name)

   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.

• Now you can use MES MoRe as long as the FlexNet server is available at this address.
  

Support