2 - Install on Windows

Install or upgrade a Fortified ID product on a Windows server.

Note! This use case, "2 - Install on Windows", will install a Fortified ID product online or using downloaded files. If you do not have internet access on the server which you are going to install on, go to use case "1 - Download JRE and Artifact for Windows" to download requested files.

Prerequisite

• Windows server 2019 or later. Local or cloud instances like AWS or Azure for example.

• Installation scripts to do an Fortified ID product installation. Contact Fortified ID on [e-mail] for installation scripts.

• Credential file to access Fortified ID product area. Contact Fortified ID on [e-mail] to get credentials.

• Correct download URL for the product you like to install. Contact Fortified ID a [e-mail] to get correct URL.

Prepare for installation or upgrade

Installation scripts

There are three files to be used when installing a Fortified ID product

1. Note. You need a Windows host with a later version of Powershell as you download computer.

2. There are three files to use when downloading a Fortified ID product offline. If you do not have the three scripts, check the prerequisite section.

3. We will put the three files in c:\temp in this use case.

   1. install_fortifiedid_product.properties

   2. install_fortifiedid_product.ps1

   3. customer_access_credentials.json

Installation/upgrade

Prepare install_fortifiedid_product.properties

Update install_fortifiedid_product.properties with the application you like to install.

1. Open install_fortifiedid_product.properties

2. Verify installation path on your Windows server

   ## JRE location
   ## Use link below if you have internet access. If you have downloaded the JRE, then add the file and path instead of the URL.
   JRE_LINK=<contact Fortified ID for latest version link of JRE>

   Note. If you have downloaded the JRE in advanced the JRE_LINK value should look like: JRE_LINK=c:\temp\fortifiedid-jre.zip

3. Verify installation path on your Windows server

   ## Path where the Fortified application will be installed
   INSTALLATION_PATH=C:\Program Files

4. Change memory for the application to use if needed.

   ## Assign memory allowed to be used by application
   assignedMemory=2048
   threadStackSize=1024

5. If you need to use a proxy, uncomment the three commented lines. Note. Ignore this if you have downloaded files in advanced.

   ## Proxy settings. Uncomment properties below to configure proxy settings.
   # PROXY_HOST=http://proxy:8080
   # PROXY_USER=username
   # PROXY_PASSWORD=password

6. See example below for Fortified ID Access. Verify that you have correct information for the product you will install.

   ## Install Fortified ID Access
   APP_LINK=<URL or path and filename to pre downloaded file>
   APP_NAME_FOLDER=Access
   APP_NAME=Fortified ID Acess
   APP_DESCRIPTION=Fortified ID Access is an Identity Provider that manage authentitcation, authorization control and single sign-on.

   1. The APP_LINK value depend if you have online access or if you have pre-downloaded the artificat. Below is two examples how it can look like:

      1. APP_LINK=https://fortifiedid.jfrog.io/artifactory/default-fortifiedid-libs-release-local/fortifiedid/integrity-server/3.0.0/integrity-server-3.0.0-dist.zip

      2. APP_LINK=integrity-server-3.0.0-dist.zip

7. Save install_fortifiedid_product.properties

Install/upgrade application

To install/upgrade application we use a PowerShell script.

1. If you doing an upgrade. Take a copy of the /customer folder and stop the service for the application you are about to install.

2. Open a Windows PowerShell prompt on the Windows server. Make sure your run the prompt as an administrator.

3. In the PowerShell prompt, go to folder C:\temp. See command below.

   PS C:\Windows\system32> cd C:\temp

4. In the PowerShell prompt, execute install_fortifiedid_product.ps1. See command below.

   PS C:\temp> .\install_fortifiedid_product.ps1

5. Type y to start installation. (Below we install Fortified ID Access as an example)

   This will install/upgrade [Fortified ID Access].
   All data in:
   C:\Program Files\FortifiedID\access\application &
   C:\Program Files\FortifiedID\access\jre will be replaced.
   Do you want to continue? (y/n):

6. If you doing an upgrade you will get a question to backup the /application and /JRE folder. The files will located in a zip-file in a /backup folder. Note. The customer folder will nerver be touched doing an upgrade. Those files are protected.

   Do you want to backup application before proceeding with installation? (y/n):

7. Type y/n depending if you like to start service

   Installation/upgrade is complete.
   Do you wish to start service: (y/n):

8. Installation is now complete!

Verify installation/upgrade

Verify when clean installation

Verify files

1. Open Windows Explorer

2. Go to C:\Program Files\FortifiedID\<app you installed>

3. You should find three folders

   1. jre

   2. application

   3. customer

   4. backup (you might have a backup folder depending on what you ansewerd during the upgrade and if you did an upgrade)

Verify service

1. Open Windows Services

2. Verify that service Fortified ID <app you installed>exists

Using "RC releases"?! Note that only last 5 are stored and are frequently replaced with new and cannot be regenerated.