Cisco Virtual Infrastructure Manager Administrator Guide, Release 2.2

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents

Find Matches in This Book

Available Languages

Download Options

Book Title

Cisco Virtual Infrastructure Manager Administrator Guide, Release 2.2

Chapter Title

Day 2 Operations of Cisco VIM Insight

PDF - Complete Book (4.69 MB) PDF - This Chapter (1.26 MB)
View with Adobe Reader on a variety of devices

Results

Updated:: January 30, 2018

Chapter: Day 2 Operations of Cisco VIM Insight

Shutting Down Cisco VIM Insight
Restarting Cisco VIM Insight
Restoring VIM Insight
Reconfiguring VIM Insight

Day 2 Operations of Cisco VIM Insight

The following topic guides you the details about the Day 2 Operations of Cisco VIM Insight.

Shutting Down Cisco VIM Insight
Restarting Cisco VIM Insight
Restoring VIM Insight
Reconfiguring VIM Insight

Shutting Down Cisco VIM Insight

To stop the Cisco VIM Insight Container services, shut down Cisco UCS VIM Insight by running the systemctl stop service command.

Procedure

Step 1

Step 2

Stop the Insight service by running the following command from the Shell window:

systemctl stop docker-insight

Check the status of Insight Container by running the following command: docker ps -a | grep insight.
```
STATUS
Up 6 seconds
```
Check the status of the service by running the following command:
```
systemctl staus docker-insight
```

The following information is displayed

Docker-insight.service – Insight Docker Service
Loaded: loaded (/usr/lib/systemd/system/docker-insight.service; enabled; vendor preset: disabled)
Active: inactive (dead) since <Date and Time since it was last active>

Restarting Cisco VIM Insight

Procedure

Step 1

Step 2

Restart the Insight service by running the following command from the shell window:

systemctl restart docker-insight

Check the status of Insight container by running the following command: docker ps -a | grep insight.
```
STATUS
Up 6 seconds
```
Check the status of the service by running the following command:
```
systemctl status docker-insight
```

The following output is displayed:

Docker-insight.service – Insight Docker Service
Loaded: loaded (/usr/lib/systemd/system/docker-insight.service; enabled; vendor preset: disabled)
Active: active (running) since <Date and Time when it got active.>

Restoring VIM Insight

Cisco VIM Insight can be restored to its previous running state which existed at the time of backup.

Note

Insight should not be running on the node on which restore operation will be performed

Procedure

Step 1

Re-image the Insight management node with the ISO version with which you want to restore the node, and with the same IP address that is used before the failure of the node.

Note

NOTE: Skip Step 1 if re-image already done with the ISO during management node restore. Insight restore can also be performed without re-image with ISO . Uninstall the Insight through bootstrap_insight.py and then restoring it by following below mentioned steps but this needs to be only done when you face issues with Insight and not in case of management node failure.

Step 2

Navigate to /var/cisco/insight_backup/ directory at the remote server where the backup directory was copied during the backup operation.

Step 3

Copy the backup file to the /var/cisco/insight_backup/ directory of the re-imaged management node. For example, to copy the backup directory from the remote host 20.0.0.5 to the management node /var/cisco/insight_backup/directory, execute the following command sequence: rsync -e ssh -rtvpX --numeric-ids root@20.0.0.5:/var/cisco/insight_backup/backup_2017-01-09_14-04-38 /var/cisco/insight_backup.

Step 4

In /var/cisco/insight_backup/backup_<date-time> directory, execute the following command:

# ./insight_restore –h

insight_restore  : Cisco VIM Insight Restore Script
----------------------------------------------------

 Usage: ./insight_restore


 -v          : Enable verbose mode

 -h          : To display this help message


    # ./insight_restore
    This will initiate an Insight install with the backed up data.

VIM Insight restore logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+



Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule	     | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS | None |
| Valid Key Check in Insight Setup Data	   |  PASS | None |
| Duplicate Key Check In Insight Setup Data |  PASS | None |
+-------------------------------------------+--------+-------+

Setting up Insight, Kindly wait!!!

Cisco VIM Insight Installed successfully!
+-----------------------+--------+---------------------------------------------------------+
| Description           | Status | Details                                                 |
+-----------------------+--------+---------------------------------------------------------+
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                                   |
| VIM UI Admin Email ID | PASS   | Check for info @: <abs path of insight_setup_data.yaml> |
|                       |        |           					                 | 
| VIM UI Admin Password | PASS   | Check for info @ /opt/cisco/insight/secrets.yaml        |
| VIM Insight Workspace | PASS   | /root/<insight_ws>                                             |
+-------------------+-------+------------------------------------------------+

VIM Insight restore successfully completed!

Done with VIM Insight restore!
VIM Insight restore logs are at: /var/log/insight/bootstrap_insight/

As the summary table describes, your VIM Insight workspace is restored and hence you need to use bootstrap_insight.py from the mentioned workspace for performing any actions from here on.

Step 5

Verify Insight status after restore operation.

# cd /root/<insight_ws>
           # ./bootstrap_insight.py –a install-status

   Cisco VIM Insight Install Status!
+-----------------------+--------+----------------------------------+
| Description           | Status | Details                          |
+-----------------------+--------+----------------------------------+
| VIM Insight Version   | PASS   | <release_tag>                    |
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                |
| VIM Insight Container | PASS   | insight_<tag_id>                 |
| VIM Mariadb Container | PASS   | mariadb_<tag_id>                 |
| VIM Insight Workspace | PASS   | /root/<insight_ws>               |
+-----------------------+--------+----------------------------------+

Reconfiguring VIM Insight

Insight reconfigure action provides you with three major functionalities:

Reconfigure Insight TLS Certificate.
Switch from Self Signed TLS Certificate to 3^rd Party TLS Certificate.
Reconfigure Insight MySQL Database Password.

Note

Insight reconfigure is not allowed after an update, as update is an intermediate stage between rollback and commit.

Reconfiguring Insight TLS Certificate
Reconfiguring Insight MySQL Database Password
Update VIM Insight
Commit VIM Insight

Reconfiguring Insight TLS Certificate

As the Insight web-service is protected by TLS, hence reconfigure action provides flexibility to change the existing TLS Certificate. As there were two approaches to configure it, there are also two approaches to change it.

Reconfigure 3rd Party TLS Certificate
Reconfigure Self Signed TLS Certificate
Switch from Self Signed TLS Certificate to 3rd Party TLS Certificate

Reconfigure 3^rd Party TLS Certificate

If you had provided your own TLS Certificate before Insight Installation through PEM_PATH key in insight_setup_data.yaml, then follow the below mentioned steps to reconfigure it.

Procedure

Step 1

To reconfigure the 3rd Party TLS certification run the following command:

# cd <path insight_setup_data.yaml>

Step 2

Open insight_setup_data.yaml file.

# vi insight_setup_data.yaml

Step 3

Edit the insight_setup_data.yaml to change value of PEM_PATH key to point to path of your new valid TLS Certificate. Save the file after editing. For example: PEM_PATH: "/root/new_tls.pem"

Note

Only change in value of PEM_PATH key is allowed during reconfigure. Any change detected in insight_setup_data.yaml other than PEM_PATH value will result in failure of Insight reconfigure.

Step 4

Run the bootstrap command as follows:

# cd <insight_ws>
# ./bootstrap_insight.py –a reconfigure –f <path_to insight_setup_data.yaml>

VIM Insight reconfigure logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log

Perform the action. Continue (Y/N)y
Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule	     | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS | None |
| Valid Key Check in Insight Setup Data	   |  PASS | None |
| Duplicate Key Check In Insight Setup Data |  PASS | None |
| Config Change Check in Insight Setup Data |  PASS  | None  |
+-------------------------------------------+--------+-------+

WARNING!! reconfigure will have few secs of Outage for Insight!

Cisco VIM Insight Already Exists!
+-----------------------+--------+---------------------------------------------------------+
| Description           | Status | Details                                                 |
+-----------------------+--------+---------------------------------------------------------+
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                                   |
| VIM UI Admin Email ID | PASS   | Check for info @: <abs path of insight_setup_data.yaml> |
|                       |        |           					                 | 
| VIM UI Admin Password | PASS   | Check for info @ /opt/cisco/insight/secrets.yaml        |
| VIM Insight Workspace | PASS   | /root/<insight_ws>                                          |
           +-----------------------+--------+---------------------------------------------------------+
Cisco VIM Insight backup Info!
+-----------------------+--------+--------------------------------------------------------------+
| Description           | Status | Details                                                      |
+-----------------------+--------+--------------------------------------------------------------+
| Insight backup Status | PASS   | Backup done @                                                |
|                       |        | /var/cisco/insight_backup/backup-<release_tag>-<date_time>   |
+-----------------------+--------+--------------------------------------------------------------+

Done with VIM Insight reconfigure!
VIM Insight reconfigure logs are at: "/var/log/insight/bootstrap_insight/"

As the summary table describes Insight gets autobacked up after reconfigure at /var/cisco/insight_backup to preserve the latest state of Insight.

Reconfigure Self Signed TLS Certificate

If you had created a new TLS Certificate through tls_insight_cert_gen.py before Insight Installation then follow the below mentioned steps to reconfigure it.

Procedure

Step 1

Run the following commands to reconfigure the self signed TLS certificate:

# cd <insight_ws>
# ./tls_insight_cert_gen.py –h
usage: tls_insight_cert_gen.py [-h] [--overwrite] --file INSIGHTSETUPDATA 
TLS cert generator Insight

optional arguments:
  -h, --help          show this help message and exit
--overwrite, -o       Overwrite Insight certificates if already present in   openstack config directory
--file INSIGHTSETUPDATA, -f INSIGHTSETUPDATA
 Location of insight_setup_data.yaml 
	    # ./tls_insight_cert_gen.py –f <path insight_setup_data.yaml> --overwrite
		This will overwrite the existing TLS certificate.

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Ansible Version         |  PASS  | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule                                      | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS  | None  |
| Valid Key Check in Insight Setup Data     |  PASS  | None  |
| Duplicate Key Check In Insight Setup Data |  PASS  | None  |
| Test Email Server for Insight             |  PASS  | None  |
+-------------------------------------------+--------+-------+

Generating a 4096 bit RSA private key
.....................................................................................++
.......++
writing new private key to '../openstack-configs/insight.key'

Step 2

Following are the steps to run the bootstrap:

# ./bootstrap_insight.py –a reconfigure –f <path_to insight_setup_data.yaml>
VIM Insight reconfigure logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log

Perform the action. Continue (Y/N)y

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Ansible Version         |  PASS  | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule                                      | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS  | None  |
| Valid Key Check in Insight Setup Data     |  PASS  | None  |
| Duplicate Key Check In Insight Setup Data |  PASS  | None  |
| Config Change Check in Insight Setup Data |  PASS  | None  |
| Test Email Server for Insight             |  PASS  | None  |
+-------------------------------------------+--------+-------+

WARNING!! reconfigure will have few secs of Outage for Insight
Cisco VIM Insight Already Exists!
+-----------------------+--------+---------------------------------------------------------+
| Description           | Status | Details                                                 |
+-----------------------+--------+---------------------------------------------------------+
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                                   |
| VIM UI Admin Email ID | PASS   | Check for info @: <abs path of insight_setup_data.yaml> |
|                       |        |           					                 | 
| VIM UI Admin Password | PASS   | Check for info @ /opt/cisco/insight/secrets.yaml        |
| VIM Insight Workspace | PASS   | /root/<insight_ws>                                          |
           +-----------------------+--------+---------------------------------------------------------+


Cisco VIM Insight backup Info!
+----------------------+-------+-------------------------------------------------------------------+
| Description          | Status| Details                                                           |
+----------------------+-------+-------------------------------------------------------------------+
| Insight backup Status| PASS  | Backup done @                                                     |
|                      |       | /var/cisco/insight_backup/insight_backup_<release_tag>_<date_time>|
+----------------------+-------+-------------------------------------------------------------------+

Done with VIM Insight reconfigure!
VIM Insight reconfigure logs are at: "/var/log/insight/bootstrap_insight/"

As the summary table describes Insight gets autobacked up after reconfigure at /var/cisco/insight_backup to preserve the latest state of Insight.

Switch from Self Signed TLS Certificate to 3^rd Party TLS Certificate

If you had created a new TLS Certificate via tls_insight_cert_gen.py before Insight Installation and now want to switch to your own TLS Certificate then follow the below mentioned steps.

Note

You cannot switch from 3^rd Party TLS Certificate to Self Signed TLS Certificate.

Procedure

Step 1

To switch from self signed TLS Certificate to 3rd party TLS certificate open and edit the insight_setup_data.yaml to add PEM_PATH by running the following command:

# cd <path insight_setup_data.yaml>
# vi insight_setup_data.yaml
Edit the insight_setup_data.yaml to add PEM_PATH key to point to path of your new valid TLS Certificate. Save the file after editing.
For example:
PEM_PATH: “/root/new_tls.pem”

Note

Only addition of PEM_PATH key is allowed during reconfigure. Any change detected in insight_setup_data.yaml other than PEM_PATH value will result in failure of Insight reconfigure.

Step 2

Following is the command to run the bootstrap:

# cd <insight_ws>
 # ./bootstrap_insight.py –a reconfigure –f <path_to insight_setup_data.yaml>

VIM Insight reconfigure logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log
Perform the action. Continue (Y/N)y

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Ansible Version         |  PASS  | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule                                      | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS  | None  |
| Valid Key Check in Insight Setup Data     |  PASS  | None  |
| Duplicate Key Check In Insight Setup Data |  PASS  | None  |
| Config Change Check in Insight Setup Data |  PASS  | None  |
| Test Email Server for Insight             |  PASS  | None  |
+-------------------------------------------+--------+-------+

WARNING!! reconfigure will have few secs of Outage for Insight!

Cisco VIM Insight Already Exists!
+-----------------------+--------+---------------------------------------------------------+
| Description           | Status | Details                                                 |
+-----------------------+--------+---------------------------------------------------------+
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                                   |
| VIM UI Admin Email ID | PASS   | Check for info @: <abs path of insight_setup_data.yaml> |
|                       |        |           					                 | 
| VIM UI Admin Password | PASS   | Check for info @ /opt/cisco/insight/secrets.yaml        |
| VIM Insight Workspace | PASS   | /root/<insight_ws>                                          |
           +-----------------------+--------+---------------------------------------------------------+

Cisco VIM Insight backup Info!
+----------------------+-------+-------------------------------------------------------------------+
| Description          | Status| Details                                                           |
+----------------------+-------+-------------------------------------------------------------------+
| Insight backup Status| PASS  | Backup done @                                                     |
|                      |       | /var/cisco/insight_backup/insight_backup_<release_tag>_<date_time>|
+----------------------+-------+-------------------------------------------------------------------+

Done with VIM Insight reconfigure!
VIM Insight reconfigure logs are at: "/var/log/insight/bootstrap_insight/"

As the summary table describes Insight gets autobacked up after reconfigure at /var/cisco/insight_backup to preserve the latest state of Insight.

Reconfiguring Insight MySQL Database Password

There are two approaches to reconfigure MySQL DB password:

System generated Insight DB password.
User supplied Insight DB password.

System generated Insight DB password
User supplied Insight DB password
Reconfigure Insight SMTP Server

System generated Insight DB password

Following are the steps to generate MySQL Insight DB password:

Procedure

Step 1

To generate the Insight DB Password run the following command:

# cd <insight_ws>
 # ./bootstrap_insight.py –a reconfigure –f <path_to insight_setup_data.yaml> --regenerate_secrets

VIM Insight reconfigure logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log
Perform the action. Continue (Y/N)y
Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule	     | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS | None |
| Valid Key Check in Insight Setup Data	   |  PASS | None |
| Duplicate Key Check In Insight Setup Data |  PASS | None |
| Config Change Check in Insight Setup Data |  PASS  | None  |
+-------------------------------------------+--------+-------+

WARNING!! reconfigure will have few secs of Outage for Insight!

Cisco VIM Insight Already Exists!
+-----------------------+--------+---------------------------------------------------------+
| Description           | Status | Details                                                 |
+-----------------------+--------+---------------------------------------------------------+
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                                   |
| VIM UI Admin Email ID | PASS   | Check for info @: <abs path of insight_setup_data.yaml> |
|                       |        |           					                 | 
| VIM UI Admin Password | PASS   | Check for info @ /opt/cisco/insight/secrets.yaml        |
| VIM Insight Workspace | PASS   | /root/<insight_ws>                                          |
           +-----------------------+--------+---------------------------------------------------------+

Cisco VIM Insight backup Info!
+-----------------------+--------+--------------------------------------------------------------+
| Description           | Status | Details                                                      |
+-----------------------+--------+--------------------------------------------------------------+
| Insight backup Status | PASS   | Backup done @                                                |
|                       |        | /var/cisco/insight_backup/backup-<release_tag>-<date_time>   |
+-----------------------+--------+--------------------------------------------------------------+
Done with VIM Insight reconfigure!
VIM Insight reconfigure logs are at: "/var/log/insight/bootstrap_insight/"
As the summary table describes Insight gets autobacked up after reconfigure at /var/cisco/insight_backup to preserve the latest state of Insight.

Step 2

Verify the password change by running the following command:

# cat /opt/cisco/insight/secrets.yaml
	DB_ROOT_PASSWORD: <new_db_password>

User supplied Insight DB password

Procedure

Step 1

To provide your own MYSQL DB Password follow the below steps:

Note

Your new DB password must contain alphanumeric characters and should be at least 8 characters long.

# cd <insight_ws>
# ./bootstrap_insight.py –a reconfigure –f <path_to insight_setup_data.yaml> --setpassword

VIM Insight reconfigure logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log
Perform the action. Continue (Y/N)y
Password for DB_ROOT_PASSWORD: <enter_valid_db_password>

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Ansible Version         |  PASS  | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule	     | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS | None |
| Valid Key Check in Insight Setup Data	   |  PASS | None |
| Duplicate Key Check In Insight Setup Data |  PASS | None |
| Config Change Check in Insight Setup Data |  PASS  | None  |
+-------------------------------------------+--------+-------+
WARNING!! reconfigure will have few secs of Outage for Insight!

Cisco VIM Insight Already Exists!
+-----------------------+--------+---------------------------------------------------------+
| Description           | Status | Details                                                 |
+-----------------------+--------+---------------------------------------------------------+
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                                   |
| VIM UI Admin Email ID | PASS   | Check for info @: <abs path of insight_setup_data.yaml> |
|                       |        |           					                 | 
| VIM UI Admin Password | PASS   | Check for info @ /opt/cisco/insight/secrets.yaml        |
| VIM Insight Workspace | PASS   | /root/<insight_ws>                                          |
           +-----------------------+--------+---------------------------------------------------------+

Cisco VIM Insight backup Info!
+----------------------+-------+-------------------------------------------------------------------+
| Description          | Status| Details                                                           |
+----------------------+-------+-------------------------------------------------------------------+
| Insight backup Status| PASS  | Backup done @                                                     |
|                      |       | /var/cisco/insight_backup/insight_backup_<release_tag>_<date_time>|
+----------------------+-------+-------------------------------------------------------------------+
Done with VIM Insight reconfigure!
VIM Insight reconfigure logs are at: "/var/log/insight/bootstrap_insight/"

As the summary table describes Insight gets autobacked up after reconfigure at /var/cisco/insight_backup to preserve the latest state of Insight.

Step 2

Verify the password change by running the following command:

# cat /opt/cisco/insight/secrets.yaml
DB_ROOT_PASSWORD: <new_db_password>

Reconfigure Insight SMTP Server

Insight requires a valid SMTP Server to send mails to users (Pod-Admin, UI-Admin and regular users). If SMTP Server goes down due to any reason you can reconfigure it.

Procedure

Step 1

Following are the steps to reconfigure the SMTP server:

# cd <path insight_setup_data.yaml>
Open insight_setup_data.yaml file
# vi insight_setup_data.yaml
Edit the insight_setup_data.yaml to change value of INSIGHT_SMTP_SERVER key. Save the file after editing.

Note

Only change in value of PEM_PATH and INSIGHT_SMTP_SERVER key is allowed during reconfigure. Any change detected in insight_setup_data.yaml other than these values will result in failure of Insight reconfigure.

Step 2

Run the bootstrap command as follows:

# cd <insight_ws>
# ./bootstrap_insight.py –a reconfigure –f <path_to insight_setup_data.yaml>
VIM Insight reconfigure logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log
Perform the action. Continue (Y/N)y

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Ansible Version         |  PASS  | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule                                      | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS  | None  |
| Valid Key Check in Insight Setup Data     |  PASS  | None  |
| Duplicate Key Check In Insight Setup Data |  PASS  | None  |
| Config Change Check in Insight Setup Data |  PASS  | None  |
| Test Email Server for Insight             |  PASS  | None  |
+-------------------------------------------+--------+-------+
WARNING!! reconfigure will have few secs of Outage for Insight!

Cisco VIM Insight Already Exists!
+-----------------------+--------+---------------------------------------------------------+
| Description           | Status | Details                                                 |
+-----------------------+--------+---------------------------------------------------------+
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                                   |
| VIM UI Admin Email ID | PASS   | Check for info @: <abs path of insight_setup_data.yaml> |
|                       |        |           					                 | 
| VIM UI Admin Password | PASS   | Check for info @ /opt/cisco/insight/secrets.yaml        |
| VIM Insight Workspace | PASS   | /root/<insight_ws>                                          |
           +-----------------------+--------+---------------------------------------------------------+

Cisco VIM Insight backup Info!
+----------------------+-------+-------------------------------------------------------------------+
| Description          | Status| Details                                                           |
+----------------------+-------+-------------------------------------------------------------------+
| Insight backup Status| PASS  | Backup done @                                                     |
|                      |       | /var/cisco/insight_backup/insight_backup_<release_tag>_<date_time>|
+----------------------+-------+-------------------------------------------------------------------+

Done with VIM Insight reconfigure!
VIM Insight reconfigure logs are at: "/var/log/insight/bootstrap_insight/"

As the summary table describes Insight gets autobacked up after reconfigure at /var/cisco/insight_backup to preserve the latest state of Insight.

Update VIM Insight

VIM Insight Update provides you the feature to switch to a new Insight release.

Following are some of the key points:

Procedure

Step 1

The update action will make the old docker containers of insight and mariadb in exit state and bring up new ones with the new tag.

Step 2

The old containers and images are restored until you perform the Commit action.

Step 3

Update is an intermediate action, from this state either you can do a Commit action to settle for the current version or do a rollback to revert back to the old version.

Step 4

The old workspace will be preserved in case you want to do a rollback to the previous version.

Step 5

After update your Insight workspace will be the new workspace you just extracted out of the tar ball.

Step 6

After an update operation, backup and reconfigure action is not allowed from either old or new Insight workspace.

Note

Do not delete your old Insight workspace until you have successfully performed a Commit to the new Insight update.

Update Scenarios

Update action has the following scenarios:

Insight and mariadb containers will get updated to a new tag.
Either insight or mariadb container will get updated to a new tag.

Update VIM Insight with Internet Access

Following are the steps to update VIM Insight:

Procedure

Step 1

Get the new installer tar ball, which will be available after each release.

Extract the tar ball to get the new Insight workspace by running the following command:

# tar –xvzf mercury-installer.tar.gz

Step 2

Update the VIM insight by running the following commands:

# cd /root/<new_insight_ws>.
/bootstrap_insight.py –a update 

VIM Insight update logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log
Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule	     | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS | None |
| Valid Key Check in Insight Setup Data	   |  PASS | None |
| Duplicate Key Check In Insight Setup Data |  PASS | None |
| Config Change Check in Insight Setup Data |  PASS  | None  |
    +-------------------------------------------+--------+-------+

Downloading Updated VIM Insight Artifacts, will take time!!!
Cisco VIM Insight update Info!
           +------------------------------------------+--------+------------------------------+
   | Description                              | Status | Details                       |
   +------------------------------------------+--------+-------------------------------+
   | VIM Insight Container: insight_<new_tag> | PASS   | Updated from insight_<old_tag>|
   | VIM Mariadb Container: mariadb_<new_tag> | PASS   | Updated from mariadb_<old_tag>|
   +------------------------------------------+--------+-------------------------------+
 Done with VIM Insight update!
 VIM Insight update logs are at: "/var/log/insight/bootstrap_insight/"

Step 3

Verify the Insight Update.

# ./bootstrap_insight.py –a update-status 
Cisco VIM Insight Update Status!
+------------------------------------------+--------+--------------------------------+
| Description                              | Status | Details                        |
+------------------------------------------+--------+--------------------------------+
| VIM Insight Container: insight_<new_tag> | PASS   | Updated from insight_<old_tag> |
| VIM Mariadb Container: insight_<new_tag> | PASS   | Updated from mariadb_<old_tag> |
+------------------------------------------+--------+--------------------------------+

VIM Insight without Internet Access

Procedure

Step 1	Copy the new installer tar ball to the Insight Management Node. Extract the tar ball to get the new Insight workspace by running the following command: # tar –xvzf mercury-installer.tar.gz
Step 2	To download the new Insight artifacts follow the steps given in Cisco_NFVI_Install_Guide_2_2 under Preparing to Install Cisco NFVI on Management Nodes Without Internet Access, page 41.
Step 3	Run Import Artifacts: # cd /root/installer_<tag_id>/tools # ./import_artifacts.sh This verifies that /var/cisco/artifcats on the management node has the following Insight artifacts, along with the other components 'insight-K9.tar' and 'mariadb-app-K9.tar'.'
Step 4	Update the Insight by running the following command: # cd ../insight/ # ./bootstrap_insight.py –a update VIM Insight update logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log Management Node Validations! +-------------------------------+--------+-------+ \| Rule \| Status \| Error \| +-------------------------------+--------+-------+ \| Check Kernel Version \| PASS \| None \| \| Check Ansible Version \| PASS \| None \| \| Check Docker Version \| PASS \| None \| \| Check Management Node Tag \| PASS \| None \| \| Check Bond Intf. Settings \| PASS \| None \| \| Root Password Check \| PASS \| None \| \| Check Boot Partition Settings \| PASS \| None \| \| Check LV Swap Settings \| PASS \| None \| \| Check Docker Pool Settings \| PASS \| None \| \| Check Home Dir Partition \| PASS \| None \| \| Check Root Dir Partition \| PASS \| None \| \| Check /var Partition \| PASS \| None \| \| Check LVM partition \| PASS \| None \| \| Check RHEL Pkgs Install State \| PASS \| None \| +-------------------------------+--------+-------+ Insight standalone Input Validations! +-------------------------------------------+--------+-------+ \| Rule \| Status \| Error \| +-------------------------------------------+--------+-------+ \| Insight standalone Schema Validation \| PASS \| None \| \| Valid Key Check in Insight Setup Data \| PASS \| None \| \| Duplicate Key Check In Insight Setup Data \| PASS \| None \| \| Config Change Check in Insight Setup Data \| PASS \| None \| +-------------------------------------------+--------+-------+ Updating VIM Insight, Kindly wait!!! Cisco VIM Insight update Info! +------------------------------------------+--------+------------------------------+ \| Description \| Status \| Details \| +------------------------------------------+--------+-------------------------------+ \| VIM Insight UI URL \| PASS \| https://<br_api:9000> \| \| VIM Insight Container: insight_<new_tag> \| PASS \| Updated from insight_<old_tag>\| \| VIM Mariadb Container: mariadb_<new_tag> \| PASS \| Updated from mariadb_<old_tag>\| \| VIM Insight Workspace \| PASS \| /root/<new_insight_ws> \| +------------------------------------------+--------+-------------------------------+ Done with VIM Insight update! VIM Insight update logs are at: "/var/log/insight/bootstrap_insight/"
Step 5	Verify Insight Update by running the following command: # ./bootstrap_insight.py –a update-status Cisco VIM Insight Update Status! +------------------------------------------+--------+--------------------------------+ \| Description \| Status \| Details \| +------------------------------------------+--------+--------------------------------+ \| VIM Insight Container: insight_<new_tag> \| PASS \| Updated from insight_<old_tag> \| \| VIM Mariadb Container: insight_<new_tag> \| PASS \| Updated from mariadb_<old_tag> \| +------------------------------------------+--------+--------------------------------+

Rollback VIM Insight

VIM Insight Rollback provides feature to revert to the old Insight release which is used before update.

Following are some key points related to the same.

The rollback action removes the new docker containers of insight and mariadb which got created after an update and bring up old ones with the old tag.
The new workspace will be left as it is in case you want to do an update operation later or in case VIM may be running from it.
After rollback your Insight workspace will be the old workspace which you were using before update.

Following are the steps to perform Insight rollback:

Procedure

Step 1

Run the following command to rollback VIM Insight:

# cd /root/<new_insight_ws>
# ./bootstrap_insight.py –a rollback

VIM Insight rollback logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Ansible Version         |  PASS  | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule	     | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS | None |
| Valid Key Check in Insight Setup Data	   |  PASS | None |
| Duplicate Key Check In Insight Setup Data |  PASS | None |
| Config Change Check in Insight Setup Data |  PASS  | None  |
    +-------------------------------------------+--------+-------+

 VIM Insight rollback in progress, Kindly wait!!!
 Cisco VIM Insight rollback Info!
           +------------------------------------------+--------+-------------------------------+
   | Description                              | Status | Details                        |
   +------------------------------------------+--------+--------------------------------+
   | VIM Insight UI URL                       | PASS   | https://<br_api:9000>          |
   | VIM Insight Container: insight_<old_tag> | PASS   | Rollback from insight_<new_tag>|
   | VIM Mariadb Container: mariadb_<old_tag> | PASS   | Rollback from mariadb_<new_tag>|
   | VIM Insight Workspace                    | PASS   | /root/<old_insight_ws>         |
   +------------------------------------------+--------+--------------------------------+
 Done with VIM Insight rollback!
 VIM Insight rollback logs are at: "/var/log/insight/bootstrap_insight/"

Step 2

Verify Rollback Status by running the following command:

 # ./bootstrap_insight.py –a install-status
Cisco VIM Insight Install Status!
+-----------------------+--------+----------------------------------+
| Description           | Status | Details                          |
+-----------------------+--------+----------------------------------+
| VIM Insight Version   | PASS   | <release_tag>                    |
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                |
| VIM Insight Container | PASS   | insight_<tag_id>                 |
| VIM Mariadb Container | PASS   | mariadb_<tag_id>                 |
| VIM Insight Workspace | PASS   | /root/<insight_ws>               |
+-----------------------+--------+----------------------------------+

Commit VIM Insight

Follow the below mentioned steps to perform Insight commit:

Procedure

Step 1

Execute the following command to commit the VIM Insight:

# cd /root/<new_insight_ws>

Step 2

Run the bootstrap command as follows:

# ./bootstrap_insight.py –a commit
VIM Insight commit logs are at: /var/log/insight/<bootstrap_insight_<date>_<time>.log

Management Node Validations!
+-------------------------------+--------+-------+
| Rule	| Status | Error |
+-------------------------------+--------+-------+
| Check Kernel Version	|  PASS | None |
| Check Docker Version	|  PASS | None |
| Check Management Node Tag	|  PASS | None |
| Check Bond Intf. Settings	|  PASS | None |
| Root Password Check	|  PASS | None |
| Check Boot Partition Settings |  PASS | None |
| Check LV Swap Settings	|  PASS | None |
| Check Docker Pool Settings	|  PASS | None |
| Check Home Dir Partition	|  PASS | None |
| Check Root Dir Partition	|  PASS | None |
| Check /var Partition	|  PASS | None |
| Check LVM partition	|  PASS | None |
| Check RHEL Pkgs Install State |  PASS | None |
+-------------------------------+--------+-------+

Insight standalone Input Validations!
+-------------------------------------------+--------+-------+
| Rule	     | Status | Error |
+-------------------------------------------+--------+-------+
| Insight standalone Schema Validation      |  PASS | None |
| Valid Key Check in Insight Setup Data	   |  PASS | None |
| Duplicate Key Check In Insight Setup Data |  PASS | None |
| Config Change Check in Insight Setup Data |  PASS  | None  |
    +-------------------------------------------+--------+-------+

 VIM Insight commit in progress, Kindly wait!!!
 Cisco VIM Insight commit Info!
           +------------------------------------------+--------+---------------------------------------+
   | Description                              | Status | Details                                |
   +------------------------------------------+--------+----------------------------------------+
   | VIM Insight UI URL                       | PASS   | Error! Hyperlink reference not valid.>                  |
   | VIM Insight Container: insight_<new_tag> | PASS   | Old container:insight_<old_tag> removed|
   | VIM Mariadb Container: mariadb_<new_tag> | PASS   | Rollback from mariadb_<old_tag> removed|
   | VIM Insight Workspace                    | PASS   | /root/<new_insight_ws>                 |
   +------------------------------------------+--------+----------------------------------------+

  Done with VIM Insight commit!
  VIM Insight commit logs are at: "/var/log/insight/bootstrap_insight/"

Step 3

Verify the Insight status by running the following command:

Verify Insight status
# ./bootstrap_insight.py –a install-status

Cisco VIM Insight Install Status!
+-----------------------+--------+----------------------------------+
| Description           | Status | Details                          |
+-----------------------+--------+----------------------------------+
| VIM Insight Version   | PASS   | <release_tag>                    |
| VIM Insight UI URL    | PASS   | https://<br_api:9000>                |
| VIM Insight Container | PASS   | insight_<tag_id>                 |
| VIM Mariadb Container | PASS   | mariadb_<tag_id>                 |
| VIM Insight Workspace | PASS   | /root/<insight_ws>               |
+-----------------------+--------+----------------------------------+

Was this Document Helpful?

Feedback

Contact Cisco

Open a Support Case
(Requires a Cisco Service Contract)

Cisco Virtual Infrastructure Manager Administrator Guide, Release 2.2

Bias-Free Language

Results

Chapter: Day 2 Operations of Cisco VIM Insight

Day 2 Operations of Cisco VIM Insight

Shutting Down Cisco VIM Insight

Restarting Cisco VIM Insight

Restoring VIM Insight

Reconfiguring VIM Insight

Reconfiguring Insight TLS Certificate

Reconfigure 3rd Party TLS Certificate

Reconfigure Self Signed TLS Certificate

Switch from Self Signed TLS Certificate to 3rd Party TLS Certificate

Reconfiguring Insight MySQL Database Password

System generated Insight DB password

User supplied Insight DB password

Reconfigure Insight SMTP Server

Update VIM Insight

Update Scenarios

Update VIM Insight with Internet Access

VIM Insight without Internet Access

Rollback VIM Insight

Commit VIM Insight

Was this Document Helpful?

Contact Cisco

Reconfigure 3^rd Party TLS Certificate

Switch from Self Signed TLS Certificate to 3^rd Party TLS Certificate