Server

4 minute readReference

createApplicationFromDeploymentPackage

Runs a procedure that creates an application from a deployment package.

Arguments

Argument Name Type Description

artifactGroup

String

(Required) The artifact group.

artifactKey

String

(Required) The artifact key.

artifactVersion

String

(Required) The artifact version.

artifactFileName

String

(Required) The artifact file name.

dslString

String

The DSL to pass to invoking procedure.

retrieveToFolder

String

The folder where the artifact is retrieved. The default value is a dot (.).

Positional arguments

artifactGroup, artifactKey, artifactVersion, artifactFileName

Usage

ec-perl

$cmdr->createApplicationFromDeploymentPackage(<artifactGroup>, <artifactKey>, <artifactVersion>, <artifactFileName>, {<optionals>});

ectool

ectool createApplicationFromDeploymentPackage artifactGroup artifactKey artifactVersion artifactFileName [optionals]

deleteLicense

Deletes a license.

Arguments

Argument Name Type Description

productName

String

(Required) Product name of the license.

featureName

String

(Required) Feature name of the license.

Positional arguments

productName, featureName

Usage

ec-perl

$cmdr->deleteLicense(<productName>, <featureName>);

ectool

ectool deleteLicense productName featureName

getAdminLicense

Retrieves the admin license, which can be used when all concurrent user licenses are in use.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getAdminLicense();

ectool

ectool getAdminLicense

getDashboardVisualizations

Retrieves all dashboard visualizations.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getDashboardVisualizations();

ectool

ectool getDashboardVisualizations

getDevOpsInsightServerConfiguration

Retrieves the current DevOps Insight Server configuration.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getDevOpsInsightServerConfiguration();

ectool

ectool getDevOpsInsightServerConfiguration

getLicense

Retrieves information for one license.

Arguments

Argument Name Type Description

productName

String

(Required) Product name of the license.

featureName

String

(Required) Feature name of the license.

Positional arguments

productName, featureName

Usage

ec-perl

$cmdr->getLicense(<productName>, <featureName>);

ectool

ectool getLicense productName featureName

getLicenseDetails

Retrieves licenses details required for UI processing.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getLicenseDetails();

ectool

ectool getLicenseDetails

getLicenses

Retrieves all license data.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getLicenses();

ectool

ectool getLicenses

getLicenseUsage

Retrieves the current license usage.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getLicenseUsage();

ectool

ectool getLicenseUsage

getServerConfiguration

Retrieves a system property by name.

Arguments

Argument Name Type Description

configName

String

Name for the system property.

Positional arguments

None.

Usage

ec-perl

$cmdr->getServerConfiguration({<optionals>});

ectool

ectool getServerConfiguration [optionals]

getServerInfo

Retrieves information about server ports and message delivery.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getServerInfo();

ectool

ectool getServerInfo

getServerPublicKey

Retrieves the public key of the CloudBees CD/RO server.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getServerPublicKey();

ectool

ectool getServerPublicKey

getServerSettings

Retrieves all server settings by category.

Arguments

Argument Name Type Description

category

SettingCategory

(Required) The category that the server settings belong to.

Positional arguments

category

Usage

ec-perl

$cmdr->getServerSettings(<category>);

ectool

ectool getServerSettings category

getServerStatus

Retrieves the current status of the CloudBees CD/RO server, including log messages generated during the startup sequence.

Arguments

Argument Name Type Description

block

Boolean

True means wait until the server reaches a new state.

diagnostics

Boolean

True to include server diagnostics.

serverStateOnly

Boolean

The response includes only the serverState element.

timeout

Integer

How many seconds before the blocking command times out.

Positional arguments

None.

Usage

ec-perl

$cmdr->getServerStatus({<optionals>});

ectool

ectool getServerStatus [optionals]

getSsoConfiguration

Retrieves the SSO server configuration.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getSsoConfiguration();

ectool

ectool getSsoConfiguration

getStatsdConfiguration

Retrieves the statsd configuration.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getStatsdConfiguration();

ectool

ectool getStatsdConfiguration

getVersions

Retrieves server version information.

Arguments

None.

Positional arguments

None.

Usage

ec-perl

$cmdr->getVersions();

ectool

ectool getVersions

importLicenseData

Imports one or more licenses.

Arguments

Argument Name Type Description

licenseData

String

(Required) Container elements for license data. Expects embedded XML as CDATA.

Positional arguments

licenseData

Usage

ec-perl

$cmdr->importLicenseData(<licenseData>);

ectool

ectool importLicenseData licenseData

setCIEventsSchemaConfiguration

Change the CI events schema configuration.

Arguments

Argument Name Type Description

eventName

String

(Required) Name of the event.

version

Long

(Required) Version of the event schema.

destination

CIEventDestination

Destination of the event.

destinationMappings

Collection

Mapping destination types to JSON text with the mapping fields.

eventSchema

String

JSON text for the event schema. Required if the event does not already have a schema registered.

Positional arguments

eventName, version

Usage

ec-perl

$cmdr->setCIEventsSchemaConfiguration(<eventName>, <version>, {<optionals>});

ectool

ectool setCIEventsSchemaConfiguration eventName version [optionals]

setDevOpsInsightServerConfiguration

Sets the DevOps Insight Server configuration.

Arguments

Argument Name Type Description

elasticSearchUrl

String

CloudBees CD/RO server retrieves data from ElasticSearch using this URL. This URL must be set if DevOps Insight is enabled.

enabled

Boolean

If true, enables DevOps Insight.

logStashUrl

String

DEPRECATED: This is the URL where LogStash receives data from CloudBees CD/RO server. This URL must be set if DevOps Insight is enabled.

password

String

The password for authenticating with the DevOps Insight Server.

testConnection

Boolean

Whether the connection to the DevOps Insight Server should be tested before saving the configuration. Defaults to false.

userName

String

The user name for authenticating with the DevOps Insight Server.

Positional arguments

None.

Usage

ec-perl

$cmdr->setDevOpsInsightServerConfiguration({<optionals>});

ectool

ectool setDevOpsInsightServerConfiguration [optionals]

setSsoConfiguration

Sets the SSO server configuration.

Arguments

Argument Name Type Description

enableSsoKerberos

Boolean

Enable or disable SSO Kerberos.

enableSsoOpenIDConnect

Boolean

Whether OpenID Connect based SSO is enabled.

enableSsoSaml

Boolean

Enable or disable SSO SAML.

Positional arguments

None.

Usage

ec-perl

$cmdr->setSsoConfiguration({<optionals>});

ectool

ectool setSsoConfiguration [optionals]

setStatsdConfiguration

Change the statsd configuration.

Arguments

Argument Name Type Description

enabled

Boolean

True if metrics should be sent to the configured statsd server.

flushRate

String

Sets the rate at which the client will flush the pending metric values to the network. E.g. if the rate is 0.1, 1 in 10 writes will flush the pending metrics. Must be between 0 and 1. The default is 0.01, flushing 1 in 100 writes.

hostName

String

The host name of the statsd server to which metrics are sent.

includeHostName

Boolean

True to include the CD server hostname in the name of statsd metrics.

port

Integer

The port on the statsd server to which metrics are sent; defaults to port 8125.

prefix

String

Prefix added to all statsd metric names; defaults to CloudBeesCD.

sampleRate

String

Sets the sample rate of elements that will be actually sent. E.g. if rate is 0.75, more or less 75% of items will be sent (and the @0.75 suffix will be added to the metrics). Must be between 0 and 1. The default is 1, sending all samples.

Positional arguments

None.

Usage

ec-perl

$cmdr->setStatsdConfiguration({<optionals>});

ectool

ectool setStatsdConfiguration [optionals]

shutdownServer

Shuts down the CloudBees CD/RO server. Shutting down the server can take as long as a couple of minutes, depending on the server activity level at the time the shutdown command is issued.

The CloudBees CD/RO server is composed of two processes. The main process is a Java Virtual Machine (JVM). The second process, called the wrapper, is responsible for interacting with the native operating system as a service. This wrapper process is responsible for starting and stopping the main JVM process.

Arguments

Argument Name Type Description

force

Boolean

If true, shutdown is forced — the server exits without any cleanup.

restart

Boolean

If true, the server is restarted after shutdown.

Positional arguments

None.

Usage

ec-perl

$cmdr->shutdownServer({<optionals>});

ectool

ectool shutdownServer [optionals]