-x mlsrv12 选项

mlsrv12 -c "connection-string" -x protocol[protocol-options] [ -x protocol[protocol-options] ... ] ...

protocol : tcpip | tls | http | https | oe

protocol-options : ( option=value; ... )

必须为正在使用的每个协议指定 -x 选项。例如，如需为 TCP/IP 和 HTTP 同时使用 MobiLink 监听，则需指定下列内容：

mlsrv12 -x tcpip(port=1234) -x http(port=2222)

缺省协议是 TCPIP，端口为 2439。

协议的允许值如下所示：

tcpip 通过 TCP/IP 接受连接。
tls 通过 TCP/IP 和传送层安全性 (TLS) 接受连接。
http 通过标准 HTTP Web 协议接受连接。
https 使用处理安全事务的 HTTP 的变异版本接受连接。使用 RSA 或 ECC 加密，HTTPS 协议通过 SSL/TLS 实现 HTTP。
oe 使用中继服务器时使用集成出站启动器。无法在服务器命令行中包括多个 -x oe 协议。

您还可以指定以下网络协议选项，形式为 option=value。必须用分号分隔多个选项。

TCP/IP 选项 如果指定了 tcpip 协议，则还可以有选择地指定以下协议选项（这些选项区分大小写）：

TCP/IP 协议选项	说明
collect_network_data={ yes \| no }	启用同步脚本以从每个同步中读取网络信息。请参见NetworkData 接口 [MobiLink 服务器 Java]和NetworkData 接口 [MobiLink 服务器 .NET]。
host=hostname	MobiLink 服务器监听的主机名或 IP 地址。缺省值为 localhost。
ignore=hostname	进行连接时 MobiLink 服务器所忽略的主机名或 IP 地址。此选项使您可以忽略来自最低可能级别的负载平衡器的请求，从而防止 MobiLink 服务器日志和 MobiLink 监控器输出文件中出现过多的输出。可以指定多个需要忽略的主机，例如 `-x tcpip(ignore=lb1;ignore=123.45.67.89)`。如果在命令行上指定多个 -x 实例，将在所有实例上忽略相应的主机；例如，如果指定 `-x tcpip(ignore=1.1.1.1) -x http`，则在 TCP/IP 和 HTTP 流上均忽略 1.1.1.1 的连接。
port=portnumber	MobiLink 服务器监听的套接字端口号。缺省端口为 2439，这是用于 MobiLink 服务器的 IANA 注册端口号。

用于具有传送层安全性的 TCP/IP 的选项 如果指定 tls 协议（该协议是具有传送层安全的 TCP/IP 协议），则可选择指定以下协议选项（这些选项区分大小写）：

TLS 协议选项	说明
collect_network_data={ yes \| no }	启用同步脚本以从每个同步中读取网络信息。请参见NetworkData 接口 [MobiLink 服务器 Java]和NetworkData 接口 [MobiLink 服务器 .NET]。
e2ee_private_key=file	包含 RSA 或 ECC 专用密钥的 PEM 或 DER 编码文件。若要使端对端加密生效，则需要使用此选项。可使用 createkey 实用程序创建 PEM 和 DER 编码文件。请参见密钥对生成器实用程序 (createkey)。
e2ee_private_key_password=password	专用密钥文件的口令。若要使端对端加密生效，则需要使用此选项。如果指定此选项，则必须也指定 e2ee_private_key 参数。为防止在 MobiLink 服务器命令行中出现此口令，使用 dbfhide 实用程序。请参见文件隐藏实用程序 (dbfhide)。
e2ee_type={ rsa \| ecc }	用于端对端加密的交换会话密钥所使用的密钥类型。必须是 rsa 或 ecc，而且必须与专用密钥文件（参见 e2ee_private_key 选项）中的密钥类型相匹配。缺省的 e2ee_type 为 rsa。如果指定此选项，则必须也指定 e2ee_private_key 选项。
fips={yes\|no}	如果通过 tls_type=rsa 指定了 TLS 协议，可以指定 fips=yes 以便使用 TCP/IP 协议和 FIPS 认证的加密算法接受连接。FIPS 认证的连接使用单独的 FIPS 140-2 认证软件。使用没有 FIPS 认证加密的 RSA 加密的服务器可与使用已启用 fips 选项的 RSA 的客户端兼容。使用已启用 fips 选项的 RSA 的服务器可与使用未启用 fips 选项的 RSA 的客户端兼容。
host=hostname	MobiLink 服务器监听的主机名或 IP 地址。缺省值为 localhost。
identity=identity-file	要用于服务器验证的标识文件的路径和文件名。
identity_password=password	用于为标识文件指定口令的可选参数。如果指定此选项，则必须也指定标识选项。请参见传送层安全。为防止在 MobiLink 服务器命令行中出现此口令，使用 dbfhide 实用程序。请参见文件隐藏实用程序 (dbfhide)。
ignore=hostname	进行连接时 MobiLink 服务器所忽略的主机名或 IP 地址。此选项使您可以忽略来自最低可能级别的负载平衡器的请求，从而防止 MobiLink 服务器日志和 MobiLink 监控器输出文件中出现过多的输出。可以指定多个需要忽略的主机，例如 `-x tcpip(ignore=lb1;ignore=123.45.67.89)`。
port=portnumber	MobiLink 服务器监听的套接字端口号。缺省端口为 2439，这是用于 MobiLink 服务器的 IANA 注册端口号。
tls_type={ rsa \| ecc }	如果将协议指定为 tls，则可以指定椭圆曲线加密算法 (ecc) 或 RSA 加密 (rsa)。为了向后兼容，还可以将 ecc 指定为 certicom。缺省的 tls_type 为 rsa。当使用 TLS 时，必须指定标识和标识口令： identity=identity-file 指定要用于服务器验证的标识文件的路径和文件名。 identity_password=password 为标识指定口令。请参见启动支持传送层安全的 MobiLink 服务器。

HTTP 选项 如果指定了 http 协议，则还可以有选择地指定以下协议选项（这些选项区分大小写）：

HTTP 选项	说明
buffer_size=number	自 MobiLink 服务器发送的 HTTP 消息的最大主体大小，单位为字节。更改此选项会减小或增大为发送 HTTP 消息而分配的内存大小。缺省值为 65536 个字节。
collect_network_data={ yes \| no }	启用同步脚本以从每个同步中读取网络信息。请参见NetworkData 接口 [MobiLink 服务器 Java]和NetworkData 接口 [MobiLink 服务器 .NET]。
host=hostname	MobiLink 服务器监听的主机名或 IP 地址。缺省值为 localhost。
log_bad_request={ yes \| no }	当设置为 yes 时，MobiLink 服务器会在接受到不完整的或意外的 HTTP 请求时显示错误。这些错误类似于由 -vf 选项显示的错误。缺省值是 no。请参见-v mlsrv12 选项。
port=portnumber	MobiLink 服务器监听的套接字端口号。缺省端口是 80。
version=http-version	MobiLink 服务器自动检测客户端使用的 HTTP 版本。该参数是一个字符串，它用于在服务器无法检测到客户端使用的版本时指定缺省的 HTTP 版本。可以选择 1.0 或 1.1。缺省值是 1.1。

HTTPS 选项 HTTPS 协议使用 RSA 或 ECC 数字证书以实现传送层安全性。如果指定 FIPS 加密，则协议将使用单独的、与 HTTPS 兼容的 FIPS 140-2 认证软件。

有关详细信息，请参见启动支持传送层安全的 MobiLink 服务器。

如果指定了 https 协议，则还可以有选择地指定以下协议选项（这些选项区分大小写）：

HTTPS 选项	说明
buffer_size=number	自 MobiLink 服务器发送的 HTTPS 消息的最大主体大小，单位为字节。更改此选项会减小或增大为发送 HTTPS 消息而分配的内存大小。缺省值为 65536 个字节。
collect_network_data={ yes \| no }	启用同步脚本以从每个同步中读取网络信息。请参见NetworkData 接口 [MobiLink 服务器 Java]和NetworkData 接口 [MobiLink 服务器 .NET]。
e2ee_private_key=file	包含 rsa 或 ecc 专用密钥的 PEM 或 DER 编码文件。若要使端对端加密生效，则需要使用此选项。可使用 createkey 实用程序创建 PEM 和 DER 编码文件。请参见密钥对生成器实用程序 (createkey)。
e2ee_private_key_password=password	专用密钥文件的口令。若要使端对端加密生效，则需要使用此选项。如果指定此选项，则必须也指定 e2ee_private_key 选项。为防止在 MobiLink 服务器命令行中出现此口令，使用 dbfhide 实用程序。请参见文件隐藏实用程序 (dbfhide)。
e2ee_type={ rsa \| ecc }	用于端对端加密的交换会话密钥所使用的密钥类型。必须是 rsa 或 ecc，而且必须与专用密钥文件（参见 e2ee_private_key 选项）中的密钥类型相匹配。缺省的 e2ee_type 为 rsa。如果指定此选项，则必须也指定 e2ee_private_key 选项。
fips={yes\|no}	如果通过 tls_type=rsa 指定了 TLS 协议，可以指定 fips=yes 以便使用 TCP/IP 协议和 FIPS 认证的加密算法接受连接。FIPS 认证的连接使用单独的 FIPS 140-2 认证软件。使用没有 FIPS 认证加密的 RSA 加密的服务器可与使用已启用 fips 选项的 RSA 的客户端兼容。使用已启用 fips 选项的 RSA 的服务器可与使用未启用 fips 选项的 RSA 的客户端兼容。
host= hostname	MobiLink 服务器监听的主机名或 IP 地址。缺省值为 localhost。
identity=server-identity	要用于服务器验证的标识文件的路径和文件名。
identity_password=password	用于为标识文件指定口令的可选参数。如果指定此选项，则必须也指定标识选项。请参见传送层安全。为防止在 MobiLink 服务器命令行中出现此口令，使用 dbfhide 实用程序。请参见文件隐藏实用程序 (dbfhide)。
log_bad_request={ yes \| no }	当设置为 yes 时，MobiLink 服务器会在接受到不完整的或意外的 HTTP 请求时显示错误。这些错误类似于由 -vf 选项显示的错误。缺省值是 no。请参见-v mlsrv12 选项。
port=portnumber	MobiLink 服务器监听的套接字端口号。端口号必须与 MobiLink 服务器所监控端口相匹配。缺省端口是 443。
tls_type={ rsa \| ecc }	如果将 TCP/IP 协议指定为 tls，则可以指定椭圆曲线加密算法 (ecc) 或 RSA 加密 (rsa)。为了向后兼容，还可以将 ecc 指定为 certicom。缺省的 tls_type 为 rsa。使用传送层安全性时，必须指定标识和标识口令： identity=identity-file 指定要用于服务器验证的标识文件的路径和文件名。 identity_password=password 指定标识文件的口令。请参见启动支持传送层安全的 MobiLink 服务器。
version=http-version	MobiLink 服务器自动检测客户端使用的 HTTP 版本。该参数是一个字符串，它用于在服务器无法检测到客户端使用的版本时指定缺省的 HTTP 版本。可以选择 1.0 或 1.1。缺省值是 1.1。

OE 选项 如果指定了 oe 协议，则还可以有选择地指定以下协议选项（这些选项区分大小写）：

OE 协议选项	说明
buffer_size=number	自 MobiLink 服务器发送的 HTTP 消息的最大主体大小，单位为字节。更改此选项会减小或增大为发送 HTTP 消息而分配的内存大小。缺省值为 65536 个字节。
config=file	出站启动器配置文件。它的格式与独立出站启动器的配置文件一样，唯一的区别是你不应在文件内指定 -cs 选项。必须指定一个配置文件。
log_bad_request={yes\|no}	当设置为 yes 时，MobiLink 服务器会在接受到不完整的或意外的 HTTP 请求时显示错误。这些错误类似于由 -vf 选项显示的错误。缺省值是 no。请参见-v mlsrv12 选项。
version=http-version	MobiLink 服务器自动检测客户端使用的 HTTP 版本。该参数是一个字符串，它用于在服务器无法检测到客户端使用的方法时指定缺省的 HTTP 版本。可以选择 1.0 或 1.1。缺省值是 1.1。

以下命令行将 TCP/IP 端口设置为 12345：

mlsrv12 -c "DSN=SQL Anywhere 12 CustDB;UID=DBA;PWD=sql" -x tcpip(port=12345)

下面的示例指定了安全类型 (RSA)、服务器标识文件和保护服务器专用密钥的标识口令：

mlsrv12 -c "DSN=my_cons"
 -x tls(tls_type=rsa;identity=c:\test\serv_rsa1.crt;identity_password=pwd)

以下示例与前面的示例相似，不同之处在于本例的标识文件名中包含空格：

mlsrv12 -c "DSN=my_cons"
 -x "tls(tls_type=rsa;identity=c:\Program Files\test\serv_rsa1.crt;identity_password=pwd)"

以下示例显示如何通过 HTTPS 协议使用端对端加密：

mlsrv12 -c "DSN=my_cons" -x https(tls_type=rsa;identity=my_identity.crt;
identity_password=my_id_pwd;e2ee_type=rsa;e2ee_private_key=my_pk.pem;
e2ee_private_key_password=my_pk_pwd)

以下示例显示集成出站启动器的使用：

mlsrv12 -c "DSN=my_cons" -x oe(config=oeconfig.txt)

在以上示例中，oeconfig.txt 文件包含以下内容：

-f farm.name 
-id servername 
-t a18b2e37dbc296322ec5a6eded6ba896
-cr "host=relayserver.sybase.com;https=0;port=80"

-x mlsrv12 选项

注意

语法

注释

参数

示例