A Silent Installation is an installation that displays no dialogs after starting, and has no configuration options to choose from (e.g. changing the destination folder name). This article contains the steps for a silent installation for Vizlib Server, as well as two batch files - VizlibServerSilentInstaller.bat should be used for installations which don't require an HTTPS certificate, while VizlibServerSilentInstaller HTTPS-CERTIFICATES.bat can be used where you need to provide an HTTPS certificate (either in PFX of PEM format).
Note: The examples used here are silent installations which have successfully completed, but the process is still evolving and the content may change as more installations take place.
TABLE OF CONTENTS
- Example 1 - New Installation
- Example 2 - Installation on New Machine (Existing Configuration)
- Working with Vizlib Server
Example 1 - New Installation
This example is for an installation where Vizlib Server is installed on a machine for the first time.
Prerequisites - Before you start, make sure the files listed here are copied to the machine hosting the new installation.
- VizlibServerInstaller.exe and VizlibServerSilentInstaller.bat. We've attached an example .bat file to demonstrate how the installer should be executed in silent mode. You should modify the batch file contents to enter any values specific to your own installation.
- The Vizlib Server license file downloaded from Vizlib Portal.
- The server SSL certificate, verified and copied (with key) in .pfx format.
Installation - Follow these steps to complete the installation.
- Open a command line with administrative rights (type cmd in the search bar and select Run as Administrator).
- Click VizlibServerSilentInstaller.bat to execute the file, passing all the required arguments in the right order.
- If the installer completes successfully, you can now login to the VMC to continue the setup using HTTP port 1980. You should also use the user name (default vmc_admin) and password specified during the installation. In most cases, you'll need to switch to the HTTPS protocol and enter the path to the SSL certificate.
Example 2 - Installation on New Machine (Existing Configuration)
This example is for installing an existing configuration of Vizlib Server for a new machine.
Prerequisites - Before you start, make sure the files listed here are copied to the new machine hosting the installation.
- VizlibServerInstaller.exe and VizlibServerSilentInstaller.bat. We've attached an example .bat file to demonstrate how the installer should be executed in silent mode. You should modify the batch file contents to enter any values specific to your own installation.
- The Vizlib Server license file downloaded from Vizlib Portal.
- The configuration file exported from the existing installation. To export the file, go to VMC System Settings and click the Export Config button to save the file to a pre-defined path. Click Download Config to download the file if you cannot access the export location (e.g. you're unable to RDP to the file path.
- The server SSL certificate, verified and copied (with key) in .pfx format. The certificate file location should match the path for the previous install, or Vizlib Server will revert to using HTTP instead of HTTPS.
Installation - Follow these steps to complete the installation.
- Open a command line with administrative rights (type cmd in the search bar and select Run as Administrator).
- Click VizlibServerSilentInstaller.bat to execute the file, passing all the required arguments in the right order. Note: The last parameter passed should be config file location.
- If the installer completes successfully, you can now login to the VMC to continue the setup using the port specified in the configuration file and the user name (vmc_admin) and password specified during the installation. During the installation, settings will be automatically imported (e.g. security rules, integrations, streams and destinations)
Note: Comments for Vizlib Teamwork and Vizlib Finance will not be transferred. If you find you have to frequently transfer the Vizlib Server installation to new environments and would like to keep these comments, we recommend either one of these approaches.
- Implementing a database backup mechanism.
- Storing comments in an external database.
Working with Vizlib Server
Vizlib Server has a full set of supporting documentation relating to installations, you can find more information here.