配置 Turbonomic REST API 连接器源

使用 REST API 连接器可在应用程序环境中连接到符合 REST 标准的 Turbonomic 服务。 仅支持 users、groups 和 entities REST API。

创建变换脚本文件。

• 完成以下步骤以创建变换脚本文件：
  1. 转至放置样本变换脚本文件 restapi_sample_response_t12n.txt的以下位置:

     $install_dir/wlp/usr/servers/prdapp/restapi_t12n

  2. 创建此文件的副本，重命名文件，并在任意文本编辑器中打开此文件。
  3. 删除该文件的现有内容，并将以下脚本复制并粘贴到该文件：

     var input;
     var finalJson;
     var output;	
     var outArr=[]
     
     // Parse the input in JSON format
     input = JSON.parse(transformationInput)
     
     if(input instanceof Array)
     {
     	outArr= input;
     
     }
     else
     {
     	outArr.push(input);
     }
     finalJson=outArr;  
     output = JSON.stringify(finalJson);

  4. 将该文件另存为具有 .js 文件扩展名的 JavaScript 文件。
     这将创建变换脚本文件。

生成 JSESSION cookie

• 完成以下步骤以生成 JSESSION cookie:
  1. 使用 PuTTY 登录到装有 Turbonomic 的 VM。
  2. 运行以下命令以生成 JSESSION cookie。 将在运行该命令的位置生成 cookie 文件。

     curl -k -v 'https://server_IP_or_HOSTNAME/vmturbo/rest/login' --data
     'username=<user_name>&password=<password>'

     其中：

     • server_IP_or_HOSTNAME 是托管 Turbonomic Web Service 的服务器的 IP 地址或主机名。
     • <user_name> 是管理员帐户用户名。
     • <password> 是管理员帐户的密码。
  3. 运行以下命令可查看 cookie 存储：
     cat /<directory_name>/cookies
     以下是显示的输出示例：

     # Netscape HTTP Cookie File
     # http://curl.haxx.se/docs/http-cookies.html
     # This file was generated by libcurl! Edit at your own risk.
     
     #HttpOnly_server_IP_or_HOSTNAME FALSE / TRUE 0 JSESSIONID node0orh922baxbyyj4lrgd0nv5pl38.node0
     

     JSESSION cookie 将显示为 node0orh922baxbyyj4lrgd0nv5pl38.node0 。

     此 cookie 会在数分钟之后到期，因此，您需要重新创建该 cookie 并在所有源和数据定义中输入相应 cookie。 若要避免上述重复步骤，您可以联系 IBM 专业服务代表。

使用 REST API 连接器添加符合 REST 标准的 Turbonomic Web Service。

• 要使用 REST API 连接器添加符合 Turbonomic REST 标准的 Web Service ，请完成以下步骤:
  1. 打开 Dashboard Designer。
  2. 在导航窗格中，转至 连接器和源 > 连接器源。
  3. 在 "所有连接器源" 页面上，单击 添加源。

     “添加连接器源”窗口随即显示。

  4. 从 连接器类型 列表中，选择 REST API 连接器。
  5. 在 连接器源名称 字段中，输入源的名称。

     源名称可以包含字母数字字符和下划线。

  6. 在终端 URL 字段中，以以下任意一种格式输入网络服务的 URL 详细信息：

     http://server_IP_or_HOSTNAME/vmturbo/rest/

     其中：

     • server_IP_or_HOSTNAME 是托管 Web Service 的服务器的 IP 地址或主机名。
  7. 从 认证类型 列表中，选择 无。
  8. 要变换响应，请在 响应变换脚本名称 字段中输入变换脚本文件的名称。
  9. 单击下一步。
  10. 从 方法 列表中，选择方法并根据您选择的方法完成以下任何步骤:
      • 对于 GET 方法，请在 URI 字段中，输入该源的统一资源标识 (URI)。
      • 对于 POST 方法，在 URI 字段中，输入源的 URI ，在 请求主体 字段中，输入发布请求。

      适用于 GET 方法的 URI 示例：users

  11. 在 定制头下，输入以下头和值:
      • 定制头名称: 输入 Cookie
      • 值：输入先前已生成的 JSESSION cookie。

        例如，node0orh922baxbyyj4lrgd0nv5pl38.node0

  12. 要确保与数据源的连接成功，请单击 测试连接。
      如果源详细信息和样本请求有效且完整，那么会显示一条消息，指出连接成功。 对于连接失败消息，必须更正该消息中提到的错误，然后再次测试连接。

      注: 即使源详细信息有效，也可能由于针对样本请求接收到无效响应而显示连接失败消息。
  13. 单击保存。