使用 Parasoft SOAtest 和 Virtualize 服务器需要许可证。如果可以访问部署 WAR 的计算机,则可以编辑 <SOAVIRT_HOME>/WEB-INF/
目录中的 config.properties 文件,以便在启动服务器之前配置许可证设置。如果您没有访问该文件的权限,或者正在将服务器配置为自动化流程的一部分,则可以使用 REST API 设置许可证设置。章节目录:
对密码进行编码
从许可证服务器或 DTP 请求 SOAtest 和 Virtualize 服务器的许可证需要用户名和密码。强烈建议对密码进行编码,以保证成功进行身份验证和安全连接。将 WAR 部署到 <SOAVIRT_HOME> 后,可根据您的操作系统运行:
<SOAVIRT_HOME>/scripts/encodepass.sh <YOUR_PASSWORD>
或
<SOAVIRT_HOME>/scripts/encodepass.bat <YOUR_PASSWORD>
来执行密码编码。
您还可以使用 -encodepass
标志运行 SOAtest 或 Virtualize 的命令行实例。例如:
soatestcli.exe -encodepass <YOUR_PASSWORD>
virtualizecli.exe -encodepass <YOUR_PASSWORD>
这两种方法都会生成一个编码字符串,您可以用它来代替 SOAtest 和 Virtualize 服务器配置文件中的密码属性。 有关命令行选项的更多信息,请参阅 CLI 选项。
使用许可证服务器中的许可证
配置以下设置以使用许可证服务器中的许可证:
SOAtest 和 Virtualize
license.network.use.specified.server=true license.network.url=<URL for License Server in the form https://host[:port][/context-path]> virtualize.license.use_network=true virtualize.license.network.edition=performance_server_edition virtualize.license.custom_edition_features=<comma-separated list of features> virtualize.license.enabled=true soatest.license.use_network=true soatest.license.network.edition=server_edition soatest.license.custom_edition_features=<comma-separated list of features> soatest.license.enabled=true
联系 Parasoft 技术支持,确定您的组织购买的许可证类型(例如, server_edition
)。如果正在使用自定义版本,则您至少需要为 Virtualize 至少指定服务启用
特性,并/或为 SOAtest 指定服务器 API 启用
特性。如果服务器使用 HTTPS 协议,请在 license.network.url
中的主机名前加上 https://
。
仅用于 Virtualize
license.network.use.specified.server=true license.network.url=<URL for License Server in the form https://host[:port][/context-path]> virtualize.license.use_network=true virtualize.license.network.edition=performance_server_edition virtualize.license.custom_edition_features=<comma-separated list of features> virtualize.license.enabled=true soatest.license.enabled=false
如果服务器使用 HTTPS 协议,请在 license.network.url
中的主机名前加上 https://
。
仅用于 SOAtest
license.network.use.specified.server=true license.network.url=<URL for License Server in the form https://host[:port][/context-path]> virtualize.license.enabled=false soatest.license.use_network=true soatest.license.network.edition=server_edition soatest.license.custom_edition_features=<comma-separated list of features> soatest.license.enabled=true
更多信息,请参阅服务器配置。有关高级配置,请参阅高级服务器配置选项。
使用 DTP 的许可证
您可以将 SOAtest 和 Virtualize 服务器连接到 Parasoft DTP 以检索许可证。
license.network.use.specified.server=false virtualize.license.use_network=true soatest.license.use_network=true dtp.url=<URL for DTP in the form https://host[:port][/context-path]> dtp.user=<username for account on DTP> dtp.password=<password for account on DTP>
使用单机许可证
配置以下设置以使用本地许可证:
virtualize.license.use_network=false virtualize.license.local.password=<password sent to you from Parasoft> soatest.license.use_network=false soatest.license.local.password=<password sent to you from Parasoft>
有关许可证设置的详情,请参阅服务器配置。有关高级配置,请参阅高级服务器配置选项。
接受最终用户许可协议
设置以下属性以接受《Parasoft 最终用户许可协议》(请阅读 https://www.parasoft.com/license 中的 EULA):
parasoft.eula.accepted=true
启动服务器后设置许可证
可以使用 REST API 为服务器设置许可证。还可以使用 API 配置到 CTP 的连接(请参阅服务器配置中的 env.manager.*
设置)。
通过 web 浏览器使用 REST API 页面
- 启动服务器,并打开
preferences
端点的文档:http:///<HOST>:<PORT>
/soavirt/api/v6#!/preferences/preferencesPUT_config
- 点击 Try it out,并将许可证设置作为 JSON 对象输入到 New configuration 输入字段中。文档描述了有效对象的结构。关于可以复制并粘贴到 UI 中的示例,请参阅Example Requests。
- 点击 Execute,发送请求。响应正文将包括删除密码的配置设置:
- 向
status
端点发送 GET 请求以验证已成功设置许可证:http://<HOST>:<PORT>/soavirt/api#!/status/statusGET
这将显示关于服务器主机和每个许可证特性的状态信息。
示例请求
您可以复制并粘贴以下 JSON 示例到 REST API 端点中,以帮助您入门。更改主机、端口和任何特性设置以匹配您的许可证。要接受 EULA,请将“已接受”字段更新为 true
。必须接受 EULA 才能使用该产品。您可以前往 https://www.parasoft.com/license 阅读 EULA。
{ "eula" : { "accepted" : false }, "license" : { "licenseServer": { "host": "<your-LS-host>", "port": <your-LS-port> }, "virtualize": { "enabled": true, "useNetwork": true, "network": { "edition": "performance_server_edition" } }, "soatest": { "enabled": true, "useNetwork": true, "network": { "edition": "server_edition" } } } }
{ "eula" : { "accepted" : false }, "license" : { "licenseServer": { "host": "<your-LS-host>", "port": <your-LS-port> }, "virtualize": { "enabled": true, "useNetwork": true, "network": { "edition": "custom_edition", "customFeatures": [ "<comma-separated-list-of-features>" ] } }, "soatest": { "enabled": true, "useNetwork": true, "network": { "edition": "custom_edition", "customFeatures": [ "<comma-separated-list-of-features>" ] } } } }
{ "eula" : { "accepted" : false }, "license" : { "dtp": { "host": "<your-DTP-host>", "port": <your-DTP-port>, "username": "<your-DTP-username>", "password": "<your-DTP-password>" }, "virtualize": { "enabled": true, "useNetwork": true, "network": { "edition": "performance_server_edition" } } } }
{ "eula" : { "accepted" : false }, "license" : { "dtp": { "host": "<your-DTP-host>", "port": <your-DTP-port>, "username": "<your-DTP-username>", "password": "<your-DTP-password>" }, "virtualize": { "enabled": true, "useNetwork": true, "network": { "edition": "performance_server_edition" } }, "soatest": { "enabled": true, "useNetwork": true, "network": { "edition": "server_edition" } } } }
{ "eula" : { "accepted" : false }, "license" : { "virtualize" : { "enabled" : true, "useNetwork" : false, "local" : { "password" : "<virtualize-password>" } }, "soatest" : { "enabled" : true, "useNetwork" : false, "local" : { "password" : "<soatest-password>" } } } }
在命令行使用 REST API
您也可以使用命令行通过 REST API 申请许可证。下面举例说明如何将节点锁定许可证应用到 Virtualize。
首先,您需要获得远程服务器的计算机 ID,以便从 Parasoft 购买许可证。要使用 REST API 进行此操作,请运行此命令:
curl -X GET "http://server.example.com:9080/soavirt/api/v6/status?fields=machineId" -H "accept: application/json"
机器码将在响应中返回。例如,在 Linux 服务器上,响应如下:
{"machineId":"LINUX2-xxxxxxx (Default)"}
通过 Parasoft 代表收到许可证密码后,即可进行申请。要使用 REST API 应用节点锁定许可证,请运行以下命令。请务必将下面命令中的 PASSWORD_TEXT
替换为您的实际密码。
curl -X PUT "http://server.example.com:9080/soavirt/api/v6/preferences/config" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"eula\":{\"accepted\":false},\"license\":{\"virtualize\":{\"enabled\":true,\"useNetwork\":false,\"local\":{\"password\":\"PASSWORD_TEXT\"}},\"soatest\":{\"enabled\":false,\"useNetwork\":false}}}"
在以上示例中未接受 EULA。您需要手动将 \"eula\":{\"accepted\":false}
更改为 \"eula\":{\"accepted\":true}
来接受 EULA.。您必须接受 EULA 才能使用该产品。请前往 https://www.parasoft.com/license 阅读 EULA。
验证产品是否获得许可:
curl -X GET "http://server.example.com:9080/soavirt/api/v6/status" -H "accept: application/json"
在返回的输出结果中,查找 "virtualize"
字段下的 "licensed": true
。