Miscellaneous

• 1: Changelogs
• 2: Data Backup and Maintenance
• 3: Logs
• 4: Setup on Windows
• 5: Bill of Materials
• 6: Install Self-Signed Certificate
• 7: Create PFX

1 - Changelogs

v1.0.1

Release Date: 2024-11-19

Features

• Support for IQ-Software V8.0
• Azure (Entra) integration

Fixes

• Minor bug fixes

v1.0.0

Release Date: 2024-11-06

Features

• Server support for IQ-Software V8.0
• Candidate approval workflow
• Local user management
• LDAP integration
• Role-based access control (RBAC) (No Enforcement)
• User and group management

2 - Data Backup and Maintenance

Backup

Stop server and copy the .db and .data directory to a safe location. You might need sudo rights for this.

Maintenance

We automatically run some maintenance tasks on the database every week on Sunday at 04:00 (Server time).

3 - Logs

Application Logs

In the .logs directory, you can find all the logs generated by the server.

Container Logs

There are also some logs generated by OCI containers. You can find them in the /var/lib/docker/containers (or equivalent if you are using something else) directory. For database, 10x 10mb files are retained. For application, 10x 100mb files are retained.

4 - Setup on Windows

Prerequisites

• Latest Windows Version with WSL2 Support
  • Recommended: Windows Server 2022
  • Should Work: Windows 11 23H2+
• Access to Windows Store
• Internet Connection

Installation Steps

1. Install: Ubuntu LTS on Windows Store
   • Alternatively, open Windows Store, Search for Ubuntu (by Canonical Group Limited) and Install it
2. Open Ubuntu from START and follow the instructions to set up your user inside WSL Ubuntu
3. Install Docker Engine with Docker Compose Plugin
   • (Recommended) Uninstall Old Versions
   • From the official Docker website: Install Docker Engine
     • This involves two steps: add canonical apt repository and then installing docker engine
4. Once done, optionally type: cd ~ && mkdir cdm && cd cdm
5. Now that you have a working linux inside windows, you can follow the CDM-Server installation on linux steps: See here
6. After the installation, you can find the CDM-Server in ~/cdm directory

Troubleshooting

• I can access CDM-Server from the server computer but not from other devices
  • Check your firewall settings and make sure the port is open
  • The specified CDM_HOST should resolve to the server’s IP address
• I want to run CDM-Server as a service in Ubuntu
  • You need to follow WSL2 Systemd Guide to run services in WSL2

5 - Bill of Materials

CDM-Server SBOM

We provide the SBOM in OWASP’s CycloneDX v1.5/v1.6 format which has been officially ratified as an Ecma International standard.

You can find the SBOM for CDM-Server here:

• v1.0.1: JSON | Summary
• v1.0.0: JSON | Summary

Additional Information

CDM-Server also utilizes:

• Java 21 (Temurin 21.0.5)
• PostgreSQL v16.4 (postgres:16-alpine)
• Ubuntu 24.04
• pg_repack 1.5.0
• Bulma 0.9.4
• font-awesome 6.1.2
• jsonld 1.0.0
• zxcvbn 4.4.2

6 - Install Self-Signed Certificate

Manual Installation Steps

First, you receive the certificate from the administrator. Then, you can install it using the following steps:

7 - Create PFX

At the moment, we only support .pfx file for custom certificates. If you have a different format, you can convert it to .pfx using the following command:

openssl pkcs12 -export -out cdm-server.pfx -inkey example.key -in example.cer -certfile fullchain.cer

Where:

• example.key: Your private key file.
• example.cer: Your certificate file.
• fullchain.cer: The additional CA certificate chain.