Skip to main content Link Search Menu Expand Document (external link)

On-premise configuration

There is the possibility of having several installations defined, so that it will be possible to connect to different platforms depending on the selected installation.

The command $ playground config will serve to manage these facilities.

Add installation

To add a new installation, execute the following command:

playground config add-installation <name> <fqdn>
Setting new default installation: <name>
Configuration updated on: /Users/<user>/.napptive/.playground.yaml

after adding a new installation, it will become the active installation.

Remove installation

To remove an configured installation:

playground config remove-installation <name>
New default installation: <other>
Configuration updated on: /Users/<user>/.napptive/.playground.yaml

List installations

To list all installations:

playground config view
Effective configuration:
SERVER                                                TLS     SKIP_CERT
api.<installation1_url>,staging.<installation1_url>   true    false

Installations:
CURRENT    NAME               SERVER                                                           TLS     SKIP_CERT
*          <installation1>    api.<installation1_url>,staging.<installation1_url>              true    false
           <installation2>    api.<installation2_url>,staging.<installation2_url>              true    false
           <installation3>    api.<installation3_url>,staging.<installation3_url>              true    false
...

Select an installation

To change the active installation, execute:

playground config use-installation <new>
New default installation: <new>
Configuration updated on: /Users/<user>/.napptive/.playground.yaml

Adding a custom CA

In some cases, the installation uses a custom CA, you can include this in the configuration of the installation. Having as active the installation to which we want to add the CA, execute:

playground config set-client-ca <ca_path>
Configuration updated on: /Users/<user>/.napptive/.playground.yaml

Configuration file

All the configurations will be saved into a file in the path /Users/<user>/.napptive/.playground.yaml. This file has the following format:

createdwithversion: <cli_version>
currentinstallation: <name>
installations:
- ConnectionConfig:
    CatalogAddress: catalog.<url>
    CatalogPort: 7060
    ClientCA: ""
    DashboardURL: <url>
    LoginURL: https://<url>/oauth/login?source=cli
    PATAddress: <url>
    ServerAddress: api.<url>
    ServerPort: 8002
    SkipCertValidation: false
    UseTLS: true
  Name: <name>