VSim Installation Instructions

These are instructions on installing the VSim product. Please see the VSim System Requirements first to make sure your system meets the requirements. There are special instructions for versions of MacOS from El Capitan and later.

Windows VSim Software Installation

The VSim distribution package for 64bit Windows is a self-extracting executable installer. Invoke the installer by double clicking on it. The default installation path is:

C:\Program Files\Tech-X (Win64)\VSim-9.X

where X is the minor version of your software. To open the VSim software, go to the Start Menu, click on the Tech-X folder, click on VSim 9.X, then click on VSimComposer. See Fig. 1.

windowsInstallerAllSteps.png

Fig. 1 Dialogs for Windows installation

Windows VSim Software Installation Using a Windows Network Location

These instructions outline how to install VSim to a shared network location. This method will allow users from multiple machines to access and run this installation of VSim on their local machines.

To start, you must have a shared network location that you intend to install to. To do this, locally navigate to the location you wish to install to. Right click the target folder and select properties. A window will appear. Select the “Sharing” tab near the top of the window. Click Share and set the permissions appropriately.

Now that this folder is accessible, install to the folder by following the Windows Installation instructions, using the shared location as your installation location. This can be done from the machine where VSim is being installed, or from another machine with access to the shared folder.

In order to run VSim from a network location, it is best to map the shared network location to a network drive on any machine where VSim may be run. To do this, simply right click the shared network drive on the machine where VSim will be run and select Map Network Drive. At this time you will be prompted to select a drive letter and change settings. Change the settings as desired and press Finish. The user should use this path rather than the Network path when starting VSim. When running VSim from a shared network location, we suggest using the VSim executable directly by navigating to:

Contents\bin\VSimComposer.exe

For convenience, a shortcut can be made on the machine in which VSim is run. Ensure that the shortcut uses the mapped network drive.

To ensure all users have access to the license, the license should go in:

Contents\engine\bin\

inside the installation of VSimComposer.

Linux VSim Software Installation

The VSim distribution package for Linux is a gzipped tarball. Unpack the gzipped tarball into the directory in which you wish to install VSim. A typical location would be

/usr/local/VSim-9.0

The unzip and untar command is

$ cd /usr/local
$ tar xf VSim-9.0.0-Linux64.tar.gz

Or, if your Linux machine does not have OpenGL rendering support then you may want to install the “offscreen” version, in which case the file would be “VSim-9.0.0-Linux64-offscreen.tar.gz. After untarring, the user interface is started with the command:

$ cd VSim-9.0
$ ./VSimComposer.sh

If you plan to run the simulation engine or any other executable from the command-line then you will need to source the startup script:

$ source /usr/local/VSim-9.0/VSimComposer.sh
<execute engine, analyzers, etc.>

See VSim User Guide: Running Vorpal from the Command Line for more instructions on command-line operations.

Mac OS X VSim Software Installation

MacOS Yosemite or previous Users:

The VSim distribution package for Mac OS X is a .dmg installer. Invoke the installer by double clicking on it. Drag the VSim-9.0 folder into your Applications folder (visible in the installer window). From the Application folder, double click on the VSimComposer icon in the VSim-9.0 folder. See Fig. 2. This default installation path is:

/Applications/VSim-9.0
macInstallerDialog.png

Fig. 2 Dialog for the Mac installer

MacOS El Capitan and later Users:

As of El Capitan, Apple instituted GateKeeper, which by default prevents one from executing an unsigned application. The symptom can range from inability to install a license to being told the application is damaged as shown in Fig. 3.

VSimComposer.appisdamaged.png

Fig. 3 Warning that VSimComposer is damaged, put up by GateKeeper.

If you get to this point, you must start over:

Enabling just VSimComposer (works for 9.0.0)

  • Make sure you have deleted ALL instances of the version of VSim that you are about to install, including desktop icons.
  • Unmount any VSim installer disk image.
  • Double click on the VSim installer disk image to mount it.
  • A window should open up that shows your Application folder and a VSim-9.0 folder.
  • Drag the VSim-9.0 folder into the Applications folder.
  • In a terminal window, run:
sudo spctl --add /Applications/VSim-9.0/VSimComposer.app
  • Run VSimComposer from inside the Applications folder.
  • You should now be able to add a VSim license.

Disabling GateKeeper, installing, then re-enabling GateKeeper (works for 9.0.1)

  • Make sure you have deleted ALL instances of the version of VSim that you are about to install, including desktop icons.
  • Unmount any VSim installer disk image.
  • Disable GateKeeper
sudo spctl --master-disable
  • Go to System Preferences → Security & Privacy, and make sure that Anywhere is selected under Allow apps downloaded from:. If it is not, unlock (bottom left corner button) and select it.
  • Double click on the VSim installer disk image to mount it.
  • A window should open up that shows your Application folder and a VSim-9.0 folder.
  • Drag the VSim-9.0 folder into the Applications folder.
  • Run VSimComposer from inside the Applications folder.
  • You should now see Fig. 4.
VSimComposer.appisinternetapp.png

Fig. 4 Warning that VSimComposer was downloaded from the internet, put up by GateKeeper.

  • Press Open.
  • You should now be able to add a VSim license.
  • Re-enable GateKeeper
sudo spctl --master-enable

Errors

If you open VSim and get a message saying “License File Not Found”, make sure that the path for your license starts with:

/Applications/VSim-9.0/...

If not, start over.

If you are still not allowed to open VSimComposer.app, you may be able to fix this by going to System Preferences → Security & Privacy, unlocking, and if you see “VSimComposer.app was blocked …”. Press Open Anyway.