Installation
Contents
Prerequisites
Real-time host and Data logger
- Any Concurrent iHawk system
- Real-Time Clock and Interrupt Module (RCIM)
- Concurrent RedHawk Linux 4.1 through 7.x (32 or 64 bit)
- RedHawk Linux Frequency-Based Scheduler
- 500 MB disk space.
Control Center and Human-Machine Interface
- 1280x768 or higher screen resolution is recommended (1024x600 is usable in full screen mode)
- Windows XP, Windows Vista, Windows 7, or Linux (32 or 64 bit)
- 200 MB disk space
- Adobe Flash™ is required to play video on Linux.
MLToolkit
- MATLAB® version R2008b or later including R2014a (32 or 64 bit on Windows or Linux)
- Simulink®
- Simulink Coder®. Simulink Coder itself requires MATLAB Coder®.
- Windows XP, WIndows Vista, Windows 7, or Linux (32 or 64 bit)
- 200 MB disk space
- Adobe Flash™ to play video.
PYToolkit
- Python 2.4 or later
Download Links
- Shortcut to download the latest releases: http://license.simwb.com
Server Client Version Compatibility
Starting with version SIMulation Workbench 4.0-1, the SimWB product suite has moved to a major.minor-maintenance version numbering scheme.
- If only the maintenance version number is different then the compatibility is expected between the server and the client software.
- Eg: Server 4.1-1 and Client 4.1-7 are compatible.
- If the minor version number is different then minor incompatibility exists between the server and the client software.
- Eg: Server 4.1-1 and Client 4.2-1 may have minor incompatibility issues and some stuff might not work.
- If the major version number is different then major incompatibility exists between the server and the client software.
- Eg: Server 5.1-1 and Client 4.2-1 may have major incompatibility issues and things will not work well.
Installation Instructions
Downloading DVD ISO Images
A DVD ISO image of the latest release may be downloaded by visiting: http://license.simwb.com
The single ISO image contains both 32-bit and 64-bit versions for both Linux and Windows (the real-time host and logger software can only be installed on RedHawk Linux).
Image: SimWB ISO Download Page
Fill in the form with the Login and Password supplied by Concurrent obtaining access to the software.
DVD Installation Instructions (Graphical)
Linux
Become root, mount the ISO image or physical media (if the system is not configured to automount the media when it is inserted into the DVD drive), and run the install script.
# mkdir /media/SimWB # mount -oloop -oro ccur-simwb-2020.1-2.iso /media/SimWB (or # mount /dev/dvd /media/SimWB) # cd /media/SimWB # ./install-simwb
Windows
Insert the physical media into the DVD drive or you can choose to mount the downloaded ISO using any virtual drive software (WinISO) or use 7zip to extract the content and install from there. If auto run is enabled, allow it to run Setup.exe. Otherwise, open the DVD drive in Explorer and double-click on Setup.exe (or Setup, if file-name extensions are hidden).
Welcome screen
The following window will open (if the environment variable DISPLAY is not set to an X display in Linux, see Linux DVD Installation Instructions (Text).
Image: Welcome screen
Clicking Next will take you to the License Agreement screen.
License Agreement screen
Image: License Agreement screen
If you accept the terms of the license agreement, you can click Next which will take you to the Install Manager screen.
Install Manager screen
Image: Install Manager screen
If the installer detects a previous installation of SimWB, the Uninstall Manager radio button will be enabled. Based on the radio button selection on this screen, clicking Next will take you to the Install Components screen or the Uninstall Screen.
Components screen
Image: Components selection screen RedHawk
Image: Components selections screen Windows/Generic Linux
The Components selection screen on RedHawk differs from the same screen on other operating systems including Windows. The Real-Time Host and the Real-Time Data Logger options will be enabled only if installing on a RedHawk system.
The Real-Time Host is the software that runs the real-time simulations on a RedHawk Linux system. Data logging may be done on the same system by also installing the Real-Time Data Logger, or it may be done on a different system connected to the real-time host through a dedicated network connection by installing the Real-Time Host and Real-Time Data Logger on separate systems.
When a separate system is used for data logging, the architecture must match the real-time host. Both must be 32-bit or 64-bit architectures. It is possible to install the 32-bit data logger on a 64-bit system. When running the installer on a 64-bit RedHawk system, and Real-Time Host or Real-Time Data Logger is not already installed or selected, then the Real-Time Data Logger (32-bit) may be selected.
The above described selections are available only on RedHawk Linux. The Control Center and Human-Machine Interface may be installed on many Linux systems or Windows systems, as may be the MLToolkit (inteface between MATLAB®/Simulink® and SimWB) and the PYToolkit (interface between Python and SimWB).
If the MLToolkit is selected to be installed, clicking Next on the Components selection screen will take you to the MATLAB Path screen. If MLToolkit is not selected you will be taken to the Destination screen.
MATLAB Path screen
Image: MATLAB Path screen
In order for the MLToolkit to be operational under MATLAB, the MLToolkit install location needs to be added to the MATLAB path. The installer tries to detect MATLAB installations on the system and display them in the table on this screen. You can skip the MATLAB addpath and addpath manually at a later time or you can select one of the MATLAB versions detected by the installer for the installer to automatically perform an addpath. If the installer is unable to detect a version of MATLAB which you know exists on the system, you have the option to specify the MATLAB installation directory. The MATLAB installation directory is returned by using the commandmatlabrootat the MATLAB command prompt. Clicking Next on this screen will take you to the Destination screen.
Destination screen
Image: Destination screen
On Linux the destination folder is hard-coded to /usr/local/ccursim. On Windows the users have an option to choose a different install location. The default is C:\Program Files\Concurrent. To prevent possible conflicts, the previous version of SimWB should be uninstalled. Uninstallation will delete all the folders except for some configuration files and user created HMI display. We still recommend you backup and user files in the installation directory before proceeding with the installation. Selecting the radio button for uninstalling will uninstall components before installing the newer version of SimWB. Clicking Next on this screen will start the installation process and display the Install Log screen.
Install Log screen
Image: Install Log screen
Linux DVD Installation Instructions (Text)
Become root, mount the ISO image or physical media (if the system is not configured to automount the media when it is inserted into the DVD drive), and run the install script.
# mkdir /media/SimWB # mount -oloop -oro ccur-simwb-4.0-1.iso /media/SimWB (or # mount /dev/dvd /media/SimWB) # cd /media/SimWB # ./install-simwb
If the environment variable DISPLAY is not set to an X display, a text-only install dialog will allow the user to install the real-time host and data logger software on systems that do not have graphics configured.
***************** IMPORTANT *************** * * * If you are running the data logger and * * SimWB real-time host on the same system * * answer y to the 2 following questions. * * * * Otherwise, answer yes to the question * * that corresponds to the host where you * * are running this installation script. * * * * You can define a system as a SimWB real-* * time host by installing the rpm * * ccur-simwb-rthost. # * * * Conversely, to define the system as a * * data logger host, install the rpm * * ccur-simwb-dlogger * * * ******************************************* Is this a real-time SimWB host? (y|n) y Is this a data logger SimWB host? (y|n) y Do you want to install the Control Center (GUI interface)? (y|n) y Do you want to install the MLToolkit (interface between SimWB & MATLAB)? (y|n) y Do you want to install the PYToolkit (interface between SimWB & Python)? (y|n) y simwb-cd Setting up Install Process Resolving Dependencies --> Running transaction check . . . Complete! #
Add MLToolkit to MATLAB path
Once installed the MLToolkit paths can be added to different versions of MATLAB. This is accomplished by executing the following script at the MATLAB command prompt:
cd(mltoolkitfolder); % where mltoolkitfolder is the folder where MLToolkit is installed run simwbstartup savepath
pathcommand to confirm that the ..\SimWB_Target\.. folders are indeed on the MATLAB path.