Install the Cisco APIC software using virtual media

Access the vKVM console:

1. Open the Cisco Integrated Management Controller (CIMC) GUI for the controller.

2. For an APIC -M1, M2, M3, L1, L2, or L3 server, from the CIMC GUI, choose Server > Summary > Launch KVM , then select either Java based KVM or HTML based KVM to access the KVM console.

   We recommend using the Java based KVM option whenever possible, because it is a more reliable option for larger-sized files.

3. For an APIC -M4/L4 server, from the CIMC GUI, choose Server > Summary > Launch vKVM to access the HTTP-based vKVM console.

Access the Serial over LAN (SOL) console :

1. From a terminal window, log in to the CIMC console:

   
                                   # 
                                   
                                       ssh admin@
                                       cimc_ip
                                   
                               

   Where cimc_ip is the CIMC IP address. For example:

   
                                   # 
                                   ssh admin@192.0.2.1
   admin@192.0.2.1's password: 
   system#
                               

2. Change the scope to virtual media:

   
                                   system# 
                                   scope vmedia
   system /vmedia #
                               

3. Map the .iso image to the HTTP server:

   
                                   system /vmedia # 
                                   
                                       map-www 
                                       volume_name
                                        http://
                                       http_server_ip_and_path
                                       iso_file_name
                                   
                               

   Where:

   • volume_name is the name of the volume.

   • http_server_ip_and_path is the IP address of the HTTP server and the path to the .iso file location.

   • iso_filename is the name of the .iso file.

   Note that there is a space between the http_server_ip_and_path and the iso_filename .

   For example:

   
                                   system /vmedia # 
                                   map-www apic http://198.51.100.1/home/images/ aci-apic-dk9.4.0.3d.iso
   Server username:
                               

4. Check the mapping status:

   
                                   system /vmedia # 
                                   show mappings detail
                               

   The Map-Status should be shown as OK .

5. Connect to SOL to monitor the installation process:

   
                                   system /vmedia # 
                                   connect host
                               

From the KVM console : Choose Power > Power Cycle System (cold boot) to power cycle the controller.

From the SOL console : Watch the screen during the boot process and prepare to press F6 at the appropriate moment to enter the boot selection menu.

Cisco Systems, Inc.
Configuring and testing memory..
Configuring platform hardware...
...

...
Press <F2> Setup, <F6> Boot Menu, <F7> Diagnostics, <F8> Cisco IMC COnfiguration, <F12> Network Boot

From the SOL console : When you see the message above, press F6 to enter the boot selection menu.

From the SOL console : At the boot selection menu, select the Cisco CIMC-Mapped vDVD1.22 option as the one-time boot device.

/------------------------------------\
| Please select boot device:         |
|------------------------------------|
| (Bus 05 Dev 00)PCI RAID Adapter    |
| UNIGEN PHF16H0CM1-DTE PMAP         |
| Cisco vKVM-Mapped vHDD1.22         |
| Cisco CIMC-Mapped vHDD1.22         |
| Cisco vKVM-Mapped vDVD1.22         |
| 
                        Cisco CIMC-Mapped vDVD1.22
                                 |
| Cisco vKVM-Mapped vFDD1.22         |
| UEFI: Built-in EFI Shell           |
| IBA GE Slot 0100 v1585             |
| IBA GE Slot 0101 v1585             |
| Enter Setup                        |
|------------------------------------|
|    ^ and v to move selection       |
|    ENTER to select boot device     |
|     ESC to boot using defaults     |
\------------------------------------/
                    

From the SOL console : Enter the following:

1. Determine if you want to enter the ISO URL to speed up the installation process.

   During the boot-up process, you might see the following message:

   To speed up the install, enter iso url in next ten minutes:

   You have two options at this stage:

   • Enter the ISO URL: This option will make the installation process go faster. Following is an example HTTP URL that you might enter here:

     http://10.75.61.1/aci-apic-dk9.4.2.1j.iso

     If you choose this option, you will be asked to provide the protocol type, as shown in the following example:

     
     ? 
                                             http://10.75.61.1/aci-apic-dk9.4.2.1j.iso
     ++ awk -F '/|:' '{print $4}'
     + urlip=10.75.61.1
     + '[' -z http://10.75.61.1/aci-apic-dk9.4.2.1j.iso ']'
     + '[' -z 10.75.61.1 ']'
     + break
     + '[' -n http://10.75.61.1/aci-apic-dk9.4.2.1j.iso ']'
     + set +e
     + configured=0
     + '[' 0 -eq 0 ']'
     + echo 'Configuring network interface'
     Configuring network interface
     + echo 'type static, dhcp, bash for a shell to configure networking, or url to re-enter the url: '
                                         

     Choose the appropriate protocol type:

     • static: If you choose this option, you will be asked to enter the interface name, management IP address and gateway. Following is an example of how to find the correct management interface:

       
       ? 
                                                       static
       + case $ntype in
       + configure_static
       + echo 'Available interfaces'
       Available interfaces
       + ls -l /sys/class/net
       total 0
       lrwxrwxrwx. 1 root root 0 Sep 26 16:04 enp11s0 -> ../../devices/pci0000:00/0000:00:03.0/0000:06:00.0/0000:07:01.0/0000:09:00.0/0000:0a:00.0/0000:0b:00.0/net/enp11s0
       lrwxrwxrwx. 1 root root 0 Sep 26 16:04 enp12s0 -> ../../devices/pci0000:00/0000:00:03.0/0000:06:00.0/0000:07:01.0/0000:09:00.0/0000:0a:01.0/0000:0c:00.0/net/enp12s0
       lrwxrwxrwx. 1 root root 0 Sep 26 16:04 enp1s0f0 -> ../../devices/pci0000:00/0000:00:01.0/0000:01:00.0/net/enp1s0f0
       lrwxrwxrwx. 1 root root 0 Sep 26 16:04 enp1s0f1 -> ../../devices/pci0000:00/0000:00:01.0/0000:01:00.1/net/enp1s0f1
       lrwxrwxrwx. 1 root root 0 Sep 26 16:04 lo -> ../../devices/virtual/net/lo
       + read -p 'Interface to configure: ' interface
       Interface to configure:
       [anaconda] 1:main* 2:shell  3:log  4:storage-lo> Switch tab: Alt+Tab | Help: F1
                                                   

       In the output above, the network interface with the shorter pci numbering corresponds to the two Out-Of-Band management interfaces: enp1s0f0 (eth1-1) and enp1s0f1 (eth1-2). If both interfaces are cabled as they should be, you can select either of them. However, if only one interface has a cable connected to it, you must choose the interface that corresponds to the cabled port.

     • dhcp

     Also note that you do not have a space between the http_server_ip_and_path and the iso_filename for this ISO URL (for example, http://198.51.100.1/home/images/aci-apic-dk9.4.0.3d.iso ).

   • Do not enter the ISO URL: If you do not want to enter the ISO URL, the installation process starts after ten minutes. This option is not supported on Cisco APIC versions 5.3(x) , 6.0(2), and above.

   The system starts fetching the ISO at this point.

   
   + read -p 'Interface to configure: ' interface
   Interface to configure: enp1s0f0
   + read -p 'address: ' addr
   address: 10.75.39.72/24
   + read -p 'gateway: ' gw
   gateway: 10.75.39.254
   + ip addr add 10.75.39.72/24 dev enp1s0f0
   + ip link set enp1s0f0 up
   + ip route add default via 10.75.39.254
   ++ seq 1 2
   + for count in '$(seq 1 2)'
   + ping -c 1 10.75.61.1
   PING 10.75.61.1 (10.75.61.1) 56(84) bytes of data.
   64 bytes from 10.75.61.1: icmp_seq=1 ttl=125 time=0.875 ms
   --- 10.75.61.1 ping statistics ---
   1 packets transmitted, 1 received, 0% packet loss, time 0ms
   rtt min/avg/max/mdev = 0.875/0.875/0.875/0.000 ms
   + configured=1
   + break
   + '[' 1 -eq 0 ']'
   + echo 'Fetching http://10.75.61.1/aci-apic-dk9.4.2.1j.iso'
   Fetching http://10.75.61.1/aci-apic-dk9.4.2.1j.iso
   + wget -o /dev/null -O /tmp/cdrom.iso http://10.75.61.1/aci-apic-dk9.4.2.1j.iso
   

   You can track the status of the process by going to Tools > Stats in the KVM console .

2. Wait until you see the message poweroff in the SOL console, then exit from SOL by pressing Ctrl and x ( Ctrl+x ).

3. Change the scope to virtual media again:

   
                                   system# 
                                   scope vmedia
   system /vmedia #
                               

4. Unmap the .iso image that you mapped in 2.c :

   
                                   system /vmedia # 
                                   
                                       unmap 
                                       volume_name
                                   
                               

   At the Save mapping prompt, enter yes if you want to save the mapping or no if you do not want to save the mapping. For example:

   
                                   system /vmedia # 
                                   unmap apic
   Save mapping? Enther 'yes' or 'no' to confirm (CTRL-C to cancel) → 
                                   yes
   system /vmedia # 
                               

5. Connect back to SOL again:

   
                                   system /vmedia # 
                                   connect host
                               

From the KVM console : Choose Power > Power on System to power on the controller.

From the SOL console : Enter the following:

1. Enter the options for the initial setup, such as fabric name, number of controllers, tunnel endpoint address pool, and infra VLAN ID to complete the installation process.