Summary

This instruction includes two paths when installing a Fortified ID product on Windows.

1. You do NOT have internet access from your target Windows server. If you have internet access SKIP this step and go to step 2.

   1. Follow https://docs.fortifiedid.se/installation/windows/download-jre-and-artifact

2. If you have internet access or have completed step 1, then it is time to installation.

   1. Follow https://docs.fortifiedid.se/installation/windows/install-on-windows

Note! If you have internet access from the Windows server, skip this use case and go to next use case, "Install on Windows".

Prerequisite

• A host that support Powershell. (E.g. Windows 11 or Windows 2019)

• Download scripts to do an offline download of JRE and Fortified ID artifact. Contact Fortified ID on info@fortifiedid.se to get download scripts.

• Credential file to access Fortified ID product area. Contact Fortified ID on info@fortifiedid.se to get credentials.

• Correct download URL for the product you like to install. Contact Fortified ID a info@fortifiedid.se to get correct URL.

Download installation scripts

Download installation scripts

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

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.

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

1. download_artifact_and_jre.ps1

2. download_artifact_and_jre.properties

3. customer_access_credentials.json

Download of installation data

Prepare download_artifact_and_jre.properties

Update download_artifact_and_jre.properties with the application you like to download.

1. Open download_artifact_and_jre.properties

2. Add the URL for the app to download. Locate the two lines below.

   Copy

   # Downlad product link
   APP_LINK=## Contact Fortified ID for correct version ##

3. Change download location if you like. (we will use default in this use case)

   Copy

   ## Where should JRE and Fotified ID product be downloaded to
   DOWNLOAD_LOCATION=c:\temp\

4. The script also support use of proxy for access if you have that demand.

   Copy

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

5. Save download_artifact_and_jre.properties

Run script to download installation data

Note. verify that you have the three files mentioned above in c:\temp.

1. Open a Windows PowerShell prompt on the Windows download computer. Make sure your run the prompt as an administrator.

2. In the PowerShell prompt, go to folder c:\temp. See command below.

   Copy

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

3. In the PowerShell prompt, execute download_artifact_and_jre.ps1. See command below.

   Copy

   PS C:\temp> .\download_artifact_and_jre.ps1

4. When script is completed you should two new files in c:\temp

   1. fortifiedid-jre.zip

   2. integrity-server-2.0.0-RC30-dist.zip (this is an example. You should see a zip-file with the name of the artificat you downloaded)

5. Move the two files to the windows server where you should do the installation.

To install a Fortified ID product on Windows, see use case Install on Windows

Note! This use case, "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 "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 info@fortifiedid.se for installation scripts.

• Credential file to access Fortified ID product area. Contact Fortified ID on info@fortifiedid.se to get credentials.

• Correct download URL for the product you like to install. Contact Fortified ID a info@fortifiedid.se 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

   Copy

   ## 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=https://share.fortifiedid.se/index.php/s/NMCwXXRMSpcFjtA/download

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

3. Verify installation path on your Windows server

   Copy

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

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

   Copy

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

5. If you need to use a proxy, uncomment the three commented lines.

   Copy

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

6. Uncomment the product to install (not you can only install one product at time). You only uncomment four of the five rows. First row should not be uncomment. See example below where WEB should be installed

   Copy

   ## Install Fortified ID WEB
   # APP_LINK=URL or path and filename to pre downloaded file
   # APP_NAME_FOLDER=web
   # APP_NAME=Fortified ID Web
   # APP_DESCRIPTION=Fortified ID Web 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 predownloaded 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/2.0.0-RC30/integrity-server-2.0.0-RC30-dist.zip

      2. APP_LINK=integrity-server-2.0.0-RC30-dist.zip

7. Save install_fortifiedid_product.properties

Install/upgrade application

To install/upgrade application we use a PowerShell script.

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

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

   Copy

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

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

   Copy

   PS C:\temp> .\install_fortifiedid_product.ps1

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

   Copy

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

5. 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.

   Copy

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

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

   Copy

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

7. 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