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}\appsettings.json]
[--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
| 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 appsettings.json. |
| --web-app |
|
(Optional) URL for which a web application is to be created in the database. |
| --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, appsettings.json) 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\appsettings.json
-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\appsettings.json
-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