Image Storage

ZStack ZSphere 4.10.6>ZStack ZSphere Documentation>ZStack ZSphere User Guide>Compute Management>Image Storage

Image storage acts as a repository for storing image templates containing operating systems, as well as disk images. Through image storage, you can share image files across multiple data centers.

This section introduces how to use image storage from the following chapters:

Image Storage Basic Operations

You can understand the basic operations supported by image storage from the perspective of adding, deleting, modifying, and querying.

Add a Standalone Image Storage
Add a Distributed Image Storage
Modify an Image Storage
View Image Storage Usage
Delete an Image Storage

Add a Standalone Image Storage

The platform provides multiple entry points to add image storage. You can add an image storage from the following two main entry points:

In the navigation bar on the left side of the platform page, right-click the target data center and click Add Image Storage.
In the navigation bar on the left side of the platform page, select the target data center. Then, on the right side of the platform page, click Actions > Add Image Storage, or in the Image Storage sub-page, click Add Image Storage.

In the Please Select Image Storage Type dialog, select Standalone Image Storage.

You can refer to the following examples to complete the configuration:

Step 1: Basic Configuration

Basic Information

Name: Image storage name
Description: Image storage description
Type: Displays standalone image storage
Data Center: Current data center

Configuration Information

Image Storage IP: IP address of the image storage server
SSH Port: Default port is 22, supports setting SSH port
Username: Default is root user, supports setting regular user
Password: Password for the user

Step 2: Storage Configuration

Disk Configuration

Addition Method: Supports Free Disk and Local Directory addition methods
If you choose Free Disk, configure the free disk parameters:
- Free Disk: Add unmounted partitions or unpartitioned disks on the image storage
  Note: Configuring a free disk will format the selected disk, completely clearing all partitions, file systems, and data on the disk.
Mount Path: The mount path of the storage mounted on the image storage, an absolute path must be set
Note: Do not use system directories such as /, /dev/, /proc/, /sys/, /usr/bin, /bin, as this may cause the image storage to malfunction.
Retrieve Existing Images: Default is off. If turned on, retrieves existing image files in the mount path of this image storage.
Image Sync Network: The network CIDR used for image synchronization between single-node image repositories within the same management node. If left blank, the management network is used by default. If both the source and target image repositories have this parameter set, only the image sync network of the target image repository takes effect.
Data Network: The network CIDR used for data communication between compute nodes and the image storage. If left blank, the management network is used by default.

Advanced Settings

Image Storage Reserved Capacity: Default is 1GB, the capacity reserved for use by the image storage.
Image Chunk Upload Concurrency: Default is 1, the concurrency of image chunk uploads when uploading a single image. Range: 1~16.
Image Chunk Download Concurrency: Default is 1, the concurrency of image chunk downloads when downloading a single image. Range: 1~16.

After confirming that the configuration is correct, click OK to add the single-node image repository.

Add a Distributed Image Storage

The platform provides multiple entry points to add image storage. You can add an image storage from the following two main entry points:

In the navigation bar on the left side of the platform page, right-click the target data center and click Add Image Storage.
In the navigation bar on the left side of the platform page, select the target data center. Then, on the right side of the platform page, click Actions > Add Image Storage, or in the Image Storage sub-page, click Add Image Storage.

In the Please Select Image Storage Type dialog, select Distributed Image Storage.

Basic Information

Name: Image storage name
Description: Image storage description
Type: Displays distributed image storage
Data Center: Current data center

Configuration Information

Monitoring Node Management IP: IP address of the distributed monitoring node
SSH Port: Default port is 22, set the SSH port for the monitoring node
Username: Default is root user, set the username for the monitoring node
Password: Password for the username of the monitoring node
Image Storage Pool: You can pre-create a storage pool in the distributed storage cluster and enter the UUID of the pool. If left blank, a default image storage pool is created automatically.
Data Network: The network CIDR used for data communication between compute nodes and the image storage. If left blank, the management network is used by default.

Advanced Settings

Image Storage Reserved Capacity: Default is 1GB, the capacity reserved for use by the image storage.
Image Chunk Upload Concurrency: Default is 1, the concurrency of image chunk uploads when uploading a single image. Range: 1~16.
Image Chunk Download Concurrency: Default is 1, the concurrency of image chunk downloads when downloading a single image. Range: 1~16.

Modify an Image Storage

Navigate to Menu > Image Storage.
Right-click the image storage and select the action you want to perform from the list of actions that appears.
- If you need to edit the name and description of the image storage, select Edit Name and Description.
- If you need to modify the configuration information of the image storage, select Modify Configuration.
- If you need to update the password for the image storage, select Update Password. After updating, you need to manually reconnect the image storage for the changes to take effect.

View Image Storage Usage

If you need to understand the storage usage information of the image storage, you can navigate to the image storage detail page to view the usage information. You can also clean up invalid data that has been permanently deleted and expired temporary data in the image storage based on your actual situation by clicking Actions > Data Cleanup.

Note: Deleting an image file completely and deleting virtual machines created using that image completely allows you to execute a data cleanup operation to release storage space on the image storage. During data cleanup, please avoid performing data write-related operations.

Delete an Image Storage

If you need to delete an existing image storage, on the target image storage page, click Actions > Delete to delete it. You can also delete image storage in bulk on the data center Image Storage sub-page.

Image Basic Operations

You can understand the basic operations supported by images from the perspective of adding, deleting, modifying, and querying.

Add an Image

You can add various formats of system images or disk images to the image storage. When creating a virtual machine for the first time, the system will download the image to the data storage as an image cache. Using a URL or by uploading locally, you can add image files in .qcow2, .iso, .raw, and .vmdk formats to the image storage.

The platform provides multiple entry points to add images. You can add an image from the following two main entry points:

In the navigation bar on the left side of the platform page, right-click the target image storage and click Add Image.
In the navigation bar on the left side of the platform page, select the target image storage. Then, on the right side of the platform page, click Actions > Add Image, or in the Images sub-page, click Add Image.

You can refer to the following example to add an image:

Image Storage: The current image storage
Name: Image name
Description: Image description
Image Type: Image type, including system images and disk images
Image Format: Different types of images support different image formats, including .qcow2, .iso, .raw, and .vmdk formats
Image Path: Add an image through a URL path or by uploading a local file
- URL: Supports adding an image via HTTP/HTTPS/FTP/SFTP format or through an absolute path on a single-node image repository
- Upload File: Choose a file that matches the selected image format and is accessible by the current browser to upload directly

Next Chapter: Virtual Machine

Image Storage

Image Storage Basic Operations

Add a Standalone Image Storage

Add a Distributed Image Storage

Modify an Image Storage

View Image Storage Usage

Delete an Image Storage

Image Basic Operations

Add an Image

Products

Solutions

Help & Support

Contact Us