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
![*](chapterTOC_bullet.png)
The following transport protocols allow only one port:
![*](chapterTOC_bullet.png)
JMX
![*](chapterTOC_bullet.png)
SSH
![*](chapterTOC_bullet.png)
JDWP
![*](chapterTOC_bullet.png)
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.
![*](chapterTOC_bullet.png)
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:
![*](chapterTOC_bullet.png)
COMMON-PROXY-HTTP
![*](chapterTOC_bullet.png)
COMMON-PROXY-HTTPS
![*](chapterTOC_bullet.png)
COMMON-PROXY-FTP
![*](chapterTOC_bullet.png)
COMMON-PROXY-SOCKS
![*](chapterTOC_bullet.png)
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. |