Appendix

Appendix A: Management Operations Using CLI

(I) Edit the /etc/hosts File

You can edit the /etc/hosts file using the sudo hosts command.


hosts [options...] -- Command to update the hosts file
options:
    add :adds the host to host file
    remove :remove the host from the host file
    list :lists the host in the host file
example:
    add:     $ sudo hosts add 1.2.3.4 localhost
    remove:  $ sudo hosts remove 1.2.3.4 localhost
    list:    $ sudo hosts (or) sudo hosts list 

(II) Change the IP Address of the IMM Transition Tool VM

Perform the following steps to change the IP address of the VM:

  1. SSH to the VM.

  2. Edit /etc/netplan/00-installer-config.yaml file using the below command:

    $ sudoedit /etc/netplan/00-installer-config.yaml
  3. Change the IP, Netmask, Gateway, and DNS fields as per your requirement.

  4. Edit netplan configuration using following doc: https://netplan.readthedocs.io/en/latest/examples/

  5. Save the file.

  6. Reboot the VM using the below command:

    sudo reboot

(III) Change the Hostname/Domain name of the IMM Transition Tool VM

Perform the following steps to change the hostname of the VM:

  1. SSH to the VM.

  2. Run the below command:

    sudo hostnamectl <hostname>

Perform the following steps to change the domain name of the VM:

  1. SSH to the VM.

  2. Run the below command:

    sudo hostname --fqdn <FQDN>

(IV) Change the NTP of the IMM Transition Tool VM

Perform the following steps to change the NTP of the VM:

  1. SSH to the VM.

  2. Edit /etc/systemd/timesyncd.conf file using the below command:

    $ sudoedit /etc/systemd/timesyncd.conf
  3. Uncomment and change the value of ‘NTP=’ field.

  4. Save the file.

  5. Reboot the VM using the below command:

    sudo reboot

(V) Change the Admin Password

Perform the following steps to change the password of the admin:

  1. SSH to the VM.

  2. Run the below command:

    sudo passwd admin

  3. Enter the new password.

(VI) Self-sign or Renew the SSL Certificates

Perform the following steps to self-sign or renew/reset the HTTPS SSL certificates:

  1. SSH to the VM.

  2. Run the below command:

    ssl_cert

  • ssl_cert show : Display information about the SSL certificate currently in use.

  • ssl_cert renew : Renew self-signed SSL certificate with a validity of one year.

  • ssl_cert reset : Remove SSL certificate files from the /etc/data/certificates/ directory

Appendix B: Download Logs/Technical Support

In case you need any assistance, you can share the logs file with the technical team.

Perform the following steps to send your query:

  1. Go to the list view displaying all the transition records.

  2. Scroll down to the transition record for which you need technical assistance.

  3. Click present against the record.

  4. Click Download Logs.

  5. Save the logs file in your computer.

  6. Attach the saved logs file to the email and send the email with your queries/feedback to the imm-transition-feedback@cisco.com group.

Appendix D: Providing Feedback

Use the Feedback button on the top-right corner to provide feedback about the tool or information about the missing features.