使用 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

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

仅用于 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

仅用于 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):

EULA
parasoft.eula.accepted=true

启动服务器后设置许可证

可以使用 REST API 为服务器设置许可证。还可以使用 API 配置到 CTP 的连接(请参阅服务器配置中的 env.manager.* 设置)。

通过 web 浏览器使用 REST API 页面

  1. 启动服务器,并打开 preferences 端点的文档:

    http:///<HOST>:<PORT>/soavirt/api/v6#!/preferences/preferencesPUT_config
     
  2. 点击 Try it out,并将许可证设置作为 JSON 对象输入到 New configuration 输入字段中。文档描述了有效对象的结构。关于可以复制并粘贴到 UI 中的示例,请参阅Example Requests。 
  3. 点击 Execute,发送请求。响应正文将包括删除密码的配置设置:
  4. 向 status 端点发送 GET 请求以验证已成功设置许可证:  

    http://<HOST>:<PORT>/soavirt/api#!/status/statusGET

    这将显示关于服务器主机和每个许可证特性的状态信息。

示例请求

您可以复制并粘贴以下 JSON 示例到 REST API 端点中,以帮助您入门。更改主机、端口和任何特性设置以匹配您的许可证。要接受 EULA,请将“已接受”字段更新为 true必须接受 EULA 才能使用该产品。您可以前往  https://www.parasoft.com/license 阅读 EULA。

网络许可证使用许可证服务器 - Virtualize 和 SOAtest
{
    "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"
      }
    }
  }
}
网络许可证使用许可证服务器 - Virtualize 和 SOAtest - 自定义特性
{
    "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>"
		]
      }
    }
  }
} 
网络许可证使用 DTP - 只针对 Virtualize
{
    "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"
      }
    }
  }
}
网络许可证使用 DTP - Virtualize 和 SOAtest
{
    "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"
      }
    }
  }
}
节点锁定许可证 - Virtualize 和 SOAtest
{
    "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


  • No labels