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

Note: The change takes effect the next time the database is started.
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
Specifies the new URL for the Authentication Gateway to insert into the database configuration.

Specify the 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
Specifies 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 ]
Specifies one or more OpenEdge databases to connect to. db-options allows you to specify additional connection parameters.
[-db dbname [db-options] ... ]
Specifies additional databases and connection options.
abl-startup-options
Specifies additional ABL connection parameters.

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