Core Setup Command Line
Use these commands to install Digital.ai Agility Core from the command line.
Setup [action] [instance] [options]
Action
Action | Description |
---|---|
(none) | Install a new instance |
-r | Repair (or upgrade) an existing instance |
-u | Uninstall an existing instance |
Instance
The instance name cannot contain spaces or special characters. For a New Instance, you will enter the name that you want to call the instance. This will be part of the URL, so make sure you select an appropriate name for your new instance.
For an Upgrade, the easiest way to see what the instance name needs to be in the command line is to run the installer in Wizard mode (double-click the installer executable), select Upgrade, and look at the list of Digital.ai Agility instances listed on the "Select from these installed instances" dialog. The name you need to use in the command line is the full name that shows up on the "Select from...." dialog, minus the version number in parentheses. This also applied to command line Uninstalls.
Options
Options begin with a dash or slash. Values are supplied to an option following a colon or equal-sign. For example:
-Edition:Team
/DBName=VersionOne
These options are available:
Option | Description |
---|---|
-quiet[:2] | Suppresses the wizard and message boxes. A value of 2 also suppresses the progress dialog. |
-LogFile:<filename> | Choose a different name for the Setup log. The default is setup.log. |
-Edition:<Team | XP |
-WebSiteRootPath:<iis-path> | Choose the website to which to install this instance. In hosted production: IIS://localhost/W3SVC/100/ROOT |
-DbServer:<server> -DbName:<database> -DbUser:<username> -DbPassword:<password> | Configure and provide access to SQL Server for Setup, and this instance. <server> defaults to "(local)"<database> defaults to instance name Without <username> and <password>, Setup uses integrated authentication to access SQL Server. |
-AuthMode:<V1 | IIS> |
-SigningKey:<32 bytes in HEX> | Set the encryption key used to sign the authentication Tickets held in cookies and OAuth2 grant records. Otherwise read from registry or randomly generated. |
-AdminUsername:<account> | (In AuthMode IIS) Choose the Windows account name that will be associated with the first admin (or "Admin 20") |
-UseExistingUser:<false | true> |
-ServerBaseUrl:<base-url> | Set the client-friendly scheme and host (and port) for generating absolute URLs back into the application. Used for putting links into emails. For example: https://www7.v1host.com |
-SmtpHostName:<host> -SmtpFromAddress:<email> | Configures and enables SMTP. |
-ForceDbUpgrade | Forces the execution of database scripts, even if the thumbprint indicates they are not needed. |
-DeleteDatabase | When uninstalling this instance, delete the data also. The default is to not delete. |