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

## System Requirements

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

- Windows (Windows 10+11 - 64-bit versions)
- MATLAB® R2017b ... R2026a
- Simulink®

## Update

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

###
1. Uninstall old version

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

- Uninstallation is not required and you can skip this part.

#### 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.

###
2. 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 the license is already configured for the old version.

###
3. 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

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 (mes_more_Your_Version.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. Restart MATLAB. 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

1. Extract the MES MoRe zip file (MES_MoRe_Your_Version.zip) into a target folder with write access. Suggestions:
   - C:\Program Files\MES_MoRe
   - %MATLAB_ROOT%\toolbox\MES_MoRe_Your_Version
   - %MATLAB_ROOT%\toolbox\MES_MoRe
   - x:\project\matlab\MES_MoRe_Your_Version
   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 follow the steps from "Activation (Client) -> Via License File" below.

### Purchased version

#### Installation (Server)

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

#### Activation (Client)

##### Via License Server

1. Open a Simulink model and select "Preferences -> License Configuration" from the MES MoRe tool menu.
2. In the opened dialog, enter the server's host address (IP or domain name) and optionally the port (e.g. 192.168.1.107, myserver.comp.com, 3421@myserver) in the "License Server" field.
3. Use the "Test Server" button to test your configuration.
4. When finished, click "Save" and close the dialog.

##### Via License File (.lic)

1. If you have received a license file (.lic), save it to a local folder. The file must remain in the folder for as long as you wish to use the tool.
2. Open a Simulink model and select "Preferences -> License Configuration" from the MES MoRe tool menu.
3. In the opened dialog, enter the path to the saved license file or parent folder in the "License File" field.
4. When finished, click "Save" and close the dialog.
5. To test the configuration, you can open a Simulink model and select "Preferences -> Test License Configuration" from the MES MoRe tool menu.

### 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