SkylineCLI: How to deploy a Skyline Collector
This blog post will show you how to use the Skyline CLI fling to deploy and configure a new Skyline collector.
Workflow
- Deployment of the OVA
- Register of the new Skyline collector
- Configure the Skyline collector
- Create Endpoints
Prerequisites:
- Skyline collector ova file
- Skyline CLI fling
- CSP API token
- Skyline collector information
- Environment information
- Credentials for the endpoints with the correct permissions
Download the Skyline collector:
Customer Connect Skyline Collector Download Link
Download the Skyline CLI
Skyline CLI Flings Download Link
CSP API Token
Procedure
- Log in to the VMware Cloud Services, select your user profile in the top-right corner, and click My Account.
- In the My Account page, click API Tokens, and then click Generate Token.
- Select the required organization roles (Skyline API). Set the expiration period and select OpenID.
- Click Generate.
- Copy or save the generated token.
Skyline Collector information
- FQDN
- IP address
- Netmask
- Gateway
- DNS Server
- Root password
- Proxy information
vSphere environment information
- vCenter FQDN
- vCenter user with deploy permissions
- ESXi host fqdn
- Datastore name
- Port group
Create users in your endpoints
Preparation
Create a folder and move all necessary files into the folder
1mkdir skylinecli
- move the ova and the extracted skylinecli into the folder
Create a empty json file in the folder
Example
1vi config.json
Content:
1{
2 "action": "setup",
3 "friendlyname": "FRIEDNLY-NAME",
4 "collector": "COLLECTOR-IP",
5 "username": "admin",
6 "password": "ADMIN-PASSWORD",
7 "provider": "Local",
8 "proxy": {
9 "proxyhost": "PROXY-FQDN",
10 "proxyport": "PROXY-PORT",
11 "proxyuser": "null",
12 "proxypassword": "null",
13 "verify": false
14 },
15 "rootpasspolicy": false,
16 "expirepasswordafter": "187",
17 "token": "CSP-API-TOKEN",
18 "autoupdate": true,
19 "debug": true,
20 "insecure": true,
21 "ova": true,
22 "deploy": {
23 "vc": "VCENTER-FQDN",
24 "vcuser": "VCENTER-USER",
25 "vcpassword": "VCENTER-PASSWORD",
26 "esxi": "ESXI-FQDN",
27 "datacenter": "DATACENTER-NAME",
28 "datastore": "DATASTORE-NAME",
29 "network": "PORTGROUP",
30 "hostname": "SKYLINE-COLLECTOR-HOSTNAME",
31 "IP0": "SKYLINE-COLLECTOR-IP",
32 "Netmask0": "SKYLINE-COLLECTOR-NETASMK",
33 "Gateway": "SKYLINE-COLLECTOR-GATEWAY",
34 "DNS": "SKYLINE-COLLECTOR-DNS",
35 "SourceOVA": "PATH-TO-OVA",
36 "FQDN": "SKYLINE-COLLECTOR-FQDN",
37 "SearchPath": "DOMAIN",
38 "PowerOn": true
39 },
40 "endpoints": {
41 "VCENTER-FQDN": {
42 "type": "VSPHERE",
43 "user": "SKYLINE-VCENTER-USER",
44 "password": "SKYLINE-VCENTER-USER-PASSWORD",
45 "port": "443"
46 },
47 "NSX-T-FQDN": {
48 "type": "NSX_T",
49 "user": "admin",
50 "password": "ADMIN-PASSWORD",
51 "port": "443"
52 }
53 }
54}
| Config ITEM | Description |
|---|---|
| action | Specifies the action the skylinecli will execute |
| friendlyname | Friendly name which will be shown on the Skyline Advisor |
| collector | IP or FQDN of the new Skyline Collector |
| username | Default username of the Skyline Collector "DO NOT CHANGE IT" |
| password | New Skyline admin user password |
| provider | Local "DO NOT CHANGE IT" |
| verify | true / false - Hostname verification |
| rootpasspolicy | true / false - enable or disable root password expiry |
| expirepasswordafter | if root password expiry is enabled specify the amount of days when the password will expire |
| token | CSP API token |
| autoupdate | true / false - configure whether your Collector should auto-upgrade when a newer version is available |
| debug | true / false - SkylineCLI debug output |
| insecure | true / false - SSL certificate verification |
| Proxy section | |
|---|---|
| proxyhost | Proxy IP or FQDN |
| proxyport | Proxy port |
| proxyuser | Proxy user, if no username is required set it to null |
| proxypass | Proxy password, if no password is required set it to null |
| Deployment section | |
|---|---|
| vc | vCenter FQDN or IP |
| vcuser | vCenter user like administrator@vsphere.local |
| vcpassword | vCenter user password |
| esxi | ESXi FQDN or IP |
| datacenter | Datacenter name |
| datastore | Datastore name |
| network | Portgroup name |
| hostname | Skyline collector hostname |
| IP0 | Skyline collector IP |
| Netmask0 | Skyline collector netmask |
| Gateway | Skyline collector gateway |
| DNS | DNS Server comma separated |
| SourceOVA | Full path to the Skyline Collector OVA including filename |
| FQDN | Skyline collector FQDN |
| SearchPath | Domain search path |
| PowerOn | true / false - if the collector should be fully configured set it to true |
| Endpoints section | |
|---|---|
| ENDPOINT-FQDN | FQDN of vCenter, NSX-T, vROPS, LCM, VCF, Horizon, VRA |
| type | VSPHERE, NSX_T, VROPS, LCM, VCF, HORIZON, VRA |
| user | Endpoint user name |
| password | Endpoint user password |
| port | Endpoint port |
Deployment of the Skyline collector
1skylinecli --file=config.json
Output
