Using the program WebDesigner.InstallerCMD.exe, you can install and uninstall the Web Portal using the command line console.
NOTE: Run the installation using the command line console in administrator mode.
Calling syntax for installation
WebDesigner.InstallerCMD.exe
[/prov {Provider}]
/conn {Connection string}
/authprops {Authentication string}
/appname {Application name}
/site {Site}
[/sourcedir {Directory}]
[/apppool {Application pool}]
[/webproject {Web project}]
[/constauthproj {Subproject name} /constauth {Authentication}]
[/searchserviceurl {url}]
[/applicationtoken {Token}]
[/updateuser {User name} [/updateuserdomain {Domain}]
[/updateuserpassword {Password}]]
[/allowhttp {true|false}]
[-f]
[-w]
Calling syntax for uninstalling
WebDesigner.InstallerCMD.exe
[/prov {Provider}]
/conn {Connection string}
/authprops {Authentication}
/appname {Application name}
[/site {Site}]
-R
Calling syntax for uninstalling earlier Web Portal versions back to and included version 6.x
WebDesigner.InstallerCMD.exe
/appname {Application name}
[/site {Site}]
-R
|
Parameter or option |
Description |
|---|---|
|
/Prov |
(Optional) Database provider – permitted values are VI.DB.ViSqlFactory, VI.DB and QBM.AppServer.Client.ServiceClientFactory, QBM.AppServer.Client. |
|
/Conn |
Database connection parameter. A user with a minimum access level of Configuration user is required. 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. |
|
/authprops |
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. |
|
/appname |
Application name. |
|
/site |
Internet Information Services web page on which to install the application. |
|
/sourcedir |
(Optional) Installation source. If this parameter is set, the installation is performed from the file system. If this parameter is not set, the installation is performed from the database (default). |
|
/apppool |
(Optional) Application pool. If this parameter is set, the installation is performed in the specified application pool. If this parameter is not set, a new application pool is installed (default). |
|
/webproject |
(Optional) Name of the web project. If this parameter is set, the specified web project is installed. If this parameter is not set, the web project VI_StandardWeb is installed (default). |
|
/constauthproj |
Name of the subproject. |
|
/constauth |
Authentication settings of the subproject. |
|
/searchserviceurl |
Application server for search function availability. |
|
/applicationtoken |
Application token for the Password Reset Portal. |
|
/updateuser |
(Optional) User for updating. If no user is given, the same user account is used for the application pool. |
|
/updateuserdomain |
Active Directory domain of the user. |
|
/updateuserpassword |
User password. |
|
/allowhttp |
(Optional) If the parameter is set, HTTP is permitted. If this parameter is not available, HTTPS is used (default). |
|
-w |
(Optional) Type of authentication used for the web application. If this parameter is set, Windows authentication is used. If this parameter is not set, anonymous authentication is used on IIS (default). |
|
-f |
(Optional) If this parameter is set, no permissions are allocated for the IIS_USRS user. If this parameter is not set, the permissions are allocated for the IIS_USRS user (default). |
|
-R |
Removes the web application. |
|
/? |
Displays program help. |
Example: Installation with a direct connection against a SQL Server database.
In this example, the parameters are configured as follows:
-
Connection to database on a SQL Server
-
Installation in the default website
-
Application name testqs
-
Authentication with system user testadmin
-
Application server for the availability of the search function https://dbserver.testdomain.lan/TestAppServer
-
Allow HTTP
WebDesigner.InstallerCMD.exe
/conn "Data Source=dbserver.testdomain.lan;Initial Catalog=IdentityManager;Integrated Security=False;User ID=admin;Password=password"
/site "Default Web Site"
/appname testqs
/authprops "Module=DialogUser;User=testadmin;Password="
/searchserviceurl https://dbserver.testdomain.lan/TestAppserver
/allowhttp true
Example: Installation with a direct connection to an application server
In this example, the parameters are configured as follows:
-
Connection to application
-
Installation in the default website
-
Application name testviaappserver
-
With Windows authentication as web authentication
-
User for the updating User1 with the domain MyDomain.lan
WebDesigner.InstallerCMD.exe
/prov "QBM.AppServer.Client.ServiceClientFactory, QBM.AppServer.Client"
/conn "URL=https://test.lan/IdentityManagerAppServer/"
/site "Default Web Site"
/appname testviaappserver
/authprops "Module=DialogUser;User=testadmin;Password="
-w
/updateuser User1
/updateuserdomain MyDomain.lan
/updateuserpassword topsecret
Example: Uninstalling the web application with a connection against an application server
WebDesigner.InstallerCMD.exe
/prov "QBM.AppServer.Client.ServiceClientFactory, QBM.AppServer.Client"
/conn "URL=https://test.lan/IdentityManagerAppServer/"
/appname testviaappserver
/authprops "Module=DialogUser;User=testadmin;Password="
-R
Example: Processing of authentication settings for a subproject
WebDesigner.ConfigFileEditor.exe
-constAuth ../web.config "test_UserRegistration_Web" "Module=DynamicPerson;User[test_USER]=xyz;(Password)Password[test_Password]=xyz;(Hidden)IgnoreMasterIdentities=;(Hidden)Product=Manager"