Identity Manager 8.2.1 - Operational Guide

NOTE: Unlike the default settings in the Web Designer, subprojects are not compiled at the same time. This means that when the VI_StandardWeb is compiled, the dI_UserRegistration_Web is not also compiled at the same time.

Calling syntax

VI.WebDesigner.CompilerCmd.exe

/conn {Connection string}

/dialog {Authentication string}

/project {path}

[/solution {path}]

[/mode {mode}]

[-E]

[-D]

[-R]

[/csharpout {folder}]

Table 63: Program parameters
Parameter	Description
/Conn	Database connection parameter. Alternatively, you can enter the name of the connection according to the registry HKEY_CURRENT_USER\Software\One Identity\One Identity Manager\Global\Connections.
/dialog	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.
/project	Name of the web project.
/solution	(Optional) This parameter specifies the Web Designer solution file to be used. If this parameter is not available, a database project is used.
/mode	(Optional) This parameter enables you to specify a compilation mode. Permitted values are: normal : Full compilation (default mode) nostore : No assemblies saved to the database. nocompile : C# code generation runs, but without compilation. nocodegen : Only Web Designer compilation, no C# code generation.
-E	(Optional) This parameter activates the detailed check. For more information about detailed checks, see the One Identity Manager Web Designer Reference Guide.
-D	(Optional) This parameter activates the debug compilation.
-R	(Optional) This parameter activates the generation of a stable C# text. This setting prevents use of certain random values.
/csharpout {folder}	(Optional) This parameter contains the target directory for C# text.
/help	Displays program help.

Example: Release compilation of the VI_StandardWeb

VI.WebDesigner.CompilerCmd.exe

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

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

/project VI_StandardWeb

Example: Debug compilation of the VI_User_Registration_Web

VI.WebDesigner.CompilerCmd.exe

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

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

/project VI_UserRegistration_Web

-D

Create-web-dir.exe

With the program Create-web-dir.exe you can create a One Identity Manager installation from a directory containing a One Identity Manager setup or from an installed One Identity Manager database. You can find the program on the installation media in the Modules\QBM\dvd\AddOn\SDK\LinuxWebInstall directory. You can run the program from the command line.

Calling syntax

create-web-dir.exe

[--mode=web|standalone]

--setup={Directory}|[--db-system=MSSQL|APPSERVER]

--db="{Connection string}"

--dest={Directory}

[ --modules={Module IDs}]

--targets= "{Targets}"

[--nlog={Path}\nlog.config]

[--web-config={Path}\Web.config]

[--web-app={URL}]

[--web-app-project={Web project}]

[--web-app-product={Product}]

[--web-app-auth={Authentifier}]

[--web-app-auth2={Authentifier}]

[--session-cert={Path}\SessionCertificate.pfx]

[--create-session-cert]

[--session-cert-issuer="{Issuer}"]

[--appserver-url={URL}]

[--auth="Module={Authentication string}"]

[--server-name --targets-from-server --config-from-server]

[--variable{Key=Value}]

[--nologo]

Calling the program

Windows: C:/installer/create-web-dir.exe

Linux: mono /installer/create-web-dir.exe

Table 64: Program parameters and options
Parameter or option	Alternative	Description
--mode		Installation mode. Permitted values are web (default) and standalone.
--setup	-s	Directory that contains the One Identity Manager setup and from which the installation is to be compiled. Specify either the directory containing the One Identity Manager setup or a database connection.
--db-system		Database system that should be connected as a source. Permissible values are MSSQL (default) or APPSERVER.
--db	-connect	Connection parameters to the database from which the installation is to be made. Specify either the directory containing the One Identity Manager setup or a database connection.
--dest	-d	Destination directory for the installation.
--targets	-t	Comma-delimited list of machine roles to be installed.
--modules	-m	Comma-delimited list of module IDs for installation. Optional, if the installation is to be done from an existing database.
--nlog	-n	(Optional) Path for the configuration file NLog.config.
--web-config	-w	(Optional) Path for configuration file Web.config.
--web-app		(Optional) URL for which a web application is to be created in the database.
--web-app-project		(Optional) Name of the web project (DialogAEDS.FileName) or UID of the web project (DialogAEDS.UID_DialogAEDS).
--web-app-product		(Optional) Name of the product for the web application (QBMProduct.Ident_Product) or UID of the product for the web application (QBMProduct.UID_DialogProduct).
--web-app-auth		(Optional) Name of the primary authentication module (DialogAuthentifier.Ident_DialogAuthentifier) or UID of the primary authentication module (DialogAuthentifier.UID_ DialogAuthentifier) for the web application.
--web-app-auth2		(Optional) Name of the secondary authentication module (DialogAuthentifier.Ident_DialogAuthentifier) or UID of the secondary authentication module (DialogAuthentifier.UID_ DialogAuthentifier) for the web application.
--session-cert	-c	(Optional) Path and name of the certificate file.
--create-session-cert		(Optional) Generate a new certificate if the specified certificate file does not exist.
--session-cert-issuer		(Optional) Publisher for the generated certificate file. Standard: "CN=Application Server"
--appserver-url		(Optional) URL of the application server to which the web application is to be connected.
--auth		(Optional) 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.
--config-from-server		(Optional) Fetches the configuration of the One Identity Manager Service for the Job server from the database and creates the configuration file in the destination directory. If this parameter is set, the --server-name parameter is required.
--targets-from-server		(Optional) Fetches the Job server machine roles from the database. If this parameter is set, the --server-name parameter is required.
--server-name		(Optional) Name of the Job server in the database (QBMServer table).
--variable	-v	(Optional) Replace the variables in the template files (NLog.config, Web.config) specified with %VariableName%. (Key=Value).
--nologo		(Optional) Specifies whether to display the startup banner and copyright information.
--help	-h, -?	Display program help.

Example: Installing an application server from a directory

create-web-dir.exe

-s=I:\Main\2020.07.28.001

-d=C:\Work\Install

-m=ADS,ARS,CAP,CPL,DPR,EBS,EX0,LDP,NDO,QBM,QER,RMB,RMS,SAC,SAP,SBW,SHR,SP0,TSB

-t=Server\Web\AppServer,Server\Web\AppServer\SearchCrawler,Server\Web\AppServer\SearchIndex

-w=\work\Config\Web.config

-n=\work\Config\nlog.config

-c=\work\SessionCertificate.pfx

Example: Installing an application server from the database

create-web-dir.exe

-d=C:\Work\Install

--db-connect="Data Source=<Server>;Initial Catalog=<Database>;User ID=<DB User>;Password=<Password>"

-t=Server\Web\AppServer,Server\Web\AppServer\SearchCrawler,Server\Web\AppServer\SearchIndex

-w=\work\Config\Web.config

-n=\work\Config\nlog.config

-c=\work\SessionCertificate.pfx

Example: Installing a Job server from the database with the default machine roles

create-web-dir.exe

--mode=standalone

-d=C:\Work\Install

--db-connect="Data Source=<Server>;Initial Catalog=<Database>;User ID=<DB User>;Password=<Password>"

-t=Server\Jobserver

--server-name=Server1

--targets-from-server

Example: Installing a Web Portal from the database

mono create-web-dir.exe

--db-system=MSSQL

--db-connect='Data Source=<Server>;Initial Catalog=<Database>;User ID=<DB User>;Password=<Password>'

--dest=/var/www/OneIMWeb

--targets="Server\\Web\\EndUserWebPortal"

--web-app-project="VI_StandardWeb"

--web-app-auth="RolebasedPerson"

--appserver-url=http://appserver1.localdomain/

--web-config=/tmp/web.config

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

Identity Manager 8.2.1 - Operational Guide

VI.WebDesigner.CompilerCmd.exe

Calling syntax

Example: Release compilation of the VI_StandardWeb

Example: Debug compilation of the VI_User_Registration_Web

Create-web-dir.exe

Calling syntax

Calling the program

Example: Installing an application server from a directory

Example: Installing an application server from the database

Example: Installing a Job server from the database with the default machine roles

Example: Installing a Web Portal from the database