Create a new Datastore

If there is no existing database to which Workspace Control can connect, you can add the following public properties to create a new database during the unattended installation. After creating a new database, you can optionally import a license file and Building Block. Please note that it is not possible to create a new database when installing an Agent-only installation.

Public property

Value

Description

DBTYPE

MSSQL, DB2, ORACLE, MYSQL or MSSQLAZURE

Specifies the database type.

Example: DBTYPE=MSSQL

DBSERVER

<SERVERNAME>

Specifies the database server that Workspace Control should connect to.

Example: DBSERVER=SQLServer01

DBCREATE

YES or NO (default)

Specifies whether a new database should be created using the specified values.

Does not apply to Agent only installations.

DBCREATEUSER

<USERNAME>

Specifies the database user name that should be used to create the new database.

Example: DBCREATEUSER=SA

Does not apply to Agent only installations.

DBCREATEPASSWORD

<PASSWORD>

Specifies the database password that should be used to create the new database.

Example: DBCREATEPASSWORD=SAPassword

Does not apply to Agent only installations.

DBPROTOCOLENCRYPTION

YES or NO (default)

Specifies whether protocol encryption should be used when connecting to Microsoft SQL Server.

Please note, that the default value of this public property is different from the default setting when creating a new Datastore using the Management Console

DBCERTVALIDATION

YES or NO (default)

Specifies whether the certificate that is provided by the database server must be validated against the list of Trusted Root Certificate Authorities on the Agent.

DBFIPS

YES or NO (default)

Specifies that FIPS compliant security algorithms should be used to encrypt data in the database.

DBNAME

<DATABASENAME>

Specifies the name of the database that Workspace Control should create.

Example: DBNAME=Workspace

DBUSER

<DBUSERNAME>

Specifies the database user name that Workspace Control should create to connect to the database.

Example: DBUSER=WorkspaceUser

DBIMPORTLICENSE

<FILEPATH>

Specifies a license file to be imported after creating a new database (optional).

Example: DBIMPORTLICENSE=C:\TEMP\License.xml

Does not apply to Agent only installations.

DBIMPORTBB

<FILEPATH>

Specifies a Building Block file to be imported after creating a new database (optional).

Example: DBIMPORTBB=C:\TEMP\BuildingBlock.xml

Does not apply to Agent only installations.

Example:

When the server name is SQLSERVER01, the Database name is Workspace, username/password is WorkspaceUser/WorkspaceUserPassword, the license file is located at C:\license.xml, and connections to the Datastore must be secured, the command line would be:

Msiexec /i "C:\Ivanti Workspace Control [version].msi" DBSERVER=SQLSERVER01 DBNAME=Workspace DBUSER=WorkspaceUser DBPASSWORD=WorkspaceUserPassword DBTYPE=MSSQL DBPROTOCOLENCRYPTION=Yes DBCERTVALIDATION=Yes DBCREATE=Yes DBCREATEUSER=SA DBCREATEPASSWORD=SAPassword DBIMPORTLICENSE=c:\license.xml DBIMPORTBB=C:\buildingblock.xml /qn

Example using FIPS compliant security algorithms:

When the server name is SQLSERVER01, the Database name is Workspace, username/password is WorkspaceUser/WorkspaceUserPassword, the license file is located at C:\license.xml, and the Database must be FIPS compliant, the command line would be:

Msiexec /i "C:\Ivanti Workspace Control [version].msi" DBSERVER=SQLSERVER01 DBNAME=Workspace DBFIPS=Yes DBUSER=WorkspaceUser DBPASSWORD=WorkspaceUserPassword DBTYPE=MSSQL DBPROTOCOLENCRYPTION=No DBCREATE=Yes DBCREATEUSER=SA DBCREATEPASSWORD=SAPassword DBIMPORTLICENSE=C:\license.xml /qn