Installing Viz Artist and Engine

Installation of Viz Artist and Engine requires elevated permissions on the destination computer. Make sure to log on to the computer with either an administrator account or a user account with elevated rights, before installing the software. See Running Viz Engine and Viz Artist without administrator rights for further details. If you install Viz Artist on a non-supported operating system platform, you get a warning message.

Before installing the software, make sure to:

• Check that your computer meets the Prerequisites for hardware and system configuration.

• Decide which of the Viz Artist/Viz Engine Platforms is suitable for your installation.

• If upgrading, familiarize yourself with the information in the Upgrading from a previous installation section.

  Tip: Download the Viz Artist and Engine installer from Vizrt’s FTP server.

  Info: Both Mediaftp and Fsmon have individual .msi installers rather than being included in the Viz Engine .msi starting with Viz Engine version 4.0. They are included in the Viz Artist Bundle installer.

1. Run the installer. The bundle installer provides an overview of all required dependencies that need to be installed in addition to the main application. Already installed dependencies are listed as Installed. You can collapse the selection list by clicking Settings.
   

   Note: The bundle installer selects most features by default. Check the feature list and add or remove features as required.

2. Scroll further down to select a custom installation location, if required.
   

   

3. Click INSTALL to complete the installation wizard. The various dependencies are installed as required.

4. Click Finish.

If something interrupts the installation, click Show log to view the installation log files.

Upgrading from a Previous Installation

When you upgrade an existing installation to a new version of Viz Artist and Engine, observe the following:

• Create a backup file of your existing configuration files (.cfg), especially if you are upgrading from a 3.x version. The default data directory for Viz Engine 3 is %ProgramData%\vizrt\Viz3\. The default Viz Engine data directory is %ProgramData%\vizrt\VizEngine\.

• If Viz Engine 3 was installed, follow-up versions since Viz Engine 4 print the error message An incompatible version of Viz Engine is installed. In this case, Viz Engine 3 must be uninstalled, as it is not possible to have both versions installed on a system.

• If upgrading an existing installation with the Viz Artist.msi installation file, you see this message: “Viz Artist 32-bit is already installed. Remove the existing installation first, then restart the installer.” Open Uninstall a program from the Control Panel, select Viz Artist and remove the existing installation. Then run the .msi file to install Viz Artist/Engine.

• Installing Viz Artist/Viz Engine using the bundle installer upgrades older installations. Any older version is removed, except versions prior to Viz Artist and Engine 3.6. This is true even if you opt to install Viz Artist/Viz Engine in a different directory.

• The installer suggests installing to the previous installation folder. You may change it. The recommended installation directory is C:\Program Files\vizrt\VizEngine.

• The installer pre-selects all previously installed features. You may change them.

• The installer does not support downgrading. Remove the currently installed version to install an earlier version of Viz Artist and Viz Engine.

• Upgrading does not change any modified or newly added files of the old installation. For example, Configuration files, Log files or additional files like customer plug-ins remain unchanged in their original folder.

• Since Viz version 3.7.1, viz.exe no longer checks the %Program Files% folder for Configuration files (.cfg) or Lens files (.lcb). These files must be located in %ProgramData%\vizrt\vizEngine.

  • If the previous Viz Artist/Viz Engine was installed in the default folder, the Configuration and Lens files are automatically copied during upgrade from the default installation folder to %ProgramData%\vizrt\vizEngine.

  • If the previous Viz Artist/Viz Engine was installed in a custom folder, the Configuration and Lens files needs to be copied manually from the old installation folder to %ProgramData%\vizrt\vizEngine.

To Change or Reinstall an Existing Installation

Use the Viz Artist bundle installer to change or reinstall an existing installation. The installer pre-selects any already installed features. Check the boxes for the components that you want to add or remove, then click INSTALL. This reinstalls the complete software suite, repairing any damaged or accidentally deleted files.

Silent Installation of Viz Artist and Engine

To install Viz Engine bundle with all its default settings call VizArtistBundle-x64-5.x.x.x.exe -s as administrator.

Installation of a Specific Component

To install a specific .msi from the bundle, perform following steps:

1. Open a command line and call VizArtistBundle-x64-5.x.x.x.exe --dump. This extracts all bundles .msi installers into a subfolder called "VizArtistBundle - 5.x.x.x".

2. Enter msiexec on the command line and press enter to see other options. Common options are:

   • /i: Installs or configures a product. Package: Specifies the name of the Windows Installer package file. ProductCode: Specifies the globally unique identifier (GUID) of the Windows Installer package.

   • /x: Removes a product. Package: Name of the Windows Installer package file. ProductCode: Globally unique identifier (GUID) of the Windows Installer package.

   • /l, /log: Enables logging. Make sure to specify the log file name.

     Example: msiexec /i VizArtist.4.3.0.5.msi /norestart /passive INSTALLDIR_ARTIST="C:\tmp" -lv installation.log

Unattended Installation of Viz Artist and Engine

To install Viz Artist in an unattended mode (the window of the Viz Artist bundle installer is displayed but without allowing user interaction except to cancel the installation progress) with default parameters, the following command should be used in a command prompt started as administrator:

Additional parameters:

Installed components:

Example:

To Identify Installed Version

To check the installed version of Viz Artist and Viz Engine, click on the Viz Artist Information button:

In the Information window, the version numbers show as: