Windows Server deployment

This configuration directly run the Digital Enterprise Server jar as a Windows service instead of running in a docker container. All configuration is done in a xml file instead of environment variables.

Prerequisites

• Java 11 (due to license restriction on the oracle distribution openjdk should be preferred)

• Certificate with key (for tls)

• Digital Enterprise Server bundle

• Digital Enterprise Server jar (can be obtained from the Trisotech Support team)

Configuration

Extract the Windows bundle in the Digital Enterprise Server installation folder (can be anything but must not be deleted after installation) and edit the DES_service.xml file.

• Change the DES_STORAGE line with the path of the .enterpriseserver data folder

  Name	Value
  DES_DATA	The location of the .enterpriseserver folder

  <env name="DES_STORAGE" value="<DES_DATA>"/>
  

• If HTTPS is required apply the following modifications to the file:

  Name	Value
  CERTIFICATE	the name of the PKCS12 file located in the installation folder
  CERTIFICATE_PASSWORD	the password associated with the PKCS12 file

  <service>
  
    ...
  
    <!-- HTTP -->
    <!--
    <arguments>
      -XX:+ExitOnOutOfMemoryError
      -Xshare:off
      -Dserver.port=8181
      -jar "%BASE%\des.jar"
    </arguments>
    -->
  
    <!-- HTTPS -->
    <arguments>
      -XX:+ExitOnOutOfMemoryError
      -Xshare:off
      -Dserver.port=443
      -Dserver.ssl.key-store-type=PKCS12
      -Dserver.ssl.key-store=file:<CERTIFICATE>
      -Dserver.ssl.key-store-password=<CERTIFICATE_PASSWORD>
      -jar "%BASE%\des.jar"
    </arguments>
  
    ...
  
  </service>
  

  Note

  PKCS12 bundle can be created from PEM file using the following command:

  Name	Value
  KEY	the key file associated with the certificate
  CERT	the certificate file
  PASS	the PKCS12 password
  PKCS12	the generated PKCS12 file

  openssl pkcs12 -export -in <CERT> -inkey <KEY> -out <PKCS12> -password pass:<PASS>
  

  Note

  PKCS12 bundle can also be generated from an existing JKS (Java Key Store):

  Name	Value
  JKS	Java key store file
  PKCS12	PKCS12 file

  keytool -importkeystore -srckeystore <JKS> -destkeystore <PKCS12> -deststoretype pkcs12
  

Installation

The service can be managed with .cmd files in the installation folder.

File	Description
install	install the Windows service
uninstall	uninstall the Windows service
start	start the Windows service (started automatically on reboot)
stop	stop the Windows service
restart	restart the Windows service

Note

Digital Enterprise Server log files are located in the installation folder as DES_service.err and DES_service.out.

Digital Enterprise Server CLI

The Digital Enterprise Server is managed by a command line utility named des-cli. The command line utility must be used within the DES installation folder.

Upgrades

Upgrades can be done by simply executing the stop command, overwriting the des.jar / des-cli.jar with new files and executing start.