-xs iqsrv15 Server Option

Specifies server-side Web services communications protocols.

-xs {protocol, ... }
protocol:
{NONE
| HTTP [(option=value;...)]
| HTTPS [(option=value;...)]
HTTPS-only options:
FIPS={Y | N}
IDENTITY=server-identity-filename
IDENTITY_PASSWORD=password

Use the -xs option to specify the Web protocols you want to use to listen for client connection broadcasts.

If you do not specify the -xs option, the server does not attempt to listen for Web requests.

If you specify one or more protocols, the server attempts to listen for client requests using the specified protocol(s).

You can use the HTTPS or the FIPS-approved HTTPS protocols for transport-layer security.

Regardless of the settings you choose for the -xs option, the server always listens for connection broadcasts using the shared memory protocol. You can specify any of the following:

  • option—Use the supported network protocol option for a protocol.

  • HTTP—Listen for web requests by the client using the HTTP protocol. The default port on which to listen is 80.

  • HTTPS—Listen for web requests by the client using the HTTPS protocol. The default port on which to listen is 443. You must specify the server's certificate and password to use HTTPS. The password must be an RSA certificate because HTTPS uses RSA encryption.

    The SQL Anywhere HTTP server supports HTTPS connections using SSL version 3.0 and TLS version 1.0.

    You can specify HTTPS, or HTTPS with FIPS=Y for FIPS-approved RSA encryption. FIPS-approved HTTPS uses a separate approved library, but is compatible with HTTPS.

    • server-identity-filename–the path and file name of the server identity. For HTTPS, you must use an RSA certificate.

    • password –the password for the server private key. You specify this password when you create the server certificate.

  • NONE—do not listen for web requests. This is the default.

For UNIX, you must use quotation marks if you are supplying more than one parameter:

-xs "http(OPTION1=value1;OPTION2=value2;...)"

This command allows only shared memory and TCP/IP communications:

start_iq web.db -xs http(port=80)

See System Administration Guide: Volume 1 > Connection and Communication Parameters > Network communications parameters and CommLinks connection parameter [Links].