Installation
Contents
- 1 Prerequisites
- 2 Download Links
- 3 Installation Instructions
- 3.1 Downloading DVD ISO Images
- 3.2 Linux DVD Installation Instructions (Graphical)
- 3.3 Linux DVD Installation Instructions (Text)
- 3.4 Windows DVD Installation Instructions
- 3.5 Network Installation Instructions Using nuu
- 3.6 Manual Installation on Linux
- 3.7 Installing SIMulation Workbench Toolkit for MATLAB®
Prerequisites
Real-time host and Data logger
- Any Concurrent iHawk or ImaGen 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 (32 or 64 bit)
- 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/simwb.html
Installation Instructions
Downloading DVD ISO Images
A DVD ISO image of the latest release may be downloaded by visiting the https://redhawk.ccur.com website and clicking on the Create Update CD Images link and following the instructions. A shortcut is available to quickly obtain an image of the latest version by visiting:
http://redhawk.ccur.com/swdist/simwb.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).
Fill in the form with the Login and Password supplied by Concurrent obtaining access to the software.
The following instructions document installing with the DVD, with nuu, and manually with the .rpmand and .msi files.
Linux DVD Installation Instructions (Graphical)
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
The following window will open (if the environment variable DISPLAY is not set to an X display, see Linux DVD Installation Instructions (Text).
Hovering over each selectable component will display help in the lower left-hand corner. If the installer was not run as root, the sudo option in the upper right corner will do the installation using the sudocommand.
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 describes selections are available only on RedHawk Linux. The Control Center and Human-Machine Interface may be installed on many Linux systems (if yum is available) or Windows systems, as may be the MATLAB/Simulink Toolkit (for integrating Simulink models into SIMulation Workbench). The MATLAB/Simulink Toolkit has additional installation steps see Installing Toolkit for MATLAB.
If a component is already installed, it’s check box will be pre-selected for being updated by the DVD. Select additional components you wish to install or deselect components you don’t wish to update. It is strongly advised you keep all components at the same version number.
Finally, click on the install button to begin the installation process. The installation log will be displayed, the appropriate RPMs installed, and, if the real-time host and/or data logger were installed or updated, the simwb service restarted.
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 graphical user interface? (y|n) y Do you want to install the toolkit for MATLAB/Simulink? (y|n) y simwb-cd simwb-cd simwb-cd 7/7 Setting up Install Process Resolving Dependencies --> Running transaction check ---> Package ccur-simwb-dlogger.i386 0:3.5-1 set to be updated --> Processing Dependency: ccur-simwb-core = 3.5-1 for package: ccur-simwb-dlogger ---> Package ccur-simwb-gui.i386 0:3.5-1 set to be updated ---> Package ccur-simwb-rthost.i386 0:3.5-1 set to be updated ---> Package ccur-simwb-toolkit.i386 0:3.5-1 set to be updated --> Running transaction check ---> Package ccur-simwb-core.i386 0:3.5-1 set to be updated --> Finished Dependency Resolution Dependencies Resolved =========================================================== Package Arch Version Repository Size ============================================================ Installing: ccur-simwb-toolkit i386 3.5-1 simwb-cd 58 M Updating: ccur-simwb-dlogger i386 3.5-1 simwb-cd 2.4 k ccur-simwb-gui i386 3.5-1 simwb-cd 97 M ccur-simwb-rthost i386 3.5-1 simwb-cd 305 k Updating for dependencies: ccur-simwb-core i386 3.5-1 simwb-cd 46 M Transaction Summary ================================================================================ Install 1 Package(s) Update 4 Package(s) Remove 0 Package(s) Total download size: 201 M Downloading Packages: -------- Total Running rpm_check_debug . . . Stopping SIMulation Workbench servers: [ OK ] Cleanup : ccur-simwb-core 8/9 Cleanup : ccur-simwb-dlogger 9/9 Installed: ccur-simwb-toolkit.i386 0:3.5-1 Updated: ccur-simwb-dlogger.i386 0:3.5-1 ccur-simwb-gui.i386 0:3.5-1 ccur-simwb-rthost.i386 0:3.5-1 Dependency Updated: ccur-simwb-core.i386 0:3.5-1 Complete! #
Windows DVD Installation Instructions
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:
Hovering over each selectable component will display help in the lower left-hand corner. The grayed out components are for RedHawk Linux only. The Control Center and HMI (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, as may be the Toolkit for MATLAB (for integrating Simulink models into SIMulation Workbench). The Toolkit for MATLAB has additional installation steps. Please see Installing Toolkit for MATLAB.
If a component is already installed, its check box will be pre-selected for being updated by the DVD. Select additional components you wish to install or deselect components you don’t wish to update. It is strongly advised you keep all components at the same version number.
Finally, click on the install button to begin the installation process. A standard Windows Installer window will open for each component in turn.
If you are not running the installer as an administrator you will be asked for an administrator password to elevate privileges for each installation. Follow the installation wizard instructions as you would installing any Windows program.
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</span>
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.
- 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.