Unattended installation



Start unattended mode

  1. Download the installation file (see Download GridVis ).

  2. Open a console.

  3. Execute the installation file via the command line. Be sure to include the parameter -q, otherwise the installation wizard will be opened.

Transfer of parameters

There are two options for transferring the installation parameters:

  • Transfer via the command line. To do this, append the parameters in the command line after the installation file call.

  • Transfer via a text file.

    1. Create a text file containing all parameters. In the text file, the prefixes -D and -V for system and installer parameters are omitted.

    2. Execute the installation file and use the parameter -varfile to transfer the text file.

Parameters

Parameter

Default setting

Description

Example

Standard parameters
Define how the installer should behave.

-console


Only valid in unattended mode (-q). Outputs all messages on the console with which you executed the installation file.

installer.exe -q -console

-dir <directory>

C:\Program Files\GridVis

Only valid in unattended mode (-q). Defines the installation directory.

Note

We recommend that you only use absolute paths.

installer.exe -q -dir "C:\Program Files\GridVis EnMS"

-h or -help or /?


Displays help with the parameters in a dialog box. Use the additional parameter -c to display the help in the console.

installer.exe -h -c

-overwrite


Only valid in unattended mode (-q). Overwrites files during installation without asking the user.

installer.exe -q -overwrite

-q


Starts the installer in unattended mode. In this mode, no settings are requested from the user. The installer uses the default settings unless you define others using additional parameters.

Note

Existing files are not overwritten during installation if the user has to be asked to do so. Use the parameter -overwrite to overwrite files during the installation.

Installation with default settings and overwriting of files in a different directory:
installer.exe -q -overwrite -dir "C:\Program Files\GridVis EnMS"

-varfile <file>


Transfers parameters from a text file. Enter the full path including the file name.

installer.exe -varfile "C:\Users\jan.itza\Documents\GridVis.varfile"

System parameters
Define system-specific settings. System parameters are structured as follows: -D<parameter>=<value>

-install4j.language=<ISO code>

Dependent on the system language

Defines the language in which the installation wizard is opened. Only enter the language as an ISO code without the region here.

installer.exe -Dinstall4j.language="en"

Installer variables
Define specific installation settings that are to be set with the installation wizard. Installer variables are structured as follows: -V<parameter>=<value>

-defaultLocale=<language>:<region>

Dependent on the system language

Defines the default language with which GridVis is installed. Enter the value in the form <language>:<region>.

installer.exe -VdefaultLocale="en:US"

-disableServiceStart

false

Defines whether the GridVis service is started after the installation.

installer.exe -VdisableServiceStart="true"

-instanceName=<name>

EnMS and PQ Software

Defines the unique instance name of the GridVis installation. This instance name is used, for example, for the name of the corresponding Windows service.

installer.exe -VinstanceName="GridVis EnMS"

-limitAccessToUserDir

true

Defines whether access to the directory for the user data of the GridVis Service is restricted to administrators.

Note

We recommend that you use this option because various scripts and passwords are stored in this directory.

installer.exe -VlimitAccessToUserDir="false"

-maxHeapSizeDesktop=<size>

Half of the system's working memory

Defines the amount of working memory in MB that is available for the GridVis Desktop.

installer.exe -VmaxHeapSizeDesktop="8192"

-maxHeapSizeService=<size>

Half of the system's working memory

Defines the size of the working memory in MB available for the GridVis Service.

installer.exe -VmaxHeapSizeService="8192"

-serviceAdminPassword=<password>


Defines the password for the user admin.

Attention!

Keep the password safe! If you have forgotten your password, you will need the assistance of Janitza technical support !

Note

  • You must enter a password if you install the GridVis for the first time or if you update the GridVis and your current password does not meet the requirements.

  • The following requirements apply to the password:

    • Length: 8 - 20 characters

    • At least 1 special character, 1 number, 1 lowercase letter and 1 uppercase letter

    • No spaces

  • If you transfer the password as a parameter via a text file, the password must not be enclosed in quotation marks. The quotation marks are otherwise interpreted as part of the password.

installer.exe -VserviceAdminPassword="1Dummy_Password"

-serviceInstallStartupMode=<mode>

auto

Defines how the GridVis service is started after system startup. You have the following options:

  • auto: The GridVis Service starts directly with the system start.

  • delayed: The GridVis Service starts approx. two minutes after the system startup.

  • manual: The GridVis Service does not start automatically when the system starts. You must start the GridVis service manually in order to be able to use it.

installer.exe -VserviceInstallStartupMode="delayed"

-serviceUserDir=<directory>

C:\GridVisData

Defines the directory for the user data of the GridVis service.

Note

We recommend that you only use absolute paths.

installer.exe -VserviceUserDir="C:\GridVis EnMS Data"

-sys.component.211$Boolean

true

Defines whether the GridVis Service is installed.

installer.exe -Vsys.component.211$Boolean="false"

-sys.component.212$Boolean

true

Defines whether the GridVis Desktop is installed.

installer.exe -Vsys.component.212$Boolean="false"

-webserverHttpPort=<port>

8080

Defines the HTTP port with which you access the GridVis Service.

installer.exe -VwebserverHttpPort="8090"

Examples

Command line
installer.exe -q -overwrite -console
-dir "C:\Program Files\GridVis EnMS"
-VserviceUserDir="C:\GridVis EnMS Data"
-VinstanceName="GridVis EnMS"
-VwebserverHttpPort="8090"
-VdisableServiceStart="true"
-VserviceInstallStartupMode="delayed"
-VserviceAdminPassword="1Dummy_Password"
Text file
q
overwrite
console
dir C\:\\Program Files\\GridVis EnMS
serviceUserDir=C\:\\GridVis EnMS Data
instanceName=GridVis EnMS
webserverHttpPort=8090
disableServiceStart=true
serviceInstallStartupMode=delayed
serviceAdminPassword=1Dummy_Password