Port Configuration

Create Ports

Creates a port for a Universal Messaging server instance.

Syntax

sagcc create configuration data nodeAlias Universal-Messaging-instanceName COMMON-PORTS
{--input|-i} filename.xml --password password

Arguments and Options

nodeAlias
Required. The alias name of the installation in which the Universal Messaging server instance is installed.
Universal-Messaging-instanceName
Required. The ID of the Universal Messaging server instance on which you want to create a port.
COMMON-PORTS
Required. The ID of the configuration type of which you want to create an instance.
--input|-i filename.xml
Required. The XML file that contains the port configuration data.
--password password
Required. Your Command Central password.

Examples

To create a port for the server instance with ID "Universal-Messaging-umserver" installed in the installation with alias name “sag01”, using the port configuration file "port_data.xml":

sagcc create configuration data sag01 Universal-Messaging-umserver
COMMON-PORTS --input port_data.xml --password secret

Because the {--server | -s} and {--username | -u} options are not specified, the command uses the default server and user name. For more information about these options, see IBM webMethods Command Central Help. The command specifies "secret" for the user's password.

The XML port configuration file must have the following format:

<PortSettings>
    <Port alias="nhp1">
        <Enabled>true</Enabled>
        <Type>STANDARD</Type>
        <Number>9001</Number>
        <Protocol>NHP</Protocol>
        <Backlog>100</Backlog>
        <ExtendedProperties>
            <Property name="autostart">true</Property>
            <Property name="allowforinterrealm">true</Property>
            <Property name="authtime">1000</Property>
            <Property name="EnableNIO">true</Property>
            <Property name="acceptThreads">2</Property>
            <Property name="receivebuffersize">1310721</Property>
            <Property name="SelectThreads">4</Property>
            <Property name="advertise">true</Property>
            <Property name="allowclientconnections">true</Property>
            <Property name="Backlog">100</Property>
            <Property name="Alias"/>
            <Property name="keyAlias"/>
            <Property name="sendbuffersize">1310721</Property>
            <Property name="EnableHTTP11">true</Property>
            <Property name="EnableJavaScript">true</Property>
            <Property name="CORSAllowCredentials">true</Property>
            <Property name="CORSAllowedOrigins">*</Property>
            <Property name="AjaxLPActiveDelay">100</Property>
            <Property name="EnableWebSockets">true</Property>
            <Property name="EnableGZipLP">true</Property>
            <Property name="MinimumBytesBeforeGZIP">1000</Property>
            <Property name="AjaxLPIdleDelay">60000</Property>
            <Property name="header1Name">foo</Property>
            <Property name="header1Value">bar</Property>
            <Property name="header1UserAgent">mozilla</Property>
        </ExtendedProperties>
    </Port>
</PortSettings>

Update Ports

Updates the configuration of a port for a Universal Messaging server instance.

Syntax

sagcc update configuration data nodeAlias Universal-Messaging-instanceName COMMON-PORTS-portAlias
{--input|-i} filename.xml --password password

Arguments and Options

nodeAlias
Required. The alias name of the installation in which the Universal Messaging server instance is installed.
Universal-Messaging-instanceName
Required. The ID of the Universal Messaging server instance on which you want to update a port.
COMMON-PORTS-portAlias
Required. The ID of the port instance that you want to update.
--input|-i filename.xml
Required. The XML file that contains the port configuration data.
--password password
Required. Your Command Central password.

Examples

To update the port with alias "nhp1" for the server instance with ID "Universal-Messaging-umserver" installed in the installation with alias name “sag01”, using the port configuration file "port_data.xml":

sagcc update configuration data sag01 Universal-Messaging-umserver COMMON-PORTS-nhp1
--input port_data.xml --password secret

Because the {--server | -s} and {--username | -u} options are not specified, the command uses the default server and user name. For more information about these options, see IBM webMethods Command Central Help. The command specifies "secret" for the user's password.

The XML port configuration file must have the following format:

<PortSettings>
    <Port alias="nhp1">
        <Enabled>true</Enabled>
        <Type>STANDARD</Type>
        <Number>9001</Number>
        <Protocol>NHP</Protocol>
        <Backlog>100</Backlog>
        <ExtendedProperties>
            <Property name="autostart">true</Property>
            <Property name="allowforinterrealm">true</Property>
            <Property name="authtime">1000</Property>
            <Property name="EnableNIO">true</Property>
            <Property name="acceptThreads">2</Property>
            <Property name="receivebuffersize">1310721</Property>
            <Property name="SelectThreads">4</Property>
            <Property name="advertise">true</Property>
            <Property name="allowclientconnections">true</Property>
            <Property name="Backlog">100</Property>
            <Property name="Alias"/>
            <Property name="keyAlias"/>
            <Property name="sendbuffersize">1310721</Property>
            <Property name="EnableHTTP11">true</Property>
            <Property name="EnableJavaScript">true</Property>
            <Property name="CORSAllowCredentials">true</Property>
            <Property name="CORSAllowedOrigins">*</Property>
            <Property name="AjaxLPActiveDelay">100</Property>
            <Property name="EnableWebSockets">true</Property>
            <Property name="EnableGZipLP">true</Property>
            <Property name="MinimumBytesBeforeGZIP">1000</Property>
            <Property name="AjaxLPIdleDelay">60000</Property>
            <Property name="header1Name">foo</Property>
            <Property name="header1Value">bar</Property>
            <Property name="header1UserAgent">mozilla</Property>
        </ExtendedProperties>
    </Port>
</PortSettings>

Delete Ports

Deletes a port for a Universal Messaging server instance.

Syntax

sagcc delete configuration data nodeAlias Universal-Messaging-instanceName
COMMON-PORTS-portAlias --password password

Arguments and Options

nodeAlias
Required. The alias name of the installation in which the Universal Messaging server instance is installed.
Universal-Messaging-instanceName
Required. The ID of the Universal Messaging server instance on which you want to delete a port.
COMMON-PORTS-portAlias
Required. The ID of the port instance that you want to delete.
--password password
Required. Your Command Central password.

Examples

To delete the port with alias "nhp1 for the server instance with ID "Universal-Messaging-umserver" installed in the installation with alias name “sag01”:

sagcc delete configuration data sag01 Universal-Messaging-umserver COMMON-PORTS-nhp1
--password secret

Because the {--server | -s} and {--username | -u} options are not specified, the command uses the default server and user name. For more information about these options, see IBM webMethods Command Central Help. The command specifies "secret" for the user's password.