stsurlutil update utility

Change the OpenEdge Authentication Gateway server URL for each specified database.

stsurlutil update -url url 
   
    [ -servername virtual-hostname] 
    [ -folder folder-name] 
    [-ssl args] 
    [-test true | false] 
    -db dbname [db-options] 
         [-db dbname [db-options] ... ] 
    [abl-startup-options]
  

-url url

Specify the new URL for the Authentication Gateway to insert into the database configuration.

Specify url using the format: https://<host>[port][/sts-application-name]

-servername virtual-hostname

Use this optional parameter when the Authentication Gateway is configured with multiple virtual hosts that are bound to a single IP address. Specify the hostname that you want the database to connect to. This creates a row in the database’s options table (_db-option) that stores the virtual hostname. At runtime, when the database needs to connect to the Authentication Gateway, it requests the virtual host’s TLS certificate during the TLS handshake instead of the server URL’s host.

-folder folder-name

Specify a directory (folder) where log files and temporary files are written. If not provided, the following locations are tested, and the first available folder is used:

• The directory specified by the WRKDIR environment variable
• Current working directory
• The session temp-dir specified using -T

-ssl args

Additional TLS (https) connection options. (See the ABL socket:connect method.)

-test true | false

Tests if the URL is reachable (connect-only.) The default is true, if not specified. Only the literal values true and false are accepted (no other traditional boolean pairs).

-db dbname [ db-options ]

Specify one or more OpenEdge databases to connect to. db-options allows you to specify additional connection parameters.

[-db dbname [db-options] ... ]

Specify additional databases and connection options.

abl-startup-options

Specify additional ABL connection parameters.

The stskeyutil update utility writes the new URL of the gateway to the database.