Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
219 lines (180 sloc) 7.2 KB

vROpsCLI Usage - Version 1.2.0

1 - Basic Usage

Welcome to vROpsCLI! This utility provides an array of functions to assist in managing your vROps system from the command line.

First authentication will need to be setup. For simple usage you can simply pass your credentials via the command line:

vropscli --user adminuser --password SuperSecurePass1234 --host vrops12.mydomain.com

You may also save the credentials to a local file, $HOME/.vropscli.yml WARNING: This file should be protected with OS level permission. ANYONE with this file will have credentials to your vROps system!!! While the password is encoded to prevent simple reading, a sophisticated attacker could obtain this password. To save your credentail:

vropscli --user adminuser --password SuperSecurePass1234 --host vrops12.mydomain.com saveCliCred

Test by running vropscli getAdapters and verify you are getting current information back. Your password will be encoded to prevent easy copying. If you need to change the password, rerun the saveCliCred command above.

Note: vROpsCLI assumes you vROps system is fully booting up and the cluster is fully online. Undefined behavior will result if using this utility against a system that is not fully started.

2 - Install/Upgrade Management Packs

First, you will need to upload the management pack...this may take some time. By default, this will overwrite an existing pack! It can be overridden by passing --nooverwritePak

vropscli uploadPak OracleDatabase-6.3_1.2.0_b20180319.144115.pak

Once the upload is done, you will be provided with a pak_id. Use that to start to install/upgrade. By default, this will reset the default content in the Pak! It can be overridden by passing --noforce-content-update

vropscli installPak OracleDatabase-12020180319144115

You can track the current progress with

vropscli getCurrentActivity

3 - Install Licensing

First determine the id of the solution that was installed as part of the Management pack

vropscli getSolution solution

Use the "id" from above for the correct management pack to install the license

vropscli setSolutionLicense OracleDatabase 4/trialparticipant/06-20-2018-17:30:18/BM-VREALIZE-ORACLE-DB/trial/06-22-2018-17:30:18/MP/accumulating/BM-VREALIZE-ORACLE-DB/Unlimited/C4B2F9E09CF0BADB867F1DAAF32AEAC6DDAF6473

Get current licenses installed

vropscli getSolutionLicense OracleDatabase

4 - Stop/Start Adapter Instances

Lookup Adapter Instance UUIDs

vropscli getAdapters

Stop Adapter Instance

vropscli stopAdapterInstance 9516b17d-f2a5-4da0-ab12-c4998dc0889e

Start Adapter Instance

vropscli startAdapterInstance 9516b17d-f2a5-4da0-ab12-c4998dc0889e

Checking the Status of Adapter Instances

vropscli getAdapterCollectionStatus 9516b17d-f2a5-4da0-ab12-c4998dc0889e

Exit code will be 0 for successful collection, 1 for all other states

5 - Creating new adapter instances

  1. Setup one instance of the adapter will act as a template for all settings and credentials.
  2. Determine the specific adapter and the AdapterKind from the example you created
    vropscli getAdapters
    
    The Name is the second field. Record the following info for the adapter you just created
    • UUID (1st field)
    • AdapterKind (3rd field)
  3. Generate an example CSV file based on the example you created, using the AdapterKind for step 1
    vropscli getAdapterConfig  62cae133-2233-4880-9136-a07e2f00ecfa > newadapter.csv
    
  4. If you are using a different credential for the new adapters, obtain the UUID of that credential
    vropscli getAllCredentials 
    
  5. (Opt): If you plan to assign an adapter to a specific collector, you will want to identify the ID of the new collector with the following command
    vropscli getCollectors
    
  6. Adjust the CSV file to include all the new instances based on the example you created. The initial "example" should be removed from the csv. You should leave the adapterKey blank. Once complete, create the new instances
    vropscli createAdapterInstances <CSVfile> 
    
    Example:
    vropscli createAdapterInstances newadapter.csv 
    

6 - Updating Existing Adapter Instances

  1. Identify the Adapter kind of the adapters you wish to update

    vropscli getAdapterKinds
    
  2. Generate an CSV of the existing configuration

    vropscli getAdaptersConfigs POSTGRESQL_ADAPTER > adapter.csv
    
  3. (Opt): If you plan to update the collectors, you will want to identify the ID of the new collector with the following command

    vropscli getCollectors
    
  4. If you are planning to change credentials, obtain the UUID of the new credential

    vropscli getAllCredentials 
    
    1. Adjust the CSV file, then run the update process
    vropscli updateAdapterInstances <CSVfile> 
    

    Example:

    vropscli updateAdapterInstances nagios-existing.csv
    

7 - Update Alert Definitions

  1. Identify the Adapter kind of the adapters you wish to update
    vropscli getAdapterKinds
    
  2. Generate an file of all existing alert definitions of the adapter type you wish to use
    vropscli getAlertsDefinitionsByAdapterKind <AdapterKind> > <file>
    
    Example:
    vropscli getAlertsDefinitionsByAdapterKind HPE3PAR_ADAPTER > alert.json
    
  3. Modify the file as desired
  4. Use that file to update all existing alert definitions
    vropscli updateAlertDefinitions <file>
    
    Example:
    vropscli updateAlertDefinitions alert.json
    

8 - Create Credentials

  1. In to vRealize GUI, create a single credential in the management pack of your choice. This credential will serve as a template for creating the new instances
  2. Determine the UUID of the new credentials (will be in the "id" field)
    vropscli getAllCredentials
    
  3. Build out a CSV file containing the details of this credentials. Note, no passwords will actually be exported.
    vropscli getCredential <UUID> > <filename>
    
    Example:
    vropscli getCredential f6493da5-a062-4271-a5ad-524dcf41a996 > credential.csv
    
  4. Open up the CSV, and create new entries for the new credentials you wish to use. Note any password fields will need to be populated with actual passwords. Make sure to remove the origianl "template" entry so that it is not readded.
  5. Import the new credentials. The output of this command will also show the UUID that can be used in #5 - Creating Adapter Instances, and #6 - Updating Adapter instances
    vropscli createCredentials <filename>
    
    Exmaple:
    vropscli createCredentials credential.csv
    

9 - Delete Credentials

  1. To remove credentials that are no longer in use, first identify the ID of the credential

    vropscli getAllCredentials
    
  2. Then remove the credential with the command

    vropscli deleteCredential <UUID>
    

    Example:

    vropscli deleteCredential 00f3527f-8211-4d48-9278-cff871e3abf5
    

10 - Error

Details errors can be produce by appending the "-v" flag to any command. For example:

vropscli uploadPak badfile.pak -v