Installing on Windows

This document gives an overview of how to install Signing Workflow on Windows.

Audience

This document is written for system administrators.

Prerequisite

- Internet access from the server (during the installation phase)

- Downloaded the Signing Workflow application (signing-workflow-phenixid-<version>-lib.zip) from files.phenixid.se

Hardware

A single instance of Signing Workflow will require a minimum of 2 CPU, 4 GB of RAM and 25 GB of drive space. Setups may differ based on expected load, number of users, number of signatures etc. Please contact PhenixID support for guidance.

Note that depending on the admin rights of the user logged in during installation "Run as administrator" may be required. If possible this should always be done.

Installation

Java

  1. Download Java JRE msi package from https://www.azul.com/downloads/zulu-community/?version=java-11-lts&os=windows&architecture=x86-64-bit&package=jdk
    (Change architecture to suit your environment if needed)
  2. Execute .msi package
  3. Follow the guide, use default settings or change the installation folder to suite your needs.

Signing Workflow

  1. Unzip signing-workflow-phenixid-<version>-lib.zip to any folder that suite your needs, for example "C:/PhenixID/"
  2. Rename the folder "digo" to "SigningWorkflow"
  3. Make sure the folder structure looks like this after installation.

Install Windows Service

  1. Create a folder, "service", in the SigningWorkflow folder
  2. Download Apache Commons Daemon 1.2.4 from https://downloads.apache.org/commons/daemon/binaries/windows/commons-daemon-1.2.4-bin-windows.zip
  3. Unzip the downloaded file into the service folder to create a structure like "...SigningWorkflow/service/commons-daemon-1.2.4-bin-windows/

4. Open installservice.ps in a text editor
5. Change the JAVA_HOME parameter to point to your Java installation.
Example:
$JAVA_HOME = "C:\Program Files\Zulu\zulu-11"

6. Save the file
7. Run Powershell as an administrator
8. Change directory to SigningWorkflow
9. Run installservice.ps
10. The Windows service should now have been installed.

Post Installation

Please continue with the post-installation tasks that are described in a separate document which can be found here.