Checklist

After completing the installation, here is a list of small tasks to go through to confirm the installation works as expected.


Login

For security reasons, logging in is only possible via HTTPS. Attempting to log in via HTTP produces the following error:

Access is forbidden

System Administrator

The system administrator can be used to create additional organizations.

Logging in to Relution as a System Administrator uses the credentials defined in the application.yml or in the environment variables.

application.yml

relution:
  system:
    admin:
      password: ""
      email: ""

Environment variables

SYSTEM_ADMIN_PASSWORD=""
SYSTEM_ADMIN_EMAIL=""

Organization administrator

Logging in to Relution as an organization administrator is also possible. If LDAP is used, make sure login works with at least one LDAP user account.

Test
Logging in with a local account is possible
Logging in with an LDAP account is possible

For security reasons, we strongly recommend changing the password after the first login.


Certificates

Make sure a connection to Relution is possible using the external hostname. Mobile devices can be stricter when it comes to verifying SSL certificates. Even if the desktop browser shows a valid HTTPS connection, the devices may reject the connection if some things are not configured properly. We strongly recommend using SSL Labs → to verify that everything is set up correctly.

Common errors.

  • Incomplete certificate chain (missing intermediate certificates). Chrome, Firefox, etc. can ignore this, but mobile devices may reject the connection.

  • Reverse proxy uses server name indication (SNI). This is not supported by some older Android versions. As a workaround, make sure that the MDM server’s certificate is the first one returned.


Mobile devices reject the certificate

Possible Cause.

  • The certificate chain may be incomplete. An incomplete chain is ignored by most desktop browsers, but may cause errors on mobile devices.

Solution

  • Use SSL Labs → to verify that the SSL certificate is set up correctly. The test takes about 5 minutes to complete. Fix any issues that are reported.

Mobile devices receive a different certificate

Possible Cause.

  • The server may be using Server Name Indication (SNI), which is not supported by all mobile devices.

Solution

  • Reconfigure the web server so that the first certificate returned is the one required by the mobile devices. The devices are not able to request a specific certificate and always use the first one sent by the server.

Database backups

Make sure a working database backup exists. This is important in case the hardware fails or an upgrade goes wrong.

Test
Relution’s database is included in automatic backups
The database can be restored (on another computer)

Current Relution Client Apps.

iOS

We always recommend using the Relution App Family for iOS from the public App Store. These are automatically imported into the Relution App Store.

Android

To use the native version of these applications directly in Relution, they are available here: Until Relution Server 5.10:

From Relution Server 5.11:


Support

For support purposes, allowing remote access to the Relution server can be useful. Consider enabling or installing remote access software such as Remote Desktop, SSH or TeamViewer. For the best possible security we recommend using SSH with key-based authentication.

Consider using a separate user account for support personnel (e.g., for audit purposes). The support staff usually needs read and write access to the installation directory and the ability to restart the Relution service. Relution service to restart.

Note that Relution support is usually chargeable.

Top