Application Integration (On-Premises) : Administering the Software AG Infrastructure : Using Command Central to Manage Infrastructure : Configuring Ports in OSGi Profiles : Adding Ports
Adding Ports
Perform the following procedure to configure new ports in the OSGi profiles.
1. In the Environments pane, in the Instances tab, click the OSGi instance or component to which you want to add a port.
2. Click the Configuration tab.
3. Click + to add a new port.
4. Select a value in Port Type and click OK.
5. In Connection Basics, configure the fields corresponding to the port type.
*For HTTP and HTTPS port configurations:
Field
Description
Enabled
Whether the port is enabled.
Port Number
The number you want to use for the port. Select a number that is not already in use.
Alias
Name that you want to use for the port alias. Use an alias name that is unique for the instance or component and can be included in a user-friendly URL. The only valid characters in an alias name are ASCII characters, numbers, underscore (_), dot (.), and a hyphen (-).
Keep Alive Timeout
When to close the connection if the server has not received a request from the client within this timeout value (in milliseconds); or when to close the connection if the client has explicitly placed a close request with the server.
Spare Threads Min
The starting number of request processing spare threads.
Redirect Port
The port to use when redirecting a SSL connection requests.
Spare Threads Max
The maximum number of request processing spare threads.
Accept Count
The maximum number of simultaneous connection requests allowed in the connection queue.
Connection Timeout
The connection timeout in milliseconds. This attribute is not set by default on HTTPS ports.
HTTP Header Size Max
The maximum incoming URL length in characters.
Upload Timeout Disable
Indicates if using a longer connection timeout is allowed when waiting for the servlet container to update.
*Yes. Allow longer connection time-outs while waiting for the servlet container.
*No. Do not allow longer connection time-outs.
Lookups Enable
Indicates if DNS lookups are allowed to get the actual host name of a remote client.
*Yes. DNS lookups allowed.
*No. DNS lookups not allowed.
SL Protocol
For HTTPS port configurations. The certificate encoding algorithm.
SSL Protocol
For HTTPS port configurations. The version of the secure socket layer (SSL) protocol to use; when not specified Transport Layer Security ((TLS) is used.
*For JMX and SSH port configurations:
Field
Description
Enabled
Whether the port is enabled.
Port Number
The number you want to use for the port. Select a number that is not already in use.
*For JMX, select the port for monitoring, managing, and implementing the Java process.
*For SSH, select the port for remote shell services or execution processes.
Alias
Name that you want to use for the port alias. Use an alias name that is unique for the instance or component and can be included in a user-friendly URL. The only valid characters in an alias name are ASCII characters, numbers, underscore (_), dot (.), and a hyphen (-).
JAAS Realm
For JMX and SSH port configurations. Specifies the realm name that authenticates the Java Authentication and Authorization (JAAS) service.
*For JDWP port configurations:
Note:  
The JDWP port is only used when the profile is started in debug mode.
Field
Description
Port Number
The number you want to use for the port. Select a number that is not already in use.
Alias
Name that you want to use for the port alias. Use an alias name that is unique for the instance or component and can be included in a user-friendly URL. The only valid characters in an alias name are ASCII characters, numbers, underscore (_), dot (.), and a hyphen (-).
Suspend
For JDWP port configurations. Select Yes if the runtime should be suspended until debugger connects.
6. In Thread pool Configuration, for HTTP and HTTPS ports, complete the following fields.
Field
Description
Enabled
Whether the listener uses this pool exclusively for dispatching requests. The existing thread pool is a global thread pool. If there is a very high load on this resource, there may be a delay until the global thread pool can process the request. However, with the private thread pool option enabled, requests coming into this port do not compete with other server functions for threads.
When you view the port’s details, the server reports the total number of private thread pool threads currently in use for the port.
Click Yes to enable the private thread pool settings. If you do not need to use the thread pool feature, click No.
Threadpool Min
The minimum number of threads for this private thread pool. The default is 1.
Threadpool Max
The maximum number of threads for this private thread pool. The default is 5.
Threadpool priority
The Java thread priority. The default is 5.
Important:  
Use this setting with extreme care because it will affect server performance and throughput.
7. For secure connections, complete the security fields as follows:
Field
Description
SSL Enabled
Whether secure layering is enabled.
Click Yes to enable the private thread pool settings. If you do not need to use the thread pool feature, click No.
Keystore Type
Select the keystore type.The keystore must contain the private key for secure communication.
Server Location of Keystore
Specify the directory where the keystore file is located.
Password
Specify the password to open the keystore file.
Truststore Type
Select the truststore type. The truststore must contain the trusted root certificate for the CA that signed the OSGi component certificate associated with the key alias. The truststore also contains the list of CA certificates that OSGi component uses to validate the trust relationship.
Server Location of Truststore
Specify the directory where the truststore file is located.
Password
Specify the password to open the truststore file.
Copyright © 2015- 2016 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback