This topic explains how to edit the properties of a PAS for OpenEdge instance on the Edit PAS for OpenEdge Instance page:

To edit the properties of a PAS for OpenEdge instance:

  1. In the OpenEdge Command Center console, click the PASOE instances tab.

    The console displays a page that lists all PAS for OpenEdge instances that are associated with all currently configured OpenEdge Command Center agents.

  2. Click the name of the PAS for OpenEdge instance whose configuration you want to modify.

    The Edit PAS for OpenEdge Instance page is displayed.

  3. In the Info section, update values for the following properties:
    Field Description
    Instance Name Name of the PAS for OpenEdge instance.
    Note: The PAS for OpenEdge instance name is case-sensitive and must be at least 5 characters long. It can include any character except periods (.) or square brackets ([ ]). The name must be unique among all configured PAS for OpenEdge instance names.
    Labels One or more labels assigned to the instance. Use the drop-down box to select one or more labels, or create one or more new labels to assign.
  4. Click HTTPS to expand the HTTPS connection properties section.

    Provide values for the following properties:

    Property Default value Description
    HTTPS Connector ON Use the ON/OFF toggle switch to enable or disable the HTTPS connector respectively.
    Port 8443 Specifies the HTTPS protocol connector port number.
    Connection Timeout 20000 Specifies the time, in milliseconds, to wait between the establishment of a TCP (TLS) connection by a client and the arrival of the first HTTPS request.
    SSL Session Timeout 86400 Specifies the time, in seconds, after which the TLS session ends.
    Server Key Alias test Specifies the alias name of the keystore entry holding the server's private key and public key certificate.
    Server Key Password password Specifies the password to use when accessing the TLS keystore.
    Store Type PKCS12 Specifies the type of Java keystore format used by Apache Tomcat keystore.
    Max Queue Size 100 Specifies the maximum size of the HTTPS connector message queue.
    Max Connections -1 Specifies the maximum number of TCP socket connections per HTTPS connector.
    Client Authentication none Specifies whether to enable or disable TLS client authentication by the HTTPS connector. The options are required, none, and optional. The default is none.
    Certificate Trust Type JKS Specifies the type of Java certificate store format used by tomcat-certstore.jks that holds the root or intermediate CA certificates. These certificates are used to validate the clients using TLS client authentication.
    Certificate Store Password password Specifies the Java certificate store password used to access tomcat-certstore.jks that holds the root or intermediate CA certificates. These certificates are used to validate the clients using TLS client authentication.
    Encryption Protocol TLSv1.2 Specifies the HTTPS protocol selected for secure communication. If required, you can also edit this value in the catalina.properties file.
    Enabled Ciphers ALL Specifies the list of cipher suites enabled for secure communication. This property can either be all the cipher suites or a comma-separated list of cipher suites supported by JSSE.
    Bind On Init false Check box to control when to bind the socket used by the connector.
    Compression on Check box to enable GZIP compression for HTTPS transports.
  5. Click HTTP to expand the HTTP connection properties section.

    Provide values for the following properties:

    Property Default value Description
    HTTP Connector ON Use the ON/OFF toggle switch to enable or disable the HTTP connector respectively.
    Port 8090 Specifies the HTTP protocol connector port number.
    Connection Timeout 20000 Specifies the time, in milliseconds, to wait between the establishment of a TCP connection by a client and the arrival of the first HTTP request.
    Max Connections -1 Specifies the maximum number of TCP socket connections per HTTP connector.
    Max Queue Size 100 Specifies the maximum size of HTTP connector message queue.
    URI Encoding ISO-8859-1 Specifies the character encoding used to decode the URI bytes after decoding the URL.
    Note: This value is set to the default value of the Apache Tomcat server, and it affects both the HTTP and HTTPS connectors.
    Bind On Init false Check box to control when to bind the socket used by the connector.
    Compression on Check box to enable GZIP compression for HTTP transports.
  6. Click Server Options to expand the Server Options section.

    Provide values for the following properties:

    Property Default value Description
    Shutdown Port —

    Specifies the port number to shutdown the server that is running.

    The values can range from 1024 to 65535. To disable the shutdown port, set the value to -1.

    You must specify a value in Windows, but this property is optional in UNIX.
    Shutdown Password SHUTDOWN

    Specifies a private shutdown port access code to prevent one server instance from being shutdown by anyone.

    Note: If the shutdown port is specified, you must change this value to avoid insecure configuration.
    Stuck Session Valve ON Specifies whether the stuck session valve is enabled to monitor and manage sessions that become unresponsive or exceed a defined execution time.
    Stuck Thread Threshold 600

    Specifies the maximum amount of time, in seconds, an active HTTP request can be running before it is considered stuck and is reported in the server log file.
    Max Threads 300

    Specifies the maximum number of OS process threads the PAS for OpenEdge Server can use.
    Minimum Spare Threads 10

    Specifies the number of spare threads the server reserves for future client operations.
    Web Application Directory webapps

    Specifies the location of the directory where the web applications are to be deployed. If not specified, then the default directory of the Apache Tomcat server, webapps is used.

    If a relative path is specified, it must be relative to the instance's root directory. If an absolute path is used, it must conform to a single platform type.
    Common Library Path —

    Specifies a comma-delimited list of library paths. For example, local/server/common/.*jar,local/server/common/x.jar.

    The delimiter is platform dependent, and the format of the path must conform to the common library path format of the Apache Tomcat server (https://tomcat.apache.org/tomcat-9.0-doc/class-loader-howto.html).
    Auto Deploy WAR Files false

    Select the checkbox to enable the security settings used by the Apache Tomcat server for deploying web applications.

    The default value depends on whether the PAS instance is created as a development or a production security configuration. In a production configuration, the default is false. In a development configuration, the default is true.
    Unpack WAR Files true

    Select the checkbox to allow unpacking of web archive (.war) files when the PAS for OpenEdge instance is started.
    Version Logger ON

    Use the ON/OFF toggle to enable or disable logging the command line arguments passed to Java when the Apache Tomcat server is started.
    Log Command Line Arguments true

    Select the checkbox to log the command line arguments passed to Java when the Apache Tomcat server is started.
    Log Environment Variables false

    Select the checkbox to log the current environment variables when the Apache Tomcat server is started.
    Log Java System Properties false

    Select the checkbox to log the current Java system properties when the Apache Tomcat server is started.
  7. Click Request Options to expand the Request Options section.

    Provide values for the following properties:

    Property Default value Description
    Max POST Request Size 2097152 Specifies the maximum size, in bytes, of a connector's POST message body.
    Max Pipeline Requests 100 Specifies the maximum number of pipelined HTTP keepalive requests before the TCP socket to the client is closed.
    Message Timeout 10000 Specifies the maximum time, in milliseconds, to wait for asynchronous messages to complete.
    Compression Minimum Size 2048 Specifies the minimum size, in bytes, of message that will be compressed, in bytes. This property is applicable to both HTTPS and HTTP transports.
    Compression MIME Types text/html, text/xml, text/javascript, text/css, application/json Specifies a comma-separated list of MIME types that must be compressed. This property is applicable to both HTTPS and HTTP transports.
  8. Click JVM Settings to expand the JVM Settings section.

    Set the JVM arguments to configure Java environment settings for the PAS for OpenEdge instance. For example, set -XX:NewSize and -XXMaxNewSize to specify the minimum and maximum heap size used in garbage collection.

  9. Click Logging Configuration to expand the Logging Configuration section.

    Provide values for the following properties:

    Property Recommended setting Description
    Catalina Logging Level INFO Sets log level for the core Apache Tomcat server. By default, the logging level is set to INFO, but you can change it to WARN, FINE, FINER, ERROR, DEBUG, or TRACE, as required.
    OpenEdge ABL Logging Level WARN

    Sets the log level for ABL application (oeabl.war) Session Manager and Spring Security logging.
    Authentication Logging Level ERROR

    Sets the log level for ABL application login event logging.
    Authorization Logging Level ERROR

    Sets the log level for ABL application URL access event logging.
    OpenEdge STS Logging Level WARN

    Sets the log level for the OpenEdge Authentication Gateway server Security Token Service web application.
  10. Click MS Agent Log Configuration to expand the Agent Log Configuration section.

    Provide values for the following properties:

    Property Description
    MS Agent Log Entry Types Specifies the types of log entries to write to the log file specified by the Client Logging and DataServer Logging startup parameters. If allowRuntimeUpdate is set to true, then changes to the property are applied without restarting the PAS for OpenEdge instance
    MS Agent Log Level Specifies the logging level for each entry type. You can select values from 0 to 4. If allowRuntimeUpdate is set to true, then changes to the property are applied without restarting the PAS for OpenEdge instance.

    For information about the Agent Log Configuration properties, see Troubleshoot problems with an instance.

  11. After modifying properties, you must restart the PAS for OpenEdge instance for most of the changes to take effect. However, if allowRuntimeUpdate is set to true, then changes to the MS Agent Log Entry Types and MS Agent Log Level properties are applied without restarting the PAS for OpenEdge instance.