forked from docs/doc-exports
Reviewed-by: Rumpler, Mihály <mihaly.rumpler@t-systems.com> Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com> Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
85 lines
9.9 KiB
HTML
85 lines
9.9 KiB
HTML
<a name="ces_01_0032"></a><a name="ces_01_0032"></a>
|
|
|
|
<h1 class="topictitle1">(Optional) Manually Configuring the Agent on a Windows Server</h1>
|
|
<div id="body1564039389487"><div class="section" id="ces_01_0032__en-us_topic_0078544025_section10035481163223"><h4 class="sectiontitle">Scenarios</h4><p id="ces_01_0032__en-us_topic_0078544025_p51569369182131">After you install the Agent, configure it by clicking <strong id="ces_01_0032__b15170420185712">Restore Agent Configurations</strong> on the Cloud Eye console. If the Agent fails to be configured by clicking <strong id="ces_01_0032__b613414472167">Restore Agent Configurations</strong> or due to other reasons, manually configure it by following the instructions provided in this topic.</p>
|
|
</div>
|
|
<div class="section" id="ces_01_0032__section53474814329"><h4 class="sectiontitle">Constraints</h4><p id="ces_01_0032__p15524141011311">The Agent cannot be installed on Windows BMSs.</p>
|
|
</div>
|
|
<div class="section" id="ces_01_0032__en-us_topic_0078544025_section8243987182032"><h4 class="sectiontitle">Prerequisites</h4><p id="ces_01_0032__en-us_topic_0078544025_p28279724182038">The Agent has been installed.</p>
|
|
</div>
|
|
<div class="section" id="ces_01_0032__section16332045122720"><h4 class="sectiontitle">Procedure</h4><ol id="ces_01_0032__ol05190493320"><li id="ces_01_0032__li65191349731">Log in to the ECS.</li><li id="ces_01_0032__li1322510530311">Open the <strong id="ces_01_0032__b18543556250">conf.json</strong> file in the <strong id="ces_01_0032__b17858511420">telescope_windows_amd64\bin</strong> directory.</li><li id="ces_01_0032__li543111747">Configure the following parameters. For details, see <a href="#ces_01_0032__table177211067">Table 1</a>.<div class="p" id="ces_01_0032__p75971926195019"><div class="notice" id="ces_01_0032__note1515643035019"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="ces_01_0032__en-us_topic_0000001595818516_en-us_topic_0000001595976732_en-us_topic_0000001595976732_p1516182912467">Storing plaintext AKs and SKs poses great security risks. You are advised to delegate all ECS or BMS Agents in the region. For details, see <a href="ces_faq_0028.html">How Can I Create an Agency?</a></p>
|
|
</div></div>
|
|
<pre class="screen" id="ces_01_0032__screen131872211306">{
|
|
"InstanceId":"",
|
|
"ProjectId": "",
|
|
"AccessKey": "",
|
|
"SecretKey": "",
|
|
"RegionId": "eu-de",
|
|
"ClientPort": 0,
|
|
"PortNum": 200
|
|
}</pre>
|
|
</div>
|
|
<p id="ces_01_0032__p676219331772"></p>
|
|
|
|
<div class="tablenoborder"><a name="ces_01_0032__table177211067"></a><a name="table177211067"></a><table cellpadding="4" cellspacing="0" summary="" id="ces_01_0032__table177211067" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Public parameters</caption><thead align="left"><tr id="ces_01_0032__row1970211364"><th align="left" class="cellrowborder" valign="top" width="16.99%" id="mcps1.3.4.2.3.4.2.3.1.1"><p id="ces_01_0032__p16712112610">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="83.00999999999999%" id="mcps1.3.4.2.3.4.2.3.1.2"><p id="ces_01_0032__p157521366">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ces_01_0032__row3782113618"><td class="cellrowborder" valign="top" width="16.99%" headers="mcps1.3.4.2.3.4.2.3.1.1 "><p id="ces_01_0032__p1479212615">InstanceId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="83.00999999999999%" headers="mcps1.3.4.2.3.4.2.3.1.2 "><p id="ces_01_0032__p147202117617">(Optional) Specifies the ECS ID. You can log in to the management console and view the ECS ID in the ECS list.</p>
|
|
<div class="note" id="ces_01_0032__note1977211067"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="ces_01_0032__p11711219611">If you do not configure <strong id="ces_01_0032__b1385305411">InstanceId</strong>, retain <strong id="ces_01_0032__b1763287034">"InstanceId":""</strong>. If you configure it, ensure that the following two requirements are met:</p>
|
|
<ul id="ces_01_0032__ul1871921168"><li id="ces_01_0032__li12715211860">The ECS ID must be unique at all sites, that is, in the same region, <strong id="ces_01_0032__b1855218578438">InstanceId</strong> used by the Agent cannot be the same. Otherwise, errors may occur.</li><li id="ces_01_0032__li15714212618">The <strong id="ces_01_0032__b125071521144412">InstanceId</strong> value must be consistent with the actual ECS or BMS ID. Otherwise, you cannot see the OS monitoring data on Cloud Eye.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="ces_01_0032__row5815211863"><td class="cellrowborder" valign="top" width="16.99%" headers="mcps1.3.4.2.3.4.2.3.1.1 "><p id="ces_01_0032__p9818211364">ProjectId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="83.00999999999999%" headers="mcps1.3.4.2.3.4.2.3.1.2 "><p id="ces_01_0032__p18172116612">Specifies the project ID. You do not need to configure <strong id="ces_01_0032__b1988355711442">ProjectId</strong>. Retain <strong id="ces_01_0032__b19884195754415">"ProjectId": ""</strong>. If you wish to configure it, perform the following operations:</p>
|
|
<ol type="a" id="ces_01_0032__ol3813211468"><li id="ces_01_0032__li1787211616">Log in to the Cloud Eye console, click the username in the upper right corner, and choose <strong id="ces_01_0032__b12113623184513">My Credentials</strong>.</li><li id="ces_01_0032__li980211965">Under <strong id="ces_01_0032__b1014127193111">Projects</strong>, obtain the project ID for the region where the ECS or BMS is located.</li></ol>
|
|
</td>
|
|
</tr>
|
|
<tr id="ces_01_0032__row1882211768"><td class="cellrowborder" valign="top" width="16.99%" headers="mcps1.3.4.2.3.4.2.3.1.1 "><p id="ces_01_0032__p17815211161">AccessKey/SecretKey</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="83.00999999999999%" headers="mcps1.3.4.2.3.4.2.3.1.2 "><p id="ces_01_0032__p1080211161">To obtain the AK and SK, perform the following operations:</p>
|
|
<p id="ces_01_0032__p9810216616">Log in to the Cloud Eye console, click the username in the upper right corner, and choose <strong id="ces_01_0032__b581471704210">My Credentials</strong>, and choose <strong id="ces_01_0032__b18814917194217">Access Keys</strong>.</p>
|
|
<ul id="ces_01_0032__ul118142117617"><li id="ces_01_0032__li1688217618">If you have obtained the access key, obtain the <strong id="ces_01_0032__b303280263">AccessKey</strong> value and the <strong id="ces_01_0032__b1123786184">SecretKey</strong> value in the <strong id="ces_01_0032__b112321254010">credentials.csv</strong> file saved when you create <strong id="ces_01_0032__b1245332906">Access Keys</strong>.</li><li id="ces_01_0032__li168821766">If no access keys are available, click <strong id="ces_01_0032__b381911397">Create Access Key</strong> to create one. Save the <strong id="ces_01_0032__b1037328965">credentials.csv</strong> file and obtain the <strong id="ces_01_0032__b1998452789">AccessKey</strong> value and the <strong id="ces_01_0032__b1250453955">SecretKey</strong> value in it.<div class="notice" id="ces_01_0032__note118521967"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="ces_01_0032__ul178621364"><li id="ces_01_0032__li18820212615">For security purposes, it is recommended that the user be an IAM user with the <strong id="ces_01_0032__b558765470">CES Administrator</strong> permissions only.</li></ul>
|
|
</div></div>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="ces_01_0032__row18914219612"><td class="cellrowborder" valign="top" width="16.99%" headers="mcps1.3.4.2.3.4.2.3.1.1 "><p id="ces_01_0032__p1891221166">RegionId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="83.00999999999999%" headers="mcps1.3.4.2.3.4.2.3.1.2 "><p id="ces_01_0032__p1898213615">Specifies the region ID. For example, if the ECS is located in region <strong id="ces_01_0032__b1543179872">EU DE</strong>, <strong id="ces_01_0032__b1647350073">RegionId</strong> is <strong id="ces_01_0032__b1958901032">eu-de</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ces_01_0032__row81014211966"><td class="cellrowborder" valign="top" width="16.99%" headers="mcps1.3.4.2.3.4.2.3.1.1 "><p id="ces_01_0032__p71082115617">ClientPort</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="83.00999999999999%" headers="mcps1.3.4.2.3.4.2.3.1.2 "><p id="ces_01_0032__p910421362">Specifies the start port number used by the Agent.</p>
|
|
<div class="note" id="ces_01_0032__note101092114613"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="ces_01_0032__p20101421968">The default value is <strong id="ces_01_0032__b840013806">0,</strong> indicating that the Agent will randomly use any port. Ports 1 to 1023 are reserved. You are advised not to specify a port in this range for the Agent.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="ces_01_0032__row181017213612"><td class="cellrowborder" valign="top" width="16.99%" headers="mcps1.3.4.2.3.4.2.3.1.1 "><p id="ces_01_0032__p16102021169">PortNum</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="83.00999999999999%" headers="mcps1.3.4.2.3.4.2.3.1.2 "><p id="ces_01_0032__p161082114613">Specifies the number of ports configured for the Agent.</p>
|
|
<div class="note" id="ces_01_0032__note11011211563"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="ces_01_0032__p3108214614">The default value is <strong id="ces_01_0032__b13908234467">200</strong>. If <strong id="ces_01_0032__b129091331468">ClientPort</strong> is <strong id="ces_01_0032__b49091132462">5000</strong>, the port range will be 5000 to 5199.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="ces_01_0032__li66781053151215">Wait for a few minutes.<p id="ces_01_0032__p117505546123"><a name="ces_01_0032__li66781053151215"></a><a name="li66781053151215"></a>If <strong id="ces_01_0032__b179341641153915">Agent Status</strong> is <strong id="ces_01_0032__b8515131306">Running</strong>, the Agent has been installed and starts to collect fine-grained metric data.</p>
|
|
</li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="ces_01_0005.html">Installing and Configuring the Agent on a Windows ECS</a></div>
|
|
</div>
|
|
</div>
|
|
|