Create Custom Softwareimage and Category#

New software images and categories can now be created.

Although they can be built from scratch using the add command, cloning the previously created defaults ensures that all previously applied settings (such as kernelparameters and disksetup) are copied across automatically. This reduces the amount of customization required after creation.

In this example, the software image is a simple clone of the default-image with no modifications, while the category is cloned from the default but configured to use the newly cloned software image.

Note

Managing packages in a software image is beyond the scope of this guide. For more information about managing packages in a software image, please refer to the BCM Administrator Manual.

Create the custom-image softwareimage.

a. Enter cmsh.
```
root@nvidia-era-bcm-01:~# cmsh
```
b. Enter the softwareimage mode.
```
[nvidia-era-bcm-01]% softwareimage
```
c. List the current software images.
```
[nvidia-era-bcm-01->softwareimage]% list
```
Figure 86 Terminal output after entering cmsh and listing software images#

d. Clone the default image, naming the new image to custom-image.
```
[nvidia-era-bcm-01->softwareimage]% clone default-image custom-image
```
e. Commit the changes to start the cloning process and wait for it to complete.
```
[nvidia-era-bcm-01->softwareimage*[custom-image*]]% commit
```
Figure 87 Terminal output after committing the custom-image clone#

f. Exit to return to the softwareimage mode and list the softwareimages to confirm creation.
```
[nvidia-era-bcm-01->softwareimage*[custom-image]]% exit
[nvidia-era-bcm-01->softwareimage]% list
```
Figure 88 List of software images confirming custom-image creation#
Backup the default category and set the softwareimage.

a. Enter the category mode.
```
[nvidia-era-bcm-01->softwareimage]% category
```
b. List the current categories.
```
[nvidia-era-bcm-01->category]% list
```
Figure 89 List of current categories#

c. Clone the default category, naming the new category custom.
```
[nvidia-era-bcm-01->category]% clone default custom
```
d. Set the softwareimage to point to the custom-image created in the previous steps.
```
[nvidia-era-bcm-01->category*[custom*]]% set softwareimage custom-image
```
e. Commit the changes.
```
[nvidia-era-bcm-01->category*[custom*]]% commit
```
f. Exit to return to the category mode and list the categories to confirm creation.
```
[nvidia-era-bcm-01->category*[custom]]% exit
[nvidia-era-bcm-01->category]% list
```
Figure 90 List of categories confirming custom category creation#