Installation
Contents
- 1 Prerequisites
- 2 Download Links
- 3 Server Client Version Compatibility
- 4 Installation Instructions
Prerequisites
Real-time host and Data logger
- Any Concurrent iHawk system
- Real-Time Clock and Interrupt Module (RCIM)
- Concurrent RedHawk Linux 4.1 through 6.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.
SIMulation Workbench Toolkit for MATLAB
- MATLAB® version R2008b or later including R2012b (32 or 64 bit on Windows or Linux)
- Simulink®
- Simulink Coder®
- Windows XP, WIndows Vista, Windows 7, or Linux (32 or 64 bit)
- 200 MB disk space
- Adobe Flash™ to play video.
Download Links
- Download all releases https://redhawk.ccur.com
- Shortcut to download only the latest release http://redhawk.ccur.com/swdist/simwbcd.html
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 minor incompatibility issues and things will probably not work well.
Installation Instructions
Downloading DVD ISO Images
A DVD ISO image of the latest release may be downloaded by visiting the http://redhawk.ccur.com/swdist/simwbcd.html.
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 Login 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-5.5-0.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 (Virtual CloneDrive). 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).
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.
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.
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.
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.
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.
Image: Destination screen
On Linux the destination folder is hardcoded 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.
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! #
Network Installation Instructions Using nuu
On RedHawk and RedHat systems, the nuu GUI tool may be used to install and update SIMulation Workbench over a network connection. Become root to perform the following steps. A one time setup must be done to teach nuu the location of the SIMulation Workbench repository.
# rpm -Uvh \ http://redhawk.ccur.com/simwb/ccur-simwb-repo-4-1.noarch.rpm
Now, run the nuu program.
# /usr/bin/nuu --enablerepo=ccur-simwb
The first time nuu runs after doing this, you will be prompted for the Login and Password provided by Concurrent to gain access to the software. Enter these and press OK. The following window will appear showing the Concurrent software that is installed on the system that has updates available for it.
If you are installing for the first time, click on View Updatable and select View Installable instead. If the list of updatable or installable packages is long, you may want to replace the filter .* with ccur-simwb.* and click on the Filter button to restrict the list to the SimWB packages.
You need only select the RPMs that correspond to the components you wish to install. The nuu tool will take care of installing anything that those components require, as well as making sure that disallowed combinations of RPMs are not installed. Select RPMs for installation or update by clicking on the action box to the left of the rpm name. The below are the rpms that may be selected.
ccur-simwb-rthost
Real-Time Host.
ccur-simwb-dlogger
Real-Time Data Logger.
ccur-simwb-rthost is the software that runs the simulations on a RedHawk Linux system. Data logging may be done on the same system by also installing ccur-simwb-dlogger, or it may be done on a different system connected to the real-time host through a dedicated network connection by installing ccur-simwb-rthost and ccur-simwb-dlogger on separate systems.
ccur-simwb-dlogger32
Real-Time Data Logger (32 bit).
When separate systems are used for data logging and the real-time host, the architecture of the data logger must match the architecture of real-time host: both must be 32-bit or 64-bit architectures. This RPM installs a 32-bit data logger on a 64-bit system. When running the installer on a 64-bit RedHawk system, and neither ccur-simwb-rthost nor ccur-simwb-dlogger are already installed or selected, then ccur-simwb-dlogger32 may be selected.
ccur-simwb-gui
Graphical User Interface, AKA Control Center.
ccur-simwb-gui (Control Center, for configuring a real-time host or interacting with running tests) may be installed on many Linux systems (if yum is available) or Windows systems.
ccur-simwb-toolkit
Toolkit for MATLAB
ccur-simwb-toolkit (for integrating Simulink models into SIMulation Workbench) may be installed on many Linux systems (if yum is available) or Windows system. This rpm needs MATLAB to be installed as well.
Icons will appear in the action box, indicating whether the rpm will be installed, updated, or uninstalled.
Click on the Apply Actions button. nuu will spend a few seconds analyzing dependencies, then displaying a dialog showing what actions it is going to take.
Click on OK and the RPMs will be installed.
If the real-time host or data logger software was installed, see “Licensing” on page 19. To restart the simwb services, run the following command as root:
# /sbin/service simwb restart
Manual Installation on Linux
The RPM files may be located on a DVD, DVD image, or on the redhawk.ccur.com website. The RPMs that may be installed are:
- ccur-nslm
- License manager. Prerequisite for ccur-simwb-rthost, ccur-simwb-dlogger, and ccur-simwb-dlogger32.
- ccur-simwb-core
- Core server software. Prequisite for ccur-simwb-rthost and ccur-simwb-dlogger.
- ccur-simwb-rthost
- Real-time host. Requires ccur-nslm and ccur-simwb-core.
- ccur-simwb-dlogger
- Real-time data logger. Requires ccur-nslm and ccur-simwb-core.
- ccur-simwb-dlogger32
- 32-bit real-time data logger packaged for installing on a 64-bit system. Requires ccur-nslm. Cannot be installed with ccur-simwb-core.
- ccur-simwb-gui
- Control Center and Human-Machine Interface. Does not require any of the above RPMs.
- ccur-simwb-toolkit
- Toolkit for MATLAB. Does not require any of the above RPMs.
To install one of the rpms, run the command (as root):
# rpm -U package_name-version-release.architecture.rpm
When updating any ccur-simwb-core, ccur-simwb-rthost, and ccur-simwb-rthost all that are installed must be updated by a single transaction by listing them all on the same rpm command line.
Installing SIMulation Workbench Toolkit for MATLAB®
On Linux the RPM for installing the toolkit files will place them in:
/usr/local/ccursim/toolkit.
On Windows, the files are placed in
C:\Program Files\Concurrent Computer Corporation\SIMulation Workbench Toolkit
by default. Additional steps are required inside MATLAB to complete the installation.
- Start the version of MATLAB in which you want to install the toolkit.
- Change the current working directory to the location where the files were installed (see above).
Warning: If the installer finds an existing installation, it will ask to overwrite it. To prevent the existing installation from being overwritten, remove the existing installation from the MATLAB path before running the new installation. |
- Right-click on the simwbinstaller.p file and select the Run option. Please make sure that you have write permissions to pathdef.m. Use the command which pathdefat the MATLAB command prompt to locate this file and give write permissions to this file before continuing with the installer.
- Follow the instructions on the installer wizard that opens to complete the installation.
To uninstall the toolkit, remove the SimWB_Target folders from the MATLAB path and save the path.