Cloud Portal ONE Desktop ONE DQ&C ONE MDM ONE RDM ONE Runtime Server
latest (16.3.0) 16.2.0 16.1.0 16.0.0 15.4.0 15.3.0 15.2.0 15.1.0 14.5.x 13.9.x 13.8.x 13.7.x 13.6.x 13.5.0 13.4.x 13.3.x 13.2.x
User Community Service Desk Downloads

Configuring ONE Desktop

The following article will guide you through the configuration of ONE Desktop.

Before connecting ONE Desktop to ONE, the following modules need to be deployed and running:

  • Configuration Service

  • Data Processing Module (DPM)

  • External dependencies, such as Keycloak and ONE Object Storage.

Create a ONE Desktop deployment

Configuration procedure

  1. Open Browser.

  2. Navigate to localhost:8011 (Configuration Service).

  3. In Deployments select Desktop Deployment.

  4. Click Edit.

  5. Turn Public Deployment on.

  6. Click Save.

  7. Navigate to Constants.

  8. Select Fixed.

  9. Find ataccama.one.platform.deployments.dpm-dev.security.jwt-keys.dpm-dev-key.content property.

    one desktop configuration desktop deployment

  10. Save the value of this property into a temporary text file.

  11. Return to Deployments.

  12. In Deployments select Desktop Deployment.

  13. Update the deployment configuration as follows:

    1. Replace the default properties with the following customized configuration:

      Desktop Deployment Properties
      desktop_deployment_application.properties
      ## URL of an MMM GraphQL endpoint (host:port) [string]
ataccama.desktop.mmm.url=localhost:8021/graphql

## Host of an MMM gRPC endpoint [string]
ataccama.desktop.mmm.host=localhost

## Port of an MMM gRPC endpoint [string]
ataccama.desktop.mmm.port=8521

## Host of an DPM gRPC endpoint [string]
ataccama.desktop.dpm.host=localhost

## Port of an DPM gRPC endpoint [string]
ataccama.desktop.dpm.port=8531

## DPM public key [string]
ataccama.desktop.dpm.public.key=<replace with value of ataccama.one.platform.deployments.dpm-dev.security.jwt-keys.dpm-dev-key.content>
      Desktop Deployment Properties for Remote Deployment

      For remote deployment you need to replace all localhost values with the actual address of your remote servers as shown in example below.

      desktop_deployment_application.properties
      ## URL of an MMM GraphQL endpoint (host:port) [string]
ataccama.desktop.mmm.url=http://onetestdeploy04.sol.prg-krl.atc:8021/graphql

## Host of an MMM gRPC endpoint [string]
ataccama.desktop.mmm.host=http://onetestdeploy04.sol.prg-krl.atc

## Port of an MMM gRPC endpoint [string]
ataccama.desktop.mmm.port=8521

## Host of an DPM gRPC endpoint [string]
ataccama.desktop.dpm.host=http://onetestdeploy04.sol.prg-krl.atc

## Port of an DPM gRPC endpoint [string]
ataccama.desktop.dpm.port=8531

## DPM public key [string]
ataccama.desktop.dpm.public.key=<replace with value of ataccama.one.platform.deployments.dpm-dev.security.jwt-keys.dpm-dev-key.content>

    2. Replace the value of ataccama.desktop.dpm.public.key property with the value you have saved previously in Step 11.

      one desktop configuration configuration desktop

  14. Click Configure Platform.

  15. In Deployment Properties under Unselected, find the DPM Deployment and click Select next to the deployment name.

  16. The deployment properties are now shown under Selected.

    one desktop configuration config dpe dpm

  17. Click Done.

  18. You can see the added platform configuration properties above the previously configured deployment properties.

  19. Click Deploy Property.

ONE Desktop configuration reference

The following properties are provided in the ONE Desktop (desktop) deployment in the Configuration Service.

Connecting to MMM

Property Data type Description

ataccama.desktop.mmm.url

String

The URL of the GraphQL endpoint that is used by MMM.

Default value: localhost:8021/graphql.

ataccama.desktop.mmm.host

String

The IP address or the hostname of the gRPC endpoint that is used by MMM.

Default value: localhost.

ataccama.desktop.mmm.port

Number

The gRPC port where MMM is running.

Default value: 8521.

ataccama.desktop.mmm.web.url

String

The URL where ONE Web Application is running.

Connecting to DPM

Property Data type Description

ataccama.desktop.dpm.host

String

The IP address or the hostname of the server where DPM is running.

Default value: localhost.

ataccama.desktop.dpm.public.key

String

The public key of the DPM deployment.

Corresponds to the value of the following platform property in the Configuration Service: ataccama.one.platform.deployments.<dpm_deployment>.security.jwt-keys.<dpm_deployment>-key.content.

ataccama.desktop.dpm.port

String

The gRPC port where DPM is running.

Default value: 8531.

Authentication

Property Data type Description

ataccama.desktop.auth.type

String

The type of authentication used. Allowed values: OpenID Connect, BASIC.

Default value: OpenID Connect.

ataccama.desktop.keycloak.endpoint.url

String

The URL where the Keycloak token used for OpenID Connect authentication can be retrieved, for example, localhost:8080/auth.

Was this page useful?