Manage Cumulus Linux and NetQ Images

1. On the Manage Switch Assets page, click Image Management.

2. On the Cumulus Linux Images card, click the View # missing CL images link to see what images you need. This opens the list of missing images.

3. Select one or more of the missing images and make note of the version, ASIC Vendor, and CPU architecture for each.

4. Download the Cumulus Linux disk images (.bin files) needed for upgrade from the MyMellanox downloads page, selecting the appropriate version, CPU, and ASIC. Place them in an accessible part of your local network.

5. Back in the UI, click (Add Image) above the table.

6. Provide the .bin file from an external drive that matches the criteria for the selected image(s), either by dragging and dropping onto the dialog or by selecting from a directory.

7. Click Import.

8. Click Done.

9. Click Uploaded to verify the image is in the repository.

10. Click to return to the LCM dashboard.

    The Cumulus Linux Images card now shows the number of images you uploaded.

1. Download the Cumulus Linux disk images (.bin files) needed for upgrade from the MyMellanox downloads page, selecting the appropriate version, CPU, and ASIC. Place them in an accessible part of your local network.

2. Upload the images to the LCM repository. This example uses a Cumulus Linux 4.2.0 disk image.

   cumulus@switch:~$ netq lcm add cl-image /path/to/download/cumulus-linux-4.2.0-mlnx-amd64.bin
   

3. Repeat Step 2 for each image you need to upload to the LCM repository.

1. Click Image Management.

2. On the NetQ Images card, click the View # missing NetQ images link to see what images you need. This opens the list of missing images.

3. Select one or all of the missing images and make note of the OS version, CPU architecture, and image type. Remember that you need both netq-apps and neta-agent for NetQ to perform the installation or upgrade.

4. Download the NetQ debian packages needed for upgrade from the NetQ repository, selecting the appropriate OS version and architecture. Place the files in an accessible part of your local network.

5. Back in the UI, click (Add Image) above the table.

6. Provide the .deb file(s) from an external drive that matches the criteria for the selected image, either by dragging and dropping it onto the dialog or by selecting it from a directory.

7. Click Import.

8. Click Done.

9. Click Uploaded to verify the images are in the repository.

   When all of the missing images have been uploaded, the Missing list will be empty.

10. Click to return to the LCM dashboard.

    The NetQ Images card now shows the number of images you uploaded.

1. Download the NetQ debian packages needed for upgrade from the MyMellanox downloads page, selecting the appropriate version and hypervisor/platform. Place them in an accessible part of your local network.

2. Upload the images to the LCM repository. This example uploads the two packages (netq-agent and netq-apps) needed for NetQ version 3.3.1 for a NetQ appliance or VM running Ubuntu 18.04 with an x86 architecture.

   cumulus@switch:~$ netq lcm add netq-image /path/to/download/netq-agent_3.3.1-ub18.04u33~1614767175.886b337_amd64.deb
   cumulus@switch:~$ netq lcm add netq-image /path/to/download/netq-apps_3.3.1-ub18.04u33~1614767175.886b337_amd64.deb
   

1. Click Image Management.

2. Click Add Image on the Cumulus Linux Images or NetQ Images card.

   

3. Provide one or more images from an external drive, either by dragging and dropping onto the dialog or by selecting from a directory.

4. Click Import.

5. Monitor the progress until it completes. Click Done.

6. Click to return to the LCM dashboard.

   The NetQ Images card is updated to show the number of additional images you uploaded.

Use the netq lcm add cl-image <text-image-path> and netq lcm add netq-image <text-image-path> commands to upload the images. Run the relevant command for each image that needs to be uploaded.

Cumulus Linux images:

cumulus@switch:~$ netq lcm add image /path/to/download/cumulus-linux-4.2.0-mlx-amd64.bin

NetQ images:

cumulus@switch:~$ netq lcm add image /path/to/download/	netq-agent_3.3.1-ub18.04u33~1614767175.886b337_amd64.deb
cumulus@switch:~$ netq lcm add image /path/to/download/netq-apps_3.3.1-ub18.04u33~1614767175.886b337_amd64.deb

1. Click Image Management.

2. Click the Click here to set the default CL version link in the middle of the Cumulus Linux Images card, or click the Click here to set the default NetQ version link in the middle of the NetQ Images card.

   

3. Select the version you want to use as the default for switch upgrades.

4. Click Save. The default version is now displayed on the relevant Images card.

To specify a default Cumulus Linux version, run:

cumulus@switch:~$ netq lcm add default-version cl-images <text-cumulus-linux-version>

To specify a default NetQ version, run:

cumulus@switch:~$ netq lcm add default-version netq-images <text-netq-version>

1. Click change next to the currently identified default image on the Cumulus Linux Images or NetQ Images card.

2. Select the image you want to use as the default version for upgrades.

3. Click Save.

To change the default Cumulus Linux version, run:

cumulus@switch:~$ netq lcm add default-version cl-images <text-cumulus-linux-version>

To change the default NetQ version, run:

cumulus@switch:~$ netq lcm add default-version netq-images <text-netq-version>

1. Open the LCM dashboard.

2. Click Image Management.

3. Click Manage on the Cumulus Linux Images or NetQ Images card.

4. Optionally, use the filter option above the table on the Uploaded tab to narrow down a large listing of images.

5. Click above the table.

6. Choose the export file type and click Export.

Use the json option with the netq lcm show cl-images command to output a list of the Cumulus Linux image files stored in the LCM repository.

cumulus@switch:~$ netq lcm show cl-images json
[
    {
        "id": "image_cc97be3955042ca41857c4d0fe95296bcea3e372b437a535a4ad23ca300d52c3",
        "name": "cumulus-linux-4.2.0-vx-amd64-1594775435.dirtyzc24426ca.bin",
        "clVersion": "4.2.0",
        "cpu": "x86_64",
        "asic": "VX",
        "lastChanged": 1600726385400.0
    },
    {
        "id": "image_c6e812f0081fb03b9b8625a3c0af14eb82c35d79997db4627c54c76c973ce1ce",
        "name": "cumulus-linux-4.1.0-vx-amd64.bin",
        "clVersion": "4.1.0",
        "cpu": "x86_64",
        "asic": "VX",
        "lastChanged": 1600717860685.0
    }
]

1. Open the LCM dashboard.

2. Click Image Management.

3. Click Manage on the Cumulus Linux Images or NetQ Images card.

4. On Uploaded, select the images you want to remove. Use the filter option above the table to narrow down a large listing of images.

5. Click .

To remove Cumulus Linux images, run:

netq lcm show cl-images [json]
netq lcm del cl-image <text-image-id>

1. Determine the ID of the image you want to remove.

   cumulus@switch:~$ netq lcm show cl-images json
   [
       {
           "id": "image_cc97be3955042ca41857c4d0fe95296bcea3e372b437a535a4ad23ca300d52c3",
           "name": "cumulus-linux-4.2.0-vx-amd64-1594775435.dirtyzc24426ca.bin",
           "clVersion": "4.2.0",
           "cpu": "x86_64",
           "asic": "VX",
           "lastChanged": 1600726385400.0
       },
       {
           "id": "image_c6e812f0081fb03b9b8625a3c0af14eb82c35d79997db4627c54c76c973ce1ce",
           "name": "cumulus-linux-4.1.0-vx-amd64.bin",
           "clVersion": "4.1.0",
           "cpu": "x86_64",
           "asic": "VX",
           "lastChanged": 1600717860685.0
       }
   ]
   

2. Remove the image you no longer need.

   cumulus@switch:~$ netq lcm del cl-image image_c6e812f0081fb03b9b8625a3c0af14eb82c35d79997db4627c54c76c973ce1ce
   

3. Verify it has been removed.

   cumulus@switch:~$ netq lcm show cl-images json
   [
       {
           "id": "image_cc97be3955042ca41857c4d0fe95296bcea3e372b437a535a4ad23ca300d52c3",
           "name": "cumulus-linux-4.2.0-vx-amd64-1594775435.dirtyzc24426ca.bin",
           "clVersion": "4.2.0",
           "cpu": "x86_64",
           "asic": "VX",
           "lastChanged": 1600726385400.0
       }
   ]
   

To remove NetQ images, run:

netq lcm show netq-images [json]
netq lcm del netq-image <text-image-id>

1. Determine the ID of the image you want to remove.

   cumulus@switch:~$ netq lcm show netq-images json
   [
       {
           "id": "image_d23a9e006641c675ed9e152948a9d1589404e8b83958d53eb0ce7698512e7001",
           "name": "netq-agent_3.3.0-cl4u32_1609391187.7df4e1d2_amd64.deb",
           "netqVersion": "3.3.0",
           "clVersion": "cl4u32",
           "cpu": "x86_64",
           "imageType": "NETQ_AGENT",
           "lastChanged": 1609885430638.0
       }, 
       {
           "id": "image_68db386683c796d86422f2172c103494fef7a820d003de71647315c5d774f834",
           "name": "netq-apps_3.3.0-cl4u32_1609391187.7df4e1d2_amd64.deb",
           "netqVersion": "3.3.0",
           "clVersion": "cl4u32",
           "cpu": "x86_64",
           "imageType": "NETQ_CLI",
           "lastChanged": 1609885434704.0
       }
   ]
   

2. Remove the image you no longer need.

   cumulus@switch:~$ netq lcm del netq-image image_68db386683c796d86422f2172c103494fef7a820d003de71647315c5d774f834
   

3. Verify it has been removed.

   cumulus@switch:~$ netq lcm show netq-images json
   [
       {
           "id": "image_d23a9e006641c675ed9e152948a9d1589404e8b83958d53eb0ce7698512e7001",
           "name": "netq-agent_3.3.0-cl4u32_1609391187.7df4e1d2_amd64.deb",
           "netqVersion": "3.3.0",
           "clVersion": "cl4u32",
           "cpu": "x86_64",
           "imageType": "NETQ_AGENT",
           "lastChanged": 1609885430638.0
       }
   ]