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
To update to a new version of MoRe, please follow these steps:
- Uninstall old version
If updating from the old toolbox version to the new toolbox version
If updating from the old manually installed version to any new version
- Call
path_MoRe(false)
in the MATLAB command line.
- If you added a call to init_MoRe to your startup.m, then remove this call.
- 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
- Navigate to the MATLAB Home tab. In the Environment or Resources section, open the Add-On Manager.
- 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
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.
- Extract the MES MoRe zip file (e.g., MES_MoRe_3_0.zip).
- In MATLAB, navigate to the directory where you extracted the MES MoRe zip file.
- In the "Current Folder" section of the MATLAB editor, double click the "MES_MoRe.mltbx" toolbox.
- Wait until MATLAB has finished installing the toolbox.
- Call
sl_refresh_customizations
in the MATLAB command line. There should be an MES MoRe menu entry in the Simulink editor now.
-
(Optional) Some actions from the "Analyze" submenu require Graphviz to be installed:
-
Download and install Graphviz from http://www.graphviz.org/
-
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)
- 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.
- If you extracted the zip file to the MATLAB toolbox folder (%MATLAB_ROOT%\toolbox), then call
rehash toolboxcache
once in the MATLAB command line.
-
For permanent installation (recommended):
-
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).
-
Restart MATLAB. There should be an MES MoRe menu entry in the Simulink editor now.
-
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.
-
(Optional) Some actions from the "Analyze" submenu require Graphviz to be installed:
-
Download and install Graphviz from http://www.graphviz.org/
-
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)
- Ask for the host address (IP or domain name) of the license server and optionally the port to use.
- If not already open, open Matlab. Please check if you correctly installed MES MoRe as described above.
- 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
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