Identity Manager 8.2.1 - Operational Guide

The InstallManager.Cli.exe program provides support for the installation of One Identity Manager. You can run the program from the command line.

IMPORTANT: Run the installation using the command line console in administrator mode.

Calling syntax

InstallManager.Cli.exe

-m install|change|remove|uninstall

-r {Directory}

[-i {Directory}]

[-fu]

[-mod {ModuleIDs}]

[-d {Targets}]

[-p {Packages}]

[-l {Path}]

[-fo]

[-cs {Service name} {Properties}]

[-dc]

Table 51: Program parameters and options
Parameter or option	Alternative name	Description
-m	--mode	Installation mode. Permitted values are install: Install new modules. change: Update existing modules. remove: Delete modules. uninstall: Uninstall complete installation.
-r	--rootpath	Directory containing the installation sources.
-i	--installpath	(Optional) Directory in which to install.
-fo	--filesonly	(Optional) Only file actions will be run. No start menu entries or registry keys are generated and no services are installed.
-mod	--module	Space-delimited list of module IDs.
-d	--deploymenttarget	Space delimited list of machine roles.
-p	--packages	Space-delimited list of packages.
-l	--logfile	(Optional) Path to the log file.
-fu	--forceupdate	(Optional) All data will be reinstalled.
-cs	--changeservice	Changes the properties for registration of the service. The following values are expected: Service name: Name of the service to be changed Properties: New properties of the service with: Name: Name of the service. Display: Display name of the service. Description: Description of the service. Example: "Name=<New name>;Display=<New display>;Description=<New Description>" You only need to specify the properties that are to be changed.
-dc	--deleteconfig	(Optional) Configuration data and logs are removed in uninstall mode.
-h	--help	Display program help.

Example: Installing a single module

InstallManager.Cli.exe

-m install

-r c:\sourcedir

-mod QER ADS SAP LDAP ATT

Example: Updating a machine role

InstallManager.Cli.exe

-m change

-r c:\sourcedir

-d Server\JobServer\ADS

Example: Uninstalling the One Identity Manager components

InstallManager.Cli.exe

-m uninstall

-i c:\installdir

-dc

DBCompilerCMD.exe

The DBCompilerCMD.exe program supports compiling a database.You can run the program from the command line.

Calling syntax

DBCompilerCMD.exe

/Conn="{Connection string}"

/Auth="Module={Authentication string}"

[-W]

[/Blacklist=[CompileWebServices] [CompileTypedWrappers] [CompileDialogScripts] [CompileScripts] [CompileJobChains] [CompileWebProjects] [CompileApiProjects] [CompileHtmlApps] [FillMultiLanguage]]

/WaitTimeout

[-A]

[/AutoCompileCheckInterval]

[/AutoCompileWaitSeconds]

[/AutoCompileErrorWaitSeconds]

[-S]

[-v]

Table 52: Program parameters and options
Parameter or option	Description
/Conn	Database connection parameter. Minimum access level Configuration user. For more information about permissions, see the One Identity Manager Installation Guide and the One Identity Manager Authorization and Authentication Guide. Alternatively, you can enter the name of the connection according to the registry HKEY_CURRENT_USER\Software\One Identity\One Identity Manager\Global\Connections.
/Auth	Authentication data. The authentication data depends on the authentication module used. For more information about One Identity Manager authentication modules, see the One Identity Manager Authorization and Authentication Guide.
-W	(Optional) Wait for the processing of DBQueue Processor tasks to complete before starting compilation.
-A	(Optional) Automatic compilation of the database. The database is monitored and compiled if necessary. This runs until the program is terminated with Ctrl + C.
-S	(Optional) Messages are outputted to the console without timestamp or severity level.
/LogLevel	(Optional) Scope of output to be processed. Permitted values are: Off: No logging. Fatal: All critical error messages are logged. Error: All error messages are logged. Info: All information is logged. Warn: All warnings are logged. Debug: Debugger outputs are logged. This setting should only be used for testing. Trace: Highly detailed information is logged. This setting should only be used for analysis purposes. The log file quickly becomes large and cumbersome.
/IgnoreErrors	(Optional) Specifies if error messages are ignored. Permitted values are True and False.
/Blacklist	(Optional) Space-delimited list of compiler modules that must not be compiled. Permitted values are: CompileWebServices: Compile web services CompileTypedWrappers: Compile a type-safe database model CompileDialogScripts: Compile scripts from the script library CompileScripts: Compile templates, formatting scripts and task definitions CompileJobChains: Compile processes CompileWebProjects: Compile web projects CompileApiProjects: Compile API projects CompileHtmlApps: Compile HTML applications FillMultiLanguage: Extract language-dependent texts
/WaitTimeout	Maximum waiting time for DBQueue. Default: 00:10:00
/AutoCompileCheckInterval	(Optional) Interval in seconds to check if the database needs to be compiled. Default: 30
/AutoCompileWaitSeconds	(Optional) After a compilation request is detected, compilation is deferred by this time interval before actually being be performed. Default: 0
/AutoCompileErrorWaitSeconds	(Optional) If an error occurs during compilation, the next compiler run is deferred by this time interval before actually being be performed. Default: 60
-v	(Optional) Provides additional information (verbose).
-? \|-h	Display program help.

Example:

DBCompilerCMD.exe

/Conn="Data Source=<Database server>;Initial Catalog=<Database name>;User ID=<Database user>;Password=<Password>"

/Auth="Module=DialogUser;User=<User name>;Password=<Password>"

-W

Quantum.MigratorCmd.exe

The Quantum.MigratorCmd.exe program supports migration of a One Identity Manager database. You can run the program from the command line.

Calling syntax for installation

quantum.migratorcmd.exe

--INSTALL

/Connection="{Connection string}"

/Module={Module IDs}[+]

/Destination="{Directory}"

[/Password={Password}]

[/Admin="mode=create|check|extend;login={SQL Server login name};password={SQL Server login password}]

[/Login="User=Config|User;login={SQL Server login name};password={SQL Server login password}"]

[/Person="condition={Condition};password={Person password}"]

[/User="DialogUser={System user};password={System user password}"]

[/PreCheck={[+|-] Precheck ID}]

[/Edition]

[/DialogDatabase]

Calling syntax for updating

quantum.migratorcmd.exe

--UPDATE

/Connection="{Connection string}"

/Module={Module IDs}[+] /destination="{Directory}"

[/Admin="mode=create|check|extend;login={SQL Server login name};password={SQL Server login password}]

[/Login="User=Config|User;login={SQL Server login name};password={SQL Server login password}"]

[/Person="condition={Condition};password={Person password}"]

[/User="DialogUser={System user};password={System user password}"]

[/PreCheck={[+|-] Precheck ID}]

[/KeepUpdatePhase]

[/DialogDatabase]

Calling syntax for restoring a database

quantum.migratorcmd.exe

--RESTORE

/Connection="{Connection string}"

/Destination="{Directory}"

[/Admin="mode=create|check|extend;login={SQL Server login name};password={SQL Server login password}]

[/Login="User=Config|User;login={SQL Server login name};password={SQL Server login password}"]

[/Person="condition={Condition};password={Person password}"]

[/User="DialogUser={System user};password={System user password}"]

[/PreCheck={[+|-] Precheck ID}]

[/KeepUpdatePhase]

[/DialogDatabase]

Calling syntax for passing parameters as a file

quantum.migratorcmd.exe @File

Table 53: Program parameters and options
Parameter or option	Description
--Install	Installs new database.
--Update	Update database.
--Restore	This operation performs the necessary steps to make the database operational, such as initializing the DBQueue Processor or restoring logins. The operation can be performed after a database has been restored from a backup, for example on another server.
--Dump	For internal use only.
--Import	For internal use only.
--Delta	For internal use only.
/Clear	For internal use only.
/Format	For internal use only.
/HashSize	For internal use only.
/KeepUpdatePhase	(Optional) If the parameter is set, the update phase is not reset to 0 after migration is complete (DialogDatabase.UpdatePhase).
/LogLevel	(Optional) Scope of output to be processed. Permitted values are: Off: No logging. Fatal: All critical error messages are logged. Error: All error messages are logged. Info: All information is logged. Warn: All warnings are logged. Debug: Debugger outputs are logged. This setting should only be used for testing. Trace: Highly detailed information is logged. This setting should only be used for analysis purposes. The log file quickly becomes large and cumbersome.
/Password	(Optional) Initial password for the viadmin system user when a new database is installed.
/Condition	For internal use only.
/Connection	Database connection parameter. Minimum access level Administrative user. For more information about permissions, see the One Identity Manager Installation Guide and the One Identity Manager Authorization and Authentication Guide. Alternatively, you can enter the name of the connection according to the registry HKEY_CURRENT_USER\Software\One Identity\One Identity Manager\Global\Connections.
/From	For internal use only.
/To	For internal use only.
/Destination	Source directory .
/DialogDatabase	Passes information about the database (DialogDatabase table). The value updates the entry for the database in the DialogDatabase table. This allows a new database to immediately create a valid entry in the DialogDatabase table. Example: "CustomerName=<your name>;ProductionLevel=2"
/Edition	(Optional) Edition to be installed. Permitted values are: DGE: One Identity Manager Data Governance Edition ADS: One Identity Manager Active Directory Editions STE: One Identity Manager Edition
/Admin	(Optional) Mode for creating SQL Server logins if granular permissions are used. mode: Specifies in which mode the SQL Server login is created. Permitted values are: create : The SQL Server login does not exist yet and will be created. check: The SQL Server login already exists. This checks the permissions for the SQL Server login. If the necessary permissions are missing, an error message is displayed. extend: The SQL Server login already exists. This extends the permissions for the SQL Server login. login: Name of the SQL Server login. password: Password for the SQL Server login. Example: Create a new SQL Server login "OneIM_Admin" with password "secret". /admin="mode=create;Login=OneIM_Admin;Password=secret"
/Login	(Optional) Creates the other SQL Server logins if granular permissions are used. Multiple instances of this parameter are possible. user: Name of the database user according to QBMDBPrincipal.UserName. Permitted values are: Config: Configuration user. User: End user. login: Name of the SQL Server login. password: Password for the SQL Server login. Example: Creating SQL Server logins for configuration users and end users. /login="User=Config;Login=OneIM_Config;Password=secret" /login="User=User;Login=OneIM_User;Password=secret"
/Module	Comma delimited list of module IDs. For UPDATE operation: If the module ID is followed by a plus sign (+), only this module is updated. If no plus sign is specified, all modules listed are updated.
/ModuleOwner	For internal use only.
/operation	Alternative name of the operation. Example: /operation=INSTALL
/Person	(Optional) Configuration of an employee's password (Person.DialogUserPassword). Multiple instances of this parameter are possible. condition: A valid SQL condition for the person table. password: Password (plain text or password hash). Example: Sets the "secret" password for the employee with the internal name "Sys, admin". /person="Condition=InternalName='Sys, admin'; Password=secret"
/PreCheck	(Optional) Controls the handling of database pre-checks. The input is given as + or - followed by the ID for the pre-check. Multiple instances of this parameter are possible. +ID: The pre-check is repaired. If the pre-check is not repairable, an error message is displayed. -ID: Pre-check is ignored. This only works for optional tests. Example: /precheck=-JobqueueEmpty. The ID can be taken from the PreCheck with ID '{0}' failed! error message.
/System	Database system. Permitted value is MSSQL.
/User	(Optional) Configuration of a system user's password (Person.DialogUserPassword). Multiple instances of this parameter are possible. DialogUser: Name of the system user (DialogUser.UserName). password: Password (plain text or password hash).
@file	As an alternative to directly issuing commands, you can name a text file containing the commands. Every command is in a separate line.
-v	(Optional) Provides additional information (verbose).
-? \| h	Display program help.

Example: Installing a database

quantum.migratorcmd.exe

--Install

/connection="Data Source=<Database server>;Initial Catalog=<Database>;User ID=<Database user>;Password=<Password>"

/module="TSB,ATT,CPL,HDS,POL,RMB,RMS,RPS"

/destination="C:\install"

Example: Restoring a database

quantum.migratorcmd.exe

--Restore

/connection="Data Source=<Database server>;Initial Catalog=<Database>;User ID=<Database user>;Password=<Password>"

/destination="C:\install"

/LogLevel=Warning

/precheck=-JobqueueEmpty

Identity Manager 8.2.1 - Operational Guide

InstallManager.CLI.exe

Calling syntax

Example: Installing a single module

Example: Updating a machine role

Example: Uninstalling the One Identity Manager components

DBCompilerCMD.exe

Calling syntax

Example:

Quantum.MigratorCmd.exe

Calling syntax for installation

Calling syntax for updating

Calling syntax for restoring a database

Calling syntax for passing parameters as a file

Example: Installing a database

Example: Restoring a database

AppServer.Installer.CMD.exe

Seleziona il prodotto:

Per una maggiore efficacia, compilare l'Obiettivo della chat:

Soluzioni consigliate per il problema

Identity Manager 8.2.1 - Operational Guide

InstallManager.CLI.exe

Calling syntax

Example: Installing a single module

Example: Updating a machine role

Example: Uninstalling the One Identity Manager components

DBCompilerCMD.exe

Calling syntax

Example:

Quantum.MigratorCmd.exe

Calling syntax for installation

Calling syntax for updating

Calling syntax for restoring a database

Calling syntax for passing parameters as a file

Example: Installing a database

Example: Restoring a database

AppServer.Installer.CMD.exe