Command Central 10.15 | Configuring Command Central and Platform Manager | Configuration Types for Command Central and Platform Manager OSGI
 
Configuration Types for Command Central and Platform Manager OSGI
The OSGI-CCE and OSGI-SPM run-time components support creating configuration instances of different configuration types. The following table describes the configuration types that the OSGI-CCE and OSGI-SPM run-time components support and what you can configure with each configuration type.
Configuration type
Supported on
Use to configure...
COMMON-JAVASYSPROPS
OSGI-CCE, OSGI-SPM
JAVA system properties.
COMMON-JVM-OPTIONS
OSGI-CCE, OSGI-SPM
Extended JVM options.
COMMON-JSW
OSGI-CCE, OSGI-SPM
Java Service Wrapper properties
COMMON-LDAP
OSGI-CCE
A connection to an external LDAP directory.
COMMON-LOCAL-USERS
OSGI-CCE, OSGI-SPM
The internal users for Command Central and Platform Manager.
COMMON-LOG
OSGI-CCE, OSGI-SPM
Logging levels for the logs and log file locations.
COMMON-MEMORY
OSGI-CCE, OSGI-SPM
Common memory settings, such as Initial Heap Size and Maximum Heap Size.
COMMON-PORTS
OSGI-CCE, OSGI-SPM
The HTTP, HTTPS, JMX, JDWP (Debug), and SSH ports. By default, the HTTP, HTTPS, and JMX ports are enabled and the JDWP and SSH ports are disabled. See also COMMON-PORTS Usage Notes.
COMMON-PROXY
OSGI-CCE, OSGI-SPM
The proxy server settings if you must route server requests through a third party server. See also COMMON-PROXY Usage Notes.
COMMON-SYSPROPS
OSGI-CCE, OSGI-SPM
DEPRECATED. Use COMMON-JAVASYSPROPS.
COMMON-LDAP Usage Notes
To configure a connection to an LDAP directory, you can use sag-cc-ldap or export an existing LDAP configuration to a template. Note that the value of the location parameter for the truststore and keystore should be a valid URI starting with file:///, for example:
products:
CCE:
default:
configuration:
OSGI-CCE:
COMMON-LDAP:
COMMON-LDAP-sag:
TruststoreDefinition:
Type: JKS
Location: file:///C:/SoftwareAG/common/conf/ldap_truststore.jks
COMMON-PORTS Usage Notes
*The following transport protocols allow only one port:
*JMX
*SSH
*JDWP
*The JDWP (Debug) port is disabled by default. You can only update this port using the configuration commands of the CLI, but you cannot add or remove the port. This port is used when the run-time component is started in debug mode using the sagcc exec lifecycle command.
*Use the JMX port to administer and monitor the JVM KPIs of the Command Central and Platform Manager OSGi components.
COMMON-PROXY Usage Notes
Based on the transport protocol, COMMON-PROXY has the following configuration sub-types:
*COMMON-PROXY-HTTP
*COMMON-PROXY-HTTPS
*COMMON-PROXY-FTP
*COMMON-PROXY-SOCKS
*COMMON-PROXY-ALL - when you want to use the operating system proxy settings instead of the COMMON-PROXY-* configuration.
Important:
You cannot edit or delete the COMMON-PROXY-ALL configuration type.
In the CLI configuration commands that you use to modify the proxy server settings, the input XML file that contains the proxy server configuration data must use the following format:
<?xml version="1.0" encoding="UTF-8"?>
<Proxy alias="HTTPS">
<Enabled>true</Enabled>
<Protocol>HTTPS</Protocol>
<Host>hostName</Host>
<NonProxyHosts>host1,host2</NonProxyHosts>
<Port>12321</Port>
<Username>user</Username>
<Password>secure</Password>
</Proxy>
The following table describes the values you must provide for each of the parameters in the input XML file:
Parameter
Description
Alias
The alias name to use for this host:port combination.
Specify the same value in the Alias and Protocol parameters.
Enabled
*true - enabled (default for all proxy configuration types, except COMMON-PROXY-ALL)
*false - disabled
By default, COMMON-PROXY-ALL is disabled. When you enable COMMON-PROXY-ALL, the server uses the proxy settings of the operating system and ignores any COMMON-PROXY-* configurations.
Protocol
The type of protocol to use for the host:port combination.
Specify the same value in the Alias and Protocol parameters.
Host
The host name or IP address of the proxy server.
For the COMMON-PROXY-ALL configuration type, you can also specify noHost
NonProxyHosts
You can optionally route selected requests directly to their targets, bypassing the proxy. To specify non-proxy hosts, type the fully qualified host and domain name of each server that should receive requests directly. Use | as a separator.
Port
The port on which this proxy server listens for requests. Specify a valid port number in the range of [1-65535].
Username
The user name account to access the proxy server.
Password
The password for the specified user name account.