- Updated on 17 Sep 2019
- 7 minutes to read
The following document is a walkthrough to installing the Decisions Platform on an App Server or PC. Decisions requires a database and in this guide we will use SQL Server.
Open the installer executable to begin the installation wizard.
In the first step - Installation Type - click the Install button.
After reading the license agreement, select the I accept the terms of the License Agreement checkbox, and click the Next button.
Next, in the Select Installation Type step, we choose a type that fits our needs (in this case Personal Server ).
Below is a description of when each type would be used:
|Standard Server||This is the most common type of server installation and can be used in production (live) or non-production (development) settings. Use this server type when you want to be able to log into the server from other machines, to allow others to log into the server (for example, for QA cycles), and to publish your flows.|
|Personal Server||This server type is strictly a local installation. Use this server type when you want to build and test Flows, Forms, Rules, Reports, and Pages, but you do not intend to publish them. This server type also does not let other machines log on.|
|Failover (HA) Server||This server type is identical to the Standard Server except that it is not live until it is triggered. Use this type to install a failover server that will be available but will not run jobs or events on startup.|
|Designer Repository||This server type stores entities and manages versioning. It does not run live applications.|
To configure advanced settings during your installation, select the Show Advanced Settings checkbox or, clear the checkbox to install Decisions OS with a standard configuration.
Select the desired options:
|Use Settings File||Enables a field in which you can select a file of saved settings from a previous installation|
|Install Emergency Password Reset Tool||installs command line tool that can be used to reset user passwords in Decisions.|
|Change Default System Administrator, Username and Password||option to change default Decisions “firstname.lastname@example.org”:”admin” credentials.|
|Change Destination Folder for Installation||By default, the Decisions software is installed to C:\Program Files\Decisions. If desired, change this location by enabling this setting and browsing to the desired installation location.|
|Pick Alternate Source||Enables either a URL or directory to select for the installer files.|
|Install Extra Icons||Enabling this setting installs the image library of icons available for use (which can be used as icons for items posted to the Service Catalog, for example, or to represent published workflows) Images are installed to C:\Program Files\Decisions\Images by default.|
|Show the Service Settings||Enabling this setting makes it possible to customize the user name/password under which the Service Host Manager Service will run.|
|Allow Dynamic Resource Loading (Local Module)||allows system to store and load sources from Local Module.|
|Run Service Host Manager Watcher after Installation||If enabled, the Host Manager Watcher service will run after installation. This is the process that can start and stop the 'Service Host Manager' that the Portal depends upon, as well as watches and restarts it if it stops for any reason.|
|Skip DB Connection Testing (Not Recommended)||skipping database connection test in Installation wizard.|
|Dynamic Compression (IIS) Check Disabled (Not Recommended)||disables installer to checkIIS Compression.|
Click the Next button
Under Database Setup, Database Type , select the MS SQL option. Under the Connection Type , select Basic or Custom Connection String and fill in the DB Server and DB Database fields with the server location and name of the database.
If the database does not exist, Decisions OS will attempt to create it. To test these connection settings, click the Test button.
Under Connection Settings , choose the option for Windows Integrated Security to enable database connection authentication using Windows Integrated Security, or MS SQL Server Security to enable database connection authentication using a specified username and password.
To continue installation, click Next .
Fill in the Base Url field with the URL where users will go to access the portal. To redirect all requests for the root host to the portal URL, select the Redirect Root http(s) requests to Base URL above checkbox.
In the Web Application screen, under Web Site , select the site in IIS under which Decisions will install.
Also, select desirable Application Pool.
For many standard features to work, Decisions OS requires access to a mail server with which it can send email.
To configure a connection to an SMTP server, select the SMTP Server option and fill in the required connection fields. To configure this connection later, or to configure Decisions OS to look for an SMTP server running on the local machine, select SMTP Direct Server.
In the Encryption Keys window we can restore database encryption keys from the file.
To add these rights, go to Administrative Tools > Local Security Policy > Local Policies > User Rights Assignment.
Edit the item "Log on as a service" and add your domain user.
Finally, the installer will automatically perform tests of the installation environment to ensure that it meets the operational requirements to run Decisions.
When all of the system requirement checks have successfully completed, click the Next button.
The installer will list the configuration settings for this installation.
In the event a reinstallation or recovery, save these installation settings for future reference by selecting the Save Installation Settings to File checkbox.
Click the Next button.
As part of the process, the installer will automatically download, register, and configure any required third-party services or utilities.
As this is happening, you may click the Show Details and Hide Details buttons to toggle a report of what's happening behind the scenes.
When the installation is complete, the installer displays a completion message.
Click the Finish button to close the installer and open portal. Use the administrative credentials that are provided on the screen to log into the portal.
After clicking Finish you will be redirected to the login page.
If Decisions was installed on local machine we can see localhost/decisions/... in the browser address bar.
If using a different address to install the Portal then something similar to 192.168.1.3/decisions/... would be in the browser address bar.
After so, click Login which will redirect to the Portal Home page
Updating the license
License Utility- Computers can be licensed to run the platform with third-party plugins or with the built-in licensing mechanism.
To license a machine using License Utility, open the executable and email the Machine Key it generates to "email@example.com"
The tech support team will respond with a license key which can be copy and pasted into License Utility and applied to generate a license key file.
Our example assumes that the platform has been installed in the default path.
- To access the license utility, navigate to the folder C:\Program Files\Decisions\Decisions Services Managerlicensing.
- Run the LicenseUtility.exe. The License Utility dialog box appears.
License Utility generates a unique string for this machine in the Machine Key field.
- Select the string in the Machine Key field and copy it to your clipboard.
- Paste the machine key into an email and send it to your contact for generating licenses.
Using the machine key you've provided, your license key will be generated and provide it to you.
- When you receive the license key, in the License Utility , paste the license key into the License Key field.
- Click the Apply button.
A pop-up alert will notify you when your license key is due to expire.
After updating the license, restart the Service Host Manager.