Diese Seite ist nur auf Englisch verfügbar.

Installation guide

Use installation specific passwords and ensure that passwords are being stored in a safe place. In the following parts, the safe place is referred to as Keepass.

After the initial deployment, the Deviceportal components are started as Kubernetes pods. Please refer to chapter 2 for a description of the components.

The system can be accessed via the Nexeed IAS Portal:

Name Address Credentials Information

User interface

https://<NEXEED_HOST>

username, password and NEXEED_HOST are specified in the custom-values of the corresponding environment as macmaPortalAdminUser, macmaPortalAdminPassword and nexeedHost, respectively.

Interface to manage MACMA. This includes tenant and contract creation. Each created tenant needs to be further configured to have the appropriate users, groups and modules.

Prerequisites pre-deployment

These prerequisites can be taken care of before a deployment was done. These are required to have a fully functional Deviceportal.

  • Ensure that MACMA and Portal are either

    • part of the Nexeed deployment, or

    • that there are instances of these modules hosted elsewhere where the Device Portal can be integrated

  • A supported database is available. This could be part of IaC scripts or a manually booked database

  • Environment specific custom-values are prepared. See chapter configuration

  • A DNS record is booked for the mTLS endpoints and referenced in the corresponding Helm variable <.Values.global.modules.deviceportal.mtlsGateway.deviceDomain>

  • For OpenSearch, each Kubernetes cluster node is required to have the vm.max_map_count property set to 262144. See OpenSearch documentation. This could be part of IaC scripts or manually configured (requires cluster access)

  • The Ingress Controller must have the following configurations:

  • Helm version 3.10 or higher

  • Wildcard Server certificate is ordered. The server certificate must contain SAN entries for…​

    • Nexeed Portal domain

    • Wildcard domain for Nexeed modules (in case of subdomain deployment)

    • mTLS domain (for device access - only if needed to provide a stable environment agnostic endpoint for devices)

    • Wildcard tunnel subdomain (for user access)

  • If a subdomain deployment is used, the SAN names of the server certificate would be:

    • <NEXEED_HOST> (Nexeed Portal domain)

    • *.<NEXEED_HOST> (Wildcard domain for Nexeed modules including a subdomain certs for mTLS)

    • *.tunnel.dp.<NEXEED_HOST>

  • For an Azure cloud deployment it is necessary to activate HTTP/2 support (via PowerShell or the Azure UI: 'Application gateway'→'Configuration'→'HTTP2: enabled') - in case HTTP/1.1 support is not sufficient. This is e.g. the case for deployments where ctrlX CORE devices are used (as the remote access to the UI of the device will otherwise not work correctly).

Prerequisites post-deployment

These prerequisites can only be taken care of after a deployment was done. These are required to have a fully functional Device Portal.

Edit this pageDiese Seite bearbeiten

Feedback on this pageFeedback zu dieser Seite