xRun 工具

概述

SmartEDB xRun 是一个基于 Python 的实用工具，可启动、终止并控制 SmartEDB xSQL 服务器的执行。xRun 必须在与 xSQL 服务器相同的系统上运行。建议将 xRun 作为后台进程（守护进程、服务等）运行。当 xRun 服务启动时，可通过任何浏览器访问其 Web 界面。xRun 的 Web 界面允许启动和停止 xSQL 服务器，并进一步监控和控制服务器的执行。目前无法将 xRun 连接到在 xRun 实用工具之外启动的 xSQL 服务器。

xRun 需要 Python 2.7 版本或 3.6 及以上版本。

配置和执行 xRun

xRun 服务本身通过 JSON 格式的 xrun.cfg 配置文件进行控制。该文件列出了由 xRun 管理的 xSQL 服务器以及服务器的参数：服务器配置文件的路径、工作目录和服务器的命令行参数。

除了托管服务器的信息外，配置文件还存储了 xRun 的登录数据——用户名和 SHA-512 加密的密码。

xRun 从命令行执行如下：

	xrun.sh [-a|--address <host_address>] [-p|--port <port_number>] [-k|--keyfile <key_file>] [-c|--certfile <certificate_file>]

默认接口为 http://localhost:8989

例如，以下命令行在 198.168.2.22 主机上执行 xRun，并通过本地网络的 9998 端口使其可通过 HTTP 访问：

	xrun -a 192.168.2.22 -p 9998

该服务可通过浏览器访问，网址为：http://192.168.2.22:9998

若要通过 HTTPS 访问 xRun 服务，必须指定 SSL 私钥文件和 SSL 证书文件的路径：

	xrun -a 104.19.40.101 -p 9998 -k key.dat -c certificate.dat

上述示例将 xrun 服务设置为可通过 https://104.19.40.101:9998 访问。

请注意，不建议允许公众访问 xRun。如果您希望互联网上的用户能够访问您内部网络上的服务，建议配置 SSH 端口转发。例如：

在本地执行 xRun：
```
	xrun --address localhost --port 8989
```

创建通道：

	ssh user@your-gateway-address -L:8989:localhost:8989

从浏览器访问 xRun：
```
	http://localhost:8989
```

xRun passgen 工具

首次启动 xRun 时，用户需要创建用户名和密码。之后，可以通过 xRun 用户界面（需要当前登录凭证）或通过服务器端的命令行 passgen 实用程序来修改登录信息。

	python3 passgen.py --login new-user_name --password password

请注意，运行 passgen 时没有密码要求。访问权限是通过主机操作系统的身份验证策略来控制的。