diff --git a/docs/ims/umn/ALL_META.TXT.json b/docs/ims/umn/ALL_META.TXT.json new file mode 100644 index 000000000..2751a0792 --- /dev/null +++ b/docs/ims/umn/ALL_META.TXT.json @@ -0,0 +1,1502 @@ +[ + { + "uri":"en-us_topic_0013901623.html", + "product_code":"ims", + "code":"1", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Overview", + "title":"Overview", + "githuburl":"" + }, + { + "uri":"en-us_topic_0013901609.html", + "product_code":"ims", + "code":"2", + "des":"An image is a server or disk template that contains an operating system (OS) or service data and necessary software, such as database software. IMS provides public, priva", + "doc_type":"usermanual", + "kw":"Supported OSs,OS compatibility,Supported images,Public image,Private image,Shared image,What Is Imag", + "title":"What Is Image Management Service?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713146.html", + "product_code":"ims", + "code":"3", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Supported OSs", + "title":"Supported OSs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713142.html", + "product_code":"ims", + "code":"4", + "des":"This section describes the OSs supported by different types of ECSs.Table 1 lists the OSs supported by the following ECSs:General-purpose T6General computing S2, S3, S6, ", + "doc_type":"usermanual", + "kw":"Supported OSs,OS compatibility,Supported images,OSs Supported by Different Types of ECSs,Supported O", + "title":"OSs Supported by Different Types of ECSs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713143.html", + "product_code":"ims", + "code":"5", + "des":"Image files in VMDK, VHD, QCOW2, RAW, VHDX, QED, VDI, QCOW, ZVHD2, or ZVHD format can be used to create private images. Select whichever format best meeting your requirem", + "doc_type":"usermanual", + "kw":"Supported OSs,OS compatibility,Supported images,External File Formats,Supported OSs,External Image F", + "title":"External Image File Formats and Supported OSs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0170853315.html", + "product_code":"ims", + "code":"6", + "des":"The ECS boot mode can be BIOS or UEFI. For details about the differences between the two modes, see How Is BIOS Different from UEFI?Table 1 lists the OSs that support the", + "doc_type":"usermanual", + "kw":"Supported OSs,OS compatibility,Supported images,OSs Supporting UEFI Boot Mode,Supported OSs,User Gui", + "title":"OSs Supporting UEFI Boot Mode", + "githuburl":"" + }, + { + "uri":"en-us_topic_0194137262.html", + "product_code":"ims", + "code":"7", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Basic Concepts", + "title":"Basic Concepts", + "githuburl":"" + }, + { + "uri":"en-us_topic_0171754221.html", + "product_code":"ims", + "code":"8", + "des":"A region and availability zone (AZ) identify the location of a data center. You can create resources in a specific region and AZ.A region is a physical data center, which", + "doc_type":"usermanual", + "kw":"Region,Region and AZ,Basic Concepts,User Guide", + "title":"Region and AZ", + "githuburl":"" + }, + { + "uri":"en-us_topic_0089615820.html", + "product_code":"ims", + "code":"9", + "des":"IMS supports multiple image formats, but the system uses ZVHD or ZVHD2 by default.Table 1 lists the common image formats.", + "doc_type":"usermanual", + "kw":"image formats,Common Image Formats,Basic Concepts,User Guide", + "title":"Common Image Formats", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713148.html", + "product_code":"ims", + "code":"10", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Related Services,Overview,User Guide", + "title":"Related Services", + "githuburl":"" + }, + { + "uri":"en-us_topic_0130878289.html", + "product_code":"ims", + "code":"11", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Creating a Private Image", + "title":"Creating a Private Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0013901628.html", + "product_code":"ims", + "code":"12", + "des":"A private image is an image available only to the user who created it. It contains an OS, preinstalled public applications, and a user's personal applications. A private ", + "doc_type":"usermanual", + "kw":"Create image,Create OS,Introduction,Creating a Private Image,User Guide", + "title":"Introduction", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713149.html", + "product_code":"ims", + "code":"13", + "des":"If you have created and configured a Windows ECS based on your service requirements (for example, by installing software and setting up an application environment), you c", + "doc_type":"usermanual", + "kw":"Use ECS to create image,Create system disk image,Creating a System Disk Image from a Windows ECS,Cre", + "title":"Creating a System Disk Image from a Windows ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713180.html", + "product_code":"ims", + "code":"14", + "des":"If you have created and configured a Linux ECS based on your service requirements (for example, by installing software and setting up an application environment), you can", + "doc_type":"usermanual", + "kw":"Creating a System Disk Image from a Linux ECS,Creating a Private Image,User Guide", + "title":"Creating a System Disk Image from a Linux ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713181.html", + "product_code":"ims", + "code":"15", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Creating a Windows System Disk Image from an External Image File", + "title":"Creating a Windows System Disk Image from an External Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713182.html", + "product_code":"ims", + "code":"16", + "des":"You can import a local image or a system disk image from another cloud platform to the current cloud. After an image is imported, you can use it to create ECSs or reinsta", + "doc_type":"usermanual", + "kw":"Use external image file to create image,Import image,Overview,Creating a Windows System Disk Image f", + "title":"Overview", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713189.html", + "product_code":"ims", + "code":"17", + "des":"You need to prepare an image file that meets the platform requirements.You are advised to complete the network, tool, and driver configurations in Table 1 on the ECS and ", + "doc_type":"usermanual", + "kw":"Preparing an Image File,Creating a Windows System Disk Image from an External Image File,User Guide", + "title":"Preparing an Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713183.html", + "product_code":"ims", + "code":"18", + "des":"You are advised to use OBS Browser to upload external image files to OBS buckets. For details, see Object Storage Service User Guide.Only unencrypted external image files", + "doc_type":"usermanual", + "kw":"Standard,Uploading an External Image File,Creating a Windows System Disk Image from an External Imag", + "title":"Uploading an External Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713184.html", + "product_code":"ims", + "code":"19", + "des":"Register an image file uploaded to the OBS bucket as a private image.Log in to the management console.Under Compute, click Image Management Service.The IMS console is dis", + "doc_type":"usermanual", + "kw":"Registering an External Image File as a Private Image,Creating a Windows System Disk Image from an E", + "title":"Registering an External Image File as a Private Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713188.html", + "product_code":"ims", + "code":"20", + "des":"After registering an external image file as a private image on the cloud platform, you can use the image to create ECSs or change the OSs of existing ECSs.This section de", + "doc_type":"usermanual", + "kw":"Creating a Windows ECS from an Image,Creating a Windows System Disk Image from an External Image Fil", + "title":"Creating a Windows ECS from an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713190.html", + "product_code":"ims", + "code":"21", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Creating a Linux System Disk Image from an External Image File", + "title":"Creating a Linux System Disk Image from an External Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713191.html", + "product_code":"ims", + "code":"22", + "des":"You can import a local image or a system disk image from another cloud platform to the current cloud. After an image is imported, you can use it to create ECSs or reinsta", + "doc_type":"usermanual", + "kw":"Use external image file to create image,Import image,Overview,Creating a Linux System Disk Image fro", + "title":"Overview", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713198.html", + "product_code":"ims", + "code":"23", + "des":"You need to prepare an image file that meets the platform requirements.You are advised to complete the file system, network, and driver configurations in Table 1 on the V", + "doc_type":"usermanual", + "kw":"Preparing an Image File,Creating a Linux System Disk Image from an External Image File,User Guide", + "title":"Preparing an Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713192.html", + "product_code":"ims", + "code":"24", + "des":"You are advised to use OBS Browser to upload external image files to OBS buckets. For details, see Object Storage Service User Guide.Only unencrypted external image files", + "doc_type":"usermanual", + "kw":"Standard,Uploading an External Image File,Creating a Linux System Disk Image from an External Image ", + "title":"Uploading an External Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713193.html", + "product_code":"ims", + "code":"25", + "des":"Register an image file uploaded to the OBS bucket as a private image.Log in to the management console.Under Compute, click Image Management Service.The IMS console is dis", + "doc_type":"usermanual", + "kw":"Registering an External Image File as a Private Image,Creating a Linux System Disk Image from an Ext", + "title":"Registering an External Image File as a Private Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713197.html", + "product_code":"ims", + "code":"26", + "des":"After registering an external image file as a private image on the cloud platform, you can use the image to create ECSs or change the OSs of existing ECSs.This section de", + "doc_type":"usermanual", + "kw":"Creating a Linux ECS from an Image,Creating a Linux System Disk Image from an External Image File,Us", + "title":"Creating a Linux ECS from an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0095084510.html", + "product_code":"ims", + "code":"27", + "des":"For how to create a BMS private image, see Bare Metal Server User Guide.", + "doc_type":"usermanual", + "kw":"Creating a BMS System Disk Image,Creating a Private Image,User Guide", + "title":"Creating a BMS System Disk Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0102644450.html", + "product_code":"ims", + "code":"28", + "des":"A data disk image contains only service data. You can create a data disk image from an ECS and then use the image to create new EVS disks. This is a convenient way to mig", + "doc_type":"usermanual", + "kw":"data disk image,Creating a Data Disk Image from an ECS,Creating a Private Image,User Guide", + "title":"Creating a Data Disk Image from an ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0084064672.html", + "product_code":"ims", + "code":"29", + "des":"A data disk image contains only service data. You can create a data disk image using a local image file or an external image file (image file on another cloud platform). ", + "doc_type":"usermanual", + "kw":"data disk image,external image file,Creating a Data Disk Image from an External Image File,Creating ", + "title":"Creating a Data Disk Image from an External Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0116125142.html", + "product_code":"ims", + "code":"30", + "des":"You can create an image of an entire ECS, including not just the OS, but also the software and all the service data. You can then use this image to migrate data by quickl", + "doc_type":"usermanual", + "kw":"SAN policies,Creating a Full-ECS Image from an ECS,Creating a Private Image,User Guide", + "title":"Creating a Full-ECS Image from an ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0093344231.html", + "product_code":"ims", + "code":"31", + "des":"Create a full-ECS image from a CSBS backup. This image can then be used to create ECSs.When creating a full-ECS image from a CSBS backup, ensure that the source ECS of th", + "doc_type":"usermanual", + "kw":"CSBS backup,Creating a Full-ECS Image from a CSBS Backup,Creating a Private Image,User Guide", + "title":"Creating a Full-ECS Image from a CSBS Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0176812699.html", + "product_code":"ims", + "code":"32", + "des":"You can use a Cloud Backup and Recovery (CBR) backup to create a full-ECS image, which can be used to create ECSs.The Cloud Backup and Recovery (CBR) service provides bac", + "doc_type":"usermanual", + "kw":"Use backup to create image,full-ECS image,Creating a Full-ECS Image from a CBR Backup,Creating a Pri", + "title":"Creating a Full-ECS Image from a CBR Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713151.html", + "product_code":"ims", + "code":"33", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Quickly Importing an Image File", + "title":"Quickly Importing an Image File", + "githuburl":"" + }, + { + "uri":"en-us_topic_0133773658.html", + "product_code":"ims", + "code":"34", + "des":"If an image file is larger than 128 GB, you can import it using fast import. Only the RAW and ZVHD2 formats support fast import. The image file to be imported cannot exce", + "doc_type":"usermanual", + "kw":"Overview,Quickly Importing an Image File,User Guide", + "title":"Overview", + "githuburl":"" + }, + { + "uri":"en-us_topic_0133773660.html", + "product_code":"ims", + "code":"35", + "des":"This section describes how to convert the format of an image file on a Linux server and then quickly import it to the cloud platform. You are advised to use an EulerOS EC", + "doc_type":"usermanual", + "kw":"Quickly Importing an Image File (Linux),Quickly Importing an Image File,User Guide", + "title":"Quickly Importing an Image File (Linux)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0174703579.html", + "product_code":"ims", + "code":"36", + "des":"This section describes how to convert the format of an image file on a Windows server and then quickly import it to the cloud platform. You are advised to use a local Win", + "doc_type":"usermanual", + "kw":"Quickly Importing an Image File (Windows),Quickly Importing an Image File,User Guide", + "title":"Quickly Importing an Image File (Windows)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0013901608.html", + "product_code":"ims", + "code":"37", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Managing Private Images", + "title":"Managing Private Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713199.html", + "product_code":"ims", + "code":"38", + "des":"You can modify the following attributes of a private image:NameDescriptionMinimum MemoryMaximum MemoryNIC Multi-QueueNIC multi-queue enables multiple CPUs to process NIC ", + "doc_type":"usermanual", + "kw":"Change,Image name,Image memory,NIC multi-queue,Name,Description,Minimum Memory,Maximum Memory,NIC Mu", + "title":"Modifying an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0090099339.html", + "product_code":"ims", + "code":"39", + "des":"You can export the public or private image list in the current region as a CSV file to your local PC.For public images, the file describes the image name, image status, O", + "doc_type":"usermanual", + "kw":"Exporting Image List,Managing Private Images,User Guide", + "title":"Exporting Image List", + "githuburl":"" + }, + { + "uri":"en-us_topic_0300978092.html", + "product_code":"ims", + "code":"40", + "des":"You can check the disk capacity of a private image.To check the disk capacity of a system disk image, data disk image, or ISO image, see Check the Disk Capacity of a Syst", + "doc_type":"usermanual", + "kw":"Checking the Disk Capacity of an Image,Managing Private Images,User Guide", + "title":"Checking the Disk Capacity of an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713200.html", + "product_code":"ims", + "code":"41", + "des":"You can use a public, private, or shared image to create an ECS.If you use a public image, the created ECS contains an OS and pre-installed public applications. You need ", + "doc_type":"usermanual", + "kw":"Creating an ECS from an Image,Managing Private Images,User Guide", + "title":"Creating an ECS from an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713201.html", + "product_code":"ims", + "code":"42", + "des":"You can delete private images that will no longer be used.Access the IMS console.Log in to the management console.Under Compute, click Image Management Service.The IMS co", + "doc_type":"usermanual", + "kw":"Deleting Images,Managing Private Images,User Guide", + "title":"Deleting Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042416.html", + "product_code":"ims", + "code":"43", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Sharing Images", + "title":"Sharing Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042417.html", + "product_code":"ims", + "code":"44", + "des":"You can share your private images with other tenants. The tenants who accept the shared images can use the images to create ECSs of the same specifications.You can share ", + "doc_type":"usermanual", + "kw":"share,Overview,Sharing Images,User Guide", + "title":"Overview", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042418.html", + "product_code":"ims", + "code":"45", + "des":"Before a tenant shares an image with you, you need to provide your project ID.Access the IMS console.Log in to the management console.Under Compute, click Image Managemen", + "doc_type":"usermanual", + "kw":"Obtaining the Project ID,Sharing Images,User Guide", + "title":"Obtaining the Project ID", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042419.html", + "product_code":"ims", + "code":"46", + "des":"After obtaining the project ID from a tenant, you can share specified private images with the tenant. You can share a single image or multiple images as needed.You have o", + "doc_type":"usermanual", + "kw":"share a single image,Share multiple images,Share a single image,Sharing Specified Images,Sharing Ima", + "title":"Sharing Specified Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042420.html", + "product_code":"ims", + "code":"47", + "des":"After another tenant shares images with you, you will receive a message. You can choose to accept or reject all or some of the shared images.If you are not in the same re", + "doc_type":"usermanual", + "kw":"Accepting or Rejecting Shared Images,Sharing Images,User Guide", + "title":"Accepting or Rejecting Shared Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042421.html", + "product_code":"ims", + "code":"48", + "des":"You can reject accepted images if you no longer need them.After an image is rejected, it will not be displayed on the Images Shared with Me page.You have accepted images ", + "doc_type":"usermanual", + "kw":"Rejecting Accepted Images,Sharing Images,User Guide", + "title":"Rejecting Accepted Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0075730699.html", + "product_code":"ims", + "code":"49", + "des":"If you want to use the shared images you have rejected, you can accept them from the list of rejected images.You have rejected the images shared by others.The image owner", + "doc_type":"usermanual", + "kw":"shared image,Accepting Rejected Images,Sharing Images,User Guide", + "title":"Accepting Rejected Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042422.html", + "product_code":"ims", + "code":"50", + "des":"You can stop sharing images. After you stop sharing an image:The image will be invisible to the recipient on the management console and no data will be returned when the ", + "doc_type":"usermanual", + "kw":"stop sharing images,Stopping Sharing Images,Sharing Images,User Guide", + "title":"Stopping Sharing Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032042423.html", + "product_code":"ims", + "code":"51", + "des":"In addition to the tenants you have shared images with, you can add more tenants who can use the shared images.You have shared private images.You have obtained the projec", + "doc_type":"usermanual", + "kw":"add more tenants,Adding Tenants Who Can Use Shared Images,Sharing Images,User Guide", + "title":"Adding Tenants Who Can Use Shared Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032087324.html", + "product_code":"ims", + "code":"52", + "des":"This section describes how to delete image recipients who can use shared images.You have shared private images.You have obtained project IDs of the image recipients.Acces", + "doc_type":"usermanual", + "kw":"delete image recipients who can use shared images,Deleting Image Recipients Who Can Use Shared Image", + "title":"Deleting Image Recipients Who Can Use Shared Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0000001175697174.html", + "product_code":"ims", + "code":"53", + "des":"IMS provides multiple methods for importing images. You can select a method based on the image file type, format, or size.To import a data disk image file, follow the ins", + "doc_type":"usermanual", + "kw":"Importing an Image,Managing Private Images,User Guide", + "title":"Importing an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0034011241.html", + "product_code":"ims", + "code":"54", + "des":"You can export a private image to a standard OBS bucket and then download it to your local PC.You can reproduce cloud servers and their running environments in on-promise", + "doc_type":"usermanual", + "kw":"Exporting an Image,Managing Private Images,User Guide", + "title":"Exporting an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0130878748.html", + "product_code":"ims", + "code":"55", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Optimizing a Windows Private Image", + "title":"Optimizing a Windows Private Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0047501112.html", + "product_code":"ims", + "code":"56", + "des":"ECSs require Xen Guest OS driver (PV driver) and KVM Guest OS driver (UVP VMTools) for proper running. To ensure that ECSs support both Xen and KVM and to improve network", + "doc_type":"usermanual", + "kw":"Optimization Process,Optimizing a Windows Private Image,User Guide", + "title":"Optimization Process", + "githuburl":"" + }, + { + "uri":"en-us_topic_0125075471.html", + "product_code":"ims", + "code":"57", + "des":"Open the cmd window and run the following command to query the virtualization type of the ECS:systeminfoIf the values of System Manufacturer and BIOS Version are Xen, the", + "doc_type":"usermanual", + "kw":"virtualization type,Viewing the Virtualization Type of a Windows ECS,Optimizing a Windows Private Im", + "title":"Viewing the Virtualization Type of a Windows ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0037352059.html", + "product_code":"ims", + "code":"58", + "des":"Table 1 lists the PV driver software packages required for optimizing Windows private images.Table 2 lists the UVP VMTools software packages required for optimizing Windo", + "doc_type":"usermanual", + "kw":"PV driver,UVP VMTools,Obtaining Required Software Packages,Optimizing a Windows Private Image,User G", + "title":"Obtaining Required Software Packages", + "githuburl":"" + }, + { + "uri":"en-us_topic_0037352182.html", + "product_code":"ims", + "code":"59", + "des":"When using an ECS or external image file to create a private image, ensure that the PV driver has been installed in the OS to enable Xen virtualization for subsequently c", + "doc_type":"usermanual", + "kw":"PV driver,Installing the PV Driver,Optimizing a Windows Private Image,User Guide", + "title":"Installing the PV Driver", + "githuburl":"" + }, + { + "uri":"en-us_topic_0037352061.html", + "product_code":"ims", + "code":"60", + "des":"Before using an ECS or external image file to create a private image, ensure that UVP VMTools has been installed in the OS to enable subsequently created ECSs to support ", + "doc_type":"usermanual", + "kw":"UVP VMTools,KVM virtualization,UVP VMTools,Installing UVP VMTools,Optimizing a Windows Private Image", + "title":"Installing UVP VMTools", + "githuburl":"" + }, + { + "uri":"en-us_topic_0125075472.html", + "product_code":"ims", + "code":"61", + "des":"After installing the PV driver and UVP VMTools, perform the following operations to clear system logs:For Windows Server 2008 and Windows Server 2012, right-click Compute", + "doc_type":"usermanual", + "kw":"Clearing System Logs,Optimizing a Windows Private Image,User Guide", + "title":"Clearing System Logs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0130878749.html", + "product_code":"ims", + "code":"62", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Optimizing a Linux Private Image", + "title":"Optimizing a Linux Private Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0047501133.html", + "product_code":"ims", + "code":"63", + "des":"A Linux ECS can be switched from Xen to KVM if xen-pv and VirtIO drivers run on the ECS. Before changing a Xen-based ECS to a KVM-based ECS, ensure that the required driv", + "doc_type":"usermanual", + "kw":"Optimization Process,Optimizing a Linux Private Image,User Guide", + "title":"Optimization Process", + "githuburl":"" + }, + { + "uri":"en-us_topic_0037352185.html", + "product_code":"ims", + "code":"64", + "des":"You can run the following command to query the virtualization type of an ECS:lscpuIf the value of Hypervisor vendor is Xen, the ECS uses Xen. If KVM is required, perform ", + "doc_type":"usermanual", + "kw":"Viewing the Virtualization Type of a Linux ECS,Optimizing a Linux Private Image,User Guide", + "title":"Viewing the Virtualization Type of a Linux ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0037352186.html", + "product_code":"ims", + "code":"65", + "des":"When optimizing a Linux private image, you need to change the UUID in the fstab and GRUB configuration files, and install native Xen and KVM drivers on the ECS. To ensure", + "doc_type":"usermanual", + "kw":"uvp-monitor,Uninstalling the PV Driver from a Linux ECS,Optimizing a Linux Private Image,User Guide", + "title":"Uninstalling the PV Driver from a Linux ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0086020895.html", + "product_code":"ims", + "code":"66", + "des":"When optimizing a Linux private image, you need to change the disk identifier to UUID in the GRUB configuration file of the ECS.Modify the menu.lst or grub.cfg configurat", + "doc_type":"usermanual", + "kw":"Changing the Disk Identifier in the GRUB Configuration File to UUID,Optimizing a Linux Private Image", + "title":"Changing the Disk Identifier in the GRUB Configuration File to UUID", + "githuburl":"" + }, + { + "uri":"en-us_topic_0086024961.html", + "product_code":"ims", + "code":"67", + "des":"When optimizing a Linux private image, you need to change the disk identifier to UUID in the fstab configuration file of the ECS.Take CentOS 7.0 as an example. Run blkid ", + "doc_type":"usermanual", + "kw":"UUIDs,Changing the Disk Identifier in the fstab File to UUID,Optimizing a Linux Private Image,User G", + "title":"Changing the Disk Identifier in the fstab File to UUID", + "githuburl":"" + }, + { + "uri":"en-us_topic_0000001120952155.html", + "product_code":"ims", + "code":"68", + "des":"When optimizing a Linux private image, you need to install native KVM drivers on the ECS.If you do not install KVM drivers, NICs of the ECS may not be detected and the EC", + "doc_type":"usermanual", + "kw":"native KVM drivers,Installing Native KVM Drivers,Optimizing a Linux Private Image,User Guide", + "title":"Installing Native KVM Drivers", + "githuburl":"" + }, + { + "uri":"en-us_topic_0125076462.html", + "product_code":"ims", + "code":"69", + "des":"Delete log files and historical records, and stop the ECS.Run the following commands to delete redundant key files:echo > /$path/$to/$root/.ssh/authorized_keysAn example ", + "doc_type":"usermanual", + "kw":"Delete log files,Clearing System Logs,Optimizing a Linux Private Image,User Guide", + "title":"Clearing System Logs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0046588153.html", + "product_code":"ims", + "code":"70", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Encrypting Images", + "title":"Encrypting Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0046588154.html", + "product_code":"ims", + "code":"71", + "des":"IMS allows you to create encrypted images to ensure data security.To use the image encryption function, you must apply for KMS Administrator permissions.KMS must be enabl", + "doc_type":"usermanual", + "kw":"image encryption,Encrypted images,Overview,Encrypting Images,User Guide", + "title":"Overview", + "githuburl":"" + }, + { + "uri":"en-us_topic_0046588155.html", + "product_code":"ims", + "code":"72", + "des":"You can create an encrypted image using an external image file or an encrypted ECS.Create an encrypted image using an external image file.When you register the external i", + "doc_type":"usermanual", + "kw":"encrypted image,Creating Encrypted Images,Encrypting Images,User Guide", + "title":"Creating Encrypted Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0049177180.html", + "product_code":"ims", + "code":"73", + "des":"You can convert encrypted and unencrypted images into each other or enable some advanced features (such as fast ECS creation from an image) using the image replication fu", + "doc_type":"usermanual", + "kw":"replicate an image,Replicating Images,Managing Private Images,User Guide", + "title":"Replicating Images", + "githuburl":"" + }, + { + "uri":"en-us_topic_0068002265.html", + "product_code":"ims", + "code":"74", + "des":"You can use tags to classify images. You can add, modify, or delete image tags, or search for required images by tag in the image list.When adding predefined tags to an i", + "doc_type":"usermanual", + "kw":"image tags,Tagging an Image,Managing Private Images,User Guide", + "title":"Tagging an Image", + "githuburl":"" + }, + { + "uri":"en-us_topic_0107462580.html", + "product_code":"ims", + "code":"75", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Auditing Key Operations", + "title":"Auditing Key Operations", + "githuburl":"" + }, + { + "uri":"en-us_topic_0107462581.html", + "product_code":"ims", + "code":"76", + "des":"Cloud Trace Service (CTS) is a log audit service provided by the public cloud and intended for cloud security. It allows you to collect, store, and query cloud resource o", + "doc_type":"usermanual", + "kw":"IMS Operations Recorded by CTS,Auditing Key Operations,User Guide", + "title":"IMS Operations Recorded by CTS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0107462582.html", + "product_code":"ims", + "code":"77", + "des":"Once CTS is enabled, it starts recording IMS operations. You can view operations recorded in the last seven days on the CTS management console.This section describes how ", + "doc_type":"usermanual", + "kw":"Viewing Traces,Auditing Key Operations,User Guide", + "title":"Viewing Traces", + "githuburl":"" + }, + { + "uri":"en-us_topic_0117262219.html", + "product_code":"ims", + "code":"78", + "des":"You can import an image file in VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, QED, ZVHD, or ZVHD2 format to the cloud platform. Image files in other formats need to be converte", + "doc_type":"usermanual", + "kw":"qemu-img,Converting the Image Format Using qemu-img,Managing Private Images,User Guide", + "title":"Converting the Image Format Using qemu-img", + "githuburl":"" + }, + { + "uri":"en-us_topic_0171668652.html", + "product_code":"ims", + "code":"79", + "des":"You can import an image file in VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, QED, ZVHD, or ZVHD2 format to the cloud platform. Image files in other formats need to be converte", + "doc_type":"usermanual", + "kw":"Converting the Image Format Using qemu-img-hw,Managing Private Images,User Guide", + "title":"Converting the Image Format Using qemu-img-hw", + "githuburl":"" + }, + { + "uri":"en-us_topic_0199394934.html", + "product_code":"ims", + "code":"80", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Windows Operations", + "title":"Windows Operations", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713152.html", + "product_code":"ims", + "code":"81", + "des":"If a private image is created from an ECS or external image file and the VM where the ECS or external image file is located is configured with a static IP address, you ne", + "doc_type":"usermanual", + "kw":"NIC DHCP,Enable remote desktop connection,Setting the NIC to DHCP,Windows Operations,User Guide", + "title":"Setting the NIC to DHCP", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713155.html", + "product_code":"ims", + "code":"82", + "des":"If you want to remotely access an ECS, enable remote desktop connection for the source ECS when creating a private image. This function must be enabled for GPU-accelerate", + "doc_type":"usermanual", + "kw":"Use ECS to create image,remote desktop connection,Enabling Remote Desktop Connection,Windows Operati", + "title":"Enabling Remote Desktop Connection", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030730602.html", + "product_code":"ims", + "code":"83", + "des":"To ensure that you can use the user data injection function to inject initial custom information into ECSs created from a private image (such as setting the ECS login pas", + "doc_type":"usermanual", + "kw":"Cloudbase-Init,Installing and Configuring Cloudbase-Init,Windows Operations,User Guide", + "title":"Installing and Configuring Cloudbase-Init", + "githuburl":"" + }, + { + "uri":"en-us_topic_0093887081.html", + "product_code":"ims", + "code":"84", + "des":"Running Sysprep ensures that an ECS has a unique SID after it is added to a domain.After installing Cloudbase-Init on an ECS, you need to decide whether the ECS needs to ", + "doc_type":"usermanual", + "kw":"Sysprep,Running Sysprep,Windows Operations,User Guide", + "title":"Running Sysprep", + "githuburl":"" + }, + { + "uri":"en-us_topic_0081795392.html", + "product_code":"ims", + "code":"85", + "des":"Before using some types of ECSs to create private images, you need to install special drivers on the ECSs.If you want to use the created private image to create GPU-accel", + "doc_type":"usermanual", + "kw":"Installing Special Windows Drivers,Windows Operations,User Guide", + "title":"Installing Special Windows Drivers", + "githuburl":"" + }, + { + "uri":"en-us_topic_0199394935.html", + "product_code":"ims", + "code":"86", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Linux Operations", + "title":"Linux Operations", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713176.html", + "product_code":"ims", + "code":"87", + "des":"If a private image is created from an ECS or external image file and the VM where the ECS or external image file is located is configured with a static IP address, you ne", + "doc_type":"usermanual", + "kw":"Setting the NIC to DHCP,Linux Operations,User Guide", + "title":"Setting the NIC to DHCP", + "githuburl":"" + }, + { + "uri":"en-us_topic_0069904570.html", + "product_code":"ims", + "code":"88", + "des":"To prevent NIC name drift when you use a private image to create ECSs, you need to delete files from the network rule directory of the VM where the ECS or image file is l", + "doc_type":"usermanual", + "kw":"Delete network rule files,Disable NetworkManager,Deleting Files from the Network Rule Directory,Linu", + "title":"Deleting Files from the Network Rule Directory", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030730603.html", + "product_code":"ims", + "code":"89", + "des":"To ensure that you can use the user data injection function to inject initial custom information into ECSs created from a private image (such as setting the ECS login pas", + "doc_type":"usermanual", + "kw":"Check whether Cloud-Init is installed,Cloud-Init,Installing Cloud-Init,Linux Operations,User Guide", + "title":"Installing Cloud-Init", + "githuburl":"" + }, + { + "uri":"en-us_topic_0122876047.html", + "product_code":"ims", + "code":"90", + "des":"You need to configure Cloud-Init after it is installed.Cloud-Init has been installed.An EIP has been bound to the ECS.You have logged in to the ECS.The IP address obtaini", + "doc_type":"usermanual", + "kw":"Cloud-Init,Configuring Cloud-Init,Linux Operations,User Guide", + "title":"Configuring Cloud-Init", + "githuburl":"" + }, + { + "uri":"en-us_topic_0082002007.html", + "product_code":"ims", + "code":"91", + "des":"Before using some types of ECSs to create private images, you need to install special drivers on the ECSs.If you want to use the private image to create P1 ECSs, install ", + "doc_type":"usermanual", + "kw":"Installing Special Linux Drivers,Linux Operations,User Guide", + "title":"Installing Special Linux Drivers", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713179.html", + "product_code":"ims", + "code":"92", + "des":"If multiple data disks are attached to the ECS used to create a private image, ECSs created from the image may be unavailable. Therefore, you need to detach all data disk", + "doc_type":"usermanual", + "kw":"Detaching Data Disks from an ECS,Linux Operations,User Guide", + "title":"Detaching Data Disks from an ECS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0057450886.html", + "product_code":"ims", + "code":"93", + "des":"If you want to use the ECS console logging function, you need to configure related parameters on the ECS.Currently, ECSs running the following OSs are supported: CentOS 6", + "doc_type":"usermanual", + "kw":"Configuring Console Logging,Linux Operations,User Guide", + "title":"Configuring Console Logging", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713202.html", + "product_code":"ims", + "code":"94", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"FAQs", + "title":"FAQs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0138455714.html", + "product_code":"ims", + "code":"95", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Image Consulting", + "title":"Image Consulting", + "githuburl":"" + }, + { + "uri":"en-us_topic_0195253327.html", + "product_code":"ims", + "code":"96", + "des":"When creating an ECS or BMS, you can select an image based on the following factors:Region and AZImage TypeOSAn image is a regional resource. You cannot use an image to c", + "doc_type":"usermanual", + "kw":"How Do I Select an Image?,Image Consulting,User Guide", + "title":"How Do I Select an Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0153114116.html", + "product_code":"ims", + "code":"97", + "des":"Quotas can limit the number or amount of resources available to users, such as the maximum number of ECSs or EVS disks that can be created.If the existing resource quota ", + "doc_type":"usermanual", + "kw":"How Do I Increase the Image Quota?,Image Consulting,User Guide", + "title":"How Do I Increase the Image Quota?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0173986473.html", + "product_code":"ims", + "code":"98", + "des":"Yes.Other tenants can share a private image with you. You can use it after accepting it. For details about image sharing, see Sharing Specified Images.", + "doc_type":"usermanual", + "kw":"Can I Use Private Images of Other Tenants?,Image Consulting,User Guide", + "title":"Can I Use Private Images of Other Tenants?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0193137621.html", + "product_code":"ims", + "code":"99", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Image Creation", + "title":"Image Creation", + "githuburl":"" + }, + { + "uri":"en-us_topic_0193146244.html", + "product_code":"ims", + "code":"100", + "des":"Currently, you can create a maximum of 100 private images under an account in a region.No. You can create an image from a running ECS. However, if data is written to the ", + "doc_type":"usermanual", + "kw":"Image Creation FAQs,Image Creation,User Guide", + "title":"Image Creation FAQs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0106444267.html", + "product_code":"ims", + "code":"101", + "des":"An ECS used to create a Windows full-ECS image cannot have a spanned volume. If you attempt to create an image from an ECS with a spanned volume, when the image is used t", + "doc_type":"usermanual", + "kw":"How Do I Create a Full-ECS Image Using an ECS That Has a Spanned Volume?,Image Creation,User Guide", + "title":"How Do I Create a Full-ECS Image Using an ECS That Has a Spanned Volume?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030742197.html", + "product_code":"ims", + "code":"102", + "des":"For a user that needs to be added to a domain and uses the domain account to log in to Windows, Sysprep is required before a private image is created. Otherwise, the imag", + "doc_type":"usermanual", + "kw":"Why Is Sysprep Required for Creating a Private Image from a Windows ECS?,Image Creation,User Guide", + "title":"Why Is Sysprep Required for Creating a Private Image from a Windows ECS?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0096558549.html", + "product_code":"ims", + "code":"103", + "des":"When you create a ZVHD2 image using an API, the image is created in the ZVHD format.Check whether your token contains the op_gated_lld role (op_gated_lld is the OBT tag, ", + "doc_type":"usermanual", + "kw":"What Do I Do If I Cannot Create an Image in ZVHD2 Format Using an API?,Image Creation,User Guide", + "title":"What Do I Do If I Cannot Create an Image in ZVHD2 Format Using an API?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0171668653.html", + "product_code":"ims", + "code":"104", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Image Sharing", + "title":"Image Sharing", + "githuburl":"" + }, + { + "uri":"en-us_topic_0183293890.html", + "product_code":"ims", + "code":"105", + "des":"128There is no limit.No.No.Yes. After sharing an image with other tenants, you can still use the image to create an ECS and use the created ECS to create a private image.", + "doc_type":"usermanual", + "kw":"Image Sharing FAQs,Image Sharing,User Guide", + "title":"Image Sharing FAQs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0037352060.html", + "product_code":"ims", + "code":"106", + "des":"Cause 1: Some images cannot be shared in any cases (the Share button in the Operation column for these images is unavailable), such as:Encrypted imagesFull-ECS images cre", + "doc_type":"usermanual", + "kw":"What Do I Do If I Cannot Share My Images?,Image Sharing,User Guide", + "title":"What Do I Do If I Cannot Share My Images?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0133773782.html", + "product_code":"ims", + "code":"107", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"OS", + "title":"OS", + "githuburl":"" + }, + { + "uri":"en-us_topic_0113533721.html", + "product_code":"ims", + "code":"108", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"How Is BIOS Different from UEFI?,OS,User Guide", + "title":"How Is BIOS Different from UEFI?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0093842586.html", + "product_code":"ims", + "code":"109", + "des":"The target ECS has had an EIP bound.You have obtained the driver installation package required for an OS. For details, see Table 1.The procedure for installing the NVIDIA", + "doc_type":"usermanual", + "kw":"How Do I Install the NVIDIA Driver on a P1 ECS?,OS,User Guide", + "title":"How Do I Install the NVIDIA Driver on a P1 ECS?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0106312064.html", + "product_code":"ims", + "code":"110", + "des":"Press Win+R. In the displayed dialog box, enter regedit and press Enter to open the registry editor.Open the following registry key:HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\", + "doc_type":"usermanual", + "kw":"How Do I Delete Redundant Network Connections from a Windows ECS?,OS,User Guide", + "title":"How Do I Delete Redundant Network Connections from a Windows ECS?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0117142739.html", + "product_code":"ims", + "code":"111", + "des":"If an ECS starts slowly, you can change the default timeout duration to speed up the startup.Log in to the ECS.Run the following command to switch to user root:sudo susud", + "doc_type":"usermanual", + "kw":"What Do I Do If an ECS Starts Slowly?,OS,User Guide", + "title":"What Do I Do If an ECS Starts Slowly?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0081802526.html", + "product_code":"ims", + "code":"112", + "des":"When the 20.4.1 driver package downloaded at Intel website https://downloadcenter.intel.com/search?keyword=Intel++Ethernet+Connections+CD was installed in a Windows 7 64b", + "doc_type":"usermanual", + "kw":"What Do I Do If a Windows 7 ECS Equipped with an Intel 82599 NIC Reports an Error in SR-IOV Scenario", + "title":"What Do I Do If a Windows 7 ECS Equipped with an Intel 82599 NIC Reports an Error in SR-IOV Scenarios?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713195.html", + "product_code":"ims", + "code":"113", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Image Importing", + "title":"Image Importing", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713217.html", + "product_code":"ims", + "code":"114", + "des":"No. Currently, only the VMDK, VHD, RAW, QCOW2, VHDX, QED, VDI, QCOW, ZVHD2, and ZVHD formats are supported.Images of the -flat.vmdk format and image file packages contain", + "doc_type":"usermanual", + "kw":"Can I Use Images in Formats Other Than the Specified Ones?,Image Importing,User Guide", + "title":"Can I Use Images in Formats Other Than the Specified Ones?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713216.html", + "product_code":"ims", + "code":"115", + "des":"Before using an ECS or external image file to create a private image, you need to pre-configure the ECS or the source VM of the image file. If you do not perform the pre-", + "doc_type":"usermanual", + "kw":"What Are the Impacts If I Do Not Pre-configure an ECS Used to Create a Private Image?,Image Importin", + "title":"What Are the Impacts If I Do Not Pre-configure an ECS Used to Create a Private Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0118990097.html", + "product_code":"ims", + "code":"116", + "des":"Open Virtualization Appliance (OVA) is a single file (with the .ova extension) that archives all the files making up an Open Virtualization Format (OVF). OVF is a folder ", + "doc_type":"usermanual", + "kw":"How Do I Import an OVF or OVA File to the Cloud Platform?,Image Importing,User Guide", + "title":"How Do I Import an OVF or OVA File to the Cloud Platform?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713213.html", + "product_code":"ims", + "code":"117", + "des":"If you selected an incorrect OS, ECSs may fail to be created from the private image. If the configured system disk size is less than the one in the image file, image regi", + "doc_type":"usermanual", + "kw":"What Do I Do If I Configured an Incorrect OS or System Disk Size During Private Image Registration U", + "title":"What Do I Do If I Configured an Incorrect OS or System Disk Size During Private Image Registration Using an Image File?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0058841396.html", + "product_code":"ims", + "code":"118", + "des":"The possible causes may be:You have specified a small value.Check the system disk size in the VHD image file. Specify a value no less than this size when you use the VHD ", + "doc_type":"usermanual", + "kw":"What Do I Do If the System Disk Size in a VHD Image File Exceeds the One I Have Specified on the Man", + "title":"What Do I Do If the System Disk Size in a VHD Image File Exceeds the One I Have Specified on the Management Console When I Use This File to Register a Private Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713222.html", + "product_code":"ims", + "code":"119", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Image Exporting", + "title":"Image Exporting", + "githuburl":"" + }, + { + "uri":"en-us_topic_0249675952.html", + "product_code":"ims", + "code":"120", + "des":"Yes. You can download private images in VMDK, VHD, QCOW2, or ZVHD format as instructed in Exporting an Image.", + "doc_type":"usermanual", + "kw":"Can I Download My Private Images to a Local PC?,Image Exporting,User Guide", + "title":"Can I Download My Private Images to a Local PC?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713153.html", + "product_code":"ims", + "code":"121", + "des":"No. The system disk image of an ECS is a VM file that contains a system running environment and does not have an installation boot program. Therefore, it cannot be used o", + "doc_type":"usermanual", + "kw":"Can I Use the System Disk Image of an ECS on a Physical Server After I Export It from the Cloud Plat", + "title":"Can I Use the System Disk Image of an ECS on a Physical Server After I Export It from the Cloud Platform?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0274352601.html", + "product_code":"ims", + "code":"122", + "des":"After a private image is exported to an OBS bucket, the image size in the bucket is different from that displayed in IMS. For example, the size of a private image is 1.04", + "doc_type":"usermanual", + "kw":"Why Is the Image Size in an OBS Bucket Different from That Displayed in IMS?,Image Exporting,User Gu", + "title":"Why Is the Image Size in an OBS Bucket Different from That Displayed in IMS?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713186.html", + "product_code":"ims", + "code":"123", + "des":"Currently, you cannot directly download a public image. You can use the public image to create an ECS, use the ECS to create a private image, export the private image to ", + "doc_type":"usermanual", + "kw":"Can I Download a Public Image to My Local PC?,Image Exporting,User Guide", + "title":"Can I Download a Public Image to My Local PC?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0199451475.html", + "product_code":"ims", + "code":"124", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"What Are the Differences Between Import/Export and Fast Import/Export?,Image Exporting,User Guide", + "title":"What Are the Differences Between Import/Export and Fast Import/Export?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0199396601.html", + "product_code":"ims", + "code":"125", + "des":"Some images cannot be exported. Therefore, the Export option is not provided for them in the Operation column. The following images cannot be exported:Public imagesFull-E", + "doc_type":"usermanual", + "kw":"What Do I Do If the Export Option Is Unavailable for My Image?,Image Exporting,User Guide", + "title":"What Do I Do If the Export Option Is Unavailable for My Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713203.html", + "product_code":"ims", + "code":"126", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Image Optimization", + "title":"Image Optimization", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713214.html", + "product_code":"ims", + "code":"127", + "des":"Installing Guest OS drivers on an ECS improves your experience in using the ECS. In addition, it also ensures high reliability and stability of ECSs.Windows ECSs: Install", + "doc_type":"usermanual", + "kw":"Must I Install Guest OS Drivers on an ECS?,Image Optimization,User Guide", + "title":"Must I Install Guest OS Drivers on an ECS?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032307025.html", + "product_code":"ims", + "code":"128", + "des":"You are advised to enable automatic configuration when registering a private image using an image file. Then, the system will perform the following operations:Check wheth", + "doc_type":"usermanual", + "kw":"What Will the System Do to an Image File When I Use the File to Register a Private Image?,Image Opti", + "title":"What Will the System Do to an Image File When I Use the File to Register a Private Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0040740508.html", + "product_code":"ims", + "code":"129", + "des":"When registering an external image file as a private image, you are advised to perform the preceding operations on the VM where the external image file is located.When re", + "doc_type":"usermanual", + "kw":"How Do I Configure an ECS, BMS, or Image File Before I Use It to Create an Image?,Image Optimization", + "title":"How Do I Configure an ECS, BMS, or Image File Before I Use It to Create an Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713185.html", + "product_code":"ims", + "code":"130", + "des":"If an image file is not configured as instructed in Table 1 before it is exported from the original platform, configure it by referring to Figure 1.The proper running of ", + "doc_type":"usermanual", + "kw":"What Do I Do If a Windows Image File Is Not Pre-Configured When I Use It to Register a Private Image", + "title":"What Do I Do If a Windows Image File Is Not Pre-Configured When I Use It to Register a Private Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713211.html", + "product_code":"ims", + "code":"131", + "des":"If an image file is not configured as instructed in Table 1 before it is exported from the original platform, configure it by referring to Figure 1.The proper running of ", + "doc_type":"usermanual", + "kw":"What Do I Do If a Linux Image File Is Not Pre-Configured When I Use It to Register a Private Image?,", + "title":"What Do I Do If a Linux Image File Is Not Pre-Configured When I Use It to Register a Private Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0085214115.html", + "product_code":"ims", + "code":"132", + "des":"With the increase of network I/O bandwidth, a single vCPU cannot meet the requirement of processing NIC interruptions. NIC multi-queue allows multiple vCPUs to process NI", + "doc_type":"usermanual", + "kw":"How Do I Enable NIC Multi-Queue for an Image?,Image Optimization,User Guide", + "title":"How Do I Enable NIC Multi-Queue for an Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0187108863.html", + "product_code":"ims", + "code":"133", + "des":"Fast Create greatly reduces the time required for creating ECSs from a system disk image. Currently, this feature is supported by all newly created system disk images by ", + "doc_type":"usermanual", + "kw":"How Do I Make a System Disk Image Support Fast ECS Creation?,Image Optimization,User Guide", + "title":"How Do I Make a System Disk Image Support Fast ECS Creation?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713215.html", + "product_code":"ims", + "code":"134", + "des":"Possible causes:Your image file was exported from a VMware VM, and VMware Tools was not uninstalled or not completely uninstalled.You have downloaded the Guest OS driver ", + "doc_type":"usermanual", + "kw":"What Is the Cause of the Failure to Install a Guest OS Driver on a Windows ECS?,Image Optimization,U", + "title":"What Is the Cause of the Failure to Install a Guest OS Driver on a Windows ECS?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0086020894.html", + "product_code":"ims", + "code":"135", + "des":"When optimizing a Linux private image, you need to install native Xen and KVM drivers for the image.If you do not install Xen drivers for the image, the network performan", + "doc_type":"usermanual", + "kw":"native Xen and KVM drivers,How Do I Install Native Xen and KVM Drivers?,Image Optimization,User Guid", + "title":"How Do I Install Native Xen and KVM Drivers?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0049196765.html", + "product_code":"ims", + "code":"136", + "des":"If you want to store an unencrypted image in an encrypted way, you can select an encryption key when you replicate the image. Then, the system will generate an encrypted ", + "doc_type":"usermanual", + "kw":"Image Encryption,FAQs,User Guide", + "title":"Image Encryption", + "githuburl":"" + }, + { + "uri":"en-us_topic_0138479468.html", + "product_code":"ims", + "code":"137", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Cloud-Init", + "title":"Cloud-Init", + "githuburl":"" + }, + { + "uri":"en-us_topic_0148873774.html", + "product_code":"ims", + "code":"138", + "des":"Cloud-Init is an open-source tool for cloud instance initialization. When creating ECSs from an image with Cloud-Init, you can use user data injection to inject customize", + "doc_type":"usermanual", + "kw":"What Can I Do with a Cloud-Init ECS?,Cloud-Init,User Guide", + "title":"What Can I Do with a Cloud-Init ECS?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0113992021.html", + "product_code":"ims", + "code":"139", + "des":"A major cause is that the version of Cloud-Init is incompatible with that of NetworkManager. In Debian 9.0 and later versions, NetworkManager is incompatible with Cloud-I", + "doc_type":"usermanual", + "kw":"What Do I Do If Injecting the Key or Password Using Cloud-Init Failed After NetworkManager Is Instal", + "title":"What Do I Do If Injecting the Key or Password Using Cloud-Init Failed After NetworkManager Is Installed?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0078454810.html", + "product_code":"ims", + "code":"140", + "des":"growpart for SUSE and openSUSE is an independent toolkit that does not start with cloud-*. Perform operations in this section to install growpart.Run the following comman", + "doc_type":"usermanual", + "kw":"How Do I Install growpart for SUSE 11 SP4?,Cloud-Init,User Guide", + "title":"How Do I Install growpart for SUSE 11 SP4?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0076880304.html", + "product_code":"ims", + "code":"141", + "des":"An image whose root partition file system is xfs cannot automatically expand its partitions.An image that has the LVM partition cannot automatically expand its partitions", + "doc_type":"usermanual", + "kw":"How Do I Configure a Linux Private Image to Make It Automatically Expand Its Root Partition?,Cloud-I", + "title":"How Do I Configure a Linux Private Image to Make It Automatically Expand Its Root Partition?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713220.html", + "product_code":"ims", + "code":"142", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"ECS Creation", + "title":"ECS Creation", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713209.html", + "product_code":"ims", + "code":"143", + "des":"Yes. You can specify the CPU, memory, bandwidth, data disks of the new ECSs if necessary. You can also specify their system disk size. The value must be smaller than 1024", + "doc_type":"usermanual", + "kw":"Can I Use a Private Image to Create ECSs with Different Hardware Specifications from the ECS Used to", + "title":"Can I Use a Private Image to Create ECSs with Different Hardware Specifications from the ECS Used to Create the Private Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713221.html", + "product_code":"ims", + "code":"144", + "des":"Yes. However, the value must be smaller than 30,768 GB but no less than the system disk size in the image.Ensure that your ECS OS supports the system disk size you specif", + "doc_type":"usermanual", + "kw":"Can I Specify the System Disk Size When I Create an ECS Using an Image?,ECS Creation,User Guide", + "title":"Can I Specify the System Disk Size When I Create an ECS Using an Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0034220644.html", + "product_code":"ims", + "code":"145", + "des":"This may be caused by a disk partition ID change after the cross-platform image import. As a result, no partition can be found based on the original disk partition ID in ", + "doc_type":"usermanual", + "kw":"What Do I Do If No Partition Is Found During the Startup of an ECS Created from an Imported Private ", + "title":"What Do I Do If No Partition Is Found During the Startup of an ECS Created from an Imported Private Image?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0030713219.html", + "product_code":"ims", + "code":"146", + "des":"Generally, this is because the xen-blkfront.ko module is not loaded during the startup. You need to modify OS kernel startup parameters. Figure 1 shows the startup screen", + "doc_type":"usermanual", + "kw":"What Do I Do If the Disks of an ECS Created from a CentOS Image Cannot Be Found?,ECS Creation,User G", + "title":"What Do I Do If the Disks of an ECS Created from a CentOS Image Cannot Be Found?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0113403127.html", + "product_code":"ims", + "code":"147", + "des":"This issue is probably caused by the failure of offline VirtIO driver injection.When you inject the VirtIO driver for a Windows ECS offline, there are some restrictions:I", + "doc_type":"usermanual", + "kw":"What Do I Do If an ECS Created from a Windows Image Failed to Start When I Have Enabled Automatic Co", + "title":"What Do I Do If an ECS Created from a Windows Image Failed to Start When I Have Enabled Automatic Configuration During Image Registration?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0161870891.html", + "product_code":"ims", + "code":"148", + "des":"An ECS created from a private image using the UEFI boot mode cannot start.The image OS uses the UEFI boot mode, but the uefi attribute is not added to the image.Delete th", + "doc_type":"usermanual", + "kw":"What Do I Do If an Exception Occurs When I Start an ECS Created from an Image Using the UEFI Boot Mo", + "title":"What Do I Do If an Exception Occurs When I Start an ECS Created from an Image Using the UEFI Boot Mode?", + "githuburl":"" + }, + { + "uri":"en-us_topic_0041178787.html", + "product_code":"ims", + "code":"149", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"usermanual", + "kw":"Change History,User Guide", + "title":"Change History", + "githuburl":"" + }, + { + "uri":"en-us_topic_0047898081.html", + "product_code":"ims", + "code":"150", + "des":"For details about the terms involved in this document, see Glossary.", + "doc_type":"usermanual", + "kw":"Glossary,User Guide", + "title":"Glossary", + "githuburl":"" + } +] \ No newline at end of file diff --git a/docs/ims/umn/CLASS.TXT.json b/docs/ims/umn/CLASS.TXT.json index 60fb2bebd..67d3e5d5f 100644 --- a/docs/ims/umn/CLASS.TXT.json +++ b/docs/ims/umn/CLASS.TXT.json @@ -1,11 +1,1352 @@ [ - { - "desc":"Demo", - "product_code":"ims", - "title":"Overview", - "uri":"index.html", - "doc_type":"usermanual", - "p_code":"", - "code":"1" - } -] + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Overview", + "uri":"en-us_topic_0013901623.html", + "doc_type":"usermanual", + "p_code":"", + "code":"1" + }, + { + "desc":"An image is a server or disk template that contains an operating system (OS) or service data and necessary software, such as database software. IMS provides public, priva", + "product_code":"ims", + "title":"What Is Image Management Service?", + "uri":"en-us_topic_0013901609.html", + "doc_type":"usermanual", + "p_code":"1", + "code":"2" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Supported OSs", + "uri":"en-us_topic_0030713146.html", + "doc_type":"usermanual", + "p_code":"1", + "code":"3" + }, + { + "desc":"This section describes the OSs supported by different types of ECSs.Table 1 lists the OSs supported by the following ECSs:General-purpose T6General computing S2, S3, S6, ", + "product_code":"ims", + "title":"OSs Supported by Different Types of ECSs", + "uri":"en-us_topic_0030713142.html", + "doc_type":"usermanual", + "p_code":"3", + "code":"4" + }, + { + "desc":"Image files in VMDK, VHD, QCOW2, RAW, VHDX, QED, VDI, QCOW, ZVHD2, or ZVHD format can be used to create private images. Select whichever format best meeting your requirem", + "product_code":"ims", + "title":"External Image File Formats and Supported OSs", + "uri":"en-us_topic_0030713143.html", + "doc_type":"usermanual", + "p_code":"3", + "code":"5" + }, + { + "desc":"The ECS boot mode can be BIOS or UEFI. For details about the differences between the two modes, see How Is BIOS Different from UEFI?Table 1 lists the OSs that support the", + "product_code":"ims", + "title":"OSs Supporting UEFI Boot Mode", + "uri":"en-us_topic_0170853315.html", + "doc_type":"usermanual", + "p_code":"3", + "code":"6" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Basic Concepts", + "uri":"en-us_topic_0194137262.html", + "doc_type":"usermanual", + "p_code":"1", + "code":"7" + }, + { + "desc":"A region and availability zone (AZ) identify the location of a data center. You can create resources in a specific region and AZ.A region is a physical data center, which", + "product_code":"ims", + "title":"Region and AZ", + "uri":"en-us_topic_0171754221.html", + "doc_type":"usermanual", + "p_code":"7", + "code":"8" + }, + { + "desc":"IMS supports multiple image formats, but the system uses ZVHD or ZVHD2 by default.Table 1 lists the common image formats.", + "product_code":"ims", + "title":"Common Image Formats", + "uri":"en-us_topic_0089615820.html", + "doc_type":"usermanual", + "p_code":"7", + "code":"9" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Related Services", + "uri":"en-us_topic_0030713148.html", + "doc_type":"usermanual", + "p_code":"1", + "code":"10" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Creating a Private Image", + "uri":"en-us_topic_0130878289.html", + "doc_type":"usermanual", + "p_code":"", + "code":"11" + }, + { + "desc":"A private image is an image available only to the user who created it. It contains an OS, preinstalled public applications, and a user's personal applications. A private ", + "product_code":"ims", + "title":"Introduction", + "uri":"en-us_topic_0013901628.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"12" + }, + { + "desc":"If you have created and configured a Windows ECS based on your service requirements (for example, by installing software and setting up an application environment), you c", + "product_code":"ims", + "title":"Creating a System Disk Image from a Windows ECS", + "uri":"en-us_topic_0030713149.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"13" + }, + { + "desc":"If you have created and configured a Linux ECS based on your service requirements (for example, by installing software and setting up an application environment), you can", + "product_code":"ims", + "title":"Creating a System Disk Image from a Linux ECS", + "uri":"en-us_topic_0030713180.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"14" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Creating a Windows System Disk Image from an External Image File", + "uri":"en-us_topic_0030713181.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"15" + }, + { + "desc":"You can import a local image or a system disk image from another cloud platform to the current cloud. After an image is imported, you can use it to create ECSs or reinsta", + "product_code":"ims", + "title":"Overview", + "uri":"en-us_topic_0030713182.html", + "doc_type":"usermanual", + "p_code":"15", + "code":"16" + }, + { + "desc":"You need to prepare an image file that meets the platform requirements.You are advised to complete the network, tool, and driver configurations in Table 1 on the ECS and ", + "product_code":"ims", + "title":"Preparing an Image File", + "uri":"en-us_topic_0030713189.html", + "doc_type":"usermanual", + "p_code":"15", + "code":"17" + }, + { + "desc":"You are advised to use OBS Browser to upload external image files to OBS buckets. For details, see Object Storage Service User Guide.Only unencrypted external image files", + "product_code":"ims", + "title":"Uploading an External Image File", + "uri":"en-us_topic_0030713183.html", + "doc_type":"usermanual", + "p_code":"15", + "code":"18" + }, + { + "desc":"Register an image file uploaded to the OBS bucket as a private image.Log in to the management console.Under Compute, click Image Management Service.The IMS console is dis", + "product_code":"ims", + "title":"Registering an External Image File as a Private Image", + "uri":"en-us_topic_0030713184.html", + "doc_type":"usermanual", + "p_code":"15", + "code":"19" + }, + { + "desc":"After registering an external image file as a private image on the cloud platform, you can use the image to create ECSs or change the OSs of existing ECSs.This section de", + "product_code":"ims", + "title":"Creating a Windows ECS from an Image", + "uri":"en-us_topic_0030713188.html", + "doc_type":"usermanual", + "p_code":"15", + "code":"20" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Creating a Linux System Disk Image from an External Image File", + "uri":"en-us_topic_0030713190.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"21" + }, + { + "desc":"You can import a local image or a system disk image from another cloud platform to the current cloud. After an image is imported, you can use it to create ECSs or reinsta", + "product_code":"ims", + "title":"Overview", + "uri":"en-us_topic_0030713191.html", + "doc_type":"usermanual", + "p_code":"21", + "code":"22" + }, + { + "desc":"You need to prepare an image file that meets the platform requirements.You are advised to complete the file system, network, and driver configurations in Table 1 on the V", + "product_code":"ims", + "title":"Preparing an Image File", + "uri":"en-us_topic_0030713198.html", + "doc_type":"usermanual", + "p_code":"21", + "code":"23" + }, + { + "desc":"You are advised to use OBS Browser to upload external image files to OBS buckets. For details, see Object Storage Service User Guide.Only unencrypted external image files", + "product_code":"ims", + "title":"Uploading an External Image File", + "uri":"en-us_topic_0030713192.html", + "doc_type":"usermanual", + "p_code":"21", + "code":"24" + }, + { + "desc":"Register an image file uploaded to the OBS bucket as a private image.Log in to the management console.Under Compute, click Image Management Service.The IMS console is dis", + "product_code":"ims", + "title":"Registering an External Image File as a Private Image", + "uri":"en-us_topic_0030713193.html", + "doc_type":"usermanual", + "p_code":"21", + "code":"25" + }, + { + "desc":"After registering an external image file as a private image on the cloud platform, you can use the image to create ECSs or change the OSs of existing ECSs.This section de", + "product_code":"ims", + "title":"Creating a Linux ECS from an Image", + "uri":"en-us_topic_0030713197.html", + "doc_type":"usermanual", + "p_code":"21", + "code":"26" + }, + { + "desc":"For how to create a BMS private image, see Bare Metal Server User Guide.", + "product_code":"ims", + "title":"Creating a BMS System Disk Image", + "uri":"en-us_topic_0095084510.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"27" + }, + { + "desc":"A data disk image contains only service data. You can create a data disk image from an ECS and then use the image to create new EVS disks. This is a convenient way to mig", + "product_code":"ims", + "title":"Creating a Data Disk Image from an ECS", + "uri":"en-us_topic_0102644450.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"28" + }, + { + "desc":"A data disk image contains only service data. You can create a data disk image using a local image file or an external image file (image file on another cloud platform). ", + "product_code":"ims", + "title":"Creating a Data Disk Image from an External Image File", + "uri":"en-us_topic_0084064672.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"29" + }, + { + "desc":"You can create an image of an entire ECS, including not just the OS, but also the software and all the service data. You can then use this image to migrate data by quickl", + "product_code":"ims", + "title":"Creating a Full-ECS Image from an ECS", + "uri":"en-us_topic_0116125142.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"30" + }, + { + "desc":"Create a full-ECS image from a CSBS backup. This image can then be used to create ECSs.When creating a full-ECS image from a CSBS backup, ensure that the source ECS of th", + "product_code":"ims", + "title":"Creating a Full-ECS Image from a CSBS Backup", + "uri":"en-us_topic_0093344231.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"31" + }, + { + "desc":"You can use a Cloud Backup and Recovery (CBR) backup to create a full-ECS image, which can be used to create ECSs.The Cloud Backup and Recovery (CBR) service provides bac", + "product_code":"ims", + "title":"Creating a Full-ECS Image from a CBR Backup", + "uri":"en-us_topic_0176812699.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"32" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Quickly Importing an Image File", + "uri":"en-us_topic_0030713151.html", + "doc_type":"usermanual", + "p_code":"11", + "code":"33" + }, + { + "desc":"If an image file is larger than 128 GB, you can import it using fast import. Only the RAW and ZVHD2 formats support fast import. The image file to be imported cannot exce", + "product_code":"ims", + "title":"Overview", + "uri":"en-us_topic_0133773658.html", + "doc_type":"usermanual", + "p_code":"33", + "code":"34" + }, + { + "desc":"This section describes how to convert the format of an image file on a Linux server and then quickly import it to the cloud platform. You are advised to use an EulerOS EC", + "product_code":"ims", + "title":"Quickly Importing an Image File (Linux)", + "uri":"en-us_topic_0133773660.html", + "doc_type":"usermanual", + "p_code":"33", + "code":"35" + }, + { + "desc":"This section describes how to convert the format of an image file on a Windows server and then quickly import it to the cloud platform. You are advised to use a local Win", + "product_code":"ims", + "title":"Quickly Importing an Image File (Windows)", + "uri":"en-us_topic_0174703579.html", + "doc_type":"usermanual", + "p_code":"33", + "code":"36" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Managing Private Images", + "uri":"en-us_topic_0013901608.html", + "doc_type":"usermanual", + "p_code":"", + "code":"37" + }, + { + "desc":"You can modify the following attributes of a private image:NameDescriptionMinimum MemoryMaximum MemoryNIC Multi-QueueNIC multi-queue enables multiple CPUs to process NIC ", + "product_code":"ims", + "title":"Modifying an Image", + "uri":"en-us_topic_0030713199.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"38" + }, + { + "desc":"You can export the public or private image list in the current region as a CSV file to your local PC.For public images, the file describes the image name, image status, O", + "product_code":"ims", + "title":"Exporting Image List", + "uri":"en-us_topic_0090099339.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"39" + }, + { + "desc":"You can check the disk capacity of a private image.To check the disk capacity of a system disk image, data disk image, or ISO image, see Check the Disk Capacity of a Syst", + "product_code":"ims", + "title":"Checking the Disk Capacity of an Image", + "uri":"en-us_topic_0300978092.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"40" + }, + { + "desc":"You can use a public, private, or shared image to create an ECS.If you use a public image, the created ECS contains an OS and pre-installed public applications. You need ", + "product_code":"ims", + "title":"Creating an ECS from an Image", + "uri":"en-us_topic_0030713200.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"41" + }, + { + "desc":"You can delete private images that will no longer be used.Access the IMS console.Log in to the management console.Under Compute, click Image Management Service.The IMS co", + "product_code":"ims", + "title":"Deleting Images", + "uri":"en-us_topic_0030713201.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"42" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Sharing Images", + "uri":"en-us_topic_0032042416.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"43" + }, + { + "desc":"You can share your private images with other tenants. The tenants who accept the shared images can use the images to create ECSs of the same specifications.You can share ", + "product_code":"ims", + "title":"Overview", + "uri":"en-us_topic_0032042417.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"44" + }, + { + "desc":"Before a tenant shares an image with you, you need to provide your project ID.Access the IMS console.Log in to the management console.Under Compute, click Image Managemen", + "product_code":"ims", + "title":"Obtaining the Project ID", + "uri":"en-us_topic_0032042418.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"45" + }, + { + "desc":"After obtaining the project ID from a tenant, you can share specified private images with the tenant. You can share a single image or multiple images as needed.You have o", + "product_code":"ims", + "title":"Sharing Specified Images", + "uri":"en-us_topic_0032042419.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"46" + }, + { + "desc":"After another tenant shares images with you, you will receive a message. You can choose to accept or reject all or some of the shared images.If you are not in the same re", + "product_code":"ims", + "title":"Accepting or Rejecting Shared Images", + "uri":"en-us_topic_0032042420.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"47" + }, + { + "desc":"You can reject accepted images if you no longer need them.After an image is rejected, it will not be displayed on the Images Shared with Me page.You have accepted images ", + "product_code":"ims", + "title":"Rejecting Accepted Images", + "uri":"en-us_topic_0032042421.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"48" + }, + { + "desc":"If you want to use the shared images you have rejected, you can accept them from the list of rejected images.You have rejected the images shared by others.The image owner", + "product_code":"ims", + "title":"Accepting Rejected Images", + "uri":"en-us_topic_0075730699.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"49" + }, + { + "desc":"You can stop sharing images. After you stop sharing an image:The image will be invisible to the recipient on the management console and no data will be returned when the ", + "product_code":"ims", + "title":"Stopping Sharing Images", + "uri":"en-us_topic_0032042422.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"50" + }, + { + "desc":"In addition to the tenants you have shared images with, you can add more tenants who can use the shared images.You have shared private images.You have obtained the projec", + "product_code":"ims", + "title":"Adding Tenants Who Can Use Shared Images", + "uri":"en-us_topic_0032042423.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"51" + }, + { + "desc":"This section describes how to delete image recipients who can use shared images.You have shared private images.You have obtained project IDs of the image recipients.Acces", + "product_code":"ims", + "title":"Deleting Image Recipients Who Can Use Shared Images", + "uri":"en-us_topic_0032087324.html", + "doc_type":"usermanual", + "p_code":"43", + "code":"52" + }, + { + "desc":"IMS provides multiple methods for importing images. You can select a method based on the image file type, format, or size.To import a data disk image file, follow the ins", + "product_code":"ims", + "title":"Importing an Image", + "uri":"en-us_topic_0000001175697174.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"53" + }, + { + "desc":"You can export a private image to a standard OBS bucket and then download it to your local PC.You can reproduce cloud servers and their running environments in on-promise", + "product_code":"ims", + "title":"Exporting an Image", + "uri":"en-us_topic_0034011241.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"54" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Optimizing a Windows Private Image", + "uri":"en-us_topic_0130878748.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"55" + }, + { + "desc":"ECSs require Xen Guest OS driver (PV driver) and KVM Guest OS driver (UVP VMTools) for proper running. To ensure that ECSs support both Xen and KVM and to improve network", + "product_code":"ims", + "title":"Optimization Process", + "uri":"en-us_topic_0047501112.html", + "doc_type":"usermanual", + "p_code":"55", + "code":"56" + }, + { + "desc":"Open the cmd window and run the following command to query the virtualization type of the ECS:systeminfoIf the values of System Manufacturer and BIOS Version are Xen, the", + "product_code":"ims", + "title":"Viewing the Virtualization Type of a Windows ECS", + "uri":"en-us_topic_0125075471.html", + "doc_type":"usermanual", + "p_code":"55", + "code":"57" + }, + { + "desc":"Table 1 lists the PV driver software packages required for optimizing Windows private images.Table 2 lists the UVP VMTools software packages required for optimizing Windo", + "product_code":"ims", + "title":"Obtaining Required Software Packages", + "uri":"en-us_topic_0037352059.html", + "doc_type":"usermanual", + "p_code":"55", + "code":"58" + }, + { + "desc":"When using an ECS or external image file to create a private image, ensure that the PV driver has been installed in the OS to enable Xen virtualization for subsequently c", + "product_code":"ims", + "title":"Installing the PV Driver", + "uri":"en-us_topic_0037352182.html", + "doc_type":"usermanual", + "p_code":"55", + "code":"59" + }, + { + "desc":"Before using an ECS or external image file to create a private image, ensure that UVP VMTools has been installed in the OS to enable subsequently created ECSs to support ", + "product_code":"ims", + "title":"Installing UVP VMTools", + "uri":"en-us_topic_0037352061.html", + "doc_type":"usermanual", + "p_code":"55", + "code":"60" + }, + { + "desc":"After installing the PV driver and UVP VMTools, perform the following operations to clear system logs:For Windows Server 2008 and Windows Server 2012, right-click Compute", + "product_code":"ims", + "title":"Clearing System Logs", + "uri":"en-us_topic_0125075472.html", + "doc_type":"usermanual", + "p_code":"55", + "code":"61" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Optimizing a Linux Private Image", + "uri":"en-us_topic_0130878749.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"62" + }, + { + "desc":"A Linux ECS can be switched from Xen to KVM if xen-pv and VirtIO drivers run on the ECS. Before changing a Xen-based ECS to a KVM-based ECS, ensure that the required driv", + "product_code":"ims", + "title":"Optimization Process", + "uri":"en-us_topic_0047501133.html", + "doc_type":"usermanual", + "p_code":"62", + "code":"63" + }, + { + "desc":"You can run the following command to query the virtualization type of an ECS:lscpuIf the value of Hypervisor vendor is Xen, the ECS uses Xen. If KVM is required, perform ", + "product_code":"ims", + "title":"Viewing the Virtualization Type of a Linux ECS", + "uri":"en-us_topic_0037352185.html", + "doc_type":"usermanual", + "p_code":"62", + "code":"64" + }, + { + "desc":"When optimizing a Linux private image, you need to change the UUID in the fstab and GRUB configuration files, and install native Xen and KVM drivers on the ECS. To ensure", + "product_code":"ims", + "title":"Uninstalling the PV Driver from a Linux ECS", + "uri":"en-us_topic_0037352186.html", + "doc_type":"usermanual", + "p_code":"62", + "code":"65" + }, + { + "desc":"When optimizing a Linux private image, you need to change the disk identifier to UUID in the GRUB configuration file of the ECS.Modify the menu.lst or grub.cfg configurat", + "product_code":"ims", + "title":"Changing the Disk Identifier in the GRUB Configuration File to UUID", + "uri":"en-us_topic_0086020895.html", + "doc_type":"usermanual", + "p_code":"62", + "code":"66" + }, + { + "desc":"When optimizing a Linux private image, you need to change the disk identifier to UUID in the fstab configuration file of the ECS.Take CentOS 7.0 as an example. Run blkid ", + "product_code":"ims", + "title":"Changing the Disk Identifier in the fstab File to UUID", + "uri":"en-us_topic_0086024961.html", + "doc_type":"usermanual", + "p_code":"62", + "code":"67" + }, + { + "desc":"When optimizing a Linux private image, you need to install native KVM drivers on the ECS.If you do not install KVM drivers, NICs of the ECS may not be detected and the EC", + "product_code":"ims", + "title":"Installing Native KVM Drivers", + "uri":"en-us_topic_0000001120952155.html", + "doc_type":"usermanual", + "p_code":"62", + "code":"68" + }, + { + "desc":"Delete log files and historical records, and stop the ECS.Run the following commands to delete redundant key files:echo > /$path/$to/$root/.ssh/authorized_keysAn example ", + "product_code":"ims", + "title":"Clearing System Logs", + "uri":"en-us_topic_0125076462.html", + "doc_type":"usermanual", + "p_code":"62", + "code":"69" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Encrypting Images", + "uri":"en-us_topic_0046588153.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"70" + }, + { + "desc":"IMS allows you to create encrypted images to ensure data security.To use the image encryption function, you must apply for KMS Administrator permissions.KMS must be enabl", + "product_code":"ims", + "title":"Overview", + "uri":"en-us_topic_0046588154.html", + "doc_type":"usermanual", + "p_code":"70", + "code":"71" + }, + { + "desc":"You can create an encrypted image using an external image file or an encrypted ECS.Create an encrypted image using an external image file.When you register the external i", + "product_code":"ims", + "title":"Creating Encrypted Images", + "uri":"en-us_topic_0046588155.html", + "doc_type":"usermanual", + "p_code":"70", + "code":"72" + }, + { + "desc":"You can convert encrypted and unencrypted images into each other or enable some advanced features (such as fast ECS creation from an image) using the image replication fu", + "product_code":"ims", + "title":"Replicating Images", + "uri":"en-us_topic_0049177180.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"73" + }, + { + "desc":"You can use tags to classify images. You can add, modify, or delete image tags, or search for required images by tag in the image list.When adding predefined tags to an i", + "product_code":"ims", + "title":"Tagging an Image", + "uri":"en-us_topic_0068002265.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"74" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Auditing Key Operations", + "uri":"en-us_topic_0107462580.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"75" + }, + { + "desc":"Cloud Trace Service (CTS) is a log audit service provided by the public cloud and intended for cloud security. It allows you to collect, store, and query cloud resource o", + "product_code":"ims", + "title":"IMS Operations Recorded by CTS", + "uri":"en-us_topic_0107462581.html", + "doc_type":"usermanual", + "p_code":"75", + "code":"76" + }, + { + "desc":"Once CTS is enabled, it starts recording IMS operations. You can view operations recorded in the last seven days on the CTS management console.This section describes how ", + "product_code":"ims", + "title":"Viewing Traces", + "uri":"en-us_topic_0107462582.html", + "doc_type":"usermanual", + "p_code":"75", + "code":"77" + }, + { + "desc":"You can import an image file in VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, QED, ZVHD, or ZVHD2 format to the cloud platform. Image files in other formats need to be converte", + "product_code":"ims", + "title":"Converting the Image Format Using qemu-img", + "uri":"en-us_topic_0117262219.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"78" + }, + { + "desc":"You can import an image file in VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, QED, ZVHD, or ZVHD2 format to the cloud platform. Image files in other formats need to be converte", + "product_code":"ims", + "title":"Converting the Image Format Using qemu-img-hw", + "uri":"en-us_topic_0171668652.html", + "doc_type":"usermanual", + "p_code":"37", + "code":"79" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Windows Operations", + "uri":"en-us_topic_0199394934.html", + "doc_type":"usermanual", + "p_code":"", + "code":"80" + }, + { + "desc":"If a private image is created from an ECS or external image file and the VM where the ECS or external image file is located is configured with a static IP address, you ne", + "product_code":"ims", + "title":"Setting the NIC to DHCP", + "uri":"en-us_topic_0030713152.html", + "doc_type":"usermanual", + "p_code":"80", + "code":"81" + }, + { + "desc":"If you want to remotely access an ECS, enable remote desktop connection for the source ECS when creating a private image. This function must be enabled for GPU-accelerate", + "product_code":"ims", + "title":"Enabling Remote Desktop Connection", + "uri":"en-us_topic_0030713155.html", + "doc_type":"usermanual", + "p_code":"80", + "code":"82" + }, + { + "desc":"To ensure that you can use the user data injection function to inject initial custom information into ECSs created from a private image (such as setting the ECS login pas", + "product_code":"ims", + "title":"Installing and Configuring Cloudbase-Init", + "uri":"en-us_topic_0030730602.html", + "doc_type":"usermanual", + "p_code":"80", + "code":"83" + }, + { + "desc":"Running Sysprep ensures that an ECS has a unique SID after it is added to a domain.After installing Cloudbase-Init on an ECS, you need to decide whether the ECS needs to ", + "product_code":"ims", + "title":"Running Sysprep", + "uri":"en-us_topic_0093887081.html", + "doc_type":"usermanual", + "p_code":"80", + "code":"84" + }, + { + "desc":"Before using some types of ECSs to create private images, you need to install special drivers on the ECSs.If you want to use the created private image to create GPU-accel", + "product_code":"ims", + "title":"Installing Special Windows Drivers", + "uri":"en-us_topic_0081795392.html", + "doc_type":"usermanual", + "p_code":"80", + "code":"85" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Linux Operations", + "uri":"en-us_topic_0199394935.html", + "doc_type":"usermanual", + "p_code":"", + "code":"86" + }, + { + "desc":"If a private image is created from an ECS or external image file and the VM where the ECS or external image file is located is configured with a static IP address, you ne", + "product_code":"ims", + "title":"Setting the NIC to DHCP", + "uri":"en-us_topic_0030713176.html", + "doc_type":"usermanual", + "p_code":"86", + "code":"87" + }, + { + "desc":"To prevent NIC name drift when you use a private image to create ECSs, you need to delete files from the network rule directory of the VM where the ECS or image file is l", + "product_code":"ims", + "title":"Deleting Files from the Network Rule Directory", + "uri":"en-us_topic_0069904570.html", + "doc_type":"usermanual", + "p_code":"86", + "code":"88" + }, + { + "desc":"To ensure that you can use the user data injection function to inject initial custom information into ECSs created from a private image (such as setting the ECS login pas", + "product_code":"ims", + "title":"Installing Cloud-Init", + "uri":"en-us_topic_0030730603.html", + "doc_type":"usermanual", + "p_code":"86", + "code":"89" + }, + { + "desc":"You need to configure Cloud-Init after it is installed.Cloud-Init has been installed.An EIP has been bound to the ECS.You have logged in to the ECS.The IP address obtaini", + "product_code":"ims", + "title":"Configuring Cloud-Init", + "uri":"en-us_topic_0122876047.html", + "doc_type":"usermanual", + "p_code":"86", + "code":"90" + }, + { + "desc":"Before using some types of ECSs to create private images, you need to install special drivers on the ECSs.If you want to use the private image to create P1 ECSs, install ", + "product_code":"ims", + "title":"Installing Special Linux Drivers", + "uri":"en-us_topic_0082002007.html", + "doc_type":"usermanual", + "p_code":"86", + "code":"91" + }, + { + "desc":"If multiple data disks are attached to the ECS used to create a private image, ECSs created from the image may be unavailable. Therefore, you need to detach all data disk", + "product_code":"ims", + "title":"Detaching Data Disks from an ECS", + "uri":"en-us_topic_0030713179.html", + "doc_type":"usermanual", + "p_code":"86", + "code":"92" + }, + { + "desc":"If you want to use the ECS console logging function, you need to configure related parameters on the ECS.Currently, ECSs running the following OSs are supported: CentOS 6", + "product_code":"ims", + "title":"Configuring Console Logging", + "uri":"en-us_topic_0057450886.html", + "doc_type":"usermanual", + "p_code":"86", + "code":"93" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"FAQs", + "uri":"en-us_topic_0030713202.html", + "doc_type":"usermanual", + "p_code":"", + "code":"94" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Image Consulting", + "uri":"en-us_topic_0138455714.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"95" + }, + { + "desc":"When creating an ECS or BMS, you can select an image based on the following factors:Region and AZImage TypeOSAn image is a regional resource. You cannot use an image to c", + "product_code":"ims", + "title":"How Do I Select an Image?", + "uri":"en-us_topic_0195253327.html", + "doc_type":"usermanual", + "p_code":"95", + "code":"96" + }, + { + "desc":"Quotas can limit the number or amount of resources available to users, such as the maximum number of ECSs or EVS disks that can be created.If the existing resource quota ", + "product_code":"ims", + "title":"How Do I Increase the Image Quota?", + "uri":"en-us_topic_0153114116.html", + "doc_type":"usermanual", + "p_code":"95", + "code":"97" + }, + { + "desc":"Yes.Other tenants can share a private image with you. You can use it after accepting it. For details about image sharing, see Sharing Specified Images.", + "product_code":"ims", + "title":"Can I Use Private Images of Other Tenants?", + "uri":"en-us_topic_0173986473.html", + "doc_type":"usermanual", + "p_code":"95", + "code":"98" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Image Creation", + "uri":"en-us_topic_0193137621.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"99" + }, + { + "desc":"Currently, you can create a maximum of 100 private images under an account in a region.No. You can create an image from a running ECS. However, if data is written to the ", + "product_code":"ims", + "title":"Image Creation FAQs", + "uri":"en-us_topic_0193146244.html", + "doc_type":"usermanual", + "p_code":"99", + "code":"100" + }, + { + "desc":"An ECS used to create a Windows full-ECS image cannot have a spanned volume. If you attempt to create an image from an ECS with a spanned volume, when the image is used t", + "product_code":"ims", + "title":"How Do I Create a Full-ECS Image Using an ECS That Has a Spanned Volume?", + "uri":"en-us_topic_0106444267.html", + "doc_type":"usermanual", + "p_code":"99", + "code":"101" + }, + { + "desc":"For a user that needs to be added to a domain and uses the domain account to log in to Windows, Sysprep is required before a private image is created. Otherwise, the imag", + "product_code":"ims", + "title":"Why Is Sysprep Required for Creating a Private Image from a Windows ECS?", + "uri":"en-us_topic_0030742197.html", + "doc_type":"usermanual", + "p_code":"99", + "code":"102" + }, + { + "desc":"When you create a ZVHD2 image using an API, the image is created in the ZVHD format.Check whether your token contains the op_gated_lld role (op_gated_lld is the OBT tag, ", + "product_code":"ims", + "title":"What Do I Do If I Cannot Create an Image in ZVHD2 Format Using an API?", + "uri":"en-us_topic_0096558549.html", + "doc_type":"usermanual", + "p_code":"99", + "code":"103" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Image Sharing", + "uri":"en-us_topic_0171668653.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"104" + }, + { + "desc":"128There is no limit.No.No.Yes. After sharing an image with other tenants, you can still use the image to create an ECS and use the created ECS to create a private image.", + "product_code":"ims", + "title":"Image Sharing FAQs", + "uri":"en-us_topic_0183293890.html", + "doc_type":"usermanual", + "p_code":"104", + "code":"105" + }, + { + "desc":"Cause 1: Some images cannot be shared in any cases (the Share button in the Operation column for these images is unavailable), such as:Encrypted imagesFull-ECS images cre", + "product_code":"ims", + "title":"What Do I Do If I Cannot Share My Images?", + "uri":"en-us_topic_0037352060.html", + "doc_type":"usermanual", + "p_code":"104", + "code":"106" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"OS", + "uri":"en-us_topic_0133773782.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"107" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"How Is BIOS Different from UEFI?", + "uri":"en-us_topic_0113533721.html", + "doc_type":"usermanual", + "p_code":"107", + "code":"108" + }, + { + "desc":"The target ECS has had an EIP bound.You have obtained the driver installation package required for an OS. For details, see Table 1.The procedure for installing the NVIDIA", + "product_code":"ims", + "title":"How Do I Install the NVIDIA Driver on a P1 ECS?", + "uri":"en-us_topic_0093842586.html", + "doc_type":"usermanual", + "p_code":"107", + "code":"109" + }, + { + "desc":"Press Win+R. In the displayed dialog box, enter regedit and press Enter to open the registry editor.Open the following registry key:HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\", + "product_code":"ims", + "title":"How Do I Delete Redundant Network Connections from a Windows ECS?", + "uri":"en-us_topic_0106312064.html", + "doc_type":"usermanual", + "p_code":"107", + "code":"110" + }, + { + "desc":"If an ECS starts slowly, you can change the default timeout duration to speed up the startup.Log in to the ECS.Run the following command to switch to user root:sudo susud", + "product_code":"ims", + "title":"What Do I Do If an ECS Starts Slowly?", + "uri":"en-us_topic_0117142739.html", + "doc_type":"usermanual", + "p_code":"107", + "code":"111" + }, + { + "desc":"When the 20.4.1 driver package downloaded at Intel website https://downloadcenter.intel.com/search?keyword=Intel++Ethernet+Connections+CD was installed in a Windows 7 64b", + "product_code":"ims", + "title":"What Do I Do If a Windows 7 ECS Equipped with an Intel 82599 NIC Reports an Error in SR-IOV Scenarios?", + "uri":"en-us_topic_0081802526.html", + "doc_type":"usermanual", + "p_code":"107", + "code":"112" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Image Importing", + "uri":"en-us_topic_0030713195.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"113" + }, + { + "desc":"No. Currently, only the VMDK, VHD, RAW, QCOW2, VHDX, QED, VDI, QCOW, ZVHD2, and ZVHD formats are supported.Images of the -flat.vmdk format and image file packages contain", + "product_code":"ims", + "title":"Can I Use Images in Formats Other Than the Specified Ones?", + "uri":"en-us_topic_0030713217.html", + "doc_type":"usermanual", + "p_code":"113", + "code":"114" + }, + { + "desc":"Before using an ECS or external image file to create a private image, you need to pre-configure the ECS or the source VM of the image file. If you do not perform the pre-", + "product_code":"ims", + "title":"What Are the Impacts If I Do Not Pre-configure an ECS Used to Create a Private Image?", + "uri":"en-us_topic_0030713216.html", + "doc_type":"usermanual", + "p_code":"113", + "code":"115" + }, + { + "desc":"Open Virtualization Appliance (OVA) is a single file (with the .ova extension) that archives all the files making up an Open Virtualization Format (OVF). OVF is a folder ", + "product_code":"ims", + "title":"How Do I Import an OVF or OVA File to the Cloud Platform?", + "uri":"en-us_topic_0118990097.html", + "doc_type":"usermanual", + "p_code":"113", + "code":"116" + }, + { + "desc":"If you selected an incorrect OS, ECSs may fail to be created from the private image. If the configured system disk size is less than the one in the image file, image regi", + "product_code":"ims", + "title":"What Do I Do If I Configured an Incorrect OS or System Disk Size During Private Image Registration Using an Image File?", + "uri":"en-us_topic_0030713213.html", + "doc_type":"usermanual", + "p_code":"113", + "code":"117" + }, + { + "desc":"The possible causes may be:You have specified a small value.Check the system disk size in the VHD image file. Specify a value no less than this size when you use the VHD ", + "product_code":"ims", + "title":"What Do I Do If the System Disk Size in a VHD Image File Exceeds the One I Have Specified on the Management Console When I Use This File to Register a Private Image?", + "uri":"en-us_topic_0058841396.html", + "doc_type":"usermanual", + "p_code":"113", + "code":"118" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Image Exporting", + "uri":"en-us_topic_0030713222.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"119" + }, + { + "desc":"Yes. You can download private images in VMDK, VHD, QCOW2, or ZVHD format as instructed in Exporting an Image.", + "product_code":"ims", + "title":"Can I Download My Private Images to a Local PC?", + "uri":"en-us_topic_0249675952.html", + "doc_type":"usermanual", + "p_code":"119", + "code":"120" + }, + { + "desc":"No. The system disk image of an ECS is a VM file that contains a system running environment and does not have an installation boot program. Therefore, it cannot be used o", + "product_code":"ims", + "title":"Can I Use the System Disk Image of an ECS on a Physical Server After I Export It from the Cloud Platform?", + "uri":"en-us_topic_0030713153.html", + "doc_type":"usermanual", + "p_code":"119", + "code":"121" + }, + { + "desc":"After a private image is exported to an OBS bucket, the image size in the bucket is different from that displayed in IMS. For example, the size of a private image is 1.04", + "product_code":"ims", + "title":"Why Is the Image Size in an OBS Bucket Different from That Displayed in IMS?", + "uri":"en-us_topic_0274352601.html", + "doc_type":"usermanual", + "p_code":"119", + "code":"122" + }, + { + "desc":"Currently, you cannot directly download a public image. You can use the public image to create an ECS, use the ECS to create a private image, export the private image to ", + "product_code":"ims", + "title":"Can I Download a Public Image to My Local PC?", + "uri":"en-us_topic_0030713186.html", + "doc_type":"usermanual", + "p_code":"119", + "code":"123" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"What Are the Differences Between Import/Export and Fast Import/Export?", + "uri":"en-us_topic_0199451475.html", + "doc_type":"usermanual", + "p_code":"119", + "code":"124" + }, + { + "desc":"Some images cannot be exported. Therefore, the Export option is not provided for them in the Operation column. The following images cannot be exported:Public imagesFull-E", + "product_code":"ims", + "title":"What Do I Do If the Export Option Is Unavailable for My Image?", + "uri":"en-us_topic_0199396601.html", + "doc_type":"usermanual", + "p_code":"119", + "code":"125" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Image Optimization", + "uri":"en-us_topic_0030713203.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"126" + }, + { + "desc":"Installing Guest OS drivers on an ECS improves your experience in using the ECS. In addition, it also ensures high reliability and stability of ECSs.Windows ECSs: Install", + "product_code":"ims", + "title":"Must I Install Guest OS Drivers on an ECS?", + "uri":"en-us_topic_0030713214.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"127" + }, + { + "desc":"You are advised to enable automatic configuration when registering a private image using an image file. Then, the system will perform the following operations:Check wheth", + "product_code":"ims", + "title":"What Will the System Do to an Image File When I Use the File to Register a Private Image?", + "uri":"en-us_topic_0032307025.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"128" + }, + { + "desc":"When registering an external image file as a private image, you are advised to perform the preceding operations on the VM where the external image file is located.When re", + "product_code":"ims", + "title":"How Do I Configure an ECS, BMS, or Image File Before I Use It to Create an Image?", + "uri":"en-us_topic_0040740508.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"129" + }, + { + "desc":"If an image file is not configured as instructed in Table 1 before it is exported from the original platform, configure it by referring to Figure 1.The proper running of ", + "product_code":"ims", + "title":"What Do I Do If a Windows Image File Is Not Pre-Configured When I Use It to Register a Private Image?", + "uri":"en-us_topic_0030713185.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"130" + }, + { + "desc":"If an image file is not configured as instructed in Table 1 before it is exported from the original platform, configure it by referring to Figure 1.The proper running of ", + "product_code":"ims", + "title":"What Do I Do If a Linux Image File Is Not Pre-Configured When I Use It to Register a Private Image?", + "uri":"en-us_topic_0030713211.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"131" + }, + { + "desc":"With the increase of network I/O bandwidth, a single vCPU cannot meet the requirement of processing NIC interruptions. NIC multi-queue allows multiple vCPUs to process NI", + "product_code":"ims", + "title":"How Do I Enable NIC Multi-Queue for an Image?", + "uri":"en-us_topic_0085214115.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"132" + }, + { + "desc":"Fast Create greatly reduces the time required for creating ECSs from a system disk image. Currently, this feature is supported by all newly created system disk images by ", + "product_code":"ims", + "title":"How Do I Make a System Disk Image Support Fast ECS Creation?", + "uri":"en-us_topic_0187108863.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"133" + }, + { + "desc":"Possible causes:Your image file was exported from a VMware VM, and VMware Tools was not uninstalled or not completely uninstalled.You have downloaded the Guest OS driver ", + "product_code":"ims", + "title":"What Is the Cause of the Failure to Install a Guest OS Driver on a Windows ECS?", + "uri":"en-us_topic_0030713215.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"134" + }, + { + "desc":"When optimizing a Linux private image, you need to install native Xen and KVM drivers for the image.If you do not install Xen drivers for the image, the network performan", + "product_code":"ims", + "title":"How Do I Install Native Xen and KVM Drivers?", + "uri":"en-us_topic_0086020894.html", + "doc_type":"usermanual", + "p_code":"126", + "code":"135" + }, + { + "desc":"If you want to store an unencrypted image in an encrypted way, you can select an encryption key when you replicate the image. Then, the system will generate an encrypted ", + "product_code":"ims", + "title":"Image Encryption", + "uri":"en-us_topic_0049196765.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"136" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Cloud-Init", + "uri":"en-us_topic_0138479468.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"137" + }, + { + "desc":"Cloud-Init is an open-source tool for cloud instance initialization. When creating ECSs from an image with Cloud-Init, you can use user data injection to inject customize", + "product_code":"ims", + "title":"What Can I Do with a Cloud-Init ECS?", + "uri":"en-us_topic_0148873774.html", + "doc_type":"usermanual", + "p_code":"137", + "code":"138" + }, + { + "desc":"A major cause is that the version of Cloud-Init is incompatible with that of NetworkManager. In Debian 9.0 and later versions, NetworkManager is incompatible with Cloud-I", + "product_code":"ims", + "title":"What Do I Do If Injecting the Key or Password Using Cloud-Init Failed After NetworkManager Is Installed?", + "uri":"en-us_topic_0113992021.html", + "doc_type":"usermanual", + "p_code":"137", + "code":"139" + }, + { + "desc":"growpart for SUSE and openSUSE is an independent toolkit that does not start with cloud-*. Perform operations in this section to install growpart.Run the following comman", + "product_code":"ims", + "title":"How Do I Install growpart for SUSE 11 SP4?", + "uri":"en-us_topic_0078454810.html", + "doc_type":"usermanual", + "p_code":"137", + "code":"140" + }, + { + "desc":"An image whose root partition file system is xfs cannot automatically expand its partitions.An image that has the LVM partition cannot automatically expand its partitions", + "product_code":"ims", + "title":"How Do I Configure a Linux Private Image to Make It Automatically Expand Its Root Partition?", + "uri":"en-us_topic_0076880304.html", + "doc_type":"usermanual", + "p_code":"137", + "code":"141" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"ECS Creation", + "uri":"en-us_topic_0030713220.html", + "doc_type":"usermanual", + "p_code":"94", + "code":"142" + }, + { + "desc":"Yes. You can specify the CPU, memory, bandwidth, data disks of the new ECSs if necessary. You can also specify their system disk size. The value must be smaller than 1024", + "product_code":"ims", + "title":"Can I Use a Private Image to Create ECSs with Different Hardware Specifications from the ECS Used to Create the Private Image?", + "uri":"en-us_topic_0030713209.html", + "doc_type":"usermanual", + "p_code":"142", + "code":"143" + }, + { + "desc":"Yes. However, the value must be smaller than 30,768 GB but no less than the system disk size in the image.Ensure that your ECS OS supports the system disk size you specif", + "product_code":"ims", + "title":"Can I Specify the System Disk Size When I Create an ECS Using an Image?", + "uri":"en-us_topic_0030713221.html", + "doc_type":"usermanual", + "p_code":"142", + "code":"144" + }, + { + "desc":"This may be caused by a disk partition ID change after the cross-platform image import. As a result, no partition can be found based on the original disk partition ID in ", + "product_code":"ims", + "title":"What Do I Do If No Partition Is Found During the Startup of an ECS Created from an Imported Private Image?", + "uri":"en-us_topic_0034220644.html", + "doc_type":"usermanual", + "p_code":"142", + "code":"145" + }, + { + "desc":"Generally, this is because the xen-blkfront.ko module is not loaded during the startup. You need to modify OS kernel startup parameters. Figure 1 shows the startup screen", + "product_code":"ims", + "title":"What Do I Do If the Disks of an ECS Created from a CentOS Image Cannot Be Found?", + "uri":"en-us_topic_0030713219.html", + "doc_type":"usermanual", + "p_code":"142", + "code":"146" + }, + { + "desc":"This issue is probably caused by the failure of offline VirtIO driver injection.When you inject the VirtIO driver for a Windows ECS offline, there are some restrictions:I", + "product_code":"ims", + "title":"What Do I Do If an ECS Created from a Windows Image Failed to Start When I Have Enabled Automatic Configuration During Image Registration?", + "uri":"en-us_topic_0113403127.html", + "doc_type":"usermanual", + "p_code":"142", + "code":"147" + }, + { + "desc":"An ECS created from a private image using the UEFI boot mode cannot start.The image OS uses the UEFI boot mode, but the uefi attribute is not added to the image.Delete th", + "product_code":"ims", + "title":"What Do I Do If an Exception Occurs When I Start an ECS Created from an Image Using the UEFI Boot Mode?", + "uri":"en-us_topic_0161870891.html", + "doc_type":"usermanual", + "p_code":"142", + "code":"148" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ims", + "title":"Change History", + "uri":"en-us_topic_0041178787.html", + "doc_type":"usermanual", + "p_code":"", + "code":"149" + }, + { + "desc":"For details about the terms involved in this document, see Glossary.", + "product_code":"ims", + "title":"Glossary", + "uri":"en-us_topic_0047898081.html", + "doc_type":"usermanual", + "p_code":"", + "code":"150" + } +] \ No newline at end of file diff --git a/docs/ims/umn/PARAMETERS.txt b/docs/ims/umn/PARAMETERS.txt new file mode 100644 index 000000000..6da8d5f07 --- /dev/null +++ b/docs/ims/umn/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/ims/umn/en-us_image_0000001082321842.png b/docs/ims/umn/en-us_image_0000001082321842.png new file mode 100644 index 000000000..1f8bc73a3 Binary files /dev/null and b/docs/ims/umn/en-us_image_0000001082321842.png differ diff --git a/docs/ims/umn/en-us_image_0000001147047376.png b/docs/ims/umn/en-us_image_0000001147047376.png new file mode 100644 index 000000000..3e2aa6039 Binary files /dev/null and b/docs/ims/umn/en-us_image_0000001147047376.png differ diff --git a/docs/ims/umn/en-us_image_0000001211409095.png b/docs/ims/umn/en-us_image_0000001211409095.png new file mode 100644 index 000000000..04a5b6a9e Binary files /dev/null and b/docs/ims/umn/en-us_image_0000001211409095.png differ diff --git a/docs/ims/umn/en-us_image_0030714279.png b/docs/ims/umn/en-us_image_0030714279.png new file mode 100644 index 000000000..67c1f65b6 Binary files /dev/null and b/docs/ims/umn/en-us_image_0030714279.png differ diff --git a/docs/ims/umn/en-us_image_0030714282.png b/docs/ims/umn/en-us_image_0030714282.png new file mode 100644 index 000000000..8b0dfdfa8 Binary files /dev/null and b/docs/ims/umn/en-us_image_0030714282.png differ diff --git a/docs/ims/umn/en-us_image_0030714285.png b/docs/ims/umn/en-us_image_0030714285.png new file mode 100644 index 000000000..97123d4e5 Binary files /dev/null and b/docs/ims/umn/en-us_image_0030714285.png differ diff --git a/docs/ims/umn/en-us_image_0030714288.png b/docs/ims/umn/en-us_image_0030714288.png new file mode 100644 index 000000000..a67640d2e Binary files /dev/null and b/docs/ims/umn/en-us_image_0030714288.png differ diff --git a/docs/ims/umn/en-us_image_0085074510.png b/docs/ims/umn/en-us_image_0085074510.png new file mode 100644 index 000000000..64789aaa5 Binary files /dev/null and b/docs/ims/umn/en-us_image_0085074510.png differ diff --git a/docs/ims/umn/en-us_image_0087083593.png b/docs/ims/umn/en-us_image_0087083593.png new file mode 100644 index 000000000..409a3dd44 Binary files /dev/null and b/docs/ims/umn/en-us_image_0087083593.png differ diff --git a/docs/ims/umn/en-us_image_0089766015.png b/docs/ims/umn/en-us_image_0089766015.png new file mode 100644 index 000000000..c4bf203d9 Binary files /dev/null and b/docs/ims/umn/en-us_image_0089766015.png differ diff --git a/docs/ims/umn/en-us_image_0099872706.png b/docs/ims/umn/en-us_image_0099872706.png new file mode 100644 index 000000000..84d438e80 Binary files /dev/null and b/docs/ims/umn/en-us_image_0099872706.png differ diff --git a/docs/ims/umn/en-us_image_0099872707.png b/docs/ims/umn/en-us_image_0099872707.png new file mode 100644 index 000000000..84d438e80 Binary files /dev/null and b/docs/ims/umn/en-us_image_0099872707.png differ diff --git a/docs/ims/umn/en-us_image_0099872708.png b/docs/ims/umn/en-us_image_0099872708.png new file mode 100644 index 000000000..04716d1bb Binary files /dev/null and b/docs/ims/umn/en-us_image_0099872708.png differ diff --git a/docs/ims/umn/en-us_image_0115573259.png b/docs/ims/umn/en-us_image_0115573259.png new file mode 100644 index 000000000..49c271dd8 Binary files /dev/null and b/docs/ims/umn/en-us_image_0115573259.png differ diff --git a/docs/ims/umn/en-us_image_0118549088.png b/docs/ims/umn/en-us_image_0118549088.png new file mode 100644 index 000000000..1e9d829cf Binary files /dev/null and b/docs/ims/umn/en-us_image_0118549088.png differ diff --git a/docs/ims/umn/en-us_image_0120595879.png b/docs/ims/umn/en-us_image_0120595879.png new file mode 100644 index 000000000..d1f94c13c Binary files /dev/null and b/docs/ims/umn/en-us_image_0120595879.png differ diff --git a/docs/ims/umn/en-us_image_0120595887.png b/docs/ims/umn/en-us_image_0120595887.png new file mode 100644 index 000000000..d1f94c13c Binary files /dev/null and b/docs/ims/umn/en-us_image_0120595887.png differ diff --git a/docs/ims/umn/en-us_image_0120595964.png b/docs/ims/umn/en-us_image_0120595964.png new file mode 100644 index 000000000..96d747aab Binary files /dev/null and b/docs/ims/umn/en-us_image_0120595964.png differ diff --git a/docs/ims/umn/en-us_image_0122875972.png b/docs/ims/umn/en-us_image_0122875972.png new file mode 100644 index 000000000..c815e9fc4 Binary files /dev/null and b/docs/ims/umn/en-us_image_0122875972.png differ diff --git a/docs/ims/umn/en-us_image_0122875976.png b/docs/ims/umn/en-us_image_0122875976.png new file mode 100644 index 000000000..5fd277afd Binary files /dev/null and b/docs/ims/umn/en-us_image_0122875976.png differ diff --git a/docs/ims/umn/en-us_image_0125146639.png b/docs/ims/umn/en-us_image_0125146639.png new file mode 100644 index 000000000..925e763e5 Binary files /dev/null and b/docs/ims/umn/en-us_image_0125146639.png differ diff --git a/docs/ims/umn/en-us_image_0125154453.png b/docs/ims/umn/en-us_image_0125154453.png new file mode 100644 index 000000000..274b95971 Binary files /dev/null and b/docs/ims/umn/en-us_image_0125154453.png differ diff --git a/docs/ims/umn/en-us_image_0125452070.png b/docs/ims/umn/en-us_image_0125452070.png new file mode 100644 index 000000000..9050cc49b Binary files /dev/null and b/docs/ims/umn/en-us_image_0125452070.png differ diff --git a/docs/ims/umn/en-us_image_0125511073.png b/docs/ims/umn/en-us_image_0125511073.png new file mode 100644 index 000000000..de1962339 Binary files /dev/null and b/docs/ims/umn/en-us_image_0125511073.png differ diff --git a/docs/ims/umn/en-us_image_0125515202.png b/docs/ims/umn/en-us_image_0125515202.png new file mode 100644 index 000000000..48072e341 Binary files /dev/null and b/docs/ims/umn/en-us_image_0125515202.png differ diff --git a/docs/ims/umn/en-us_image_0127506675.png b/docs/ims/umn/en-us_image_0127506675.png new file mode 100644 index 000000000..7b0eacb21 Binary files /dev/null and b/docs/ims/umn/en-us_image_0127506675.png differ diff --git a/docs/ims/umn/en-us_image_0141888758.png b/docs/ims/umn/en-us_image_0141888758.png new file mode 100644 index 000000000..ee46a4ca5 Binary files /dev/null and b/docs/ims/umn/en-us_image_0141888758.png differ diff --git a/docs/ims/umn/en-us_image_0142360062.png b/docs/ims/umn/en-us_image_0142360062.png new file mode 100644 index 000000000..f5a39cdd6 Binary files /dev/null and b/docs/ims/umn/en-us_image_0142360062.png differ diff --git a/docs/ims/umn/en-us_image_0144424631.png b/docs/ims/umn/en-us_image_0144424631.png new file mode 100644 index 000000000..f5a39cdd6 Binary files /dev/null and b/docs/ims/umn/en-us_image_0144424631.png differ diff --git a/docs/ims/umn/en-us_image_0152727234.png b/docs/ims/umn/en-us_image_0152727234.png new file mode 100644 index 000000000..35e283157 Binary files /dev/null and b/docs/ims/umn/en-us_image_0152727234.png differ diff --git a/docs/ims/umn/en-us_image_0180986761.png b/docs/ims/umn/en-us_image_0180986761.png new file mode 100644 index 000000000..d41a5694a Binary files /dev/null and b/docs/ims/umn/en-us_image_0180986761.png differ diff --git a/docs/ims/umn/en-us_image_0180992674.png b/docs/ims/umn/en-us_image_0180992674.png new file mode 100644 index 000000000..d48cc79b4 Binary files /dev/null and b/docs/ims/umn/en-us_image_0180992674.png differ diff --git a/docs/ims/umn/en-us_image_0184026531.png b/docs/ims/umn/en-us_image_0184026531.png new file mode 100644 index 000000000..1303a51c2 Binary files /dev/null and b/docs/ims/umn/en-us_image_0184026531.png differ diff --git a/docs/ims/umn/en-us_image_0187517327.png b/docs/ims/umn/en-us_image_0187517327.png new file mode 100644 index 000000000..484e614b7 Binary files /dev/null and b/docs/ims/umn/en-us_image_0187517327.png differ diff --git a/docs/ims/umn/en-us_image_0196045691.png b/docs/ims/umn/en-us_image_0196045691.png new file mode 100644 index 000000000..8a64c3072 Binary files /dev/null and b/docs/ims/umn/en-us_image_0196045691.png differ diff --git a/docs/ims/umn/en-us_image_0196045692.png b/docs/ims/umn/en-us_image_0196045692.png new file mode 100644 index 000000000..cced0a1ea Binary files /dev/null and b/docs/ims/umn/en-us_image_0196045692.png differ diff --git a/docs/ims/umn/en-us_image_0203204308.png b/docs/ims/umn/en-us_image_0203204308.png new file mode 100644 index 000000000..71bf71ddb Binary files /dev/null and b/docs/ims/umn/en-us_image_0203204308.png differ diff --git a/docs/ims/umn/en-us_image_0203204309.png b/docs/ims/umn/en-us_image_0203204309.png new file mode 100644 index 000000000..951ae4b4d Binary files /dev/null and b/docs/ims/umn/en-us_image_0203204309.png differ diff --git a/docs/ims/umn/en-us_image_0203254718.png b/docs/ims/umn/en-us_image_0203254718.png new file mode 100644 index 000000000..3ad15a7d4 Binary files /dev/null and b/docs/ims/umn/en-us_image_0203254718.png differ diff --git a/docs/ims/umn/en-us_image_0207581512.png b/docs/ims/umn/en-us_image_0207581512.png new file mode 100644 index 000000000..526264df6 Binary files /dev/null and b/docs/ims/umn/en-us_image_0207581512.png differ diff --git a/docs/ims/umn/en-us_image_0207619456.png b/docs/ims/umn/en-us_image_0207619456.png new file mode 100644 index 000000000..f2629e80b Binary files /dev/null and b/docs/ims/umn/en-us_image_0207619456.png differ diff --git a/docs/ims/umn/en-us_image_0207619609.jpg b/docs/ims/umn/en-us_image_0207619609.jpg new file mode 100644 index 000000000..7cb9e6f72 Binary files /dev/null and b/docs/ims/umn/en-us_image_0207619609.jpg differ diff --git a/docs/ims/umn/en-us_image_0208136139.png b/docs/ims/umn/en-us_image_0208136139.png new file mode 100644 index 000000000..d9b94ee59 Binary files /dev/null and b/docs/ims/umn/en-us_image_0208136139.png differ diff --git a/docs/ims/umn/en-us_image_0208136140.png b/docs/ims/umn/en-us_image_0208136140.png new file mode 100644 index 000000000..92a464842 Binary files /dev/null and b/docs/ims/umn/en-us_image_0208136140.png differ diff --git a/docs/ims/umn/en-us_image_0208136141.png b/docs/ims/umn/en-us_image_0208136141.png new file mode 100644 index 000000000..f74901175 Binary files /dev/null and b/docs/ims/umn/en-us_image_0208136141.png differ diff --git a/docs/ims/umn/en-us_image_0208252825.png b/docs/ims/umn/en-us_image_0208252825.png new file mode 100644 index 000000000..895cf31e2 Binary files /dev/null and b/docs/ims/umn/en-us_image_0208252825.png differ diff --git a/docs/ims/umn/en-us_image_0208476701.png b/docs/ims/umn/en-us_image_0208476701.png new file mode 100644 index 000000000..e45912c0e Binary files /dev/null and b/docs/ims/umn/en-us_image_0208476701.png differ diff --git a/docs/ims/umn/en-us_image_0208552567.jpg b/docs/ims/umn/en-us_image_0208552567.jpg new file mode 100644 index 000000000..dcf70d7e2 Binary files /dev/null and b/docs/ims/umn/en-us_image_0208552567.jpg differ diff --git a/docs/ims/umn/en-us_image_0210189238.png b/docs/ims/umn/en-us_image_0210189238.png new file mode 100644 index 000000000..c2ca06d9a Binary files /dev/null and b/docs/ims/umn/en-us_image_0210189238.png differ diff --git a/docs/ims/umn/en-us_image_0210206922.png b/docs/ims/umn/en-us_image_0210206922.png new file mode 100644 index 000000000..9822f6e59 Binary files /dev/null and b/docs/ims/umn/en-us_image_0210206922.png differ diff --git a/docs/ims/umn/en-us_image_0210228327.png b/docs/ims/umn/en-us_image_0210228327.png new file mode 100644 index 000000000..c92bf1a9c Binary files /dev/null and b/docs/ims/umn/en-us_image_0210228327.png differ diff --git a/docs/ims/umn/en-us_image_0214265355.png b/docs/ims/umn/en-us_image_0214265355.png new file mode 100644 index 000000000..895cf31e2 Binary files /dev/null and b/docs/ims/umn/en-us_image_0214265355.png differ diff --git a/docs/ims/umn/en-us_image_0219481382.png b/docs/ims/umn/en-us_image_0219481382.png new file mode 100644 index 000000000..0f7dfd5ca Binary files /dev/null and b/docs/ims/umn/en-us_image_0219481382.png differ diff --git a/docs/ims/umn/en-us_image_0251959651.png b/docs/ims/umn/en-us_image_0251959651.png new file mode 100644 index 000000000..2e3cc3ca6 Binary files /dev/null and b/docs/ims/umn/en-us_image_0251959651.png differ diff --git a/docs/ims/umn/en-us_image_0254928267.png b/docs/ims/umn/en-us_image_0254928267.png new file mode 100644 index 000000000..65904d8d4 Binary files /dev/null and b/docs/ims/umn/en-us_image_0254928267.png differ diff --git a/docs/ims/umn/en-us_image_0254963039.png b/docs/ims/umn/en-us_image_0254963039.png new file mode 100644 index 000000000..4a17b5f55 Binary files /dev/null and b/docs/ims/umn/en-us_image_0254963039.png differ diff --git a/docs/ims/umn/en-us_image_0254985106.png b/docs/ims/umn/en-us_image_0254985106.png new file mode 100644 index 000000000..c27055e4c Binary files /dev/null and b/docs/ims/umn/en-us_image_0254985106.png differ diff --git a/docs/ims/umn/en-us_image_0255035033.png b/docs/ims/umn/en-us_image_0255035033.png new file mode 100644 index 000000000..a56ce0946 Binary files /dev/null and b/docs/ims/umn/en-us_image_0255035033.png differ diff --git a/docs/ims/umn/en-us_image_0255101497.png b/docs/ims/umn/en-us_image_0255101497.png new file mode 100644 index 000000000..9e9c2e9a6 Binary files /dev/null and b/docs/ims/umn/en-us_image_0255101497.png differ diff --git a/docs/ims/umn/en-us_image_0275513364.png b/docs/ims/umn/en-us_image_0275513364.png new file mode 100644 index 000000000..1909444d2 Binary files /dev/null and b/docs/ims/umn/en-us_image_0275513364.png differ diff --git a/docs/ims/umn/en-us_image_0285376505.png b/docs/ims/umn/en-us_image_0285376505.png new file mode 100644 index 000000000..12e570b77 Binary files /dev/null and b/docs/ims/umn/en-us_image_0285376505.png differ diff --git a/docs/ims/umn/en-us_topic_0000001120952155.html b/docs/ims/umn/en-us_topic_0000001120952155.html new file mode 100644 index 000000000..ac2855280 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0000001120952155.html @@ -0,0 +1,199 @@ + + +

Installing Native KVM Drivers

+

Scenarios

When optimizing a Linux private image, you need to install native KVM drivers on the ECS.

+

If you do not install KVM drivers, NICs of the ECS may not be detected and the ECS cannot communicate with other resources.

+
+
+

This section describes how to install native KVM drivers.

+

Prerequisites

+
+

Procedure

Modify the configuration file based on the OS version.

+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
Table 1 Modifying configuration files for different OSs

OS

+

Configuration

+

Reference

+

CentOS/EulerOS

+

Take CentOS 7.0 as an example.

+
  1. In the /etc/dracut.conf file, add VirtIO drivers to add_drivers, including virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces.
  2. Save and exit the /etc/dracut.conf file and run the dracut -f command to generate initrd again.
+

CentOS, EulerOS

+

Ubuntu/Debian

+
  1. In the /etc/initramfs-tools/modules file, add VirtIO drivers, including virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces.
  2. Save and exit the /etc/initramfs-tools/modules file and run the update-initramfs -u command to generate initrd again.
+

Ubuntu and Debian

+

SUSE and openSUSE

+

If the OS version is earlier than SUSE 12 SP1 or openSUSE 13:

+
  1. In the /etc/sysconfig/kernel file, add VirtIO drivers to INITRD_MODULES="". VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces.
  2. Run the mkinitrd command to generate initrd again.
+

SUSE and openSUSE (Earlier than SUSE 12 SP1 or openSUSE 13)

+

If the OS version is SUSE 12 SP1:

+
  1. In the /etc/dracut.conf file, add VirtIO drivers to add_drivers. VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces.
  2. Run the dracut -f command to generate initrd again.
+

SUSE and openSUSE (SUSE 12 SP1)

+

If the OS version is later than SUSE 12 SP1 or openSUSE 13:

+
  1. In the /etc/dracut.conf file, add VirtIO drivers to add_drivers. VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces.
  2. Save and exit the /etc/dracut.conf file and run the dracut -f command to generate initrd again.
+

SUSE and openSUSE (Later than SUSE 12 SP1 or openSUSE 13)

+
+
+
+

CentOS, EulerOS

  1. Run the following command to open the /etc/dracut.conf file:

    vi /etc/dracut.conf

    +
  2. Press i to enter the editing mode and add VirtIO drivers to add_drivers (the format depends on the OS requirements).
    [root@CTU10000xxxxx ~]# vi /etc/dracut.conf 
+# additional kernel modules to the default 
+add_drivers+="virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio" 
+....
    +
  3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/dracut.conf file.
  4. Run the following command to regenerate initrd:

    dracut -f /boot/initramfs-2.6.32-573.8.1.el6.x86_64.img

    +

    If the virtual file system is not the default initramfs, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the grub.cfg file, which can be /boot/grub/grub.cfg, /boot/grub2/grub.cfg, or /boot/grub/grub.conf depending on the OS.

    +
  5. If the virtual file system is initramfs, run the following command to check whether native KVM drivers have been loaded:

    lsinitrd /boot/initramfs-`uname -r`.img | grep virtio

    +

    If the virtual file system is initrd, run the following command to check whether native KVM drivers have been loaded:

    +

    lsinitrd /boot/initrd-`uname -r` | grep virtio

    +

    Assume that the virtual file system is initramfs. The following command output will be displayed:

    +
    [root@CTU10000xxxxx home]# lsinitrd /boot/initramfs-`uname -r`.img | grep virtio 
+-rwxr--r--   1 root     root        23448 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/block/virtio_blk.ko 
+-rwxr--r--   1 root     root        50704 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/net/virtio_net.ko 
+-rwxr--r--   1 root     root        28424 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/scsi/virtio_scsi.ko 
+drwxr-xr-x   2 root     root            0 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio 
+-rwxr--r--   1 root     root        14544 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio/virtio.ko 
+-rwxr--r--   1 root     root        21040 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio/virtio_pci.ko 
+-rwxr--r--   1 root     root        18016 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio/virtio_ring.ko
    +

    If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following command to check whether the drivers are built-in ones in the kernel:

    +

    cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y

    +
    +
+
+

Ubuntu and Debian

  1. Run the following command to open the modules file:

    vi /etc/initramfs-tools/modules

    +
  2. Press i to enter the editing mode and add VirtIO drivers to the /etc/initramfs-tools/modules file (the format depends on the OS requirements).
    [root@CTU10000xxxxx ~]#vi /etc/initramfs-tools/modules 
+...
+# Examples: 
+# 
+# raid1 
+# sd_mOd 
+virtio_blk
+virtio_scsi
+virtio_net
+virtio_pci
+virtio_ring
+virtio
    +
  3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/initramfs-tools/modules file.
  4. Run the following command to regenerate initrd:

    update-initramfs -u

    +
  5. Run the following command to check whether native KVM drivers have been installed:

    lsinitramfs /boot/initrd.img-`uname -r` |grep virtio

    +
    [root@ CTU10000xxxxx home]# lsinitramfs /boot/initrd.img-`uname -r` |grep virtio 
+lib/modules/3.5.0-23-generic/kernel/drivers/scsi/virtio_scsi.ko
    +

    If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following command to check whether the drivers are built-in ones in the kernel:

    +
    [root@ CTU10000xxxxx home]# cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y
+CONFIG_VIRTIO_BLK=y
+CONFIG_VIRTIO_NET=y
+CONFIG_VIRTIO=y
+CONFIG_VIRTIO_RING=y
+CONFIG_VIRTIO_PCI=y
+CONFIG_VIRTIO_MMIO_CMDLINE_DEVICES=y
    +
    +
+
+

SUSE and openSUSE (Earlier than SUSE 12 SP1 or openSUSE 13)

Modify the /etc/sysconfig/kernel file.
  1. Run the following command to modify the /etc/sysconfig/kernel file:

    vi etc/sysconfig/kernel

    +
  2. Add VirtIO drivers to INITRD_MODULES="" (the format of drivers depends on the OS).
    SIA10000xxxxx:~ # vi /etc/sysconfig/kernel 
+# (like drivers for scsi-controllers, for lvm or reiserfs)
+#
+INITRD_MODULES="ata_piix ata_generic virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio"
    +
  3. Run the mkinitrd command to generate initrd again.

    If the virtual file system is not the default initramfs or initrd, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the menu.lst or grub.cfg file (/boot/grub/menu.lst, /boot/grub/grub.cfg, or /boot/grub2/grub.cfg).

    +
    +

    The following is an example initrd file of SUSE 11 SP4:

    +
    default 0 
+timeout 10 
+gfxmenu (hd0,0)/boot/message 
+title sles11sp4_001_[_VMX_] 
+root (hd0,0) 
+kernel /boot/linux.vmx vga=0x314 splash=silent console=ttyS0,115200n8 console=tty0 net.ifnames=0 NON_PERSISTENT_DEVICE_NAMES=1 showopts 
+initrd /boot/initrd.vmx 
+title Failsafe_sles11sp4_001_[_VMX_] 
+root (hd0,0) 
+kernel /boot/linux.vmx vga=0x314 splash=silent ide=nodma apm=off noresume edd=off powersaved=off nohz=off highres=off processsor.max+cstate=1 nomodeset x11failsafe console=ttyS0,115200n8 console=tty0 net.ifnames=0 NON_PERSISTENT_DEVICE_NAMES=1 showopts 
+initrd /boot/initrd.vmx
    +

    /boot/initrd.vmx in the initrd line is the initrd file actually used. Run the dracut -f /boot/initrd.vmx command. If the initrd file does not contain the /boot directory, such as /initramfs-xxx, run the dracut -f /boot/initramfs-xxx command.

    +
  4. Run the following command to check whether the VirtIO module for KVM is loaded:
    lsinitrd /boot/initrd-`uname -r` | grep virtio
    SIA10000xxxxx:~ # lsinitrd /boot/initrd-`uname -r` | grep virtio
+-rwxr--r-- 1 root root 19248 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/scsi/virtio_scsi.ko
+-rwxr--r-- 1 root root 23856 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/block/virtio_blk.ko
+drwxr-xr-x 2 root root 0 Jul 12 14:53 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio
+-rwxr--r-- 1 root root 15848 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_ring.ko
+-rwxr--r-- 1 root root 20008 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_pci.ko
+-rwxr--r-- 1 root root 12272 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio.ko
+-rwxr--r-- 1 root root 38208 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/net/virtio_net.ko
    +
    +
  5. Restart the ECS.
  6. Run the following command to check whether KVM drivers exist in initrd:

    lsinitrd /boot/initrd-`uname -r` | grep virtio

    +
    SIA10000xxxxx:~ # lsinitrd /boot/initrd-`uname -r` | grep virtio
+-rwxr--r-- 1 root root 19248 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/scsi/virtio_scsi.ko
+-rwxr--r-- 1 root root 23856 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/block/virtio_blk.ko
+drwxr-xr-x 2 root root 0 Jul 12 14:53 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio
+-rwxr--r-- 1 root root 15848 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_ring.ko
+-rwxr--r-- 1 root root 20008 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_pci.ko
+-rwxr--r-- 1 root root 12272 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio.ko
+-rwxr--r-- 1 root root 38208 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/net/virtio_net.ko
    +

    If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following command to check whether the drivers are built-in ones in the kernel:

    +

    cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y

    +
    +
+
+
+

SUSE and openSUSE (SUSE 12 SP1)

Modify the /etc/dracut.conf file.
  1. Run the following command to open the /etc/dracut.conf file:

    vi /etc/dracut.conf

    +
  2. Press i to enter the editing mode and add VirtIO drivers to add-drivers (the format depends on the OS requirements).
    [root@CTU10000xxxxx ~]# vi /etc/dracut.conf 
+# additional kernel modules to the default
+add_drivers+="ata_piix ata_generic virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio"
    +
  3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/dracut.conf file.
  4. Run the following command to regenerate initrd:

    dracut -f /boot/initramfs-File name

    +

    If the virtual file system is not the default initramfs, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the grub.cfg file, which can be /boot/grub/grub.cfg, /boot/grub2/grub.cfg, or /boot/grub/grub.conf depending on the OS.

    +
  5. If the virtual file system is initramfs, run the following command to check whether native KVM drivers have been loaded:

    lsinitrd /boot/initramfs-`uname -r`.img | grep virtio

    +

    If the virtual file system is initrd, run the following command to check whether native KVM drivers have been loaded:

    +

    lsinitrd /boot/initrd-`uname -r` | grep virtio

    +
+
+
+

SUSE and openSUSE (Later than SUSE 12 SP1 or openSUSE 13)

Modify the /etc/dracut.conf file.

+
Take SUSE Linux Enterprise Server 12 SP2 (x86_64) as an example.
  1. Run the following command to open the /etc/dracut.conf file:

    vi /etc/dracut.conf

    +
  2. Press i to enter the editing mode and add VirtIO drivers to add_drivers (the format depends on the OS requirements).
    [root@CTU10000xxxxx ~]# vi /etc/dracut.conf 
+# additional kernel modules to the default
+add_drivers+="ata_piix ata_generic virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio"
    +
  3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/dracut.conf file.
  4. Run the following command to regenerate initrd:

    dracut -f /boot/initramfs-File name

    +

    If the virtual file system is not the default initramfs, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the grub.cfg file, which can be /boot/grub/grub.cfg, /boot/grub2/grub.cfg, or /boot/grub/grub.conf depending on the OS.

    +
  5. If the virtual file system is initramfs, run the following command to check whether native KVM drivers have been loaded:

    lsinitrd /boot/initramfs-`uname -r`.img | grep virtio

    +

    If the virtual file system is initrd, run the following command to check whether native KVM drivers have been loaded:

    +

    lsinitrd /boot/initrd-`uname -r` | grep virtio

    +

    Assume that the virtual file system is initrd. The following command output will be displayed:

    +
    sluo-ecs-30dc:~ # lsinitrd /boot/initrd-`uname -r` | grep virtio
+-rw-r--r-- 1 root root 29335 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/block/virtio_blk.ko
+-rw-r--r-- 1 root root 57007 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/net/virtio_net.ko
+-rw-r--r-- 1 root root 32415 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/scsi/virtio_scsi.ko
+drwxr-xr-x 2 root root 0 Sep 28 10:21 lib/modules/4.4.21-69-default/kernel/drivers/virtio
+-rw-r--r-- 1 root root 19623 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/virtio/virtio.ko
+-rw-r--r-- 1 root root 38943 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/virtio/virtio_pci.ko
+-rw-r--r-- 1 root root 24431 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/virtio/virtio_ring.ko
    +

    If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following command to check whether the drivers are built-in ones in the kernel:

    +

    cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y

    +
    +
+
+
+
+
+
+
Parent topic: Optimizing a Linux Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0000001175697174.html b/docs/ims/umn/en-us_topic_0000001175697174.html new file mode 100644 index 000000000..38b1b5f6d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0000001175697174.html @@ -0,0 +1,38 @@ + + +

Importing an Image

+

IMS provides multiple methods for importing images. You can select a method based on the image file type, format, or size.

+ +
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0013901608.html b/docs/ims/umn/en-us_topic_0013901608.html new file mode 100644 index 000000000..5fc69c10a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0013901608.html @@ -0,0 +1,41 @@ + + +

Managing Private Images

+
+
+ +
+ diff --git a/docs/ims/umn/en-us_topic_0013901609.html b/docs/ims/umn/en-us_topic_0013901609.html new file mode 100644 index 000000000..b946a30f9 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0013901609.html @@ -0,0 +1,50 @@ + + +

What Is Image Management Service?

+

Overview

An image is a server or disk template that contains an operating system (OS) or service data and necessary software, such as database software. IMS provides public, private, and shared images.

+

Image Management Service (IMS) allows you to manage the entire lifecycle of your images. You can create ECSs or BMSs from public, private, or shared images. You can also create a private image from a cloud server or an external image file to make it easier to migrate workloads to the cloud or on the cloud.

+
+

Image Types

Images are classified as public, private, and shared. Public images are provided by the cloud platform, private images are those you created yourself, and shared images are private images that other tenants have shared with you.

+ +
+ + + + + + + + + + + + + +

Image Type

+

Description

+

Public image

+

A public image is a standard, widely used image. It contains an OS and preinstalled public applications and is available to all users. Public images are very stable and their OS and any included software have been officially authorized for use. If a public image does not contain the application environments or software you need, you can use a public image to create an ECS and then deploy required software as needed.

+

Private image

+

A private image contains an OS or service data, preinstalled public applications, and a user's personal applications. Private images are only available to the users who created them.

+

A private image can be a system disk image, data disk image, or full-ECS image.

+
  • A system disk image contains an OS and pre-installed software for various services. You can use a system disk image to create ECSs and migrate your services to the cloud.
  • A data disk image contains only service data. You can use a data disk image to create EVS disks and use them to migrate your service data to the cloud.
  • A full-ECS image contains an OS, pre-installed software, and service data. A full-ECS image is created using differential backups and the creation takes less time than creating a system or data disk image of the same size.
+

Shared image

+

A shared image is a private image another user has shared with you.

+
+
+
+

IMS Functions

IMS provides:

+ +
+

Access Methods

The public cloud provides a web-based service management platform (a management console). You can access the IMS service through HTTPS APIs or from the management console.

+ +
+
+
+
+
Parent topic: Overview
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0013901623.html b/docs/ims/umn/en-us_topic_0013901623.html new file mode 100644 index 000000000..f54735caa --- /dev/null +++ b/docs/ims/umn/en-us_topic_0013901623.html @@ -0,0 +1,17 @@ + + +

Overview

+
+
+ +
+ diff --git a/docs/ims/umn/en-us_topic_0013901628.html b/docs/ims/umn/en-us_topic_0013901628.html new file mode 100644 index 000000000..c41f85e9b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0013901628.html @@ -0,0 +1,14 @@ + + +

Introduction

+

A private image is an image available only to the user who created it. It contains an OS, preinstalled public applications, and a user's personal applications. A private image can be a system disk image, data disk image, or full-ECS image. It can be created from a cloud server or an external image file.

+

Creating a private image does not affect the running of services on the cloud server or cause data loss.

+
This section describes how to create a private image using any of the following methods: +
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713142.html b/docs/ims/umn/en-us_topic_0030713142.html new file mode 100644 index 000000000..a92dd03b2 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713142.html @@ -0,0 +1,542 @@ + + +

OSs Supported by Different Types of ECSs

+

This section describes the OSs supported by different types of ECSs.

+

x86 ECSs

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 Supported OS versions-01

OS

+

OS Version

+

Windows

+

Windows Server 2008 R2 Standard/Enterprise/Datacenter/Web

+

Windows Server 2012 Standard/Datacenter

+

Windows Server 2012 R2 Standard/Datacenter

+

Windows Server 2016 Standard/Datacenter

+

Windows Server 2019 Standard/Datacenter

+

Windows Server Core Version 1709

+

CentOS

+

64-bit: CentOS 6.10, 6.9, 6.8, 6.7, 6.6, 6.5, 6.4, and 6.3

+

64-bit: CentOS 7.9, 7.8, 7.7, 7.6, 7.5, 7.4, 7.3, 7.2, 7.1, and 7.0

+

64-bit: CentOS 8.3, 8.2, 8.1, and 8.0

+

Ubuntu

+

64-bit: Ubuntu 20.04, 18.04, 16.04, 14.04, and 12.04 Server

+

EulerOS

+

64-bit: EulerOS 2.9, 2.5, 2.3, and 2.2

+

Red Hat

+

64-bit: Red Hat 6.10, 6.9, 6.8, 6.7, 6.6, 6.5, and 6.4

+

64-bit: Red Hat 7.6, 7.5, 7.4, 7.3, 7.2, 7.1, and 7.0

+

64-bit: Red Hat 8.0

+

SUSE Linux Enterprise

+

64-bit: SLES 11 SP4 and 11 SP3

+

64-bit: SLES 12 SP4, 12 SP3, 12 SP2, 12 SP1, and 12

+

64-bit: SLES 15, 15 SP1, and 15 SP2

+

Debian

+

64-bit: Debian 8.0.0–8.10.0

+

64-bit: Debian 9.13.0, 9.12.0, 9.11.0, 9.9.0, 9.8.0, 9.7.0, 9.6.0, 9.5.0, 9.4.0, 9.3.0, and 9.0.0

+

64-bit: Debian 10.0.0–10.5.0, 10.7.0

+

openSUSE

+

64-bit: openSUSE 13.2

+

64-bit: openSUSE Leap 15.1 and 15.0

+

64-bit: openSUSE Leap 42.3, 42.2, and 42.1

+

Fedora

+

64-bit: Fedora 22–32

+

CoreOS

+

64-bit: CoreOS 2079.4.0

+

FreeBSD

+

64bit: FreeBSD 11.0,10.3, and 12.1

+

openEuler

+

64-bit: openEuler 20.03

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 2 Supported OS versions-02

OS

+

OS Version

+

Kernel Version

+

Windows

+

Windows Server 2008 R2 Enterprise/Datacenter/Web/Standard

+

Windows Server 2012 R2 Standard/Datacenter

+

Windows Server 2016 Standard/Datacenter

+

Windows Server 2019 Datacenter

+

Windows Server Version 1709 Datacenter

+

10.0.14393

+

6.1.7600

+

6.0.6002

+

6.1.7600

+

6.3.9600

+

CentOS

+

64-bit:

+

CentOS 6

+

CentOS 7

+

CentOS 8

+

2.6.32-754.10.1.e16.x86_64

+

2.6.32-696.16.1.el6.x86_64

+

2.6.32-754.10.1.el6.x86_64

+

2.6.32-754.11.1.e16.x86_64

+

3.10.0-514.10.2.el7.x86_64

+

3.10.0-693.11.1.el7.x86_64

+

3.10.0-862.9.1.el7.x86_64

+

3.10.0-957.5.1.e17.x86_64

+

3.10.0-957.10.1.e17.x86_64

+

Ubuntu

+

64-bit:

+

Ubuntu 14.04 Server

+

Ubuntu 16.04 Server

+

Ubuntu 18.04 Server

+

Ubuntu 20.04 Server

+

4.15.0-52-56

+

4.4.0-151-178

+

4.4.0-104-generic

+

4.4.0-141-generic

+

4.4.0-142-generic

+

4.4.0-145-generic

+

4.15.0-34-generic

+

4.15.0-45-generic

+

4.15.0-47-generic

+

EulerOS

+

64-bit:

+

EulerOS 2.2

+

EulerOS 2.3

+

EulerOS 2.5

+

3.10.0-327.62.59.83.h162.x86_64

+

3.10.0-514.44.5.10.h198.x86_64

+

3.10.0-327.59.59.46.h38.x86_64

+

3.10.0-327.62.59.83.h96.x86_64

+

3.10.0-327.62.59.83.h128.x86_64

+

3.10.0-514.44.5.10.h121.x86_64

+

3.10.0-514.44.5.10.h142.x86_64

+

Red Hat

+

64-bit:

+

Red Hat 6

+

Red Hat 7

+

2.6.32-358.6.2.el6.x86_64

+

2.6.32-431.20.3.el6

+

2.6.32-504.12.2.el6

+

2.6.32-573.el6.x86_64

+

2.6.32-696.1.1.el6.x86_64

+

2.6.32-696.10.2.el6.x86_64

+

2.6.32-754.el6.x86_64

+

3.10.0-229.1.2.el7.x86_64

+

3.10.0-327.36.1.el7.x86_64

+

3.10.0-514.36.1.el7

+

3.10.0-514.6.1.el7.x86_64

+

3.10.0-693.11.6.el7.x86_64

+

3.10.0-862.3.2.el7.x86_64

+

SUSE Linux Enterprise

+

64-bit:

+

SLES 11

+

SLES 12

+

3.0.101-108.18-default

+

3.12.74-60.64.40-default

+

4.4.103-92.53-default

+

4.4.120-92.70-default

+

4.4.121-92.92

+

Debian

+

64-bit:

+

Debian 8

+

Debian 9

+

4.9.168-1+deb9u3

+

3.2.0-4-686-pae

+

3.2.0-4-amd64

+

3.16.0-4-amd64

+

4.9.0-3-amd64

+

4.9.0-4-amd64

+

4.9.0-8-amd64

+

4.9.0-9-amd64

+

4.19.0-5-amd64

+

openSUSE

+

64-bit:

+

openSUSE 15.0

+

openSUSE 15.1

+

4.4.103-18.41-default

+

3.0.101-108.18-default

+

Fedora

+

64-bit:

+

Fedora 2x

+

5.1.11-200.fc29.x86_64

+

4.5.5-300.fc24.x86_64

+

4.20.8-200.fc29.x86_64

+

5.2.8-200.fc30.x86_64

+

4.8.6-300.fc25.x86_64

+

openEuler

+

64-bit:

+

openEuler 20.03

+

4.19.90-2003.4.0.0036.oel.x86_64

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 3 Supported OS versions-03

OS

+

OS Version

+

Kernel Version

+

CentOS

+

64-bit:

+

CentOS 6

+

CentOS 7

+

CentOS 8

+

2.6.32-754.15.3.e16.x86_64

+

2.6.32-696.16.1.el6.x86_64

+

2.6.32-754.10.1.el6.x86_64

+

2.6.32-754.11.1.e16.x86_64

+

3.10.0-514.10.2.el7.x86_64

+

3.10.0-693.11.1.el7.x86_64

+

3.10.0-862.9.1.el7.x86_64

+

3.10.0-957.21.3.e17.x86_64

+

3.10.0-957.5.1.e17.x86_64

+

3.10.0-957.10.1.e17.x86_64

+

Ubuntu

+

64-bit:

+

Ubuntu 14.04 Server

+

Ubuntu 16.04 Server

+

Ubuntu 18.04 Server

+

Ubuntu 20.04 Server

+

4.15.0-52-56

+

4.4.0-151-178

+

4.4.0-104-generic

+

4.4.0-141-generic

+

4.4.0-142-generic

+

4.4.0-145-generic

+

4.15.0-34-generic

+

4.15.0-45-generic

+

4.15.0-47-generic

+

EulerOS

+

64-bit:

+

EulerOS 2.2

+

EulerOS 2.3

+

EulerOS 2.5

+

EulerOS 2.9

+

3.10.0-327.62.59.83.h162.x86_64

+

3.10.0-514.44.5.10.h198.x86_64

+

3.10.0-327.59.59.46.h38.x86_64

+

3.10.0-327.62.59.83.h96.x86_64

+

3.10.0-327.62.59.83.h128.x86_64

+

3.10.0-514.44.5.10.h121.x86_64

+

3.10.0-514.44.5.10.h142.x86_64

+

Red Hat

+

64-bit:

+

Red Hat 6

+

Red Hat 7

+

2.6.32-358.6.2.el6.x86_64

+

2.6.32-431.20.3.el6

+

2.6.32-504.12.2.el6

+

2.6.32-573.el6.x86_64

+

2.6.32-696.1.1.el6.x86_64

+

2.6.32-696.10.2.el6.x86_64

+

2.6.32-754.el6.x86_64

+

3.10.0-229.1.2.el7.x86_64

+

3.10.0-327.36.1.el7.x86_64

+

3.10.0-514.36.1.el7

+

3.10.0-514.6.1.el7.x86_64

+

3.10.0-693.11.6.el7.x86_64

+

3.10.0-862.3.2.el7.x86_64

+

SUSE Linux Enterprise

+

64-bit:

+

SLES 11

+

SLES 12

+

SLES 15

+

3.0.101-108.18-default

+

3.12.74-60.64.40-default

+

4.4.103-92.53-default

+

4.4.120-92.70-default

+

4.4.121-92.92

+

Debian

+

64-bit:

+

Debian 8

+

Debian 9

+

Debian 10

+

4.9.168-1+deb9u3

+

3.2.0-4-686-pae

+

3.2.0-4-amd64

+

3.16.0-4-amd64

+

4.9.0-3-amd64

+

4.9.0-4-amd64

+

4.9.0-8-amd64

+

4.9.0-9-amd64

+

4.19.0-5-amd64

+

openSUSE

+

64-bit:

+

openSUSE 15.0

+

openSUSE 15.1

+

4.4.103-18.41-default

+

3.0.101-108.18-default

+

Fedora

+

64-bit:

+

Fedora 2x

+

Fedora 3x

+

5.1.11-200.fc29.x86_64

+

4.5.5-300.fc24.x86_64

+

4.20.8-200.fc29.x86_64

+

5.2.8-200.fc30.x86_64

+

4.8.6-300.fc25.x86_64

+

openEuler

+

64-bit:

+

openEuler 20.03

+

4.19.90-2003.4.0.0036.oel.x86_64

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
Table 4 Supported OS versions-04

OS

+

OS Version

+

Kernel Version

+

CentOS

+

64-bit:

+

CentOS 7

+

3.10.0-514.10.2.el7.x86_64

+

3.10.0-693.11.1.el7.x86_64

+

3.10.0-862.9.1.el7.x86_64

+

3.10.0-957.21.3.e17.x86_64

+

3.10.0-957.5.1.e17.x86_64

+

3.10.0-957.10.1.e17.x86_64

+

Ubuntu

+

64-bit:

+

Ubuntu 14.04 Server

+

Ubuntu 16.04 Server

+

Ubuntu 18.04 Server

+

4.4.0-31-generic

+

4.4.0-131-generic

+

4.4.0-141-generic

+

4.4.0-142-generic

+

4.15.0-29-generic

+

4.15.0-45-generic

+

SUSE Linux Enterprise

+

64-bit:

+

SLES 12

+

4.4.103-92.53-default

+

4.4.120-92.70-default

+

Debian

+

64-bit:

+

Debian 8

+

Debian 9

+

3.16.0-7-amd64

+

3.16.0-4-amd64

+

4.9.0-3-amd64

+
+
+
+

Kunpeng ECSs

Table 5 lists the OSs supported by the following ECSs:

+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 5 Supported OS versions-05

OS

+

OS Version

+

CentOS

+

64-bit: CentOS 7.6, 7.5, and 7.4

+

64-bit: CentOS 8.0

+

Ubuntu

+

64-bit: Ubuntu 18.04 Server

+

EulerOS

+

64-bit: EulerOS 2.8

+

Red Hat

+

64-bit: Red Hat 7.6 and 7.5

+

SUSE Linux Enterprise

+

64-bit: SLES 12 SP5 and SP4

+

64-bit: SLES 15

+

openSUSE

+

64-bit: openSUSE Leap 15.0

+

Fedora

+

64-bit: Fedora 29

+

Debian

+

64-bit: Debian 10.2.0

+

openEuler

+

64-bit: openEuler 20.03

+
+
+
+
+
+
+
Parent topic: Supported OSs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713143.html b/docs/ims/umn/en-us_topic_0030713143.html new file mode 100644 index 000000000..37961f3c1 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713143.html @@ -0,0 +1,209 @@ + + +

External Image File Formats and Supported OSs

+

External File Formats

Image files in VMDK, VHD, QCOW2, RAW, VHDX, QED, VDI, QCOW, ZVHD2, or ZVHD format can be used to create private images. Select whichever format best meeting your requirements.

+
+

Supported OSs

When you upload an external image file to an OBS bucket on the management console, the OS contained in the image file will be checked. Table 1 lists the OSs supported for external image files.

+

If the OS cannot be identified or is not supported:

+ + +
  • Uploading image files containing OSs not listed in Table 1 may fail. You are advised to contact the customer service before uploading these image files.
  • For details about the formats and OSs supported for BMS images, see Bare Metal Server Private Image Creation Guide.
  • When uploading a CoreOS image file, set the OS type to CoreOS. Otherwise, the OS type will be set to Other (64bit). In addition, ensure that coreos-cloudinit has been installed and configured for CoreOS. Automatic system upgrades must be disabled. Otherwise, they may make ECSs created using this image unavailable.
  • You can only use external image files containing Windows 10 64bit or Windows 7 Enterprise 64bit to create ECSs on a Dedicated Host (DeH).
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 Supported OSs

OS

+

Version

+

Windows

+

Windows 10 64bit

+

Windows 7 Enterprise 64bit

+

Windows Server 2016 Standard 64bit

+

Windows Server 2016 Datacenter 64bit

+

Windows Server 2012 R2 Standard 64bit

+

Windows Server 2012 Essentials R2 64bit

+

Windows Server 2012 R2 Datacenter 64bit

+

Windows Server 2012 Datacenter 64bit

+

Windows Server 2012 Standard 64bit

+

Windows Server 2008 R2 WEB 64bit

+

Windows Server 2008 R2 Standard 64bit

+

Windows Server 2008 R2 Enterprise 64bit

+

Windows Server 2008 R2 Datacenter 64bit

+

SUSE

+

SUSE Linux Enterprise Server 15 SP1 64bit

+

SUSE Linux Enterprise Server 15 64bit

+

SUSE Linux Enterprise Server 12 SP5 64bit

+

SUSE Linux Enterprise Server 12 SP3 64bit

+

SUSE Linux Enterprise Server 12 SP2 64bit

+

SUSE Linux Enterprise Server 12 SP1 64bit

+

SUSE Linux Enterprise Server 12 64bit

+

SUSE Linux Enterprise Server 11 SP4 64bit

+

SUSE Linux Enterprise Server 11 SP3 64bit

+

SUSE Linux Enterprise Server 11 SP3 32bit

+

SUSE Linux Enterprise Server 11 SP1 32bit

+

Oracle Linux

+

Oracle Linux Server release 7.6 64bit

+

Oracle Linux Server release 7.5 64bit

+

Oracle Linux Server release 7.4 64bit

+

Oracle Linux Server release 7.3 64bit

+

Oracle Linux Server release 7.2 64bit

+

Oracle Linux Server release 7.1 64bit

+

Oracle Linux Server release 7.0 64bit

+

Oracle Linux Server release 6.10 64bit

+

Oracle Linux Server release 6.9 64bit

+

Oracle Linux Server release 6.8 64bit

+

Oracle Linux Server release 6.7 64bit

+

Oracle Linux Server release 6.5 64bit

+

Red Hat

+

Red Hat Linux Enterprise 8.0 64bit

+

Red Hat Linux Enterprise 7.6 64bit

+

Red Hat Linux Enterprise 7.5 64bit

+

Red Hat Linux Enterprise 7.4 64bit

+

Red Hat Linux Enterprise 7.3 64bit

+

Red Hat Linux Enterprise 7.2 64bit

+

Red Hat Linux Enterprise 7.1 64bit

+

Red Hat Linux Enterprise 7.0 64bit

+

Red Hat Linux Enterprise 6.10 64bit

+

Red Hat Linux Enterprise 6.9 64bit

+

Red Hat Linux Enterprise 6.8 64bit

+

Red Hat Linux Enterprise 6.7 64bit

+

Red Hat Linux Enterprise 6.6 64bit

+

Red Hat Linux Enterprise 6.6 32bit

+

Red Hat Linux Enterprise 6.5 64bit

+

Red Hat Linux Enterprise 6.4 64bit

+

Red Hat Linux Enterprise 6.4 32bit

+

Ubuntu

+

Ubuntu 20.04 Server 64bit

+

Ubuntu 19.04 Server 64bit

+

Ubuntu 18.04 Server 64bit

+

Ubuntu 16.04.3 Server 64bit

+

Ubuntu 16.04.2 Server 64bit

+

Ubuntu 16.04 Server 64bit

+

Ubuntu 14.04.5 Server 64bit

+

Ubuntu 14.04.4 Server 64bit

+

Ubuntu 14.04.4 Server 32bit

+

Ubuntu 14.04.3 Server 64bit

+

Ubuntu 14.04.3 Server 32bit

+

Ubuntu 14.04.1 Server 64bit

+

Ubuntu 14.04.1 Server 32bit

+

Ubuntu 14.04 Server 64bit

+

Ubuntu 14.04 Server 32bit

+

openSUSE

+

openSUSE 42.3 64bit

+

openSUSE 42.2 64bit

+

openSUSE 42.1 64bit

+

openSUSE 15.1 64bit

+

openSUSE 15.0 64bit

+

openSUSE 13.2 64bit

+

openSUSE 11.3 64bit

+

CentOS

+

CentOS 8.0 64bit

+

CentOS 7.9 64bit

+

CentOS 7.8 64bit

+

CentOS 7.7 64bit

+

CentOS 7.6 64bit

+

CentOS 7.5 64bit

+

CentOS 7.4 64bit

+

CentOS 7.3 64bit

+

CentOS 7.2 64bit

+

CentOS 7.1 64bit

+

CentOS 7.0 64bit

+

CentOS 7.0 32bit

+

CentOS 6.10 64bit

+

CentOS 6.10 32bit

+

CentOS 6.9 64bit

+

CentOS 6.8 64bit

+

CentOS 6.7 64bit

+

CentOS 6.7 32bit

+

CentOS 6.6 64bit

+

CentOS 6.6 32bit

+

CentOS 6.5 64bit

+

CentOS 6.5 32bit

+

CentOS 6.4 64bit

+

CentOS 6.4 32bit

+

CentOS 6.3 64bit

+

CentOS 6.3 32bit

+

Debian

+

Debian GNU/Linux 10.0.0 64bit

+

Debian GNU/Linux 9.3.0 64bit

+

Debian GNU/Linux 9.0.0 64bit

+

Debian GNU/Linux 8.8.0 64bit

+

Debian GNU/Linux 8.7.0 64bit

+

Debian GNU/Linux 8.6.0 64bit

+

Debian GNU/Linux 8.5.0 64bit

+

Debian GNU/Linux 8.4.0 64bit

+

Debian GNU/Linux 8.2.0 64bit

+

Debian GNU/Linux 8.1.0 64bit

+

Fedora

+

Fedora 30 64bit

+

Fedora 29 64bit

+

Fedora 28 64bit

+

Fedora 27 64bit

+

Fedora 26 64bit

+

Fedora 25 64bit

+

Fedora 24 64bit

+

Fedora 23 64bit

+

Fedora 22 64bit

+

EulerOS

+

EulerOS 2.9 64bit

+

EulerOS 2.5 64bit

+

EulerOS 2.3 64bit

+

EulerOS 2.2 64bit

+

EulerOS 2.1 64bit

+

CoreOS

+

CoreOS 1068.10.0

+

CoreOS 1010.5.0

+

CoreOS 1298.6.0

+

openEuler

+

openEuler 20.03 64bit

+
+
+
+

Related Operations

For how to upload an external image file, see Uploading an External Image File and Uploading an External Image File.

+

After an external image file is successfully uploaded, you can register this image file as a private image on the cloud platform. For details, see Registering an External Image File as a Private Image and Registering an External Image File as a Private Image.

+
+
+
+
+
Parent topic: Supported OSs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713146.html b/docs/ims/umn/en-us_topic_0030713146.html new file mode 100644 index 000000000..3c52ca40d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713146.html @@ -0,0 +1,19 @@ + + +

Supported OSs

+
+
+ + +
+
Parent topic: Overview
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713148.html b/docs/ims/umn/en-us_topic_0030713148.html new file mode 100644 index 000000000..fbf77f9f1 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713148.html @@ -0,0 +1,85 @@ + + +

Related Services

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 Related services

Service

+

Relationship with IMS

+

Related Operation

+

Elastic Cloud Server (ECS)

+

You can use an image to create ECSs or use an ECS to create an image.

+		 +

Bare Metal Server (BMS)

+

You can use an image to create BMSs or use a BMS to create an image.

+

Creating a BMS System Disk Image

+

Object Storage Service (OBS)

+

Images are stored in OBS buckets. External image files to be uploaded to the system are stored in OBS buckets, and private images are exported to OBS buckets.

+

Exporting an Image

+

Key Management Service (KMS)

+

KMS provides the keys used for encrypting images.

+

Encrypting Images

+

Elastic Volume Service (EVS)

+

You can create a data disk image using a data disk of an ECS. The created data disk image can be used to create other EVS disks.

+

Creating a Data Disk Image from an ECS

+

Cloud Server Backup Service (CSBS)

+

You can use a CSBS backup to create a full-ECS image.

+

Creating a Full-ECS Image from a CSBS Backup

+

Cloud Backup and Recovery (CBR)

+

You can use a CBR backup to create a full-ECS image.

+

Creating a Full-ECS Image from a CBR Backup

+

Tag Management Service (TMS)

+

You can add tags to images for convenient classification and search.

+

Tagging an Image

+

Cloud Trace Service (CTS)

+

CTS records IMS operations for query, auditing, or backtracking.

+

Auditing Key Operations

+
+
+
+
+
+
Parent topic: Overview
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713149.html b/docs/ims/umn/en-us_topic_0030713149.html new file mode 100644 index 000000000..665d6c4bf --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713149.html @@ -0,0 +1,98 @@ + + +

Creating a System Disk Image from a Windows ECS

+

Scenarios

If you have created and configured a Windows ECS based on your service requirements (for example, by installing software and setting up an application environment), you can create a system disk image based on this configured ECS. Then, all new ECSs created from this image will have the same software and environment preinstalled.

+

Creating a system disk image does not affect the running of services on the ECS or cause data loss.

+
+

Background

The following figure shows the process of creating a system disk image from an ECS.

+
Figure 1 Creating a system disk image and using it to create ECSs
+ +
+

Prerequisites

Before creating a private image from an ECS:

+ +

If an ECS is created from a public image, Cloudbase-Init has been installed by default. You can follow the guide in the prerequisites to verify the installation.

+
+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Create a system disk image.

    1. Click Create Image in the upper right corner.
    2. Set image parameters.

      Table 1 and Table 2 list the parameters in the Image Type and Source and Image Information areas, respectively.

      + +
      + + + + + + + + + + +
      Table 1 Image type and source

      Parameter

      +

      Description

      +

      Type

      +

      Select System disk image.

      +

      Source

      +

      Select ECS and select an ECS with required configurations.

      +
      +
      + +
      + + + + + + + + + + + + + + + + +
      Table 2 Image information

      Parameter

      +

      Description

      +

      Encryption

      +

      This parameter specifies whether the image will be encrypted. The value is provided by the system and cannot be changed.

      +
      • Only an unencrypted private image can be created from an unencrypted ECS.
      • Only an encrypted private image can be created from an encrypted ECS.
      +

      Name

      +

      Set a name for the image.

      +

      Tag

      +

      (Optional) Set a tag key and a tag value for the image to make identification and management of your images easier.

      +

      Description

      +

      (Optional) Enter a description of the image.

      +
      +
      +
    3. Click Create Now.
    4. Confirm the parameters and click Submit.
    +

  3. Go back to the Private Images page and view the new system disk image.

    The time required for creating an image depends on the ECS system disk size, network quality, and the number of concurrent tasks. When the image status changes to Normal, the image creation is complete.

    +
    • Do not perform any operations on the selected ECS or its associated resources during image creation.
    • An ECS created from an encrypted image is also encrypted. The key used for encrypting the ECS is the same as that used for encrypting the image.
    • An image created from an encrypted ECS is also encrypted. The key used for encrypting the image is the same as that used for encrypting the ECS.
    +
    +

+
+

Follow-up Procedure

After a system disk image is created, you can use either of the following methods to migrate data between two servers:

+ +
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713151.html b/docs/ims/umn/en-us_topic_0030713151.html new file mode 100644 index 000000000..3a4d9debb --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713151.html @@ -0,0 +1,19 @@ + + +

Quickly Importing an Image File

+
+
+ + +
+
Parent topic: Creating a Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713152.html b/docs/ims/umn/en-us_topic_0030713152.html new file mode 100644 index 000000000..2b5ce0458 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713152.html @@ -0,0 +1,33 @@ + + +

Setting the NIC to DHCP

+

Scenarios

If a private image is created from an ECS or external image file and the VM where the ECS or external image file is located is configured with a static IP address, you need to change the NIC attribute to DHCP so that the new ECSs created from the private image can dynamically obtain an IP address.

+

This section uses Windows Server 2008 R2 as an example to describe how to configure DHCP. For details about how to configure DHCP on ECSs running other OSs, see the relevant OS documentation.

+

When registering an external image file as a private image, configure DHCP on the VM where the external image file is located. You are advised to configure DHCP on the VM and then export the image file.

+
+
+

Prerequisites

You have logged in to the ECS used to create a Windows private image.

+

For details about how to log in to an ECS, see Elastic Cloud Server User Guide.

+
+

Procedure

  1. On the ECS, choose Start > Control Panel.
  2. Click Network and Internet Connections.
  3. Click Network and Sharing Center.
    Figure 1 Network and Sharing Center
    +
  4. Select the connection configured with the static IP address. For example, click Local Area Connection 2.
    Figure 2 Local Area Connection 2 Status
    +
  5. Click Properties and select the configured Internet protocol version.
  6. On the General tab, select Obtain an IP address automatically and Obtain DNS server address automatically and click OK. Figure 3 shows the dialog box for configuring the IP address obtaining mode.

    You are advised to record the original network information so that you can restore the network if necessary.

    +
    +
    Figure 3 Configuring the IP address obtaining mode
    +

    The system will automatically obtain an IP address.

    +
+
+
+
+
+
Parent topic: Windows Operations
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713153.html b/docs/ims/umn/en-us_topic_0030713153.html new file mode 100644 index 000000000..62a8dda5b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713153.html @@ -0,0 +1,11 @@ + + +

Can I Use the System Disk Image of an ECS on a Physical Server After I Export It from the Cloud Platform?

+

No. The system disk image of an ECS is a VM file that contains a system running environment and does not have an installation boot program. Therefore, it cannot be used on a physical server.

+
+
+
+
Parent topic: Image Exporting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713155.html b/docs/ims/umn/en-us_topic_0030713155.html new file mode 100644 index 000000000..189c66ccb --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713155.html @@ -0,0 +1,28 @@ + + +

Enabling Remote Desktop Connection

+

Scenarios

If you want to remotely access an ECS, enable remote desktop connection for the source ECS when creating a private image. This function must be enabled for GPU-accelerated ECSs.

+

When registering an external image file as a private image, enable remote desktop connection on the VM where the external image file is located. You are advised to enable this function on the VM and then export the image file.

+
+
+

Prerequisites

You have logged in to the ECS used to create a Windows private image.

+

For details about how to log in to an ECS, see Elastic Cloud Server User Guide.

+
+

Procedure

  1. Before enabling this function, you are advised to set the resolution of the ECS to 1920×1080.

    On the ECS, choose Start > Control Panel. Under Appearance and Personalization, click Adjust screen resolution. Then select a proper value from the Resolution drop-down list box.

    +
  2. Choose Start, right-click Computer, and choose Properties from the shortcut menu.
  3. Click Remote settings.
  4. In the Remote tab, select Allow connections from computers running any version of Remote Desktop (less secure).
  5. Click OK.
  6. Choose Start > Control Panel and navigate to Windows Firewall.
  7. Choose Allow a program or feature through Windows Firewall in the left pane.
  8. Select programs and features that are allowed by the Windows firewall for Remote Desktop based on your network requirements and click OK in the lower part.
    Figure 1 Configuring remote desktop
    +
+
+
+
+
+
Parent topic: Windows Operations
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713176.html b/docs/ims/umn/en-us_topic_0030713176.html new file mode 100644 index 000000000..d3a16fd29 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713176.html @@ -0,0 +1,33 @@ + + +

Setting the NIC to DHCP

+

Scenarios

If a private image is created from an ECS or external image file and the VM where the ECS or external image file is located is configured with a static IP address, you need to change the NIC attribute to DHCP so that the new ECSs created from the private image can dynamically obtain an IP address.

+

The configuration method varies depending on OSs.

+

When registering an external image file as a private image, configure DHCP on the VM where the external image file is located. You are advised to configure DHCP on the VM and then export the image file.

+
+
+

Prerequisites

You have logged in to the ECS used to create a Windows private image.

+

For details about how to log in to an ECS, see Elastic Cloud Server User Guide.

+
+

Procedure

This section uses Ubuntu 14.04 as an example to describe how to query and configure NIC attributes of an ECS.

+
  1. Run the following command on the ECS to open the /etc/network/interfaces file using the vi editor and query the IP address obtaining mode:

    vi /etc/network/interfaces

    +
    • If DHCP has been configured on all NICs, enter :q to exit the vi editor.
      Figure 1 DHCP IP address obtaining mode
      +
    • If static IP addresses are set on the NICs, go to 2.
      Figure 2 Static IP address obtaining mode
      +
    +
  2. Press i to enter editing mode.
  3. Delete the static IP address configuration and configure DHCP for the NICs.

    You can insert a number sign (#) in front of each line of static IP address configuration to comment it out.

    +
    Figure 3 Configuring DHCP on a NIC
    +

    If the ECS has multiple NICs, you must configure DHCP for all the NICs.

    +
    Figure 4 Configuring DHCP on multiple NICs
    +
  4. Press Esc, enter :wq, and press Enter.

    The system saves the configuration and exits the vi editor.

    +
+
+

Related Operations

Configure DHCP to enable the ECS to obtain IP addresses continuously.

+ +
+
+
+
+
Parent topic: Linux Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713179.html b/docs/ims/umn/en-us_topic_0030713179.html new file mode 100644 index 000000000..92c19f96f --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713179.html @@ -0,0 +1,40 @@ + + +

Detaching Data Disks from an ECS

+

Scenarios

If multiple data disks are attached to the ECS used to create a private image, ECSs created from the image may be unavailable. Therefore, you need to detach all data disks from the ECS before using it to create a private image.

+

This section describes how to detach all data disks from an ECS.

+
+

Prerequisites

You have logged in to the ECS used to create a Linux private image.

+
+

Procedure

  1. Check whether the ECS has data disks.

    Run the following command to check the number of disks attached to the ECS:

    +

    fdisk -l

    +
    • If the number is greater than 1, the ECS has data disks. Go to 2.
    • If the number is equal to 1, no data disk is attached to the ECS. Go to 3.
    +
  2. Run the following command to check the data disks attached to the ECS:

    mount

    +
    • If the command output does not contain any EVS disk information, no EVS data disks need to be detached.
      /dev/vda1 on / type ext4 (rw,relatime,data=ordered)
      +
    • If information similar to the following is displayed, go to 3:
      /dev/vda1 on / type ext4 (rw,relatime,data=ordered)
+/dev/vdb1 on /mnt/test type ext4 (rw,relatime,data=ordered)
      +
    +
  3. Delete the configuration information in the fstab file.
    1. Run the following command to edit the fstab file:

      vi /etc/fstab

      +
    2. Delete the disk configuration from the fstab file.

      The /etc/fstab file contains information about the file systems and storage devices automatically attached to the ECS when the ECS starts. The configuration about data disks automatically attached to the ECS needs to be deleted, for example, the last line shown in the following figure.

      +
      Figure 1 EVS disk configuration in the fstab file
      +
    +
  4. Run the following command to detach data disks from the ECS:

    Run the following command to detach the disks:

    +

    umount /dev/vdb1

    +
  5. Run the following command to check the data disks attached to the ECS:

    mount

    +

    If the command output contains no information about the data disks, they have been detached from the ECS.

    +
+
+
+
+
+
Parent topic: Linux Operations
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713180.html b/docs/ims/umn/en-us_topic_0030713180.html new file mode 100644 index 000000000..abade2c3b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713180.html @@ -0,0 +1,98 @@ + + +

Creating a System Disk Image from a Linux ECS

+

Scenarios

If you have created and configured a Linux ECS based on your service requirements (for example, by installing software and setting up an application environment), you can create a system disk image based on this configured ECS. Then, all new ECSs created from this image will have the same software and environment preinstalled.

+

Creating a system disk image does not affect the running of services on the ECS or cause data loss.

+
+

Background

The following figure shows the process of creating a system disk image from an ECS.

+
Figure 1 Creating a system disk image and using it to create ECSs
+ +
+

Prerequisites

Before creating a private image from an ECS:

+ +

If an ECS is created from a public image, Cloud-Init has been installed by default. You can follow the guide to verify the installation.

+
+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Create a system disk image.

    1. Click Create Image in the upper right corner.
    2. Set image parameters.

      Table 1 and Table 2 list the parameters in the Image Type and Source and Image Information areas, respectively.

      + +
      + + + + + + + + + + +
      Table 1 Image type and source

      Parameter

      +

      Description

      +

      Type

      +

      Select System disk image.

      +

      Source

      +

      Select ECS and select an ECS with required configurations.

      +
      +
      + +
      + + + + + + + + + + + + + + + + +
      Table 2 Image information

      Parameter

      +

      Description

      +

      Encryption

      +

      This parameter specifies whether the image will be encrypted. The value is provided by the system and cannot be changed.

      +
      • Only an unencrypted private image can be created from an unencrypted ECS.
      • Only an encrypted private image can be created from an encrypted ECS.
      +

      Name

      +

      Set a name for the image.

      +

      Tag

      +

      (Optional) Set a tag key and a tag value for the image to make identification and management of your images easier.

      +

      Description

      +

      (Optional) Enter a description of the image.

      +
      +
      +
    3. Click Create Now.
    4. Confirm the parameters and click Submit.
    +

  3. Go back to the Private Images page and view the new system disk image.

    The time required for creating an image depends on the ECS system disk size, network quality, and the number of concurrent tasks. When the image status changes to Normal, the image creation is complete.

    +
    • Do not perform any operations on the selected ECS or its associated resources during image creation.
    • An ECS created from an encrypted image is also encrypted. The key used for encrypting the ECS is the same as that used for encrypting the image.
    • An image created from an encrypted ECS is also encrypted. The key used for encrypting the image is the same as that used for encrypting the ECS.
    +
    +

+
+

Follow-up Procedure

After a system disk image is created, you can use either of the following methods to migrate data between two servers:

+ +
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713181.html b/docs/ims/umn/en-us_topic_0030713181.html new file mode 100644 index 000000000..49b961f3a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713181.html @@ -0,0 +1,23 @@ + + +

Creating a Windows System Disk Image from an External Image File

+
+
+ + +
+
Parent topic: Creating a Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713182.html b/docs/ims/umn/en-us_topic_0030713182.html new file mode 100644 index 000000000..827356d23 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713182.html @@ -0,0 +1,23 @@ + + +

Overview

+

You can import a local image or a system disk image from another cloud platform to the current cloud. After an image is imported, you can use it to create ECSs or reinstall the OSs of existing ECSs.

+

Creation Process

Figure 1 shows the process of creating a private image.

+
Figure 1 Creating a Windows system disk image
+

As shown in the figure, the following steps are required to register an external image file as a private image:

+
  1. Prepare an external image file that meets platform requirements. For details, see Preparing an Image File.
  2. Upload the external image file to your OBS bucket. For details, see Uploading an External Image File.
  3. On the management console, select the uploaded image file and register it as a private image. For details, see Registering an External Image File as a Private Image.
  4. After the private image is registered, you can use it to create ECSs. For details, see Creating a Windows ECS from an Image.
+
+
+
+
+
Parent topic: Creating a Windows System Disk Image from an External Image File
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713183.html b/docs/ims/umn/en-us_topic_0030713183.html new file mode 100644 index 000000000..519e7bcb9 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713183.html @@ -0,0 +1,13 @@ + + +

Uploading an External Image File

+

You are advised to use OBS Browser to upload external image files to OBS buckets. For details, see Object Storage Service User Guide.

+
  • Only unencrypted external image files or those encrypted using SSE-KMS can be uploaded to the OBS bucket.
  • The storage class of the OBS bucket must be Standard.
+
+
+
+
+
Parent topic: Creating a Windows System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713184.html b/docs/ims/umn/en-us_topic_0030713184.html new file mode 100644 index 000000000..65199bd7a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713184.html @@ -0,0 +1,118 @@ + + +

Registering an External Image File as a Private Image

+

Scenarios

Register an image file uploaded to the OBS bucket as a private image.

+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Register an external image file as a private image.

    1. Click Create Image in the upper right corner.
    2. Set image parameters.

      Table 1 and Table 2 list the parameters in the Image Type and Source and Image Information areas, respectively.

      + +
      + + + + + + + + + + + + + +
      Table 1 Image type and source

      Parameter

      +

      Description

      +

      Type

      +

      Select System disk image.

      +

      Source

      +

      Select Image File for Source. Select the bucket storing the image file from the list and then select the image file.

      +

      Enable Fast Create

      +

      This parameter is available only when you select a ZVHD2 or RAW image file.

      +

      This function enables fast image creation and supports import of large files (up to 1 TB) as long as the files to be uploaded are converted to ZVHD2 or RAW format and optimized. If you have a file that meets the requirements, select Enable Fast Create and select the confirmation information following Image File Preparation.

      +
      NOTE:

      To learn how to convert image file formats and generate bitmap files, see Quickly Importing an Image File.

      +
      +
      +
      + +
      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Table 2 Image information

      Parameter

      +

      Description

      +

      Enable automatic configuration

      +

      If you select this option, the system will automatically check and optimize the image file. For details, see What Will the System Do to an Image File When I Use the File to Register a Private Image?

      +

      Function

      +

      Specifies whether the image is used to create ECSs or BMSs. The value can be ECS system disk image or BMS system disk image. This section uses ECS system disk image as an example.

      +

      Boot Mode

      +

      This parameter is optional. The value can be BIOS or UEFI. For details about the differences between the two, see How Is BIOS Different from UEFI?

      +

      For details about which OSs support UEFI boot, see OSs Supporting UEFI Boot Mode.

      +

      The boot mode must be the same as that in the image file. You need to confirm which boot mode is used in the image file. After you select the correct boot mode, the boot mode will be configured for the image at the background. Select the right boot mode, or ECSs created using the image will not be able to boot up.

      +

      OS

      +

      To ensure that the image can be created and used properly, select an OS consistent with that in the image file. If you do not select an OS, the system attempts to automatically identify the OS in the image file.

      +
      NOTE:
      • If the system detects that the image file OS is different from the one you selected, the OS detected by the system will be used.
      • If the system cannot detect the OS in the image file, the OS you selected will be used.
      • If the OS you selected or identified by the system is incorrect, ECSs created from the image file may be affected.
      +
      +

      System Disk (GB)

      +

      The system disk capacity. Ensure that this value is at least equal to the system disk size in the image file.

      +
      NOTE:

      If the uploaded VHD image is generated using qemu-img or similar tools, check the system disk size based on What Do I Do If the System Disk Size in a VHD Image File Exceeds the One I Have Specified on the Management Console When I Use This File to Register a Private Image?

      +
      +

      Data Disk (GB)

      +

      You can also add data disks to the image. You need to obtain an image file containing data disks in advance. This function is used to migrate VMs and data disks from other platforms to the current platform.

      +

      To add data disks, click , set the data disk size, and click Select Image File. In the displayed dialog box, select the target bucket and then the target image file containing the data disk.

      +

      A maximum of three data disks can be added.

      +

      Name

      +

      Set a name for the image.

      +

      Encryption

      +

      (Optional) If you want to encrypt the image, select KMS encryption and select the key to be used from the key list. After you select KMS encryption, the system will create a default master private key ims/default for you. You can also select a private key from the private key list.

      +

      For how to encrypt an image, see Creating Encrypted Images.

      +

      Tag

      +

      (Optional) Set a tag key and a tag value for the image to make identification and management of your images easier.

      +

      Description

      +

      (Optional) Enter a description of the image.

      +
      +
      +
    3. Click Create Now, confirm the configurations, and click Submit.
    +

  3. Go back to the Private Images page. The image is successfully registered when its status becomes Normal.

    If you add data disks during image creation, a system disk image and data disk images will be generated. The number of data disk images depends on the number of data disks you add (a maximum of 3).

    +

    The time required for image registration is determined by the image file size. You may need to wait a long period of time for the image file to be successfully registered as a private image.

    +
    +

+
+
+
+
+
Parent topic: Creating a Windows System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713185.html b/docs/ims/umn/en-us_topic_0030713185.html new file mode 100644 index 000000000..a11569174 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713185.html @@ -0,0 +1,43 @@ + + +

What Do I Do If a Windows Image File Is Not Pre-Configured When I Use It to Register a Private Image?

+

If an image file is not configured as instructed in Table 1 before it is exported from the original platform, configure it by referring to Figure 1.

+

The proper running of ECSs depends on the XEN Guest OS driver (PV driver) or KVM Guest OS driver (UVP VMTools). If no such a driver is installed, the performance of ECSs will be affected and some functions will be unavailable. Ensure that the PV driver or UVP VMTools has been installed for the image file as needed before it is exported from the original platform. Otherwise, the ECSs created from the image will fail to start.

+ +
+
Figure 1 Image creation process
+

Step 1: Upload the Image File

Upload the external image file to an OBS bucket. For details, see Uploading an External Image File.

+
+

Step 2 Register the Image File as a Private Image

On the management console, select the uploaded image file and register it as a private image. For details, see Registering an External Image File as a Private Image.

+
+

Step 3: Create an ECS

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab.
  3. Locate the row that contains the private image and click Apply for Server in the Operation column.
  4. Set parameters as promoted to create an ECS. Pay attention to the following:
    • Bind an EIP to the ECS so that you can upload installation packages to the ECS or download installation packages from the ECS.
    • You must add inbound rules for security groups of the ECS to ensure that the ECS can be accessed.
    • If the image file has Cloudbase-Init installed, set a password and log in to the ECS using the password as prompted. If Cloudbase-Init is not installed, use the password or certificate contained in the image file to log in the ECS.
    +

    For details, see Elastic Cloud Server User Guide.

    +
  5. Perform the following steps to check whether the private image has been pre-configured:
    1. Check whether the ECS can be successfully started. If the start succeeds, a Guest OS driver has been installed for the image file on the original platform or the driver has been automatically installed for the private image on the cloud platform. If the start failed, install a Guest OS driver for the image file on the original platform and start from Step 1: Upload the Image File again.
    2. Check whether you can log in to the ECS using your configured password or key. If you can, Cloudbase-Init has been installed. If you cannot, use the password or key contained in the image file to log in to the ECS and install Cloudbase-Init as instructed in Installing and Configuring Cloudbase-Init.
    3. Check whether NICs are set to DHCP by referring to 2 in Step 4: Configure the ECS.
    4. Use MSTSC to log in to the ECS. If the login is successful, remote desktop connection is enabled on the ECS. If the login fails, enable remote desktop connection by referring to 3 in Step 4: Configure the ECS.
    +

    If the ECS meets the preceding requirements, the private image has been pre-configured. Skip Step 4: Configure the ECS and Step 5: Create a Private Image from the ECS.

    +
+
+

Step 4: Configure the ECS

Remotely log in to the ECS created in Step 3: Create an ECS to configure it.

+
  1. Log in to the ECS.
  2. Check whether NICs are set to DHCP. If the ECS is configured with a static IP address, change its IP address assignment mode to DHCP as instructed in Setting the NIC to DHCP.
  3. Enable remote desktop connection for the ECS as needed. For details, see Enabling Remote Desktop Connection.
  4. (Optional) Configure value-added functions. +
+
+

Step 5: Create a Private Image from the ECS

For details, see Creating a System Disk Image from a Windows ECS.

+
+

(Optional) Clear the Environment

After the image registration is complete, delete the image file as well as the intermediate private image and ECS to prevent them from occupying storage and compute resources.

+ +
+
+
+
+
Parent topic: Image Optimization
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713186.html b/docs/ims/umn/en-us_topic_0030713186.html new file mode 100644 index 000000000..e2245edf0 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713186.html @@ -0,0 +1,15 @@ + + +

Can I Download a Public Image to My Local PC?

+

Currently, you cannot directly download a public image. You can use the public image to create an ECS, use the ECS to create a private image, export the private image to your OBS bucket, and download the private image to your local PC.

+

Helpful links:

+ +

Windows and SUSE Linux public images and the private images created from these public images cannot be exported.

+
+
+
+
+
Parent topic: Image Exporting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713188.html b/docs/ims/umn/en-us_topic_0030713188.html new file mode 100644 index 000000000..2c7120ba9 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713188.html @@ -0,0 +1,17 @@ + + +

Creating a Windows ECS from an Image

+

Scenarios

After registering an external image file as a private image on the cloud platform, you can use the image to create ECSs or change the OSs of existing ECSs.

+

This section describes how to create an ECS from an image.

+
+

Procedure

Create an ECS by referring to Creating an ECS from an Image.

+

Note the following when setting the parameters:

+ +
+
+
+
+
Parent topic: Creating a Windows System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713189.html b/docs/ims/umn/en-us_topic_0030713189.html new file mode 100644 index 000000000..4c69d189f --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713189.html @@ -0,0 +1,67 @@ + + +

Preparing an Image File

+

You need to prepare an image file that meets the platform requirements.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 Windows image file requirements

Image File Property

+

Requirement

+

OS

+
  • Windows Server 2008, Windows Server 2012, Windows Server 2016
  • 32-bit or 64-bit
  • The OS cannot be bound to specific hardware.
  • The OS must support full virtualization.
+

For details about the supported OS versions, see External Image File Formats and Supported OSs. These OSs support automatic configuration. For details, see What Will the System Do to an Image File When I Use the File to Register a Private Image? For other OSs, check and install the Guest OS driver. On the image registration page, select Other Windows. After the image is imported, whether the system is started depends on the driver integrity.

+

Image format

+

VMDK, VHD, QCOW2, RAW, VHDX, QED, VDI, QCOW, ZVHD2, and ZVHD

+

Image size

+

Maximum file size: 128 GB

+
If the image size is between 128 GB and 1 TB, convert the image file into the RAW or ZVHD2 format and import the image using fast import. +
+

Network

+

The NIC must be set to DHCP. Otherwise, the ECS startup or network capability will be abnormal. For details, see:

+

Setting the NIC to DHCP

+

The following value-added operations are optional:

+ +

Tool

+

You are advised to install Cloudbase-Init.

+

Cloudbase-Init is an open-source tool for cloud instance initialization. When creating ECSs from an image with Cloudbase-Init, you can use user data injection to inject customized initialization details (for example, an ECS login password) to the ECSs. You can also configure and manage a running ECS by querying and using metadata. If Cloudbase-Init is not installed, you cannot apply custom configurations to the ECSs. You will have to use the original password in the image file to log in to the ECSs.

+

For details, see Installing and Configuring Cloudbase-Init.

+

Driver

+		 +

Other requirements

+
  • Currently, images with data disks cannot be created. The image file must contain only the system disk, and the system disk size must be [1 GB, 1024 GB].
  • The initial password in the image file must contain uppercase letters, lowercase letters, digits, and special characters (!@$%^-_=+[{}]:,./?).
  • The boot partition and system partition must be on the same disk.
  • For an external image file, you need an administrator account and password combination.
  • Generally, the boot mode is BIOS in an image. Some OS images support the UEFI boot mode. For details, see "OSs Supporting UEFI Boot Mode" in Image Service Management User Guide.
  • The image file cannot be encrypted, or ECSs created from the registered image may not work properly.
+
+
+
+
+
+
Parent topic: Creating a Windows System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713190.html b/docs/ims/umn/en-us_topic_0030713190.html new file mode 100644 index 000000000..49d430955 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713190.html @@ -0,0 +1,23 @@ + + +

Creating a Linux System Disk Image from an External Image File

+
+
+ + +
+
Parent topic: Creating a Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713191.html b/docs/ims/umn/en-us_topic_0030713191.html new file mode 100644 index 000000000..c87b91089 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713191.html @@ -0,0 +1,23 @@ + + +

Overview

+

You can import a local image or a system disk image from another cloud platform to the current cloud. After an image is imported, you can use it to create ECSs or reinstall the OSs of existing ECSs.

+

Creation Process

Figure 1 shows the process of creating a private image.

+
Figure 1 Creating a Linux system disk image
+

The procedure is as follows:

+
  1. Prepare an external image file that meets platform requirements. For details, see Preparing an Image File.
  2. Upload the external image file to your OBS bucket. For details, see Uploading an External Image File.
  3. On the management console, select the uploaded image file and register it as a private image. For details, see Registering an External Image File as a Private Image.
  4. After the private image is registered, you can use it to create ECSs. For details, see Creating a Linux ECS from an Image.
+
+
+
+
+
Parent topic: Creating a Linux System Disk Image from an External Image File
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713192.html b/docs/ims/umn/en-us_topic_0030713192.html new file mode 100644 index 000000000..4af7f84c6 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713192.html @@ -0,0 +1,13 @@ + + +

Uploading an External Image File

+

You are advised to use OBS Browser to upload external image files to OBS buckets. For details, see Object Storage Service User Guide.

+
  • Only unencrypted external image files or those encrypted using SSE-KMS can be uploaded to the OBS bucket.
  • The storage class of the OBS bucket must be Standard.
+
+
+
+
+
Parent topic: Creating a Linux System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713193.html b/docs/ims/umn/en-us_topic_0030713193.html new file mode 100644 index 000000000..6df34d291 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713193.html @@ -0,0 +1,118 @@ + + +

Registering an External Image File as a Private Image

+

Scenarios

Register an image file uploaded to the OBS bucket as a private image.

+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Register an external image file as a private image.

    1. Click Create Image in the upper right corner.
    2. Set image parameters.

      Table 1 and Table 2 list the parameters in the Image Type and Source and Image Information areas, respectively.

      + +
      + + + + + + + + + + + + + +
      Table 1 Image type and source

      Parameter

      +

      Description

      +

      Type

      +

      Select System disk image.

      +

      Source

      +

      Select Image File for Source. Select the bucket storing the image file from the list and then select the image file.

      +

      Enable Fast Create

      +

      This parameter is available only when you select a ZVHD2 or RAW image file.

      +

      This function enables fast image creation and supports import of large files (up to 1 TB) as long as the files to be uploaded are converted to ZVHD2 or RAW format and optimized. If you have a file that meets the requirements, select Enable Fast Create and select the confirmation information following Image File Preparation.

      +
      NOTE:

      To learn how to convert image file formats and generate bitmap files, see Quickly Importing an Image File.

      +
      +
      +
      + +
      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Table 2 Image information

      Parameter

      +

      Description

      +

      Enable automatic configuration

      +

      If you select this option, the system will automatically check and optimize the image file. For details, see What Will the System Do to an Image File When I Use the File to Register a Private Image?

      +

      Function

      +

      Specifies whether the image is used to create ECSs or BMSs. The value can be ECS system disk image or BMS system disk image. This section uses ECS system disk image as an example.

      +

      Boot Mode

      +

      This parameter is optional. The value can be BIOS or UEFI. For details about the differences between the two, see How Is BIOS Different from UEFI?

      +

      For details about which OSs support UEFI boot, see OSs Supporting UEFI Boot Mode.

      +

      The boot mode must be the same as that in the image file. You need to confirm which boot mode is used in the image file. After you select the correct boot mode, the boot mode will be configured for the image at the background. Select the right boot mode, or ECSs created using the image will not be able to boot up.

      +

      OS

      +

      To ensure that the image can be created and used properly, select an OS consistent with that in the image file. If you do not select an OS, the system attempts to automatically identify the OS in the image file.

      +
      NOTE:
      • If the system detects that the image file OS is different from the one you selected, the OS detected by the system will be used.
      • If the system cannot detect the OS in the image file, the OS you selected will be used.
      • If the OS you selected or identified by the system is incorrect, ECSs created from the image file may be affected.
      +
      +

      System Disk (GB)

      +

      The system disk capacity. Ensure that this value is at least equal to the system disk size in the image file.

      +
      NOTE:

      If the uploaded VHD image is generated using qemu-img or similar tools, check the system disk size based on What Do I Do If the System Disk Size in a VHD Image File Exceeds the One I Have Specified on the Management Console When I Use This File to Register a Private Image?

      +
      +

      Data Disk (GB)

      +

      You can also add data disks to the image. You need to obtain an image file containing data disks in advance. This function is used to migrate VMs and data disks from other platforms to the current platform.

      +

      To add data disks, click , set the data disk size, and click Select Image File. In the displayed dialog box, select the target bucket and then the target image file containing the data disk.

      +

      A maximum of three data disks can be added.

      +

      Name

      +

      Set a name for the image.

      +

      Encryption

      +

      (Optional) If you want to encrypt the image, select KMS encryption and select the key to be used from the key list. After you select KMS encryption, the system will create a default master private key ims/default for you. You can also select a private key from the private key list.

      +

      For how to encrypt an image, see Creating Encrypted Images.

      +

      Tag

      +

      (Optional) Set a tag key and a tag value for the image to make identification and management of your images easier.

      +

      Description

      +

      (Optional) Enter a description of the image.

      +
      +
      +
    3. Click Create Now, confirm the configurations, and click Submit.
    +

  3. Go back to the Private Images page. The image is successfully registered when its status becomes Normal.

    If you add data disks during image creation, a system disk image and data disk images will be generated. The number of data disk images depends on the number of data disks you add (a maximum of 3).

    +

    The time required for image registration is determined by the image file size. You may need to wait a long period of time for the image file to be successfully registered as a private image.

    +
    +

+
+
+
+
+
Parent topic: Creating a Linux System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713195.html b/docs/ims/umn/en-us_topic_0030713195.html new file mode 100644 index 000000000..459c93dc6 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713195.html @@ -0,0 +1,23 @@ + + +

Image Importing

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713197.html b/docs/ims/umn/en-us_topic_0030713197.html new file mode 100644 index 000000000..04b2a14fe --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713197.html @@ -0,0 +1,17 @@ + + +

Creating a Linux ECS from an Image

+

Scenarios

After registering an external image file as a private image on the cloud platform, you can use the image to create ECSs or change the OSs of existing ECSs.

+

This section describes how to create an ECS from an image.

+
+

Procedure

Create an ECS by referring to Creating an ECS from an Image.

+

Note the following when setting the parameters:

+ +
+
+
+
+
Parent topic: Creating a Linux System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713198.html b/docs/ims/umn/en-us_topic_0030713198.html new file mode 100644 index 000000000..ccf4d106e --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713198.html @@ -0,0 +1,72 @@ + + +

Preparing an Image File

+

You need to prepare an image file that meets the platform requirements.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 Linux image file requirements

Image File Property

+

Requirement

+

OS

+
  • SUSE, Oracle Linux, Red Hat, Ubuntu, openSUSE, CentOS, Debian, Fedora, EulerOS, and NeoKylin
  • 32-bit or 64-bit
  • The OS cannot be bound to specific hardware.
  • The OS must support full virtualization.
+

For details about the supported OS versions, see External Image File Formats and Supported OSs. These OSs support automatic configuration. For details, see What Will the System Do to an Image File When I Use the File to Register a Private Image? For other OSs, check and install the VirtIO driver (see Installing Native KVM Drivers). On the image registration page, select Other Linux. After the image is imported, whether the system is started depends on the driver integrity.

+

Image format

+

VMDK, VHD, QCOW2, RAW, VHDX, QED, VDI, QCOW, ZVHD2, and ZVHD

+

Image size

+

Maximum file size: 128 GB

+
If the image size is between 128 GB and 1 TB, convert the image file into the RAW or ZVHD2 format and import the image using fast import. +
+

Network

+

The NIC must be set to DHCP and files must be deleted from the network role directory. Otherwise, the ECS startup or network capability will be abnormal. For details, see:

+ +

The following value-added operations are optional:

+ +

Tool

+

You are advised to install Cloud-Init.

+

Cloud-Init is an open-source tool for cloud instance initialization. When creating ECSs from an image with Cloud-Init, you can use user data injection to inject customized initialization details (for example, an ECS login password) to the ECSs. You can also configure and manage a running ECS by querying and using metadata. If Cloud-Init is not installed, you cannot apply custom configurations to the ECSs. You will have to use the original password in the image file to log in to the ECSs.

+

For details, see Installing Cloud-Init.

+

Driver

+

Installing native KVM drivers

+

File system

+		 +

Other requirements

+
  • Currently, images with data disks cannot be created. The image file must contain only the system disk, and the system disk size must be [1 GB, 1024 GB].
  • The initial password in the image file must contain uppercase letters, lowercase letters, digits, and special characters (!@$%^-_=+[{}]:,./?).
  • The boot partition and system partition must be on the same disk.
  • Generally, the boot mode is BIOS in an image. Some OS images support the UEFI boot mode. For details, see "OSs Supporting UEFI Boot Mode" in Image Service Management User Guide.
  • The image file cannot be encrypted, or ECSs created from the registered image may not work properly.
  • The /etc/fstab file cannot contain automatic mounting information of non-system disks. Otherwise, the login to the created ECS may fail.
  • If the external image file uses LVM as the system disk, ECSs created from the private image do not support file injection.
  • If the VM where the external image file is located has been shut down, it must be a graceful shutdown. Otherwise, a blue screen may occur when the ECS created from the private image is started.
+
+
+
+
+
+
Parent topic: Creating a Linux System Disk Image from an External Image File
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713199.html b/docs/ims/umn/en-us_topic_0030713199.html new file mode 100644 index 000000000..2c1fbd18d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713199.html @@ -0,0 +1,26 @@ + + +

Modifying an Image

+

Scenarios

You can modify the following attributes of a private image:

+ +
+

Constraints

+
+

Procedure

Use any of the following methods to modify an image:

+
Method 1:
  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab to display the image list.
  3. Locate the row that contains the image and click Modify in the Operation column.
  4. In the Modify Image dialog box, modify the image.
+
+
Method 2:
  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab to display the image list.
  3. On the image list, click the name of the target image.
  4. On the image details page, click Modify in the upper right corner. In the Modify Image dialog box, modify image attributes.
+
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713200.html b/docs/ims/umn/en-us_topic_0030713200.html new file mode 100644 index 000000000..692bb63d7 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713200.html @@ -0,0 +1,18 @@ + + +

Creating an ECS from an Image

+

Scenarios

You can use a public, private, or shared image to create an ECS.

+ +
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Public Images, Private Images, or Images Shared with Me tab to display the image list.
  3. Locate the row that contains your desired image and click Apply for Server in the Operation column.
  4. For details about how to create an ECS, see Elastic Cloud Server User Guide.

    When you use a system disk image to create an ECS, you can set the ECS specifications and system disk type without considering those in the image, but the system disk size can only be larger than that in the image.

    +
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713201.html b/docs/ims/umn/en-us_topic_0030713201.html new file mode 100644 index 000000000..8c8d1b1a8 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713201.html @@ -0,0 +1,23 @@ + + +

Deleting Images

+

Scenarios

You can delete private images that will no longer be used.

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab to display the image list.
  3. Locate the row that contains the image, choose More > Delete in the Operation column.

    To delete multiple images:

    +
    1. Select the images you want to delete in the image list.
    2. Click Delete above the image list.
    +
    +
  4. (Optional) Select Delete CSBS backups of the full-ECS images.

    This parameter is available only when you have selected full-ECS images from the image list.

    +

    If you select this option, the system will delete CSBS backups of the full-ECS images.

    +

    If CSBS backups failed to be deleted, the cause may be that these backups are being created and cannot be deleted. In this case, manually delete them as prompted.

    +
    +
  5. Click Yes.
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713202.html b/docs/ims/umn/en-us_topic_0030713202.html new file mode 100644 index 000000000..ff78db8f9 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713202.html @@ -0,0 +1,29 @@ + + +

FAQs

+
+
+ +
+ diff --git a/docs/ims/umn/en-us_topic_0030713203.html b/docs/ims/umn/en-us_topic_0030713203.html new file mode 100644 index 000000000..8c9ed8e7e --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713203.html @@ -0,0 +1,31 @@ + + +

Image Optimization

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713209.html b/docs/ims/umn/en-us_topic_0030713209.html new file mode 100644 index 000000000..a6bd23e57 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713209.html @@ -0,0 +1,11 @@ + + +

Can I Use a Private Image to Create ECSs with Different Hardware Specifications from the ECS Used to Create the Private Image?

+

Yes. You can specify the CPU, memory, bandwidth, data disks of the new ECSs if necessary. You can also specify their system disk size. The value must be smaller than 1024 GB but no less than the system disk size in the image.

+
+
+
+
Parent topic: ECS Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713211.html b/docs/ims/umn/en-us_topic_0030713211.html new file mode 100644 index 000000000..7bee12765 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713211.html @@ -0,0 +1,46 @@ + + +

What Do I Do If a Linux Image File Is Not Pre-Configured When I Use It to Register a Private Image?

+

If an image file is not configured as instructed in Table 1 before it is exported from the original platform, configure it by referring to Figure 1.

+

The proper running of ECSs depends on the Xen or KVM driver. If no such a driver is installed, the performance of ECSs will be affected and some functions will be unavailable. Ensure that the Xen or KVM driver has been installed for the image file as needed before it is exported from the original platform. Otherwise, the ECSs created from the image will fail to start.

+

For details, see How Do I Install Native Xen and KVM Drivers?

+
+
Figure 1 Image creation process
+

Step 1: Upload the Image File

Upload the external image file to an OBS bucket. For details, see Uploading an External Image File.

+
+

Step 2 Register the Image File as a Private Image

On the management console, select the uploaded image file and register it as a private image. For details, see Registering an External Image File as a Private Image.

+
+

Step 3: Create an ECS

Create an ECS from the private image.

+
  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab.
  3. Locate the row that contains the private image and click Apply for Server in the Operation column.
  4. Set parameters as promoted to create an ECS. Pay attention to the following:
    • You must add inbound rules for security groups of the ECS to ensure that the ECS can be accessed.
    • If Cloud-Init has been installed in the image file, set a login password as prompted. If Cloud-Init is not installed, use the password or certificate contained in the image file to log in.
    +

    For details, see Elastic Cloud Server User Guide.

    +
  5. Perform the following steps to check whether the private image has been pre-configured:
    1. Check whether the ECS can be successfully started. If the start succeeds, the Xen or KVM driver has been installed for the external image file on the original platform or the driver has been automatically installed for the private image on the cloud platform. If the start failed, install the Xen or KVM driver as needed for the image file and start from Step 1: Upload the Image File again.
    2. Check whether you can log in to the ECS using your configured password or key. If you can, Cloud-Init has been installed. If you cannot, use the password or key contained in the image file to log in to the ECS and install Cloud-Init as instructed in Installing Cloud-Init.
    3. Check the network configuration by referring to Step 4: Configure the ECS.
    +

    If the ECS meets the preceding requirements, the private image has been pre-configured. Skip Step 4: Configure the ECS and Step 5: Create a Private Image from the ECS.

    +
+
+

Step 4: Configure the ECS

Remotely log in to the ECS created in Step 3: Create an ECS to configure it.

+
  1. Log in to the ECS.
  2. Configure the network.
    • Run the ifconfig command to check whether the private IP address of the ECS is the same as that displayed on the console. If they are inconsistent, delete files from the network rule directory as instructed in Deleting Files from the Network Rule Directory.
    • Check whether NICs are set to DHCP. If the ECS is configured with a static IP address, change its IP address assignment mode to DHCP as instructed in Setting the NIC to DHCP.
    • Run the service sshd status command to check whether SSH is enabled. If it is disabled, run the service sshd start command to enable it. Ensure that your firewall (for example, Linux iptables) allows SSH access.
    +
  3. Configure a file system. +
  4. (Optional) Configure value-added functions. +
+
+

Step 5: Create a Private Image from the ECS

Create a private image from the ECS. For details, see Creating a System Disk Image from a Linux ECS.

+
+

(Optional) Clear the Environment

After the image registration is complete, delete the image file as well as the intermediate private image and ECS to prevent them from occupying storage and compute resources.

+ +
+
+
+
+
Parent topic: Image Optimization
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713213.html b/docs/ims/umn/en-us_topic_0030713213.html new file mode 100644 index 000000000..8e7dfe3e0 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713213.html @@ -0,0 +1,12 @@ + + +

What Do I Do If I Configured an Incorrect OS or System Disk Size During Private Image Registration Using an Image File?

+

If you selected an incorrect OS, ECSs may fail to be created from the private image. If the configured system disk size is less than the one in the image file, image registration will fail.

+

In such cases, delete the incorrect image and create a new one using correct parameter settings.

+
+
+
+
Parent topic: Image Importing
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713214.html b/docs/ims/umn/en-us_topic_0030713214.html new file mode 100644 index 000000000..a2f986518 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713214.html @@ -0,0 +1,12 @@ + + +

Must I Install Guest OS Drivers on an ECS?

+

Installing Guest OS drivers on an ECS improves your experience in using the ECS. In addition, it also ensures high reliability and stability of ECSs.

+ +
+
+
+
Parent topic: Image Optimization
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713215.html b/docs/ims/umn/en-us_topic_0030713215.html new file mode 100644 index 000000000..5adff4bdd --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713215.html @@ -0,0 +1,13 @@ + + +

What Is the Cause of the Failure to Install a Guest OS Driver on a Windows ECS?

+

Possible causes:

+ + +
+
+
+
Parent topic: Image Optimization
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713216.html b/docs/ims/umn/en-us_topic_0030713216.html new file mode 100644 index 000000000..d06589d03 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713216.html @@ -0,0 +1,13 @@ + + +

What Are the Impacts If I Do Not Pre-configure an ECS Used to Create a Private Image?

+

Before using an ECS or external image file to create a private image, you need to pre-configure the ECS or the source VM of the image file. If you do not perform the pre-configuration, there will be the following impacts:

+
  1. If you do not delete residual rule files from the udev directory, new ECSs will retain the configurations of the source ECS or image file. If you do not set the IP address assignment mode to DHCP, NICs of new ECSs will not start from eth0. You need to remotely log in to the new ECSs to perform configurations.
  2. For Linux, the following issues may occur during the ECS creation:
    • Custom passwords cannot be injected.
    • Certificates cannot be injected.
    • Other custom configurations cannot be applied on new ECSs.
    +
  3. If you do not delete information about automatic disk attachment detection from the fstab file, new ECSs may fail to start.
+
+
+
+
Parent topic: Image Importing
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713217.html b/docs/ims/umn/en-us_topic_0030713217.html new file mode 100644 index 000000000..206bd3bf1 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713217.html @@ -0,0 +1,15 @@ + + +

Can I Use Images in Formats Other Than the Specified Ones?

+

No. Currently, only the VMDK, VHD, RAW, QCOW2, VHDX, QED, VDI, QCOW, ZVHD2, and ZVHD formats are supported.

+

Images of the -flat.vmdk format and image file packages containing snapshot volumes or delta volumes are not supported. You can use qemu-img to convert an image to one of the supported formats before uploading it to the cloud platform.

+

For how to install and use qemu-img in Windows, visit:

+

https://cloudbase.it/qemu-img-windows/

+
+
+
+
+
Parent topic: Image Importing
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713219.html b/docs/ims/umn/en-us_topic_0030713219.html new file mode 100644 index 000000000..683ae6288 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713219.html @@ -0,0 +1,48 @@ + + +

What Do I Do If the Disks of an ECS Created from a CentOS Image Cannot Be Found?

+

Symptom

Generally, this is because the xen-blkfront.ko module is not loaded during the startup. You need to modify OS kernel startup parameters. Figure 1 shows the startup screen after the login to the ECS.

+
Figure 1 Startup screen
+
+

Solution

Perform the following operations to modify OS kernel boot parameters:

+

These operations must be performed after the OS starts. You are advised to modify kernel boot parameters in the ECS used for creating the image.

+
+
  1. Run the following command to log in to the OS:
    lsinitrd /boot/initramfs-`uname -r`.img |grep -i xen
    • If the command output contains xen-blkfront.ko, contact the customer service.
    • If no command output is displayed, go to 2.
    +
    +
  2. Back up the GRUB configuration file.
    • If the ECS runs CentOS 6, run the following command:

      cp /boot/grub/grub.conf /boot/grub/grub.conf.bak

      +
    • If the ECS runs CentOS 7, run the following command:

      cp /boot/grub2/grub.cfg /boot/grub2/grub.cfg.bak

      +
    +
  3. Use the vi editor to open the GRUB configuration file. Run the following command (using CentOS 7 as an example):

    vi /boot/grub2/grub.cfg

    +
  4. Add xen_emul_unplug=all to the default boot kernel.

    Search for the line that contains root=UUID= and add xen_emul_unplug=all to the end of the line.

    +
    +
    menuentry 'CentOS Linux (3.10.0-229.el7.x86_64) 7 (Core) with debugging' --class centos --class gnu-linux --class gnu --class os --unrestricted $menuentry_id_option 'gnulinux-3.10.0-229.el7.x86_64-advanced-bf3cc825-7638-48d8-8222-cd2f412dd0de' {
+        load_video
+        set gfxpayload=keep
+        insmod gzio
+        insmod part_msdos
+        insmod ext2
+        set root='hd0,msdos1'
+        if [ x$feature_platform_search_hint = xy ]; then
+          search --no-floppy --fs-uuid --set=root --hint='hd0,msdos1'  bf3cc825-7638-48d8-8222-cd2f412dd0de
+        else
+          search --no-floppy --fs-uuid --set=root bf3cc825-7638-48d8-8222-cd2f412dd0de
+        fi
+        linux16 /boot/vmlinuz-3.10.0-229.el7.x86_64 root=UUID=bf3cc825-7638-48d8-8222-cd2f412dd0de xen_emul_unplug=all ro crashkernel=auto rhgb quiet  systemd.log_level=debug systemd.log_target=kmsg
+        initrd16 /boot/initramfs-3.10.0-229.el7.x86_64.img
+}
    +
  5. Press Esc, enter :wq, and press Enter to exit the vi editor.
  6. Create an image using the ECS, upload and register the image on the cloud platform.
+
+
+
+
+
Parent topic: ECS Creation
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030713220.html b/docs/ims/umn/en-us_topic_0030713220.html new file mode 100644 index 000000000..81929d4d3 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713220.html @@ -0,0 +1,25 @@ + + +

ECS Creation

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713221.html b/docs/ims/umn/en-us_topic_0030713221.html new file mode 100644 index 000000000..92ea9eb60 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713221.html @@ -0,0 +1,13 @@ + + +

Can I Specify the System Disk Size When I Create an ECS Using an Image?

+

Yes. However, the value must be smaller than 30,768 GB but no less than the system disk size in the image.

+

Ensure that your ECS OS supports the system disk size you specified.

+
+
+
+
+
Parent topic: ECS Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030713222.html b/docs/ims/umn/en-us_topic_0030713222.html new file mode 100644 index 000000000..eaf398de7 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030713222.html @@ -0,0 +1,25 @@ + + +

Image Exporting

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030730602.html b/docs/ims/umn/en-us_topic_0030730602.html new file mode 100644 index 000000000..855460ff8 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030730602.html @@ -0,0 +1,86 @@ + + +

Installing and Configuring Cloudbase-Init

+

Scenarios

To ensure that you can use the user data injection function to inject initial custom information into ECSs created from a private image (such as setting the ECS login password), install Cloudbase-Init on the ECS used to create the image.

+ +
+

Prerequisites

+
+

Install Cloudbase-Init

  1. On the Windows Start menu, choose Control Panel > Programs > Programs and Features and check whether Cloudbase-Init is installed. +
  2. Check whether the version of the OS is Windows desktop.
    • If yes, go to 3.
    • If the OS is Windows Server, go to 4.
    +
  3. Enable the administrator account (Windows 7 is used as an example).
    1. Click Start and choose Control Panel > System and Security > Administrative Tools.
    2. Double-click Computer Management.
    3. Choose System Tools > Local Users and Groups > Users.
    4. Right-click Administrator and select Properties.
    5. Deselect Account is disabled.
    +
  4. Download the Cloudbase-Init installation package.

    Download the Cloudbase-Init installation package of the appropriate version based on the OS architecture from the Cloudbase-Init official website (http://www.cloudbase.it/cloud-init-for-windows-instances/).

    +

    Cloudbase-Init has two versions: stable and beta.

    +

    To obtain the stable version, visit the following paths:

    + +

    To obtain the beta version, visit the following paths:

    + +
  5. Double-click the Cloudbase-Init installation package.
  6. Click Next.
  7. Select I accept the terms in the License Agreement and click Next.
  8. Retain the default path and click Next.
  9. In the Configuration options window, enter Administrator for Username, select COM1 for Serial port for logging, and ensure that Run Cloudbase-Init service as LocalSystem is not selected.

    The version number shown in the figure is for reference only.

    +
    +
    Figure 1 Configuring parameters
    +
  10. Click Next.
  11. Click Install.
  12. In the Files in Use dialog box, select Close the application and attempt to restart them and click OK.
  13. Check whether the version of the OS is Windows desktop.
    • If yes, go to 15.
    • If no, go to 14.
    +
  14. In the Completed the Cloudbase-Init Setup Wizard window, ensure that neither option is selected.
    Figure 2 Completing the Cloudbase-Init installation
    +

    The version number shown in the figure is for reference only.

    +
    +
  15. Click Finish.
+
+

Configure Cloudbase-Init

  1. Edit the configuration file C:\Program Files\Cloudbase Solutions\Cloudbase-Init\conf\cloudbase-init.conf in the Cloudbase-Init installation path.
    1. Add netbios_host_name_compatibility=false to the last line of the file so that the hostname supports a maximum of 63 characters.

      NetBIOS contains no more than 15 characters due to Windows system restrictions.

      +
      +
    2. Add metadata_services=cloudbaseinit.metadata.services.httpservice.HttpService to enable the agent to access the IaaS OpenStack data source.
    3. (Optional) Add the following configuration items to configure the number of retry times and interval for obtaining metadata:
      retry_count=40
+retry_count_interval=5
      +
    4. (Optional) Add the following configuration item to prevent metadata network disconnections caused by the default route added by Windows:
      [openstack]
+add_metadata_private_ip_route=False
      +
    5. (Optional) When the Cloudbase-Init version is 0.9.12 or later, you can customize the length of the password.

      Change the value of user_password_length to customize the password length.

      +
    +
  2. Release the current DHCP address so that the created ECSs can obtain correct addresses.

    In the Windows command line, run the following command to release the current DHCP address:

    +

    ipconfig /release

    +

    This operation will interrupt network connection and adversely affect ECS use. The network will automatically recover after the ECSs are started again.

    +
    +
  3. When creating an image using a Windows ECS, you need to change the SAN policy of the ECS to OnlineAll. Otherwise, EVS disks attached to the ECSs created from the image may be offline.

    Windows has three types of SAN policies: OnlineAll, OfflineShared, and OfflineInternal.

    + +
    + + + + + + + + + + + + + +
    Table 1 SAN policies

    Type

    +

    Description

    +

    OnlineAll

    +

    All newly detected disks are automatically brought online.

    +

    OfflineShared

    +

    All disks on sharable buses, such as iSCSI and FC, are left offline by default, while disks on non-sharable buses are kept online.

    +

    OfflineInternal

    +

    All newly detected disks are left offline.

    +
    +
    +
    1. Execute cmd.exe and run the following command to query the current SAN policy of the ECS using DiskPart:

      diskpart

      +
    2. Run the following command to view the SAN policy of the ECS:
      san
      • If the SAN policy is OnlineAll, run the exit command to exit DiskPart.
      +
      +
      • If the SAN policy is not OnlineAll, go to 3.c.
      +
    3. Run the following command to change the SAN policy of the ECS to OnlineAll:

      san policy=onlineall

      +
    +
+
+
+
+
+
Parent topic: Windows Operations
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0030730603.html b/docs/ims/umn/en-us_topic_0030730603.html new file mode 100644 index 000000000..4d223ea99 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030730603.html @@ -0,0 +1,127 @@ + + +

Installing Cloud-Init

+

Scenarios

To ensure that you can use the user data injection function to inject initial custom information into ECSs created from a private image (such as setting the ECS login password), install Cloud-Init on the ECS used to create the image.

+ +
+

Prerequisites

+
+

Procedure

  1. Check whether Cloud-Init has been installed.

    For details, see Check Whether Cloud-Init Has Been Installed.

    +
  2. Install Cloud-Init.

    You can install Cloud-Init using either of the following methods: (Recommended) Install Cloud-Init Using the Official Installation Package and Install Cloud-Init Using the Official Source Code Package and pip.

    +
+
+

Check Whether Cloud-Init Has Been Installed

Perform the operations provided here to check whether Cloud-Init has been installed.

+

The methods of checking whether Cloud-Init is installed vary depending on the OSs. Take CentOS 6 as an example. Run the following command to check whether Cloud-Init is installed:

+

rpm -qa |grep cloud-init

+

If information similar to the following is displayed, Cloud-Init has been installed:

+
cloud-init-0.7.5-10.el6.centos.2.x86_64
+
If Cloud-Init has been installed, perform the following operations:
  • Check whether to use the certificate in the ECS OS. If the certificate is no longer used, delete it.
    • If the certificate is stored in a directory of user root, for example, /$path/$to/$root/.ssh/authorized_keys, run the following commands:

      cd /root/.ssh

      +

      rm authorized_keys

      +
    • If the certificate is not stored in a directory of user root, for example, /$path/$to/$none-root/.ssh/authorized_keys, run the following commands:

      cd /home/centos/.ssh

      +

      rm authorized_keys

      +
    +
  • Run the following command to delete the cache generated by Cloud-Init and ensure that the ECS created from the private image can be logged in by using the certificate:

    sudo rm -rf /var/lib/cloud/*

    +
+

Do not restart the ECS after performing the configuration. Otherwise, you need to configure it again.

+
+
+
+

(Recommended) Install Cloud-Init Using the Official Installation Package

The method of installing Cloud-Init on an ECS varies depending on the OS. Perform the installation operations as user root.

+

The following describes how to install Cloud-Init on an ECS running SUSE Linux, CentOS, Fedora, Debian, and Ubuntu. For other OS types, install the required type of Cloud-Init. For example, you need to install coreos-cloudinit on ECSs running CoreOS.

+ +
+

Install Cloud-Init Using the Official Source Code Package and pip

The following operations use Cloud-Init 0.7.9 as an example to describe how to install Cloud-Init.

+
  1. Download the cloud-init-0.7.9.tar.gz source code package (version 0.7.9 is recommended) and upload it to the /home/ directory of the ECS.

    Download cloud-init-0.7.9.tar.gz from the following path:

    +

    https://launchpad.net/cloud-init/trunk/0.7.9/+download/cloud-init-0.7.9.tar.gz

    +
  2. Create a pip.conf file in the ~/.pip/ directory and edit the following content:

    If the ~/.pip/ directory does not exist, run the mkdir ~/.pip command to create it.

    +
    +
    [global]
+index-url  = https://<$mirror>/simple/
+trusted-host = <$mirror>
    +

    Replace <$mirror> with a public network PyPI source.

    +

    Public network PyPI source: https://pypi.python.org/

    +
    +
  3. Run the following command to install the downloaded Cloud-Init source code package (select --upgrade as needed during installation):

    pip install [--upgrade] /home/cloud-init-0.7.9.tar.gz

    +
  4. Run the cloud-init -v command. Cloud-Init is installed successfully if the following information is displayed:
    cloud-init 0.7.9
    +
  5. Enable Cloud-Init to automatically start upon system boot.
    • If the OS uses SysVinit to manage automatic start of services, run the following commands:

      chkconfig --add cloud-init-local; chkconfig --add cloud-init; chkconfig --add cloud-config; chkconfig --add cloud-final

      +

      chkconfig cloud-init-local on; chkconfig cloud-init on; chkconfig cloud-config on; chkconfig cloud-final on

      +

      service cloud-init-local status; service cloud-init status; service cloud-config status; service cloud-final status

      +
    • If the OS uses Systemd to manage automatic start of services, run the following commands:

      systemctl enable cloud-init-local.service cloud-init.service cloud-config.service cloud-final.service

      +

      systemctl status cloud-init-local.service cloud-init.service cloud-config.service cloud-final.service

      +
    +
+

If you install Cloud-Init using the official source code package and pip, pay attention to the following:

+
  1. Add user syslog to the adm group during the installation. If user syslog exists, add it to the adm group. For some OSs (such as CentOS and SUSE), user syslog may not exist. Run the following commands to create user syslog and add it to the adm group:

    useradd syslog

    +

    groupadd adm

    +

    usermod -g adm syslog

    +
  2. Change the value of distro in system_info in the /etc/cloud/cloud.cfg file based on the OS release version, such as distro: ubuntu, distro: sles, distro: debian, and distro: fedora.
+
+
+
+
+
+
Parent topic: Linux Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0030742197.html b/docs/ims/umn/en-us_topic_0030742197.html new file mode 100644 index 000000000..dd466662e --- /dev/null +++ b/docs/ims/umn/en-us_topic_0030742197.html @@ -0,0 +1,20 @@ + + +

Why Is Sysprep Required for Creating a Private Image from a Windows ECS?

+

Why Is Sysprep Required?

For a user that needs to be added to a domain and uses the domain account to log in to Windows, Sysprep is required before a private image is created. Otherwise, the image will contain information about the original ECS, especially the SID. ECSs with the same SID cannot be added to a domain. If Windows does not require any user or ECS to be added to a domain, you do not need to run Sysprep.

+
+
+
+

Restrictions on Running Sysprep

Sysprep can only be used for configuring a new Windows installation. You can run Sysprep multiple times to install and configure Windows. However, you can reset and activate a Windows OS only three times, and you are not allowed to use Sysprep to re-configure an existing Windows OS.

+

In the Windows command line, enter the following command to check how many times you can run Sysprep in the displayed Windows Script Host dialog box:

+

slmgr /dlv

+

If the value of Remaining Windows rearm count is 0, you cannot run Sysprep.

+
+
+
+
+
+
Parent topic: Image Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032042416.html b/docs/ims/umn/en-us_topic_0032042416.html new file mode 100644 index 000000000..41969a91c --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042416.html @@ -0,0 +1,31 @@ + + +

Sharing Images

+
+
+ + +
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032042417.html b/docs/ims/umn/en-us_topic_0032042417.html new file mode 100644 index 000000000..eae05838a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042417.html @@ -0,0 +1,19 @@ + + +

Overview

+

You can share your private images with other tenants. The tenants who accept the shared images can use the images to create ECSs of the same specifications.

+

Constraints

+
+

Procedure

If you want to share a private image with another tenant, the procedure is as follows:

+
  1. You obtain the project ID from the tenant.
  2. You share an image with the tenant.
  3. The tenant accepts the shared image.

    After accepting the image, the tenant can use it to create ECSs.

    +
+
+

Related FAQs

If you have any questions, see Image Sharing FAQs.

+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032042418.html b/docs/ims/umn/en-us_topic_0032042418.html new file mode 100644 index 000000000..18cf5282a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042418.html @@ -0,0 +1,25 @@ + + +

Obtaining the Project ID

+

Scenarios

Before a tenant shares an image with you, you need to provide your project ID.

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the username in the upper right corner and select My Credentials from the drop-down list.

    On the My Credentials page, view the project ID in the project list.

    +
    Figure 1 Viewing the project ID
    +
+
+
+
+
+
Parent topic: Sharing Images
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0032042419.html b/docs/ims/umn/en-us_topic_0032042419.html new file mode 100644 index 000000000..4506083a1 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042419.html @@ -0,0 +1,30 @@ + + +

Sharing Specified Images

+

Scenarios

After obtaining the project ID from a tenant, you can share specified private images with the tenant. You can share a single image or multiple images as needed.

+
+

Prerequisites

+
+

Procedure

+
+

Related Operations

After you share images with a tenant, the tenant can accept the shared images on the Images Shared with Me page on the IMS console. For detailed operations, see Accepting or Rejecting Shared Images.

+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032042420.html b/docs/ims/umn/en-us_topic_0032042420.html new file mode 100644 index 000000000..0af7c56b6 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042420.html @@ -0,0 +1,31 @@ + + +

Accepting or Rejecting Shared Images

+

Scenarios

After another tenant shares images with you, you will receive a message. You can choose to accept or reject all or some of the shared images.

+

If you are not in the same region as the tenant sharing the images with you, you will not receive the message.

+
+
+

Prerequisites

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Images Shared with Me tab.

    A message is displayed above the image list asking you whether to accept the shared images.

    +
    • To accept all the shared images, click Accept All in the upper right corner.
    • To accept some images, select the images and click Accept.
    • To reject some images, select the images and click Reject.
    +

    If no message is displayed, check whether you have selected a correct region.

    +
    +
  3. (Optional) In the Accept Full-ECS Image dialog box, select a server backup vault with the Backup protection type and click OK.

    This dialog box is displayed when the shared image is a full-ECS image.

    +

    When accepting a full-ECS image, you must specify a vault for storing the CBR backups associated with the full-ECS image. The vault capacity must be no less than the total capacities of the system disk and data disk backups.

    +

    For more information about server backup vaults, see Cloud Backup and Recovery User Guide.

    +
    +
+
+

Results

+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032042421.html b/docs/ims/umn/en-us_topic_0032042421.html new file mode 100644 index 000000000..d0b2183fb --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042421.html @@ -0,0 +1,20 @@ + + +

Rejecting Accepted Images

+

Scenarios

You can reject accepted images if you no longer need them.

+

After an image is rejected, it will not be displayed on the Images Shared with Me page.

+
+

Prerequisites

You have accepted images shared by other users.

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Images Shared with Me tab.
  3. Determine the next step based on how many images you are to reject.
    • To reject multiple images: select the images to be rejected and click Reject above the image list. In the displayed dialog box, click Yes.
    • To reject a specific image: locate the image to be rejected and click Reject in the Operation column. In the displayed dialog box, click Yes.
    +
+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032042422.html b/docs/ims/umn/en-us_topic_0032042422.html new file mode 100644 index 000000000..a9f3d6cb6 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042422.html @@ -0,0 +1,19 @@ + + +

Stopping Sharing Images

+

Scenarios

You can stop sharing images. After you stop sharing an image:

+ +
+

Prerequisites

You have shared private images with others.

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab.
  3. Locate the row that contains the private image that you no longer want to share, and choose More > Share in the Operation column.
  4. In the Share Image dialog box, click the Stop Sharing tab.
  5. Select the project ID that you want to stop image sharing and click OK.
+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032042423.html b/docs/ims/umn/en-us_topic_0032042423.html new file mode 100644 index 000000000..2d7fa1c7d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032042423.html @@ -0,0 +1,19 @@ + + +

Adding Tenants Who Can Use Shared Images

+

Scenarios

In addition to the tenants you have shared images with, you can add more tenants who can use the shared images.

+
+

Prerequisites

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab.
  3. Click the image name to view image details.
  4. Click Add Tenant.
  5. In the Add Tenant dialog box, enter the project ID of the tenant to be added and click OK.

    To add multiple tenants, enter their project IDs and separate them with commas. Click OK.

    +
+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032087324.html b/docs/ims/umn/en-us_topic_0032087324.html new file mode 100644 index 000000000..33081af2f --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032087324.html @@ -0,0 +1,19 @@ + + +

Deleting Image Recipients Who Can Use Shared Images

+

Scenarios

This section describes how to delete image recipients who can use shared images.

+
+

Prerequisites

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab.
  3. Click the image name to view image details.
  4. View the tenants who can use shared image.
  5. Delete one or all of the recipients:
    • To delete a single image recipient, locate the target recipient and click Delete.
    • To delete all image recipients, click Delete All above the image recipient list.
    +
  6. Click Yes.
+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0032307025.html b/docs/ims/umn/en-us_topic_0032307025.html new file mode 100644 index 000000000..7237b31fd --- /dev/null +++ b/docs/ims/umn/en-us_topic_0032307025.html @@ -0,0 +1,18 @@ + + +

What Will the System Do to an Image File When I Use the File to Register a Private Image?

+

You are advised to enable automatic configuration when registering a private image using an image file. Then, the system will perform the following operations:

+

Linux

+

For the following image files, the system does not copy this driver after Enable automatic configuration is selected:

+
  • Image files whose /usr directory is an independent partition
  • Fedora 29 64bit, Fedora 30 64bit, and CentOS 8.0 64bit image files that use the XFS file system
  • SUSE 12 SP4 64bit image files that use the ext4 file system
+
+
+

Windows

+
+
+
+
+
Parent topic: Image Optimization
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0034011241.html b/docs/ims/umn/en-us_topic_0034011241.html new file mode 100644 index 000000000..2cc27644b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0034011241.html @@ -0,0 +1,40 @@ + + +

Exporting an Image

+

Scenarios

You can export a private image to a standard OBS bucket and then download it to your local PC.

+
+

Background

+
+

Constraints

+
+

Prerequisites

An OBS bucket is available in the region where the private image is located.

+

If no OBS bucket is available, create one by referring to Object Storage Service User Guide. Select Standard for Storage Class.

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Locate the row that contains the image to be exported, click More in the Operation column and select Export.
  3. In the displayed Export Image dialog box, set the following parameters:
    • Fast Export: To export an image larger than 128 GB, you must enable fast export, and you cannot specify the format of the exported image (which can only be ZVHD2). After exporting the image, you can use qemu-img-hw to convert it to your desired format. For details, see Converting the Image Format Using qemu-img-hw.

      For details about differences between export and fast export, see What Are the Differences Between Import/Export and Fast Import/Export?

      +
      +
    • Format: Select one from qcow2, vmdk, vhd, and zvhd as you need.
    • Name: Enter a name that is easy to identify.
    • Storage Path: Click to expand the bucket list and select an OBS bucket for storing the exported image.
    +
  4. Click OK.

    You can view the image export progress above the private image list.

    +
+
+

Follow-up Procedure

After the image is exported successfully, you can download it from the OBS bucket through the management console or OBS Browser+.

+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0034220644.html b/docs/ims/umn/en-us_topic_0034220644.html new file mode 100644 index 000000000..cd847c034 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0034220644.html @@ -0,0 +1,99 @@ + + +

What Do I Do If No Partition Is Found During the Startup of an ECS Created from an Imported Private Image?

+

Symptom

This may be caused by a disk partition ID change after the cross-platform image import. As a result, no partition can be found based on the original disk partition ID in the image. In this case, you need to change the disk partition in the image (UUID=UUID of the disk partition).

+
+

Solution

The following uses openSUSE 13.2 as an example to describe how to change the partition name.

+
  1. Run the following command to query the disk partition ID:

    ls -l /dev/disk/by-id/

    +

    The example command output is as follows.

    +
    total 0
+lrwxrwxrwx 1 root root 10 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001 -> ../../xvda
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part1 -> ../../xvda1
+lrwxrwxrwx 1 root root 12 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part10 -> ../../xvda10
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part2 -> ../../xvda2
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part5 -> ../../xvda5
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part6 -> ../../xvda6
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part7 -> ../../xvda7
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part8 -> ../../xvda8
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ata-QEMU_HARDDISK_QM00001-part9 -> ../../xvda9
+lrwxrwxrwx 1 root root 10 Jul 22 01:35 ata-QEMU_HARDDISK_QM00005 -> ../../xvde
+lrwxrwxrwx 1 root root 10 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001 -> ../../xvda
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part1 -> ../../xvda1
+lrwxrwxrwx 1 root root 12 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part10 -> ../../xvda10
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part2 -> ../../xvda2
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part5 -> ../../xvda5
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part6 -> ../../xvda6
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part7 -> ../../xvda7
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part8 -> ../../xvda8
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00001-part9 -> ../../xvda9
+lrwxrwxrwx 1 root root 10 Jul 22 01:35 scsi-SATA_QEMU_HARDDISK_QM00005 -> ../../xvde
    +

    ata-QEMU_HARDDISK_xxx and scsi-SATA_QEMU_HARDDISK_xxx indicate that the disk of the ECS is simulated using Quick EMUlator (QEMU). The content on the left of -> is the disk partition ID, and that on the right of -> is the partition name.

    +
  2. Run the following command to query the disk partition UUID:

    ls -l /dev/disk/by-uuid/

    +

    The example command output is as follows.

    +
    total 0
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 45ecd7a0-29da-4402-a017-4564a62308b8 -> ../../xvda5
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 55386c6a-9e32-41d4-af7a-e79596221f51 -> ../../xvda9
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 55f36660-9bac-478c-a701-7ecc5347f789 -> ../../xvda8
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 780f36bc-0ada-4c98-9a8d-44570d65333d -> ../../xvda1
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 b3b7c47f-6a91-45ef-80d6-275b1cc16e19 -> ../../xvda6
+lrwxrwxrwx 1 root root 11 Jul 22 01:35 ea63b55d-3b6e-4dcd-8986-956b72bac3e9 -> ../../xvda7
+lrwxrwxrwx 1 root root 12 Jul 22 01:35 eb3cc645-925e-4bc5-bedf-c2a6f3b65809 -> ../../xvda10
    +

    The content on the left of -> is the disk partition UUID, and that on the right of -> is the partition name. Obtain the relationship between the disk partition name, partition ID, and partition UUID.

    +
  3. Run the following command to check the partition names in the /etc/fstab file:

    vi /etc/fstab

    +

    The example command output is as follows.

    +
    /dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part5 / ext3 defaults,errors=panic 1 1
+/dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part1 /boot ext3 defaults,errors=panic 1 2
+/dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part6 /home ext3 nosuid,errors=panic 1 2
+/dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part10 /opt ext3 defaults,errors=panic 1 2
+/dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part7 /tmp ext3 nodev,nosuid,errors=panic 1 2
+/dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part9 /usr ext3 defaults,errors=panic 1 2
+/dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part8 /var ext3 nodev,nosuid,errors=panic 1 2
+sysfs /sys sysfs noauto 0 0
+proc /proc proc defaults 0 0
+usbfs /proc/bus/usb usbfs noauto 0 0
+devpts /dev/pts devpts mode=0620,gid=5 0 0
+/dev/cdrom /media/ udf,iso9660 noexec,noauto,nouser,nodev,nosuid 1 2
+tmpfs /dev/shm tmpfs noexec,nodev,nosuid 0 0
    +

    The values in the first column are the disk partition IDs.

    +
  4. Press i to enter editing mode. Change the disk partition ID in the row that contains /dev/disk/xxx in the /etc/fstab file in step 3 to UUID=UUID of the disk partition based on the query results in step 1 and step 2.
    The modified content is as follows.
    UUID=45ecd7a0-29da-4402-a017-4564a62308b8 / ext3 defaults,errors=panic 1 1
+UUID=780f36bc-0ada-4c98-9a8d-44570d65333d /boot ext3 defaults,errors=panic 1 2
+UUID=b3b7c47f-6a91-45ef-80d6-275b1cc16e19 /home ext3 nosuid,errors=panic 1 2
+UUID=eb3cc645-925e-4bc5-bedf-c2a6f3b65809 /opt ext3 defaults,errors=panic 1 2
+UUID=ea63b55d-3b6e-4dcd-8986-956b72bac3e9 /tmp ext3 nodev,nosuid,errors=panic 1 2
+UUID=55386c6a-9e32-41d4-af7a-e79596221f51 /usr ext3 defaults,errors=panic 1 2
+UUID=55f36660-9bac-478c-a701-7ecc5347f789 /var ext3 nodev,nosuid,errors=panic 1 2
+sysfs /sys sysfs noauto 0 0
+proc /proc proc defaults 0 0
+usbfs /proc/bus/usb usbfs noauto 0 0
+devpts /dev/pts devpts mode=0620,gid=5 0 0
+/dev/cdrom /media/ udf,iso9660 noexec,noauto,nouser,nodev,nosuid 1 2
+tmpfs /dev/shm tmpfs noexec,nodev,nosuid 0 0
    +
    +

    Ensure that the UUIDs are correct. Otherwise, the ECS cannot start properly.

    +
    +
  5. Press Esc, enter :wq, and press Enter. The system saves the configuration and exits the vi editor.
  6. Check the partition names in the system boot configuration file.

    The system boot configuration files vary depending on the OS. Confirm the boot configuration file of the current OS.

    +
    • Grand Unified Boot Loader (GRUB) configuration file
      • /boot/grub/grub.conf
      • /boot/grub/menu.lst
      • /boot/grub/grub.cfg
      • /boot/grub2/grub.cfg
      +
    • Syslinux configuration file
      • /extlinux.conf
      • /boot/syslinux/extlinux.conf
      • /boot/extlinux/extlinux.conf
      • /boot/syslinux/syslinux.cfg
      • /syslinux/syslinux.cfg
      • /syslinux.cfg
      +
    +

    The boot file in this example is /boot/grub/menu.lst. Run the following command to check it:

    +

    vi /boot/grub/menu.lst

    +
    default 0
+timeout 3
+title xxx Server OS - xxxxxx
+kernel /boot/vmlinuz-3.0.101-0.47.52-default root=/dev/disk/by-id/scsi-SATA_QEMU_HARDDISK_QM00001-part5 resume= memmap=0x2000000$0x3E000000 nmi_watchdog=2 crashkernel=512M-:256M console=ttyS0,115200 console=tty0 xen_emul_unplug=all
+initrd /boot/initrd-3.0.101-0.47.52-default
    +
  7. Press i to enter editing mode and change the partition names in the system boot configuration file.

    Change the disk partition name in the /boot/grub/menu.lst file in 6 to UUID=UUID of the disk partition based on the query results in 1 and 2.

    +
    default 0
+timeout 3
+title xxx Server OS - xxxxxx
+kernel /boot/vmlinuz-3.0.101-0.47.52-default root=UUID=45ecd7a0-29da-4402-a017-4564a62308b8 resume= memmap=0x2000000$0x3E000000 nmi_watchdog=2 crashkernel=512M-:256M console=ttyS0,115200 console=tty0 xen_emul_unplug=all
+initrd /boot/initrd-3.0.101-0.47.52-default
    +
  8. Press Esc, enter :wq, and press Enter. The system saves the configuration and exits the vi editor.
+
+
+
+
+
Parent topic: ECS Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0037352059.html b/docs/ims/umn/en-us_topic_0037352059.html new file mode 100644 index 000000000..fbcc1ff82 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0037352059.html @@ -0,0 +1,101 @@ + + +

Obtaining Required Software Packages

+

PV Driver

Table 1 lists the PV driver software packages required for optimizing Windows private images.

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 PV driver software packages

Software Package

+

OS

+

How to Obtain

+

pvdriver-win2008R2-64bit.exe

+

Windows Server 2008 R2 64bit

+

https://osdriver.obs.eu-de.otc.t-systems.com/pvdriver/windows/pvdriver-win2008R2-64bit.exe

+

pvdriver-win2012R2-64bit.exe

+

Windows Server 2012 R2 64bit

+

https://osdriver.obs.eu-de.otc.t-systems.com/pvdriver/windows/pvdriver-win2012R2-64bit.exe

+

pvdriver-win2016-64bit.exe

+

Windows Server 2016 64bit

+

https://osdriver.obs.eu-de.otc.t-systems.com/pvdriver/windows/pvdriver-win2016-64bit.exe

+

pvdriver-win2019-64bit.exe

+

Windows Server 2019 64bit

+

https://osdriver.obs.eu-de.otc.t-systems.com/pvdriver/windows/pvdriver-win2019-64bit.exe

+

pvdriver-win7-64bit.exe

+

Windows 7 64bit

+

https://osdriver.obs.eu-de.otc.t-systems.com/pvdriver/windows/pvdriver-win7-64bit.exe

+

pvdriver-win10-64bit.exe

+

Windows 10 64bit

+

https://osdriver.obs.eu-de.otc.t-systems.com/pvdriver/windows/pvdriver-win10-64bit.exe

+
+
+
+

UVP VMTools

Table 2 lists the UVP VMTools software packages required for optimizing Windows private images.

+ +
+ + + + + + + + + + + + + + + + + +
Table 2 UVP VMTools software packages

Software Package

+

OS

+

How to Obtain

+

vmtools-WIN2008R2-x64.exe

+

Windows Server 2008 R2

+

https://obs.eu-de.otc.t-systems.com/osdriver/vmtools/windows/vmtools-WIN2008R2-x64.exe

+

vmtools-WIN2012-x64.exe

+

Windows Server 2012 R2

+

https://obs.eu-de.otc.t-systems.com/osdriver/vmtools/windows/vmtools-WIN2012R2-x64.exe

+

vmtools-WIN2016-x64.exe

+
  • Windows Server 2016
  • Windows Server 2019
+

https://obs.eu-de.otc.t-systems.com/osdriver/vmtools/windows/vmtools-WIN2016-x64.exe

+
+
+
+
+
+
+
Parent topic: Optimizing a Windows Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0037352060.html b/docs/ims/umn/en-us_topic_0037352060.html new file mode 100644 index 000000000..f288f9d9a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0037352060.html @@ -0,0 +1,13 @@ + + +

What Do I Do If I Cannot Share My Images?

+
Cause 1: Some images cannot be shared in any cases (the Share button in the Operation column for these images is unavailable), such as: +
+

Cause 2: Images can only be shared within the same region. If you are attempting to share an image across regions, your attempt will fail.

+
+
+
+
Parent topic: Image Sharing
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0037352061.html b/docs/ims/umn/en-us_topic_0037352061.html new file mode 100644 index 000000000..676692703 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0037352061.html @@ -0,0 +1,42 @@ + + +

Installing UVP VMTools

+

Scenarios

Before using an ECS or external image file to create a private image, ensure that UVP VMTools has been installed in the OS to enable subsequently created ECSs to support KVM virtualization and improve network performance.

+

If you do not install UVP VMTools, NICs of the ECS may not be detected and the ECS cannot communicate with other resources.

+
+

UVP VMTools has been installed by default when you use a public image to create ECSs. You can perform the following operations to verify the installation:

+

Open the version configuration file to check whether UVP VMTools is the latest:

+

C:\Program Files (x86)\virtio\bin\version

+

If the version is 2.5.0 or later, the current UVP VMTools can be used. Otherwise, perform operations in Installing UVP VMTools to install UVP VMTools.

+
+

Prerequisites

+
+

Installing UVP VMTools

The following operations describe how to install UVP VMTools. vmtools-WIN2008R2-x64.exe extracted from vmtools-WIN2008R2-x64.zip is used as an example.

+
  1. Log in to the Windows ECS using VNC.

    For details about how to log in to an ECS, see Elastic Cloud Server User Guide.

    +

    You must log in to the ECS using VNC. Remote desktop connection is not allowed because the NIC driver needs to be updated during the installation but the NIC is in use for the remote desktop connection. As a result, the installation will fail.

    +
    +
  2. Download the required UVP VMTools based on the ECS OS and Obtaining Required Software Packages.
  3. Decompress the UVP Tools software package. This section uses vmtools-WIN2008R2-x64.exe extracted from vmtools-WIN2008R2-x64.zip as an example to describe how to decompress the UVP Tools software package.
  4. Right-click vmtools-WIN2008R2-x64.exe, select Run as administrator from the shortcut menu, and complete the installation as prompted.
  5. In the displayed dialog box, select I accept the terms in the License Agreement and click Install.
    Figure 1 Installing UVP VMTools
    +
  6. Install UVP VMTools as prompted.
  7. Perform the following operations to install UVP VMTools on an ECS running Windows Server 2008:
    1. The Windows Security dialog box shown in Figure 2 may be displayed during installation. In the dialog box, select Always trust... and click Install. Otherwise, the installation will fail.
      Figure 2 Windows Security
      +
    2. Click Finish.
    +
  8. Perform the operations in Verifying the Installation to check whether UVP VMTools is successfully installed.
+
+

Verifying the Installation

Perform the following steps to verify the installation of UVP VMTools:

+
  1. Click Start. Choose Control Panel > Programs and Features.
  2. Locate UVP VMTools for Windows.
    If UVP VMTools for Windows exists, the installation is successful, as shown in Figure 3.
    Figure 3 Verifying the installation
    +
    +
+
+
+
+
+
Parent topic: Optimizing a Windows Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0037352182.html b/docs/ims/umn/en-us_topic_0037352182.html new file mode 100644 index 000000000..3d651495d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0037352182.html @@ -0,0 +1,41 @@ + + +

Installing the PV Driver

+

Scenarios

When using an ECS or external image file to create a private image, ensure that the PV driver has been installed in the OS to enable Xen virtualization for subsequently created ECSs, improve the I/O processing performance of the ECSs, and implement advanced functions such as monitoring hardware of the ECSs.

+

If you do not install the PV driver, the ECS network performance will be poor, and the security group and firewall configured for the ECS will not take effect.

+
+

The PV driver has been installed by default when you use a public image to create ECSs. You can perform the following operations to verify the installation:

+

Open the version configuration file to check whether the PV driver is the latest:

+
C:\Program Files (x86)\Xen PV Drivers\bin\version
  • If the PV driver version is later than 2.5, you do not need to install the PV driver.
  • If the PV driver version is not displayed or the version is 2.5 or earlier, perform operations in Installing the PV Driver.
+
+
+

Prerequisites

+
+

Installing the PV Driver

  1. Log in to the Windows ECS using VNC.

    For details about how to log in to an ECS, see Elastic Cloud Server User Guide.

    +

    You must log in to the ECS using VNC. Remote desktop connection is not allowed because the NIC driver needs to be updated during the installation but the NIC is in use for the remote desktop connection. As a result, the installation will fail.

    +
    +
  2. On the ECS, choose Start > Control Panel.
  3. Click Uninstall a program.
  4. Uninstall GPL PV drivers for Windows x.x.x.xx as prompted.
  5. Download the required PV driver based on the ECS OS and Obtaining Required Software Packages.
  6. Decompress the PV driver software package.
  7. Right-click GPL PV Drivers for Windows x.x.x.xx, select Run as administrator, and complete the installation as prompted.
  8. Restart the ECS as prompted to make the PV driver take effect.

    ECSs running Windows Server 2008 must be restarted twice.

    +

    After the PV driver is installed, the ECS NIC configuration will be lost. If you have configured NICs before, you need to configure them again.

    +
    +
+
+

Verifying the Installation

Perform the following steps to verify the installation of the PV driver:

+
  1. Click Start. Choose Control Panel > Programs and Features.
  2. Locate the PV driver for Windows.

    If the PV driver exists, the installation is successful, as shown in Figure 1.

    +
    Figure 1 Verifying the installation
    +
+
+
+
+
+
Parent topic: Optimizing a Windows Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0037352185.html b/docs/ims/umn/en-us_topic_0037352185.html new file mode 100644 index 000000000..12f760cd2 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0037352185.html @@ -0,0 +1,23 @@ + + +

Viewing the Virtualization Type of a Linux ECS

+

You can run the following command to query the virtualization type of an ECS:

+

lscpu

+

If the value of Hypervisor vendor is Xen, the ECS uses Xen. If KVM is required, perform the operations in this section to optimize the Linux private image.

+

If the ECS uses KVM, you are also advised to optimize the private image to prevent any exceptions with the ECSs created from the image.

+
+
Figure 1 Viewing the virtualization type of a Linux ECS
+
+
+
+
Parent topic: Optimizing a Linux Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0037352186.html b/docs/ims/umn/en-us_topic_0037352186.html new file mode 100644 index 000000000..e5fc8123c --- /dev/null +++ b/docs/ims/umn/en-us_topic_0037352186.html @@ -0,0 +1,34 @@ + + +

Uninstalling the PV Driver from a Linux ECS

+

Scenarios

When optimizing a Linux private image, you need to change the UUID in the fstab and GRUB configuration files, and install native Xen and KVM drivers on the ECS. To ensure that you can successfully install native Xen and KVM drivers, you must uninstall the PV driver from the ECS.

+
+

Procedure

  1. Log in to the ECS as user root using VNC.
  2. Run the following command to check whether the PV driver is installed in the OS:

    ps -ef | grep uvp-monitor

    +

    The PV driver is installed in the OS if the following information is displayed:

    +
    root     4561        1    0   Jun29 ?           00:00:00   /usr/bin/uvp-monitor
+root     4567     4561    0   Jun29 ?           00:00:00   /usr/bin/uvp-monitor
+root     6185     6085    0   03:04  pts/2      00:00:00   grep uvp-monitor
    + +
  3. In the VNC login window, open the CLI.

    For how to open the CLI, see the OS manual.

    +
  4. Run the following command to uninstall the PV driver:

    /etc/.uvp-monitor/uninstall

    +
    • The PV driver is uninstalled successfully if the following command output is displayed:
      The PV driver is uninstalled successfully. Reboot the system for the uninstallation to take effect.
      +
    • If .uvp-monitor is not contained in the command output, go to 5.
      -bash: /etc/.uvp-monitor/uninstall: No such file or directory
      +
    +
  5. Perform the following operations to delete uvp-monitor that failed to take effect, preventing log overflow:
    1. Run the following command to check whether UVP user-mode programs are installed in the OS:

      rpm -qa | grep uvp

      +

      Information similar to the following is displayed:

      +
      libxenstore_uvp3_0-3.00-36.1.x86_64
+uvp-monitor-2.2.0.315-3.1.x86_64
+kmod-uvpmod-2.2.0.315-3.1.x86_64
      +
    2. Run the following commands to delete the installation packages:

      rpm -e kmod-uvpmod

      +

      rpm -e uvp-monitor

      +

      rpm -e libxenstore_uvp

      +
    +
+
+
+
+
+
Parent topic: Optimizing a Linux Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0040740508.html b/docs/ims/umn/en-us_topic_0040740508.html new file mode 100644 index 000000000..22676330e --- /dev/null +++ b/docs/ims/umn/en-us_topic_0040740508.html @@ -0,0 +1,118 @@ + + +

How Do I Configure an ECS, BMS, or Image File Before I Use It to Create an Image?

+

ECS or Image File Configurations

+
+ + + + + + + + + + + + + +
Table 1 ECS configurations

OS

+

Configuration

+

Reference

+

Windows

+
  • Set the NIC to DHCP.
  • Enable remote desktop connection.
  • (Optional) install special Windows drivers.
  • (Optional) Install Cloudbase-Init.
  • Install the Guest OS drivers, including the PV driver and UVP VMTools.
  • Run Sysprep.
+

Creating a System Disk Image from a Windows ECS

+

Linux

+
  • Set the NIC to DHCP.
  • (Optional) install special Linux drivers.
  • (Optional) Install Cloud-Init.
  • Delete files from the network rule directory.
  • Change the disk identifier in the GRUB configuration file to UUID.
  • Change the disk identifier in the fstab file to UUID.
  • Install native Xen and KVM drivers.
  • Detach data disks from the ECS.
  • Configure console logging.
+

Creating a System Disk Image from a Linux ECS

+
+
+ +
+ + + + + + + + + + + + + +
Table 2 Image file configurations

OS

+

Configuration Item

+

Reference

+

Windows

+
  • Set the NIC to DHCP.
  • Enable remote desktop connection.
  • Install the Guest OS drivers, including the PV driver and UVP VMTools.
  • (Optional) Install Cloudbase-Init.
  • (Optional) Enable NIC multi-queue.
+

Preparing an Image File

+

Linux

+
  • Delete files from the network rule directory.
  • Set the NIC to DHCP.
  • Install native Xen and KVM drivers.
  • Change the disk identifier in the GRUB configuration file to UUID.
  • Change the disk identifier in the fstab file to UUID.
  • Delete the automatic attachment information of non-system disks from the /etc/fstab file.
  • (Optional) Install Cloud-Init.
  • (Optional) Enable NIC multi-queue.
+

Preparing an Image File

+
+
+
  • When registering an external image file as a private image, you are advised to perform the preceding operations on the VM where the external image file is located.
  • When registering a Windows external image file as a private image, if the Guest OS drivers are installed, the cloud platform will check the image file after you select Enable automatic configuration. If the GuestOS drivers are not installed, the cloud platform will try to install them.
+
+
+

BMS or Image File Configurations

+
+ + + + + + + + + + + + + +
Table 3 BMS configurations

OS

+

Configuration Item

+

Reference

+

Windows

+
  • Install software in the bms-network-config package.
  • Install Cloudbase-Init.
  • Delete residual files from the OS.
+

For details, see "Creating a Private Image from a BMS" in Bare Metal Server User Guide.

+

Linux

+
  • Install software in the bms-network-config package.
  • Install Cloud-Init.
  • Delete residual files from the OS.
+

For details, see "Creating a Private Image from a BMS" in Bare Metal Server User Guide.

+
+
+ +
+ + + + + + + + + + + + + +
Table 4 Image file configurations

OS

+

Configuration Item

+

Reference

+

Windows

+
  • Install drivers for x86 v5 BMSs.
  • Install Cloudbase-Init.
  • Install software in the bms-network-config package.
  • (Optional) Install the SDI iNIC driver.
  • Set the Windows time zone.
  • Set the virtual memory.
  • (Optional) Configure automatic Windows update.
  • Configure SID.
+

Bare Metal Server Image Creation Guide

+

Linux

+
  • Install and configure Cloud-Init.
  • Modify the hardware device driver that boots the OS.
  • Install software in the bms-network-config package.
  • (Optional) Install the SDI iNIC driver.
  • (Optional) Install the Hi1822 NIC driver.
  • (Optional) Install the IB driver.
  • (Optional) Install drivers for x86 V5 BMSs.
  • (Optional) Install the UltraPath software.
  • Perform security configuration.
  • Configure remote login to the BMS.
  • Configure automatic root partition expansion.
+

Bare Metal Server Image Creation Guide

+
+
+
+
+
+
+
Parent topic: Image Optimization
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0041178787.html b/docs/ims/umn/en-us_topic_0041178787.html new file mode 100644 index 000000000..cfeee438d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0041178787.html @@ -0,0 +1,273 @@ + + +

Change History

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Released On

+

Description

+

2021-08-15

+

Added the following content:

+ +

Modified the following content:

+ +

Deleted the following content:

+
  • Marketplace images
+

2020-08-12

+

Added the following content:

+ +

Modified the following content:

+ +

2020-07-20

+

Modified the following content:

+ +

2020-05-26

+

Modified the following content:

+

Added the link for obtaining the UVP VMTools software package for Windows Server 2019 in Obtaining Required Software Packages.

+

2019-03-29

+

Added the following content:

+

What Do I Do If an Exception Occurs When I Start an ECS Created from an Image Using the UEFI Boot Mode?

+

Modified the following content:

+ +

2019-03-28

+

Accepted in OTC-4.0/Agile.

+

2019-01-23

+

Deleted "Image Storage Fee."

+

2018-12-30

+

Added the following content:

+

Added support for external image files using Fedora 29 64bit External Image File Formats and Supported OSs.

+

2018-12-21

+

Modified the following content:

+ +

2018-09-30

+

Added the following content:

+

Added Quickly Importing an Image File.

+
Modified the following content: +
+

2018-08-30

+

Modified the following content:

+

Optimized operations in Accepting or Rejecting Shared Images.

+

2018-07-30

+

Added the following content:

+

Added more OS types for external image files, including openSUSE 15 64bit, SUSE 15 64bit, EulerOS 2.1 64bit, and EulerOS 2.3 64bit in External Image File Formats and Supported OSs.

+

2018-07-10

+

Accepted in Agile-07.2018.

+

2018-07-05

+

Modified the following content:

+

Modified the restrictions and limitations in sections "Creating a Full-ECS Image Using an ECS" and "Creating a Full-ECS Image Using a CSBS Backup".

+

2018-06-30

+

Added the following content:

+

Converting the Image Format Using qemu-img

+
Modified the following content:
  • Modified sections for creating and registering images due to the modification on the IMS web interface.
  • Added new OSs supported for external image files, including Ubuntu 18.04 64bit, Red Hat 7.5 64bit, Oracle 7.5 64bit, CentOS 7.5 64bit, and Fedora 28 64bit in External Image File Formats and Supported OSs.
+
+

2018-05-30

+
Added the following content: +
+

Modified the following content:

+

Changed Tools for Windows to Guest OS driver.

+

2018-04-30

+

Added the following content:

+

How Do I Delete Redundant Network Connections from a Windows ECS?

+

2018-03-30

+

Added the following content:

+

Creating a Data Disk Image from an ECS

+

2018-02-28

+

Modified the following content:

+

Added support for exporting public images in Exporting Image List.

+

2018-01-30

+

Added the following content:

+

What Do I Do If I Cannot Create an Image in ZVHD2 Format Using an API?

+

Modified the following content:

+

Added new OSs supported for external image files, including Fedora 27 64bit and Debian 9.3 64bit in External Image File Formats and Supported OSs.

+

2017-12-30

+

Added the following content:

+

Common Image Formats

+

Modified the following content:

+

Added support for the VHDX, QED, VDI, and QCOW formats in External Image File Formats and Supported OSs.

+

2017-11-30

+

Added the following content:

+

How Do I Enable NIC Multi-Queue for an Image?

+

2017-10-30

+
Modified the following content:
  • Added the OSs supported for external image files, including Oracle Linux Server release 7.4 64bit, Red Hat Linux Enterprise 7.4 64bit, and CentOS 7.4 64bit in External Image File Formats and Supported OSs.
  • Changed the upper limit of the system disk size of the ECS used to create a private image to 1024 GB.
+
+

2017-09-30

+
Added the following content: +
+

Modified the following content:

+

Added the support for the RAW format in External Image File Formats and Supported OSs.

+

2017-08-30

+

Added the following content:

+

Creating a BMS System Disk Image

+
Modified the following content: +
+

2017-07-29

+

Added the following content:

+

Tagging an Image

+

Modified the following content:

+

Added the method of installing Cloud-Init using pip in Installing Cloud-Init.

+

2017-06-30

+

Modified the following content:

+

Updated the operations performed by the system on image files in What Will the System Do to an Image File When I Use the File to Register a Private Image?

+

2017-05-30

+
Modified the following content: +
+

2017-04-28

+
Added the following content: +
+

Modified the following content:

+

Added support for external image files containing CoreOS 1298.6.0 in External Image File Formats and Supported OSs.

+

2017-03-30

+
Modified the following content: +
+

2017-02-28

+

Added the following content:

+

Replicating Images

+
Modified the following content:
  • Added CentOS 6.5 64bit, CentOS 6.4 64bit, CentOS 6.3 64bit, and Fedora 25 64bit to the supported OSs of public images.
  • Added the OSs supported for external image files, including Windows Server 2016 Standard 64bit, Windows Server 2016 Datacenter 64bit, SUSE Linux Enterprise Server 12 SP2 64bit, Oracle Linux Server release 6.5 64bit, Oracle Linux Server release 7.3 64bit, Red Hat 6.7 64bit, openSUSE 42.2 64bit, CentOS 7.3 64bit, and Fedora 25 64bit in External Image File Formats and Supported OSs.
+
+

2017-02-08

+

Modified the following content:

+

Added support for external image files containing Red Hat 7.3 64bit in External Image File Formats and Supported OSs.

+

2017-01-20

+

Added the following content:

+

Encrypting Images

+
Modified the following content:
  • Added new OSs for public images, including EulerOS 2.2 64bit, CentOS 7.3 64bit, Novell SUSE Enterprise Linux Server 12 SP2 64bit, openSUSE 42.2 64bit, Oracle Linux Server release 7.3 64bit, and Windows Server 2016 Datacenter 64bit.
  • Added new OSs supported for external image files, including SUSE Linux Enterprise Server 12 SP1 64bit, SUSE Linux Enterprise Server 11 SP4 64bit, Oracle Linux Server release 7.0 64bit, Red Hat 7.1 64bit, openSUSE 42.1 64bit, and EulerOS 2.2 64bit in External Image File Formats and Supported OSs.
+
+

2016-12-30

+

Modified the following content:

+

Added support for external image files containing openSUSE 11.3 64bit in External Image File Formats and Supported OSs.

+

2016-11-24

+

Modified the following content:

+

Added support for external image files containing Debian 8.6.0 64bit in External Image File Formats and Supported OSs.

+

2016-10-19

+

Added the following content:

+

Exporting an Image

+

Modified the following content:

+

Updated the OSs supported for public images.

+

2016-07-15

+
Added the following content: +
+

Modified the following content:

+

Updated the OSs supported for public images.

+

2016-03-14

+

This issue is the first official release.

+
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0046588153.html b/docs/ims/umn/en-us_topic_0046588153.html new file mode 100644 index 000000000..fb23f5ad7 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0046588153.html @@ -0,0 +1,17 @@ + + +

Encrypting Images

+
+
+ + +
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0046588154.html b/docs/ims/umn/en-us_topic_0046588154.html new file mode 100644 index 000000000..532f6f661 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0046588154.html @@ -0,0 +1,15 @@ + + +

Overview

+

IMS allows you to create encrypted images to ensure data security.

+

To use the image encryption function, you must apply for KMS Administrator permissions.

+
+

Constraints

+
+
+
+
+
Parent topic: Encrypting Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0046588155.html b/docs/ims/umn/en-us_topic_0046588155.html new file mode 100644 index 000000000..7d7bd385a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0046588155.html @@ -0,0 +1,15 @@ + + +

Creating Encrypted Images

+

You can create an encrypted image using an external image file or an encrypted ECS.

+ + +
+
+
+
Parent topic: Encrypting Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0047501112.html b/docs/ims/umn/en-us_topic_0047501112.html new file mode 100644 index 000000000..100fc4b3a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0047501112.html @@ -0,0 +1,15 @@ + + +

Optimization Process

+

ECSs require Xen Guest OS driver (PV driver) and KVM Guest OS driver (UVP VMTools) for proper running. To ensure that ECSs support both Xen and KVM and to improve network performance, the PV driver and UVP VMTools must be installed for the image.

+
  1. Create an ECS using the Windows private image to be optimized and log in to the ECS.
  2. Install the latest version of PV driver on the ECS.

    For details, see Installing the PV Driver.

    +
  3. Install the UVP VMTools required for creating ECSs in the KVM virtual resource pool.

    For details, see Installing UVP VMTools.

    +
  4. On the ECS, choose Control Panel > Power Options. Click Choose when to turn off the display, select Never for Turn off the display, and save the changes.
  5. Clear system logs and then stop the ECS.

    For details, see Clearing System Logs.

    +
  6. Create a Windows private image using the ECS.
+
+
+
+
Parent topic: Optimizing a Windows Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0047501133.html b/docs/ims/umn/en-us_topic_0047501133.html new file mode 100644 index 000000000..2acd4140d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0047501133.html @@ -0,0 +1,17 @@ + + +

Optimization Process

+

A Linux ECS can be switched from Xen to KVM if xen-pv and VirtIO drivers run on the ECS. Before changing a Xen-based ECS to a KVM-based ECS, ensure that the required drivers have been installed and the UUID has been configured for the Linux private image. In addition, optimizing the private image can improve network performance of the ECS.

+
  1. Use the Linux image to be optimized to create an ECS, and start and log in to the ECS.
  2. Uninstall the PV Driver installed on the ECS.

    For details, see Uninstalling the PV Driver from a Linux ECS.

    +
  3. Change the disk ID in the GRUB configuration file to UUID.

    For details, see Changing the Disk Identifier in the GRUB Configuration File to UUID.

    +
  4. Change the disk ID in the fstab file to UUID.

    For details, see Changing the Disk Identifier in the fstab File to UUID.

    +
  5. Install native KVM drivers.

    For details, see Installing Native KVM Drivers.

    +
  6. Delete log files and historical records, and stop the ECS.

    For details, see Clearing System Logs.

    +
  7. Create a Linux private image using the ECS.
+
+
+
+
Parent topic: Optimizing a Linux Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0047898081.html b/docs/ims/umn/en-us_topic_0047898081.html new file mode 100644 index 000000000..c49f11e9f --- /dev/null +++ b/docs/ims/umn/en-us_topic_0047898081.html @@ -0,0 +1,7 @@ + + +

Glossary

+

For details about the terms involved in this document, see Glossary.

+
+
+ diff --git a/docs/ims/umn/en-us_topic_0049177180.html b/docs/ims/umn/en-us_topic_0049177180.html new file mode 100644 index 000000000..833c6fad4 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0049177180.html @@ -0,0 +1,26 @@ + + +

Replicating Images

+

Scenarios

You can convert encrypted and unencrypted images into each other or enable some advanced features (such as fast ECS creation from an image) using the image replication function. You may need to replicate an image in the following scenarios:

+ +
+

Constraints

+
+

Prerequisites

The images to be replicated are in the Normal state.

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Locate the row that contains the image to be replicated, click More in the Operation column, and select Replicate.
  3. In the displayed Replicate Image dialog box, set the following parameters:
    • Name: Enter a name that is easy to identify.
    • Description: This parameter is optional. Enter description of the replication.
    • Encryption: If you want to encrypt the image or change a key, select KMS encryption and select the key you want to use from the drop-down list.
    +
  4. Click OK.

    On the Private Images page, view the replication progress. If the status of the new image becomes Normal, the image replication is successful.

    +
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0049196765.html b/docs/ims/umn/en-us_topic_0049196765.html new file mode 100644 index 000000000..f10ba3122 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0049196765.html @@ -0,0 +1,12 @@ + + +

Image Encryption

+

How Can I Change an Unencrypted Image to an Encrypted One?

If you want to store an unencrypted image in an encrypted way, you can select an encryption key when you replicate the image. Then, the system will generate an encrypted replica of the unencrypted image.

+
+
+
+
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0057450886.html b/docs/ims/umn/en-us_topic_0057450886.html new file mode 100644 index 000000000..541263443 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0057450886.html @@ -0,0 +1,42 @@ + + +

Configuring Console Logging

+

Scenarios

If you want to use the ECS console logging function, you need to configure related parameters on the ECS.

+

Currently, ECSs running the following OSs are supported: CentOS 6 series, Red Hat 6 series, CentOS 7 series, Red Hat 7 series, Ubuntu 14 series, SUSE 11 series, SUSE 12 series, Debian, Ubuntu 16 series, Fedora, FreeBSD, and CoreOS.

+

To use the Console Log function on the ECS console, perform this operation. Otherwise, skip this section.

+
+
+

Prerequisites

You have logged in to the ECS.

+
+

Procedure

The configuration method varies depending on the OS.

To prevent impact on the start of the recovery mode, you are advised to modify only the item used for the default start.

+
+
  • For CentOS and Red Hat 6, perform the following steps:
    1. Run the following command to open the configuration file:

      vi /boot/grub/menu.lst

      +
    2. Locate the row that contains linux, linux16, or kernel (depending on the system), add console=ttyS0 to its end, and delete parameter rhgb quiet. If console=ttyS0 already exists, you do not need to add it. Save the change and exit.
    +
  • For CentOS 7, Red Hat 7, and Ubuntu 14, perform the following steps:
    1. Run the following command to open the configuration file:

      vi /boot/grub2/grub.cfg

      +
    2. Locate the row that contains linux, linux16, or kernel (depending on the system), add console=ttyS0 to its end, and delete parameter rhgb quiet. If console=ttyS0 already exists, you do not need to add it. Save the change and exit.
    +
  • For SUSE Linux 11, perform the following steps:
    1. Run the following command to open the configuration file:

      vi /boot/grub/menu.1st

      +
    2. Locate the row that contains linux, linux16, or kernel (depending on the system) and add console=ttyS0 to its end. If console=ttyS0 already exists, you do not need to add it. Save the change and exit.
    +
  • For SUSE Linux 12, openSUSE 13, and openSUSE 42, perform the following steps:
    1. Run the following command to open the configuration file:

      vi /boot/grub2/grub.cfg

      +
    2. Locate the row that contains linux, linux16, or kernel (depending on the system) and add console=ttyS0 to its end. If console=ttyS0 already exists, you do not need to add it. Save the change and exit.
    +
  • For Debian and Ubuntu 16, perform the following steps:
    1. Run the following command to open the configuration file:

      vi /boot/grub/grub.cfg

      +
    2. Locate the row that contains linux, linux16, or kernel (depending on the system) and add console=ttyS0 to its end. If console=ttyS0 already exists, you do not need to add it. Save the change and exit.
    +
  • For Fedora, perform the following steps:
    1. Run the following command to open the configuration file:

      vi /boot/grub2/grub.cfg

      +
    2. Locate the row that contains linux, linux16, or kernel (depending on the system) and add console=ttyS0 to its end. If console=ttyS0 already exists, you do not need to add it. Save the change and exit.
    +
  • For FreeBSD, perform the following steps:
    1. Run the following command to open the configuration file:

      vi /boot/loader.conf

      +
    2. Add console="comconsole". If console="comconsole" already exists, you do not need to add it. Save the change and exit.
    +
  • For CoreOS, perform the following steps:
    1. Run the following command to check whether ttyS0 has been configured:

      cat /proc/cmdline | grep ttyS0

      +
      • If yes, ttyS0 has been configured.
      • If no, ttyS0 has not been configured. Go to 2.
      +
    2. Run the following command to open the configuration file to be edited:

      vi /usr/share/oem/grub.cfg

      +

      If the /usr/share/oem/grub.cfg configuration file does not exist, manually create the file.

      +
      +
    3. Add set linux_append="console=ttyS0". If set linux_append="console=ttyS0" already exists, you do not need to add it. Save the change and exit.
    +
+
+
+
+
+
+
Parent topic: Linux Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0058841396.html b/docs/ims/umn/en-us_topic_0058841396.html new file mode 100644 index 000000000..2eeb36508 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0058841396.html @@ -0,0 +1,21 @@ + + +

What Do I Do If the System Disk Size in a VHD Image File Exceeds the One I Have Specified on the Management Console When I Use This File to Register a Private Image?

+
The possible causes may be:
  1. You have specified a small value.

    Check the system disk size in the VHD image file. Specify a value no less than this size when you use the VHD image file to register an image.

    +
  2. The actual size of the VHD image file is larger than its virtual size, if this VHD image file is generated using qemu-img or a similar tool. For details, see https://bugs.launchpad.net/qemu/+bug/1490611.

    Run the following command to check the VHD image file information:

    +
    [xxxx@xxxxx test]$ qemu-img info 2g.vhd
+image: 2g.vhd
+file format: vpc
+virtual size: 2.0G (2147991552 bytes)
+disk size: 8.0K
+cluster_size: 2097152
    +

    The virtual size is converted from the actual size (unit: byte) to an integer in GB. As a result, the actual file size 2147991552 bytes (2.0004 GB) is larger than the virtual size 2 GB. Therefore, you need to specify a value larger than the actual size 2.0004 GB. (The system disk size value on the management can only be an integer, so you only need to enter a value larger than 2.)

    +
+
+
+
+
+
Parent topic: Image Importing
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0068002265.html b/docs/ims/umn/en-us_topic_0068002265.html new file mode 100644 index 000000000..3c266f6cb --- /dev/null +++ b/docs/ims/umn/en-us_topic_0068002265.html @@ -0,0 +1,29 @@ + + +

Tagging an Image

+

Scenarios

You can use tags to classify images. You can add, modify, or delete image tags, or search for required images by tag in the image list.

+

When adding predefined tags to an image or searching for an image using predefined tags, you must have permission to access the Tag Management Service (TMS).

+
+
+

Constraints

An image can have a maximum of 10 tags.

+
+

Add, Delete, and Modify Image Tags

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab and click the image name to display the image details.
    • To modify an image tag, go to 3.
    +
    • To delete an image tag, go to 4.
    • To add an image tag, go to 5.
    +
  3. Click the Tags tab, locate the target tag, and click Edit in the Operation column. In the displayed dialog box, modify the tag.
  4. Click the Tags tab, locate the target tag, and click Delete in the Operation column. In the displayed dialog box, click Yes.
  5. Click the Tags tab and then Add Tag. In the displayed dialog box, add a tag.
+
+

Search for Private Images by Tag

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab and then Search by Tag.
  3. Enter the tag key and value.

    Neither the tag key nor tag value can be empty. When the tag key and tag value are matched, the system automatically shows your desired private images.

    +
  4. Click to add a tag.

    You can add multiple tags to search for private images. The system will display private images that match all tags.

    +
  5. Click Search.

    The system searches for private images based on tag keys or tag values.

    +
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0069904570.html b/docs/ims/umn/en-us_topic_0069904570.html new file mode 100644 index 000000000..4d2811ed0 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0069904570.html @@ -0,0 +1,38 @@ + + +

Deleting Files from the Network Rule Directory

+

Scenarios

To prevent NIC name drift when you use a private image to create ECSs, you need to delete files from the network rule directory of the VM where the ECS or image file is located during the private image creation.

+

When registering an external image file as a private image, delete files from the network rule directory on the VM where the external image file is located. You are advised to delete the files on the VM and then export the image file.

+
+
+

Prerequisites

An OS and VirtIO drivers have been installed on the ECS.

+
+

Procedure

  1. Run the following command to query files in the network rule directory:

    ls -l /etc/udev/rules.d

    +
  2. Run the following commands to delete the files whose names contain persistent and net from the network rule directory:

    Example:

    +

    rm /etc/udev/rules.d/30-net_persistent-names.rules

    +

    rm /etc/udev/rules.d/70-persistent-net.rules

    +

    The italic content in the commands varies depending on your environment.

    +

    For CentOS 6 images, to prevent NIC name drift, you need to create an empty rules configuration file.

    +

    Example:

    +

    touch /etc/udev/rules.d/75-persistent-net-generator.rules //Replace 75 with the actual value in the environment.

    +
    +
  3. Delete network rules.
    • If the OS uses the initrd system image, perform the following operations:
      1. Run the following command to check whether the initrd image file whose name starts with initrd and ends with default contains the persistent and net network device rule files (replace the italic content in the following command with the actual OS version):

        lsinitrd /boot/initrd-2.6.32.12-0.7-default |grep persistent|grep net

        +
        • If no, no further action is required.
        • If yes, go to 3.b.
        +
      2. Run the following command to back up the initrd image files (replace the italic part in the following command with the actual OS version):

        cp /boot/initrd-2.6.32.12-0.7-default /boot/initrd-2.6.32.12-0.7-default_bak

        +
      3. Run the following command to generate the initrd file again:

        mkinitrd

        +
      +
    • If the OS uses the initramfs system image (such as Ubuntu), perform the following operations:
      1. Run the following command to check whether the initramfs image file whose name starts with initrd and ends with generic contains persistent and net rule files.

        lsinitramfs /boot/initrd.img-3.19.0-25-generic|grep persistent|grep net

        +
        • If no, no further action is required.
        • If yes, go to 3.b.
        +
      2. Run the following command to back up the initrd image files:

        cp /boot/initrd.img-3.19.0-25-generic /boot/initrd.img-3.19.0-25-generic_bak

        +
      3. Run the following command to generate the initramfs image files again:

        update-initramfs -u

        +
      +
    +
+
+
+
+
+
Parent topic: Linux Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0075730699.html b/docs/ims/umn/en-us_topic_0075730699.html new file mode 100644 index 000000000..d573cd0a0 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0075730699.html @@ -0,0 +1,18 @@ + + +

Accepting Rejected Images

+

Scenarios

If you want to use the shared images you have rejected, you can accept them from the list of rejected images.

+
+

Prerequisites

+
+

Procedure

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Images Shared with Me tab.
  3. Click Rejected Images. All the rejected images are displayed.
  4. Select the images you want to accept and click Accept.
  5. Check the accepted images in the shared image list.
+
+
+
+
+
Parent topic: Sharing Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0076880304.html b/docs/ims/umn/en-us_topic_0076880304.html new file mode 100644 index 000000000..1083c43f1 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0076880304.html @@ -0,0 +1,213 @@ + + +

How Do I Configure a Linux Private Image to Make It Automatically Expand Its Root Partition?

+

Constraints

+
+

Installation of growpart on Different OSs

To enable private images to automatically expand the root partition, install growpart. +
+ + + + + + + + + + + + + +
Table 1 growpart installation packages for different OSs

OS

+

Tool Package

+

Debian/Ubuntu

+

cloud-init, cloud-utils, and cloud-initramfs-growroot

+

Fedora/CentOS

+

cloud-init, cloud-utils, and cloud-utils-growpart

+

SUSE/openSUSE

+

cloud-init and growpart

+
+
+
+

For Debian 9, use method 1 to install growpart. If the installation fails, use method 2 to install growpart.

+

Method 1:

+

Run the following command to install growpart:

+

apt-get install -y -f cloud-init cloud-utils cloud-initramfs-growroot

+

Method 2:

+
If method 1 fails, it may be because the installation source of Debian 9.0.0 is faulty. You need to download dependent packages cloud-utils and cloud-initramfs-growroot and install them.
  1. Run the following command to download the dependent packages:

    wget Package download path

    +

    You can obtain the dependent packages from the following paths:

    +

    http://ftp.br.debian.org/debian/pool/main/c/cloud-utils/cloud-utils_0.29-1_all.deb

    +

    http://ftp.br.debian.org/debian/pool/main/c/cloud-initramfs-tools/cloud-initramfs-growroot_0.18.debian5_all.deb

    +
  2. Run the following command to rectify the dependent packages:

    apt --fix-broken install

    +
  3. Run the following command to install the dependent packages:

    dpkg -i cloud-utils package path cloud-initramfs-growroot package path

    +

    An example command is dpkg -i /root/cloud-utils_0.29-1_all.deb /root/cloud-initramfs-growroot_0.18.debian5_all.deb.

    +
+
+

For other Debian versions, run the following command to install dependent packages:

+

apt-get update;apt-get install cloud-utils cloud-initramfs-growroot

+
+
+

Procedure

Take the following as two examples of image disk partitioning:

+

If the root partition is the last partition, see Root partition at the last.

+

If the root partition is not the last partition, see Root partition not at the last.

+
If the parted command fails, ensure that the parted tool has been installed in the OS. Perform the following operations to install the tool:
  • For CentOS, run the following command:

    yum install parted

    +
  • For Debian, run the following command:

    apt-get install parted

    +
+
+
+ +
+
+
+
+
Parent topic: Cloud-Init
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0078454810.html b/docs/ims/umn/en-us_topic_0078454810.html new file mode 100644 index 000000000..69cef7594 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0078454810.html @@ -0,0 +1,37 @@ + + +

How Do I Install growpart for SUSE 11 SP4?

+

Scenarios

growpart for SUSE and openSUSE is an independent toolkit that does not start with cloud-*. Perform operations in this section to install growpart.

+
+

Procedure

  1. Run the following commands to check whether Cloud-Init and growpart have been installed:

    rpm -qa | grep cloud-init

    +

    The command output is as follows:

    +
    cloud-init-0.7.8-39.2
    +

    rpm -qa | grep growpart

    +

    The command output is as follows:

    +
    growpart-0.29-8.1
    +
  2. Run the following command to uninstall Cloud-Init and growpart:

    zypper remove cloud-init growpart

    +
  3. Run the following commands to delete residual files:

    rm -fr /etc/cloud/*

    +

    rm -fr /var/lib/cloud/*

    +
  4. Run the following command to install growpart:

    zypper install http://download.opensuse.org/repositories/home:/garloff:/OTC:/cloudinit/SLE_11_SP4/noarch/growpart-0.27-1.1.noarch.rpm

    +
  5. Run the following command to install python-oauth:

    zypper install http://download.opensuse.org/repositories/home:/garloff:/OTC:/cloudinit/SLE_11_SP4/x86_64/python-oauth-1.0.1-35.1.x86_64.rpm

    +
  6. Run the following command to install Cloud-Init:

    zypper install http://download.opensuse.org/repositories/home:/garloff:/OTC:/cloudinit/SLE_11_SP4/x86_64/cloud-init-0.7.6-27.23.1.x86_64.rpm

    +
  7. Run the following commands to check whether growpart, python-oauth, and Cloud-Init have been installed successfully:

    rpm -qa | grep growpart

    +

    The command output is as follows:

    +
    growpart-0.27-1.1
    +

    rpm -qa | grep python-oauth

    +

    The command output is as follows:

    +
    python-oauthlib-0.6.0-1.5
+python-oauth-1.0.1-35.1
    +

    rpm -qa | grep cloud-init

    +

    The command output is as follows:

    +
    cloud-init-0.7.6-27.19.1
    +
  8. Run the following command to check the configuration:

    chkconfig cloud-init-local on;chkconfig cloud-init on;chkconfig cloud-config on;chkconfig cloud-final on

    +
+
+
+
+
+
Parent topic: Cloud-Init
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0081795392.html b/docs/ims/umn/en-us_topic_0081795392.html new file mode 100644 index 000000000..31d720392 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0081795392.html @@ -0,0 +1,42 @@ + + +

Installing Special Windows Drivers

+

Scenarios

Before using some types of ECSs to create private images, you need to install special drivers on the ECSs.

+
+

GPU Driver

If you want to use the created private image to create GPU-accelerated ECSs, install a proper GPU driver for the image to enable GPU acceleration. There are two types of NVIDIA Tesla GPU drivers for GPU-accelerated ECSs, Tesla and GRID/vGPU drivers.

+ + +
+ + + + + + + + + + +
Table 1 Installing the GRID driver

ECS Type

+

How to Install the Driver

+

G1

+

For details, see Downloading GRID Driver and Software License Packages in Installing a GRID Driver on a GPU-accelerated ECS.

+

G2

+

Log in at http://www.nvidia.com/Download/index.aspx?lang=en-us. You are advised to select the latest CUDA Toolkit version.

+
NOTICE:

After the GPU driver is installed, run the following command to switch the GPU working mode and restart the ECS (for example, the GPU driver is installed in C:\Program Files\NVIDIA Corporation\NVSMI\nvidia-smi.exe):

+

"C:\Program Files\NVIDIA Corporation\NVSMI\nvidia-smi.exe" -dm 0

+
+
+
+
+

SR-IOV NIC Driver

If you want to use the created private image to create G2 ECSs, install the SR-IOV NIC driver for the image to improve performance and scalability.

+

To download the SR-IOV driver, log in at https://downloadcenter.intel.com/search?keyword=Intel++Ethernet+Connections+CD. You are advised to select version 20.4.1 or later.

+

If error "No Intel adapter found" occurs during the driver installation, refer to What Do I Do If a Windows 7 ECS Equipped with an Intel 82599 NIC Reports an Error in SR-IOV Scenarios? for troubleshooting.

+
+
+
+
+
Parent topic: Windows Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0081802526.html b/docs/ims/umn/en-us_topic_0081802526.html new file mode 100644 index 000000000..551c1048f --- /dev/null +++ b/docs/ims/umn/en-us_topic_0081802526.html @@ -0,0 +1,19 @@ + + +

What Do I Do If a Windows 7 ECS Equipped with an Intel 82599 NIC Reports an Error in SR-IOV Scenarios?

+

Symptom

When the 20.4.1 driver package downloaded at Intel website https://downloadcenter.intel.com/search?keyword=Intel++Ethernet+Connections+CD was installed in a Windows 7 64bit ECS with SR-IOV passthrough enabled, the system displayed the message "No Intel adapter found".

+
+

Cause Analysis

The OS identifies an Intel 82599 passthrough NIC without a driver installed as an Ethernet controller. When the 20.4.1 driver package was installed, the OS did not identify the Intel NIC, leading to the error.

+
+

Solution

Run Autorun.exe in the folder where the 20.4.1 driver package is stored. Install a driver on the NIC before installing the driver package so that the NIC can be identified as an Intel 82599 virtual function (VF) device by the OS. Use either of the following methods to install the driver:

+ +
+
+
+
+
Parent topic: OS
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0082002007.html b/docs/ims/umn/en-us_topic_0082002007.html new file mode 100644 index 000000000..17ed36078 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0082002007.html @@ -0,0 +1,18 @@ + + +

Installing Special Linux Drivers

+

Scenarios

Before using some types of ECSs to create private images, you need to install special drivers on the ECSs.

+
+

NVIDIA Driver

If you want to use the private image to create P1 ECSs, install the NVIDIA driver for the image to enable computing acceleration. For details, see How Do I Install the NVIDIA Driver on a P1 ECS?

+
+

InfiniBand NIC Driver

  1. If you want to use the private image to create H2 ECSs, install the InfiniBand NIC driver for the image. Download the required version (4.2-1.0.0.0) of InfiniBand NIC driver from the official website and install the driver by following the instructions provided by Mellanox. +
  2. If you want to use the private image to create HL1 ECSs, install the InfiniBand NIC driver for the image. Download the required version (4.2-1.0.0.0) of InfiniBand NIC driver from the official website and install the driver by following the instructions provided by Mellanox. +
+
+
+
+
+
Parent topic: Linux Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0084064672.html b/docs/ims/umn/en-us_topic_0084064672.html new file mode 100644 index 000000000..fb9a65e08 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0084064672.html @@ -0,0 +1,39 @@ + + +

Creating a Data Disk Image from an External Image File

+

Scenarios

A data disk image contains only service data. You can create a data disk image using a local image file or an external image file (image file on another cloud platform). Then, you can use the data disk image to create EVS disks and migrate your service data to the cloud.

+
+

Background

The following figure shows the process of creating a data disk image from an external image file.

+
Figure 1 Creating a data disk image from an external image file
+
  1. Prepare an external image file. The file must be in VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, QED, ZVHD, or ZVHD2 format. If you want to use an image file in other formats, convert the file into any of the listed formats before importing it to the cloud platform.
  2. When uploading the external image file, you must select an OBS bucket with standard storage. For details, see Uploading an External Image File.
  3. Create a data disk image. For details, see Procedure.
  4. Use the data disk image to create data disks. For details, see Follow-up Procedure.
+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Create a data disk image.

    1. Click Create Image in the upper right corner.
    2. In the Image Type and Source area, select Data disk image for Type.
    3. Select Image File for Source. Select the bucket storing the image file from the list and then select the image file.
      Figure 2 Creating a data disk image
      +
    4. To register the image file using the Fast Create function, select Enable Fast Create.
      • Currently, this function supports only image files in ZVHD2 or RAW format.
      • For how to convert image file formats and generate bitmap files, see Quickly Importing an Image File.
      +
      +

      After you select Enable Fast Create, select the confirmation information following Image File Preparation if you have prepared the required files.

      +
    5. In the Image Information area, set the following parameters.
      • OS Type: The value can be Windows or Linux.
      • Data Disk: The value ranges from 1 GB to 2048 GB and must be no less than the data disk size in the image file.
      • Name: Enter a name for the image.
      • (Optional) Encryption: If you want to encrypt the image, select KMS encryption and then select the key to be used from the key list.
      • (Optional) Tag: Set a tag key and a tag value for the image to easily identify and manage it.
      • (Optional) Description: Enter description of the image.
      +
    6. Click Create Now.
    7. Confirm the parameters and click Submit.
    +

  3. Go back to the Private Images page and view the new data disk image.

    When the image status changes to Normal, the image creation is complete.

    +

+
+

Follow-up Procedure

If you want to use the created data disk image to create an EVS disk and attach it to an ECS, you can perform either of the following operations:

+ +
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0085214115.html b/docs/ims/umn/en-us_topic_0085214115.html new file mode 100644 index 000000000..31dec2b5b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0085214115.html @@ -0,0 +1,229 @@ + + +

How Do I Enable NIC Multi-Queue for an Image?

+

Scenarios

With the increase of network I/O bandwidth, a single vCPU cannot meet the requirement of processing NIC interruptions. NIC multi-queue allows multiple vCPUs to process NIC interruptions, thereby improving network PPS and I/O performance.

+
+

ECSs Supporting NIC Multi-Queue

NIC multi-queue can be enabled on an ECS only when the ECS specifications, virtualization type, and image meet the requirements described in this section.

+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 KVM ECSs that support NIC multi-queue

OS

+

Image

+

Supported By

+

Windows

+

Windows Server 2008 WEB R2 64bit

+

Private images

+

Windows Server 2008 R2 Standard/Datacenter/Enterprise 64bit

+

Private images

+

Windows Server 2012 R2 Standard/Datacenter 64bit

+

Private images

+

Windows Server 2016 Standard/Datacenter 64bit

+

Private images

+

Linux

+

Ubuntu 14.04/16.04 Server 64bit

+

Public images

+

openSUSE 42.2 64bit

+

Public images

+

SUSE Enterprise 12 SP1/SP2 64bit

+

Public images

+

CentOS 6.8/6.9/7.0/7.1/7.2/7.3/7.4/7.5/7.6 64bit

+

Public images

+

Debian 8.0.0/8.8.0/8.9.0/9.0.0 64bit

+

Public images

+

Fedora 24/25 64bit

+

Public images

+

EulerOS 2.2 64bit

+

Public images

+
+
+
+

Operation Instructions

Assume that an ECS has the required specifications and virtualization type.

+ +
+

Register the external image file as a private image

Register the external image file as a private image. For details, see Registering an External Image File as a Private Image.

+
+

Set NIC Multi-Queue for the Image

Windows OSs have not commercially supported NIC multi-queue. If you enable NIC multi-queue in a Windows image, starting an ECS created using such an image may be slow.

+

Use either of the following methods to set NIC multi-queue.

+
Method 1:
  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. On the displayed Private Images page, locate the row that contains the target image and click Modify in the Operation column.
  3. Set NIC multi-queue for the image.
+
+
Method 2:
  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. On the displayed Private Images page, click the name of the target image.
  3. In the upper right corner of the displayed image details page, click Modify. In the displayed Modify Image dialog box, set NIC multi-queue for the image.
+
+

Method 3: Add hw_vif_multiqueue_enabled to the image using an API.

+
  1. Obtain a token. For details, see Token Authentication.
  2. Call an API to update image information. For details, see "Updating Image Information (Native OpenStack API)" in Image Management Service API Reference.
  3. Add X-Auth-Token to the request header.

    The value of X-Auth-Token is the token obtained in step 1.

    +
  4. Add Content-Type to the request header.

    The value of Content-Type is application/openstack-images-v2.1-json-patch.

    +

    The request URI is in the following format:

    +

    PATCH /v2/images/{image_id}

    +
    The request body is as follows:
    [       
+         { 
+          "op":"add",
+          "path":"/hw_vif_multiqueue_enabled", 
+          "value": "true" 
+         } 
+ ]
    +
    +

    Figure 1 shows an example request body for setting NIC multi-queue.

    +
    Figure 1 Example request body
    +
+
+

Create an ECS from the Private Image

Use the registered private image to create an ECS. For details, see Elastic Cloud Server User Guide. Note the following when setting the parameters:
  • Region: Select the region where the private image is located.
  • Image: Select Private image and then the desired image from the drop-down list.
+
+
+

Enable NIC Multi-Queue

KVM ECSs running Windows use private images to support NIC multi-queue.

+

For Linux ECSs, which run CentOS 7.4 as an example, perform the following operations to enable NIC multi-queue:

+
  1. Enable NIC multi-queue.

    1. Log in to the ECS.
    2. Run the following command to obtain the number of queues supported by the NIC and the number of queues with NIC multi-queue enabled:

      ethtool -l NIC

      +
    3. Run the following command to configure the number of queues used by the NIC:

      ethtool -L NIC combined Number of queues

      +
    +

    Example:

    +
    [root@localhost ~]# ethtool -l eth0  #View the number of queues used by NIC eth0.
+Channel parameters for eth0:
+Pre-set maximums:
+RX:               0
+TX:               0
+Other:                  0
+Combined: 4  #Indicates that a maximum of four queues can be enabled for the NIC.
+Current hardware settings:
+RX:               0
+TX:               0
+Other:                  0
+Combined: 1 #Indicates that one queue has been enabled.
+
+[root@localhost ~]# ethtool -L eth0 combined 4 #Enable four queues on NIC eth0.
    +

  2. (Optional) Enable irqbalance so that the system automatically allocates NIC interruptions to multiple vCPUs.

    1. Run the following command to enable irqbalance:

      service irqbalance start

      +
    2. Run the following command to view the irqbalance status:

      service irqbalance status

      +

      If the Active value in the command output contains active (running), irqbalance has been enabled.

      +
      Figure 2 Enabled irqbalance
      +
    +

  3. (Optional) Enable interrupt binding.

    Enabling irqbalance allows the system to automatically allocate NIC interruptions, improving network performance. If the improved network performance fails to meet your expectations, manually configure interrupt affinity on the target ECS.

    +

    The detailed operations are as follows:

    +

    Run the following script so that each ECS vCPU responds the interrupt requests initialized by one queue. That is, one queue corresponds to one interrupt, and one interrupt binds to one vCPU.

    +
    #!/bin/bash
+service irqbalance stop
+
+eth_dirs=$(ls -d /sys/class/net/eth*)
+if [ $? -ne 0 ];then
+    echo "Failed to find eth*  , sleep 30" >> $ecs_network_log
+    sleep 30
+    eth_dirs=$(ls -d /sys/class/net/eth*)
+fi
+
+for eth in $eth_dirs
+do
+    cur_eth=$(basename $eth)
+    cpu_count=`cat /proc/cpuinfo| grep "processor"| wc -l`
+    virtio_name=$(ls -l /sys/class/net/"$cur_eth"/device/driver/ | grep pci |awk {'print $9'})
+
+    affinity_cpu=0
+    virtio_input="$virtio_name""-input"
+    irqs_in=$(grep "$virtio_input" /proc/interrupts | awk -F ":" '{print $1}')
+    for irq in ${irqs_in[*]}
+    do
+        echo $((affinity_cpu%cpu_count)) > /proc/irq/"$irq"/smp_affinity_list
+        affinity_cpu=$[affinity_cpu+2]
+    done
+
+    affinity_cpu=1
+    virtio_output="$virtio_name""-output"
+    irqs_out=$(grep "$virtio_output" /proc/interrupts | awk -F ":" '{print $1}')
+    for irq in ${irqs_out[*]}
+    do
+        echo $((affinity_cpu%cpu_count)) > /proc/irq/"$irq"/smp_affinity_list
+        affinity_cpu=$[affinity_cpu+2]
+    done
+done
    +

  4. (Optional) Enable XPS and RPS.

    XPS allows the system with NIC multi-queue enabled to select a queue by vCPU when sending a data packet.

    +
    #!/bin/bash
+# enable XPS feature
+cpu_count=$(grep -c processor /proc/cpuinfo)
+dec2hex(){
+  echo $(printf "%x" $1)
+}
+eth_dirs=$(ls -d /sys/class/net/eth*)
+if [ $? -ne 0 ];then
+    echo "Failed to find eth* , sleep 30" >> $ecs_network_log
+    sleep 30
+    eth_dirs=$(ls -d /sys/class/net/eth*)
+fi
+for eth in $eth_dirs
+do
+    cpu_id=1
+    cur_eth=$(basename $eth)
+    cur_q_num=$(ethtool -l $cur_eth | grep -iA5 current | grep -i combined | awk {'print $2'})
+    for((i=0;i<cur_q_num;i++))
+    do
+        if [ $i -eq $ cpu_count ];then
+            cpu_id=1
+        fi
+        xps_file="/sys/class/net/${cur_eth}/queues/tx-$i/xps_cpus"
+        rps_file="/sys/class/net/${cur_eth}/queues/rx-$i/rps_cpus"
+        cpuset=$(dec2hex "$cpu_id")
+        echo $cpuset > $xps_file
+        echo $cpuset > $rps_file
+        let cpu_id=cpu_id*2
+    done
+done
    +

+
+
+
+
+
Parent topic: Image Optimization
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0086020894.html b/docs/ims/umn/en-us_topic_0086020894.html new file mode 100644 index 000000000..a68d889b4 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0086020894.html @@ -0,0 +1,229 @@ + + +

How Do I Install Native Xen and KVM Drivers?

+

Scenarios

When optimizing a Linux private image, you need to install native Xen and KVM drivers for the image.

+

If you do not install Xen drivers for the image, the network performance of the ECSs created from this image will be poor, and the security groups and firewall configured for the ECSs will not take effect.

+

If you do not install KVM drivers for the image, the NICs of the ECSs may not be detected and the ECSs will be unable to communicate with other resources.

+
+
+

This section describes how to install native Xen and KVM drivers.

+

Prerequisites

+
+

Procedure

Modify the configuration file depending on the OS.
  • CentOS, EulerOS

    Take CentOS 7.0 as an example. Modify the /etc/dracut.conf file. Add the xen-pv and VirtIO drivers to add_drivers. xen-pv drivers include xen-blkfront and xen-netfront. VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces. Save and exit the /etc/dracut.conf file. Run the dracut -f command to regenerate initrd.

    +

    For details, see CentOS and EulerOS.

    +
  • Ubuntu and Debian

    Modify the /etc/initramfs-tools/modules file. Add the xen-pv and VirtIO drivers. xen-pv drivers include xen-blkfront and xen-netfront. VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces. Save and exit the /etc/initramfs-tools/modules file. Run the update-initramfs -u command to regenerate initrd.

    +

    For details, see Ubuntu and Debian.

    +
  • SUSE and openSUSE
    • If the OS version is earlier than SUSE 12 SP1 or openSUSE 13, modify the /etc/sysconfig/kernel file and add xen-pv and VirtIO drivers to INITRD_MODULES="". xen-pv drivers include xen_vnif, xen_vbd, and xen_platform_pci. VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces. Run the mkinitrd command to regenerate initrd.
    • If the OS version is SUSE 12 SP1, modify the /etc/dracut.conf file and add xen-pv and VirtIO drivers to add_drivers. xen-pv drivers include xen_vnif, xen_vbd, and xen_platform_pci. VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces. Run the dracut -f command to regenerate initrd.
    • If the OS version is later than SUSE 12 SP1 or openSUSE 13, modify the /etc/dracut.conf file and add xen-pv and VirtIO drivers to add_drivers. xen-pv drivers include xen-blkfront and xen-netfront. VirtIO drivers include virtio_blk, virtio_scsi, virtio_net, virtio_pci, virtio_ring, and virtio. Separate driver names with spaces. Save and exit the /etc/dracut.conf file. Run the dracut -f command to regenerate initrd.
    +
    For details, see SUSE and openSUSE.

    For SUSE, run the following command to check whether xen-kmp (driver package for xen-pv) is installed:

    +

    rpm -qa |grep xen-kmp

    +

    If information similar to the following is displayed, xen-kmp is installed in the OS:

    +
    xen-kmp-default-4.2.2_04_3.0.76_0.11-0.7.5
    +

    If xen-kmp is not installed, obtain it from the ISO file and install it.

    +

    If you add built-in drivers to the initrd or initramfs file by mistake, the ECS will not be affected.

    +
    +
    +
+
+
+

CentOS and EulerOS

  1. Run the following command to open the /etc/dracut.conf file:

    vi /etc/dracut.conf

    +
  2. Press i to enter editing mode and add the xen-pv and VirtIO drivers to add_drivers (the format varies depending on the OS).
    [root@CTU10000xxxxx ~]# vi /etc/dracut.conf 
+# additional kernel modules to the default 
+add_drivers+="xen-blkfront xen-netfront virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio" 
+......
    +
  3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/dracut.conf file.
  4. Run the following command to regenerate initrd:

    dracut -f /boot/initramfs-2.6.32-573.8.1.el6.x86_64.img

    +

    If the virtual file system is not the default initramfs, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the grub.cfg file, which can be /boot/grub/grub.cfg, /boot/grub2/grub.cfg, or /boot/grub/grub.conf depending on the OS.

    +
  5. If the virtual file system is initramfs, run the following commands to check whether native Xen and KVM drivers have been loaded:

    lsinitrd /boot/initramfs-`uname -r`.img | grep xen

    +

    lsinitrd /boot/initramfs-`uname -r`.img | grep virtio

    +

    If the virtual file system is initrd, run the following commands to check whether native Xen and KVM drivers have been loaded:

    +

    lsinitrd /boot/initrd-`uname -r` | grep xen

    +

    lsinitrd /boot/initrd-`uname -r` | grep virtio

    +

    Assume that the virtual file system is initramfs. The following command output will be displayed:

    +
    [root@CTU10000xxxxx home]# lsinitrd /boot/initramfs-`uname -r`.img | grep xen 
+-rwxr--r--   1 root     root        54888 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/block/xen-blkfront.ko 
+-rwxr--r--   1 root     root        45664 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/net/xen-netfront.ko 
+ 
+[root@CTU10000xxxxx home]# lsinitrd /boot/initramfs-`uname -r`.img | grep virtio 
+-rwxr--r--   1 root     root        23448 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/block/virtio_blk.ko 
+-rwxr--r--   1 root     root        50704 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/net/virtio_net.ko 
+-rwxr--r--   1 root     root        28424 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/scsi/virtio_scsi.ko 
+drwxr-xr-x   2 root     root            0 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio 
+-rwxr--r--   1 root     root        14544 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio/virtio.ko 
+-rwxr--r--   1 root     root        21040 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio/virtio_pci.ko 
+-rwxr--r--   1 root     root        18016 Jul 16 17:53 lib/modules/2.6.32-573.8.1.el6.x86_64/kernel/drivers/virtio/virtio_ring.ko
    +

    If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following commands to check whether built-in drivers are in the kernel:

    +

    cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y

    +

    cat /boot/config-`uname -r` | grep CONFIG_XEN | grep y

    +
    +
+
+

Ubuntu and Debian

  1. Run the following command to open the modules file:

    vi /etc/initramfs-tools/modules

    +
  2. Press i to enter editing mode and add the xen-pv and VirtIO drivers to the /etc/initramfs-tools/modules file (the format varies depending on the OS).
    [root@CTU10000xxxxx ~]#vi /etc/initramfs-tools/modules 
+......
+# Examples: 
+# 
+# raid1 
+# sd_mOd 
+xen-blkfront
+xen-netfront
+virtio_blk
+virtio_scsi
+virtio_net
+virtio_pci
+virtio_ring
+virtio
    +
  3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/initramfs-tools/modules file.
  4. Run the following command to regenerate initrd:

    update-initramfs -u

    +
  5. Run the following commands to check whether native Xen and KVM drivers have been installed:

    lsinitramfs /boot/initrd.img-`uname -r` |grep xen

    +

    lsinitramfs /boot/initrd.img-`uname -r` |grep virtio

    +
    [root@ CTU10000xxxxx home]# lsinitramfs /boot/initrd.img-`uname -r` |grep xen 
+lib/modules/3.5.0-23-generic/kernel/drivers/net/ethernet/qlogic/netxen 
+lib/modules/3.5.0-23-generic/kernel/drivers/net/ethernet/qlogic/netxen/netxen_nic.ko 
+lib/modules/3.5.0-23-generic/kernel/drivers/net/xen-netback 
+lib/modules/3.5.0-23-generic/kernel/drivers/net/xen-netback/xen-netback.ko 
+lib/modules/3.5.0-23-generic/kernel/drivers/block/xen-blkback 
+lib/modules/3.5.0-23-generic/kernel/drivers/block/xen-blkback/xen-blkback.ko 
+ 
+[root@ CTU10000xxxxx home]# lsinitramfs /boot/initrd.img-`uname -r` |grep virtio 
+lib/modules/3.5.0-23-generic/kernel/drivers/scsi/virtio_scsi.ko
    +

    If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following commands to check whether built-in drivers are in the kernel:

    +
    [root@ CTU10000xxxxx home]# cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y
+CONFIG_VIRTIO_BLK=y
+CONFIG_VIRTIO_NET=y
+CONFIG_VIRTIO=y
+CONFIG_VIRTIO_RING=y
+CONFIG_VIRTIO_PCI=y
+CONFIG_VIRTIO_MMIO_CMDLINE_DEVICES=y
+[root@ CTU10000xxxxx home]# cat /boot/config-`uname -r` | grep CONFIG_XEN | grep y
+CONFIG_XEN_BLKDEV_FRONTEND=y
+CONFIG_XEN_NETDEV_FRONTEND=y
    +
    +
+
+

SUSE and openSUSE

If the OS version is earlier than SUSE 12 SP1 or openSUSE 13, modify the /etc/sysconfig/kernel file. For details, see scenario 1.

+

If the OS version is SUSE 12 SP1, modify the /etc/dracut.conf file and add xen-pv and VirtIO drivers. For details, see scenario 2.

+
If the OS version is later than SUSE 12 SP1 or openSUSE 13, modify the /etc/dracut.conf file and add xen-pv and VirtIO drivers to add_drivers. For details, see scenario 3.
  • If the OS version is earlier than SUSE 12 SP1 or openSUSE 13, perform the following steps:

    For SUSE, run the following command to check whether xen-kmp (driver package for xen-pv) is installed in the OS:

    +

    rpm -qa |grep xen-kmp

    +

    If information similar to the following is displayed, xen-kmp is installed:

    +
    xen-kmp-default-4.2.2_04_3.0.76_0.11-0.7.5
    +

    If xen-kmp is not installed, obtain it from the installation ISO and install it first.

    +
    +
    1. Run the following command to open the /etc/sysconfig/kernel file:

      vi etc/sysconfig/kernel

      +
    2. Add the xen-pv and VirtIO drivers after INITRD_MODULES= (the format of drivers depends on the OS).
      SIA10000xxxxx:~ # vi /etc/sysconfig/kernel 
+# (like drivers for scsi-controllers, for lvm or reiserfs)
+#
+INITRD_MODULES="ata_piix ata_generic xen_vnif xen_vbd xen_platform_pci virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio"
      +
    3. Run the mkinitrd command to regenerate initrd:

      If the virtual file system is not the default initramfs or initrd, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the menu.lst or grub.cfg file (/boot/grub/menu.lst, /boot/grub/grub.cfg, or /boot/grub2/grub.cfg).

      +
      +

      The following is an example initrd file of SUSE 11 SP4:

      +
      default 0
+timeout 10
+gfxmenu (hd0,0)/boot/message
+title sles11sp4_001_[_VMX_]
+root (hd0,0)
+kernel /boot/linux.vmx vga=0x314 splash=silent console=ttyS0,115200n8 console=tty0 net.ifnames=0 NON_PERSISTENT_DEVICE_NAMES=1 showopts
+initrd /boot/initrd.vmx
+title Failsafe_sles11sp4_001_[_VMX_]
+root (hd0,0)
+kernel /boot/linux.vmx vga=0x314 splash=silent ide=nodma apm=off noresume edd=off powersaved=off nohz=off highres=off processsor.max+cstate=1 nomodeset x11failsafe console=ttyS0,115200n8 console=tty0 net.ifnames=0 NON_PERSISTENT_DEVICE_NAMES=1 showopts
+initrd /boot/initrd.vmx
      +

      /boot/initrd.vmx in the initrd line is the initrd file actually used. Run the dracut -f /boot/initrd.vmx command. If the initrd file does not contain the /boot directory, such as /initramfs-xxx, run the dracut -f /boot/initramfs-xxx command.

      +
    4. Run the following commands to check whether the PVOPS module for Xen or VirtIO module for KVM is loaded:

      lsinitrd /boot/initrd-`uname -r` | grep xen

      +
      lsinitrd /boot/initrd-`uname -r` | grep virtio
      SIA10000xxxxx:~ # lsinitrd /boot/initrd-`uname -r` | grep xen
+-rwxr--r-- 1 root root 42400 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/block/xen-blkfront.ko
+-rwxr--r-- 1 root root 44200 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/net/xen-netfront.ko
+
+SIA10000xxxxx:~ # lsinitrd /boot/initrd-`uname -r` | grep virtio
+-rwxr--r-- 1 root root 19248 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/scsi/virtio_scsi.ko
+-rwxr--r-- 1 root root 23856 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/block/virtio_blk.ko
+drwxr-xr-x 2 root root 0 Jul 12 14:53 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio
+-rwxr--r-- 1 root root 15848 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_ring.ko
+-rwxr--r-- 1 root root 20008 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_pci.ko
+-rwxr--r-- 1 root root 12272 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio.ko
+-rwxr--r-- 1 root root 38208 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/net/virtio_net.ko
      +
      +
    5. Restart the ECS.
    6. Modify the /boot/grub/menu.lst file. Add xen_platform_pci.dev_unplug=all and modify the root configuration.

      Before the modification:

      +
      ###Don't change this comment -YaST2 identifier: Original name: linux###
+title SUSE Linux Enterprise Server 11SP4 - 3.0.76-0.11 (default) 
+root (hd0,0) 
+kernel /boot/vmlinuz-3.0.76-0.11-default root=UUID=4eb40294-4c6f-4384-bbb6-b8795bbb1130 splash=silentcrashkernel=256M-:128M showopts vga=0x314
+initrd /boot/initrd-3.0.76-0.11-default
      +

      After the modification:

      +
      ###Don't change this comment -YaST2 identifier: Original name: linux###
+title SUSE Linux Enterprise Server 11SP4 - 3.0.76-0.11 (default) 
+root (hd0,0) 
+kernel /boot/vmlinuz-3.0.76-0.11-default root=UUID=4eb40294-4c6f-4384-bbb6-b8795bbb1130 splash=silentcrashkernel=256M-:128M showopts vga=0x314 xen_platform_pci.dev_unplug=all 
+initrd /boot/initrd-3.0.76-0.11-default
      +
      • Ensure that the root partition is in the UUID format.
      • xen_platform_pci.dev_unplug=all is added to shield QEMU devices.
      • For SUSE 11 SP1 64bit to SUSE 11 SP4 64bit, add xen_platform_pci.dev_unplug=all to the menu.lst file. For SUSE 12 or later, this function is enabled by default, and you do not need to configure it.
      +
      +
    7. Run the following commands to check whether the Xen drivers exist in initrd:

      lsinitrd /boot/initrd-`uname -r` | grep xen

      +

      lsinitrd /boot/initrd-`uname -r` | grep virtio

      +
      SIA10000xxxxx:~ # lsinitrd /boot/initrd-`uname -r` | grep xen
+-rwxr--r-- 1 root root 42400 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/block/xen-blkfront.ko
+-rwxr--r-- 1 root root 44200 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/net/xen-netfront.ko
+
+SIA10000xxxxx:~ # lsinitrd /boot/initrd-`uname -r` | grep virtio
+-rwxr--r-- 1 root root 19248 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/scsi/virtio_scsi.ko
+-rwxr--r-- 1 root root 23856 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/block/virtio_blk.ko
+drwxr-xr-x 2 root root 0 Jul 12 14:53 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio
+-rwxr--r-- 1 root root 15848 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_ring.ko
+-rwxr--r-- 1 root root 20008 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio_pci.ko
+-rwxr--r-- 1 root root 12272 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/virtio/virtio.ko
+-rwxr--r-- 1 root root 38208 Jun 22 2012 lib/modules/2.6.32-279.el6.x86_64/kernel/drivers/net/virtio_net.ko
      +

      If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following commands to check whether built-in drivers are in the kernel:

      +

      cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y

      +

      cat /boot/config-`uname -r` | grep CONFIG_XEN | grep y

      +
      +
    +
  • If the OS version is SUSE 12 SP1, perform the following steps:
    1. Run the following command to open the /etc/dracut.conf file:

      vi /etc/dracut.conf

      +
    2. Press i to enter editing mode and add the xen-pv and VirtIO drivers to add-drivers (the format varies depending on the OS).
      [root@CTU10000xxxxx ~]# vi /etc/dracut.conf 
+# additional kernel modules to the default
+add_drivers+="ata_piix ata_generic xen_vnif xen_vbd xen_platform_pci virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio"
      +
    3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/dracut.conf file.
    4. Run the following command to regenerate initrd:

      dracut -f /boot/initramfs-File name

      +

      If the virtual file system is not the default initramfs, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the grub.cfg file, which can be /boot/grub/grub.cfg, /boot/grub2/grub.cfg, or /boot/grub/grub.conf depending on the OS.

      +
    5. If the virtual file system is initramfs, run the following commands to check whether native Xen and KVM drivers have been loaded:

      lsinitrd /boot/initramfs-`uname -r`.img | grep xen

      +

      lsinitrd /boot/initramfs-`uname -r`.img | grep virtio

      +

      If the virtual file system is initrd, run the following commands to check whether native Xen and KVM drivers have been loaded:

      +

      lsinitrd /boot/initrd-`uname -r` | grep xen

      +

      lsinitrd /boot/initrd-`uname -r` | grep virtio

      +
    +
  • If the OS version is later than SUSE 12 SP1 or openSUSE 13, perform the following steps:
    Take SUSE Linux Enterprise Server 12 SP2 (x86_64) as an example.
    1. Run the following command to open the /etc/dracut.conf file:

      vi /etc/dracut.conf

      +
    2. Press i to enter editing mode and add the xen-pv and VirtIO drivers to add_drivers (the format varies depending on the OS).
      [root@CTU10000xxxxx ~]# vi /etc/dracut.conf 
+# additional kernel modules to the default
+add_drivers+="ata_piix ata_generic xen-blkfront xen-netfront virtio_blk virtio_scsi virtio_net virtio_pci virtio_ring virtio"
      +
    3. Press Esc, enter :wq, and press Enter. The system saves the change and exits the /etc/dracut.conf file.
    4. Run the following command to regenerate initrd:

      dracut -f /boot/initramfs-File name

      +

      If the virtual file system is not the default initramfs, run the dracut -f Name of the initramfs or initrd file actually used command. The actual initramfs or initrd file name can be obtained from the grub.cfg file, which can be /boot/grub/grub.cfg, /boot/grub2/grub.cfg, or /boot/grub/grub.conf depending on the OS.

      +
    5. If the virtual file system is initramfs, run the following commands to check whether native Xen and KVM drivers have been loaded:

      lsinitrd /boot/initramfs-`uname -r`.img | grep xen

      +

      lsinitrd /boot/initramfs-`uname -r`.img | grep virtio

      +

      If the virtual file system is initrd, run the following commands to check whether the native Xen and KVM driver modules are successfully loaded:

      +

      lsinitrd /boot/initrd-`uname -r` | grep xen

      +

      lsinitrd /boot/initrd-`uname -r` | grep virtio

      +

      Assume that the virtual file system is initrd. The following command output will be displayed:

      +
      sluo-ecs-30dc:~ # lsinitrd /boot/initrd-`uname -r` | grep xen
+-rw-r--r-- 1 root root 69575 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/block/xen-blkfront.ko
+-rw-r--r-- 1 root root 53415 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/net/xen-netfront.ko
+drwxr-xr-x 2 root root 0 Sep 28 10:21 lib/modules/4.4.21-69-default/updates/pvdriver/xen-hcall
+-rwxr-xr-x 1 root root 8320 Sep 28 10:21 lib/modules/4.4.21-69-default/updates/pvdriver/xen-hcall/xen-hcall.ko
+
+sluo-ecs-30dc:~ # lsinitrd /boot/initrd-`uname -r` | grep virtio
+-rw-r--r-- 1 root root 29335 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/block/virtio_blk.ko
+-rw-r--r-- 1 root root 57007 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/net/virtio_net.ko
+-rw-r--r-- 1 root root 32415 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/scsi/virtio_scsi.ko
+drwxr-xr-x 2 root root 0 Sep 28 10:21 lib/modules/4.4.21-69-default/kernel/drivers/virtio
+-rw-r--r-- 1 root root 19623 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/virtio/virtio.ko
+-rw-r--r-- 1 root root 38943 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/virtio/virtio_pci.ko
+-rw-r--r-- 1 root root 24431 Oct 26 2016 lib/modules/4.4.21-69-default/kernel/drivers/virtio/virtio_ring.ko
      +

      If you add built-in drivers to the initrd or initramfs file, the ECS will not be affected. This makes it easy to modify the drivers. However, you cannot check the drivers by running the lsinitrd command. You can run the following commands to check whether built-in drivers are in the kernel:

      +

      cat /boot/config-`uname -r` | grep CONFIG_VIRTIO | grep y

      +

      cat /boot/config-`uname -r` | grep CONFIG_XEN | grep y

      +
      +
    +
    +
+
+
+
+
+
+
Parent topic: Image Optimization
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0086020895.html b/docs/ims/umn/en-us_topic_0086020895.html new file mode 100644 index 000000000..08a6c91b8 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0086020895.html @@ -0,0 +1,132 @@ + + +

Changing the Disk Identifier in the GRUB Configuration File to UUID

+

Scenarios

When optimizing a Linux private image, you need to change the disk identifier to UUID in the GRUB configuration file of the ECS.

+
Modify the menu.lst or grub.cfg configuration file (/boot/grub/menu.lst, /boot/grub/grub.cfg, /boot/grub2/grub.cfg, /boot/grub/grub.conf, or /boot/efi/EFI/euleros/grub.cfg), and configure the boot partition using the UUID.

The root partition identified in the configuration file varies depending on the OS. It may be root=/dev/xvda or root=/dev/disk.

+
+
+
+

Procedure

+
+
+
+
+
Parent topic: Optimizing a Linux Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0086024961.html b/docs/ims/umn/en-us_topic_0086024961.html new file mode 100644 index 000000000..1c6b16a9d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0086024961.html @@ -0,0 +1,44 @@ + + +

Changing the Disk Identifier in the fstab File to UUID

+

Scenarios

When optimizing a Linux private image, you need to change the disk identifier to UUID in the fstab configuration file of the ECS.

+
+

Procedure

+
  1. Log in to the ECS as user root.
  2. Run the following command to query all types of mounted file systems and device UUIDs:

    blkid

    +

    The following information is displayed:

    +
    /dev/xvda2: UUID="4eb40294-4c6f-4384-bbb6-b8795bbb1130" TYPE="xfs"  
+/dev/xvda1: UUID="2de37c6b-2648-43b4-a4f5-40162154e135" TYPE="swap"
    +
  3. Run the following command to query the fstab file:

    cat /etc/fstab

    +

    The following information is displayed:

    +
    [root@CTU1000028010 ~]# cat /etc/fstab  
+/dev/xvda2  /       xfs     defaults    0 0 
+/dev/xvda1  swap    swap    defaults    0 0
    +
  4. Check whether the disk identifier in the fstab file is the device name.
    • If the disk is represented by UUID, no further operation is required.
    • If the disk is represented by the device name, go to 5.
    +
  5. Run the following command to open the fstab file:

    vi /etc/fstab

    +
  6. Press i to enter editing mode and change the disk identifier in the fstab file to UUID.
+ +
  1. Log in to the ECS as user root.
  2. Run the following command to query all types of mounted file systems and device UUIDs:

    blkid

    +
    /dev/xvda2: UUID="4eb40294-4c6f-4384-bbb6-b8795bbb1130" TYPE="xfs" 
+/dev/xvda1: UUID="2de37c6b-2648-43b4-a4f5-40162154e135" TYPE="swap"
    +

    Before the change:

    +
    [root@CTU1000028010 ~]# cat /etc/fstab 
+/dev/xvda2  /       xfs     defaults    0 0
+/dev/xvda1  swap    swap    defaults    0 0
    +

    After the change:

    +
    [root@CTU1000028010 ~]# cat /etc/fstab 
+UUID=4eb40294-4c6f-4384-bbb6-b8795bbb1130  /       xfs     defaults    0 0
+UUID=2de37c6b-2648-43b4-a4f5-40162154e135  swap    swap    defaults    0 0
    +
  3. Press Esc, enter :wq, and press Enter. The system saves the configuration and exits the vi editor.
  4. Run the following command to verify the change:

    cat /etc/fstab

    +

    The change is successful if information similar to the following is displayed:

    +
    [root@CTU1000028010 ~]# cat /etc/fstab  
+UUID=4eb40294-4c6f-4384-bbb6-b8795bbb1130  /       xfs     defaults    0 0 
+UUID=2de37c6b-2648-43b4-a4f5-40162154e135  swap    swap    defaults    0 0
    +
+
+
+
+
+
Parent topic: Optimizing a Linux Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0089615820.html b/docs/ims/umn/en-us_topic_0089615820.html new file mode 100644 index 000000000..43a838b3d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0089615820.html @@ -0,0 +1,95 @@ + + +

Common Image Formats

+

IMS supports multiple image formats, but the system uses ZVHD or ZVHD2 by default.

+

Table 1 lists the common image formats.

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 Common image formats

Image Format

+

Description

+

Remarks

+

ZVHD

+

This format uses the ZLIB compression algorithm and supports sequential read and write.

+

A universal format supported by IaaS OpenStack; a format supported for imported and exported images

+

ZVHD2

+

This format uses the ZSTD algorithm and supports lazy loading.

+

A format for the lazy loading feature; a format supported for imported images

+

QCOW2

+

This is a disk image supported by the QEMU simulator. It is a file that indicates a block device disk of a fixed size. Compared with the RAW format, the QCOW2 format has the following features:

+
  • Supports a lower disk usage.
  • Supports Copy-On-Write (CoW). The image file only reflects disk changes.
  • Supports snapshots.
  • Supports zlib compression and encryption by following Advanced Encryption Standard (AES).
+

A format supported for imported and exported images

+

VMDK

+

VMDK is a virtual disk format from VMware. A VMDK file represents a physical disk drive of the virtual machine file system (VMFS) on an ECS.

+

A format supported for imported and exported images

+

VHD

+

VHD is a virtual disk file format from Microsoft. A VHD file is a compressed file stored in the file system of the host machine. It mainly contains a file system required for starting ECSs.

+

A format supported for imported and exported images

+

VHDX

+

VHDX is a new VHD format introduced into Hyper-V of Windows Server 2012 by Microsoft. Compared with the VHD format, VHDX has a larger storage capacity. It provides protection against data damage during power supply failures, and the disk structure alignment has been optimized to prevent performance degradation of new physical disks in a large sector.

+

A format supported for imported images

+

RAW

+

A RAW file can be directly read and written by ECSs. This format does not support dynamic space expansion and has the best I/O performance.

+

A format supported for imported images

+

QCOW

+

QCOW manages the space allocation of an image through the secondary index table. The secondary index uses the memory cache technology and needs the query operation, which results in performance loss. The performance of QCOW is inferior to that of QCOW2, and the read and write performance is inferior to that of RAW.

+

A format supported for imported images

+

VDI

+

VDI is the disk image file format used by the VirtualBOX virtualization software from Oracle. It supports snapshots.

+

A format supported for imported images

+

QED

+

The QED format is an evolved version of the QCOW2 format. Its storage location query mode and data block size are the same as those of the QCOW2 format. However, QED implements Copy-On-Write (CoW) in a different way as it uses a dirty flag to replace the reference count table of QCOW2.

+

A format supported for imported images

+
+
+
+
+
+
Parent topic: Basic Concepts
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0090099339.html b/docs/ims/umn/en-us_topic_0090099339.html new file mode 100644 index 000000000..f45a91e74 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0090099339.html @@ -0,0 +1,27 @@ + + +

Exporting Image List

+

Scenarios

You can export the public or private image list in the current region as a CSV file to your local PC.

+ +
+

Exporting Private Image Information

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab and click .

    The system will automatically export all private images in the current region under your account to a local directory.

    +

    The file name is in the format of private-images-Region ID-Export time.

    +
    +
+
+

Exporting Public Image Information

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Public Images tab and click .

    The system will automatically export all public images in the current region to a local directory.

    +

    The file name is in the format of public-images-Region ID-Export time.

    +
    +
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0093344231.html b/docs/ims/umn/en-us_topic_0093344231.html new file mode 100644 index 000000000..f7b33f88a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0093344231.html @@ -0,0 +1,32 @@ + + +

Creating a Full-ECS Image from a CSBS Backup

+

Scenarios

Create a full-ECS image from a CSBS backup. This image can then be used to create ECSs.

+
+

Constraints

+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Create a full-ECS image.

    1. Click Create Image in the upper right corner.
    2. In the Image Type and Source area, select Full-ECS image for Type.
    3. Select CSBS Backup for Source and then select a backup from the list.
      Figure 1 Creating a full-ECS image using a CSBS backup
      +
    4. In the Image Information area, configure basic image details, such as the image name and description.
    5. Click Create Now.
    6. Confirm the parameters and click Submit.
    +

  3. Switch back to the Image Management Service page to monitor the image status.

    When the image status changes to Normal, the image creation is complete.

    +

+
+

Follow-up Procedure

+
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0093842586.html b/docs/ims/umn/en-us_topic_0093842586.html new file mode 100644 index 000000000..951eccd9a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0093842586.html @@ -0,0 +1,297 @@ + + +

How Do I Install the NVIDIA Driver on a P1 ECS?

+

Prerequisites

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 NVIDIA drivers

OS

+

Driver

+

How to Obtain

+

Ubuntu 16.04

+

GPU driver installation package NVIDIA-Linux-x86_64-375.66.run

+

http://www.nvidia.com/download/driverResults.aspx/118955/en-us

+

CUDA Toolkit installation package cuda_8.0.61_375.26_linux.run

+

https://developer.nvidia.com/compute/cuda/8.0/Prod2/local_installers/cuda_8.0.61_375.26_linux-run

+

CentOS 7.4

+

GPU driver installation package NVIDIA-Linux-x86_64-375.66.run

+

http://www.nvidia.com/download/driverResults.aspx/118955/en-us

+

CUDA Toolkit installation package cuda_8.0.61_375.26_linux.run

+

https://developer.nvidia.com/compute/cuda/8.0/Prod2/local_installers/cuda_8.0.61_375.26_linux-run

+

Debian 9.0

+

GPU driver installation package NVIDIA-Linux-x86_64-384.81.run

+

http://www.nvidia.com/download/driverResults.aspx/124722/en-us

+

CUDA Toolkit installation package cuda_9.0.176_384.81_linux.run

+

https://developer.nvidia.com/compute/cuda/9.0/Prod/local_installers/cuda_9.0.176_384.81_linux-run

+
+
+
+

Procedure

The procedure for installing the NVIDIA driver varies according to the OS.

+ +
  1. Log in to the target ECS and run the following command to switch to user root:

    sudo su

    +

  2. (Optional) Install the GCC and g++ software.

    Perform this step only if the GCC and g++ software has not been installed.

    +

    apt-get install gcc

    +

    apt-get install g++

    +

    apt-get install make

    +

  3. (Optional) Disable the Nouveau driver.

    Perform this step if the Nouveau driver has been installed on the target ECS. This prevents conflict with the NVIDIA driver installation.

    +
    1. Run the following command to check whether the Nouveau driver is running on the target ECS:

      lsmod | grep nouveau

      +
      • If yes, go to 3.b.
      • If no, go to 4.
      +
    2. Add the following statement to the end of the /etc/modprobe.d/blacklist.conf file:

      blacklist nouveau

      +

      options nouveau modeset=0

      +
    3. Run the following commands to back up and create an initramfs application:

      mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak

      +

      update-initramfs -u

      +
    4. Run the following command to restart the ECS:

      reboot

      +
    +

  4. (Optional) Disable the X service.

    If the ECS has been logged in using the GUI, disable the X service before installing the NVIDIA driver.

    +
    1. Run the following command to switch to multi-user mode:

      systemctl set-default multi-user.target

      +
    2. Run the following command to restart the ECS:

      reboot

      +
    +

  5. (Optional) Install the GPU driver.

    You can either use the GPU driver provided in the CUDA Toolkit installation package or download the required GPU driver. Unless otherwise specified, you are advised to install GPU driver NVIDIA-Linux-x86_64-375.66.run, which has been fully verified.
    1. Upload the GPU driver installation package NVIDIA-Linux-x86_64-xxx.yy.run to the /tmp directory of the ECS.

      To download the GPU driver, log in at http://www.nvidia.com/Download/index.aspx?lang=en.

      +
      Figure 1 Downloading the GPU driver
      +
    2. Run the following command to install the GPU driver:

      sh ./NVIDIA-Linux-x86_64-xxx.yy.run

      +
    3. Run the following command to delete the installation package:

      rm -f NVIDIA-Linux-x86_64-xxx.yy.run

      +
    +
    +

  6. Install the CUDA Toolkit.

    Unless otherwise specified, you are advised to install CUDA Toolkit cuda_8.0.61_375.26_linux.run, which has been fully verified.
    1. Upload the CUDA Toolkit installation package cuda_a.b.cc_xxx.yy_linux.run to the /tmp directory of the ECS.

      To download the CUDA Toolkit, log in at https://developer.nvidia.com/cuda-downloads.

      +
    2. Run the following command to change the permission:

      chmod +x cuda_a.b.cc_xxx.yy_linux.run

      +
    3. Run the following command to install the CUDA Toolkit:

      ./cuda_a.b.cc_xxx.yy_linux.run -toolkit -samples -silent -override --tmpdir=/tmp/

      +
    4. Run the following command to delete the installation package:

      rm -f cuda_a.b.cc_xxx.yy_linux.run

      +
    5. Run the following commands to check whether the installation is successful:

      cd /usr/local/cuda/samples/1_Utilities/deviceQueryDrv/

      +

      make

      +

      ./deviceQueryDrv

      +

      If the terminal display contains "Result = PASS", both CUDA Toolkit and GPU driver have been installed.

      +
      ./deviceQueryDrv Starting...  
+   
+ CUDA Device Query (Driver API) statically linked version   
+ Detected 1 CUDA Capable device(s)  
+   
+ Device 0: "Tesla P100-PCIE-16GB"  
+   CUDA Driver Version:                           8.0  
+   CUDA Capability Major/Minor version number:    6.0  
+   Total amount of global memory:                 16276 MBytes (17066885120 bytes)  
+   (56) Multiprocessors, ( 64) CUDA Cores/MP:     3584 CUDA Cores  
+   GPU Max Clock rate:                            1329 MHz (1.33 GHz)  
+   Memory Clock rate:                             715 Mhz  
+   Memory Bus Width:                              4096-bit  
+   L2 Cache Size:                                 4194304 bytes  
+   Max Texture Dimension Sizes                    1D=(131072) 2D=(131072, 65536) 3D=(16384, 16384, 16384)  
+   Maximum Layered 1D Texture Size, (num) layers  1D=(32768), 2048 layers  
+   Maximum Layered 2D Texture Size, (num) layers  2D=(32768, 32768), 2048 layers  
+   Total amount of constant memory:               65536 bytes  
+   Total amount of shared memory per block:       49152 bytes  
+   Total number of registers available per block: 65536  
+   Warp size:                                     32  
+   Maximum number of threads per multiprocessor:  2048  
+   Maximum number of threads per block:           1024  
+   Max dimension size of a thread block (x,y,z): (1024, 1024, 64)  
+   Max dimension size of a grid size (x,y,z):    (2147483647, 65535, 65535)  
+   Texture alignment:                             512 bytes  
+   Maximum memory pitch:                          2147483647 bytes  
+   Concurrent copy and kernel execution:          Yes with 2 copy engine(s)  
+   Run time limit on kernels:                     No  
+   Integrated GPU sharing Host Memory:            No  
+   Support host page-locked memory mapping:       Yes  
+   Concurrent kernel execution:                   Yes  
+   Alignment requirement for Surfaces:            Yes  
+   Device has ECC support:                        Enabled  
+   Device supports Unified Addressing (UVA):      Yes  
+   Device PCI Domain ID / Bus ID / location ID:   0 / 0 / 6  
+   Compute Mode:  
+      < Default (multiple host threads can use ::cudaSetDevice() with device simultaneously) >  
+ Result = PASS
      +
    +
    +

+ +
  1. Log in to the target ECS and run the following command to switch to user root:

    sudo su

    +

  2. (Optional) Install GCC, g++, and kernel-devel.

    Perform this step only if GCC, g++, and kernel-devel have not been installed.

    +

    yum install gcc

    +

    yum install gcc-c++

    +

    yum install make

    +

    yum install kernel-devel-`uname -r`

    +

  3. (Optional) Disable the Nouveau driver.

    Perform this step if the Nouveau driver has been installed on the target ECS. This prevents conflict with the NVIDIA driver installation.

    +
    1. Run the following command to check whether the Nouveau driver is running on the target ECS:

      lsmod | grep nouveau

      +
      • If yes, go to 3.b.
      • If no, go to 4.
      +
    2. Add the following statement to the end of the /etc/modprobe.d/blacklist.conf file:

      blacklist nouveau

      +
    3. Run the following commands to back up and create an initramfs application:

      mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak

      +

      dracut -v /boot/initramfs-$(uname -r).img $(uname -r)

      +
    4. Run the following command to restart the ECS:

      reboot

      +
    +

  4. (Optional) Disable the X service.

    If the ECS has been logged in using the GUI, disable the X service before installing the NVIDIA driver.

    +
    1. Run the following command to switch to multi-user mode:

      systemctl set-default multi-user.target

      +
    2. Run the following command to restart the ECS:

      reboot

      +
    +

  5. (Optional) Install the GPU driver.

    You can either use the GPU driver provided in the CUDA Toolkit installation package or download the required GPU driver. Unless otherwise specified, you are advised to install GPU driver NVIDIA-Linux-x86_64-375.66.run, which has been fully verified.
    1. Upload the GPU driver installation package NVIDIA-Linux-x86_64-xxx.yy.run to the /tmp directory of the ECS.

      To download the GPU driver, log in at http://www.nvidia.com/Download/index.aspx?lang=en.

      +
      Figure 2 Downloading the driver installation package
      +
    2. Run the following command to install the GPU driver:

      sh ./NVIDIA-Linux-x86_64-xxx.yy.run

      +
    3. Run the following command to delete the installation package:

      rm -f NVIDIA-Linux-x86_64-xxx.yy.run

      +
    +
    +

  6. Install the CUDA Toolkit.

    Unless otherwise specified, you are advised to install CUDA Toolkit cuda_8.0.61_375.26_linux.run, which has been fully verified.
    1. Upload the CUDA Toolkit installation package cuda_a.b.cc_xxx.yy_linux.run to the /tmp directory of the ECS.

      To download the CUDA Toolkit, log in at https://developer.nvidia.com/cuda-downloads.

      +
    2. Run the following command to change the permission:

      chmod +x cuda_a.b.cc_xxx.yy_linux.run

      +
    3. Run the following command to install the CUDA Toolkit:

      ./cuda_a.b.cc_xxx.yy_linux.run -toolkit -samples -silent -override --tmpdir=/tmp/

      +
    4. Run the following command to delete the installation package:

      rm -f cuda_a.b.cc_xxx.yy_linux.run

      +
    5. Run the following commands to check whether the installation is successful:

      cd /usr/local/cuda/samples/1_Utilities/deviceQueryDrv/

      +

      make

      +

      ./deviceQueryDrv

      +

      If the terminal display contains "Result = PASS", both CUDA Toolkit and GPU driver have been installed.

      +
      ./deviceQueryDrv Starting...  
+   
+ CUDA Device Query (Driver API) statically linked version   
+ Detected 1 CUDA Capable device(s)  
+   
+ Device 0: "Tesla P100-PCIE-16GB"  
+   CUDA Driver Version:                           8.0  
+   CUDA Capability Major/Minor version number:    6.0  
+   Total amount of global memory:                 16276 MBytes (17066885120 bytes)  
+   (56) Multiprocessors, ( 64) CUDA Cores/MP:     3584 CUDA Cores  
+   GPU Max Clock rate:                            1329 MHz (1.33 GHz)  
+   Memory Clock rate:                             715 Mhz  
+   Memory Bus Width:                              4096-bit  
+   L2 Cache Size:                                 4194304 bytes  
+   Max Texture Dimension Sizes                    1D=(131072) 2D=(131072, 65536) 3D=(16384, 16384, 16384)  
+   Maximum Layered 1D Texture Size, (num) layers  1D=(32768), 2048 layers  
+   Maximum Layered 2D Texture Size, (num) layers  2D=(32768, 32768), 2048 layers  
+   Total amount of constant memory:               65536 bytes  
+   Total amount of shared memory per block:       49152 bytes  
+   Total number of registers available per block: 65536  
+   Warp size:                                     32  
+   Maximum number of threads per multiprocessor:  2048  
+   Maximum number of threads per block:           1024  
+   Max dimension size of a thread block (x,y,z): (1024, 1024, 64)  
+   Max dimension size of a grid size (x,y,z):    (2147483647, 65535, 65535)  
+   Texture alignment:                             512 bytes  
+   Maximum memory pitch:                          2147483647 bytes  
+   Concurrent copy and kernel execution:          Yes with 2 copy engine(s)  
+   Run time limit on kernels:                     No  
+   Integrated GPU sharing Host Memory:            No  
+   Support host page-locked memory mapping:       Yes  
+   Concurrent kernel execution:                   Yes  
+   Alignment requirement for Surfaces:            Yes  
+   Device has ECC support:                        Enabled  
+   Device supports Unified Addressing (UVA):      Yes  
+   Device PCI Domain ID / Bus ID / location ID:   0 / 0 / 6  
+   Compute Mode:  
+      < Default (multiple host threads can use ::cudaSetDevice() with device simultaneously) >  
+ Result = PASS
      +
    +
    +

+ +
  1. Log in to the target ECS and run the following command to switch to user root:

    sudo su

    +

  2. (Optional) Install the dependency software GCC and g++ of the NVIDIA driver.

    Perform this step only if the GCC and g++ software has not been installed.

    +

    apt-get install gcc

    +

    apt-get install g++

    +

    apt-get install make

    +

    apt-get install linux-headers-$(uname -r)

    +

  3. (Optional) Disable the Nouveau driver.

    Perform this step if the Nouveau driver has been installed on the target ECS. This prevents conflict with the NVIDIA driver installation.

    +
    1. Run the following command to check whether the Nouveau driver is running on the target ECS:

      lsmod | grep nouveau

      +
      • If yes, go to 3.b.
      • If no, go to 4.
      +
    2. Add the following statement to the end of the /etc/modprobe.d/blacklist.conf file:

      blacklist nouveau

      +

      options nouveau modeset=0

      +
    3. Run the following commands to back up and create an initramfs application:

      mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak

      +

      update-initramfs -u

      +
    4. Run the following command to restart the ECS:

      reboot

      +
    +

  4. (Optional) Disable the X service.

    If the ECS has been logged in using the GUI, disable the X service before installing the NVIDIA driver.

    +
    1. Run the following command to switch to multi-user mode:

      systemctl set-default multi-user.target

      +
    2. Run the following command to restart the ECS:

      reboot

      +
    +

  5. (Optional) Install the GPU driver.

    You can either use the GPU driver provided in the CUDA Toolkit installation package or download the required GPU driver. Unless otherwise specified, you are advised to install GPU driver NVIDIA-Linux-x86_64-384.81.run, which has been fully verified.
    1. Upload the GPU driver installation package NVIDIA-Linux-x86_64-xxx.yy.run to the /tmp directory of the ECS.

      To download the GPU driver, log in at http://www.nvidia.com/Download/index.aspx?lang=en.

      +
      Figure 3 Downloading the GPU driver
      +
    2. Run the following command to install the GPU driver:

      sh ./NVIDIA-Linux-x86_64-xxx.yy.run

      +
    3. Run the following command to delete the installation package:

      rm -f NVIDIA-Linux-x86_64-xxx.yy.run

      +
    +
    +

  6. Install the CUDA Toolkit.

    The CUDA Toolkit version required by Debian 9.0 GCC must be 9.0 or later. Unless otherwise specified, you are advised to install CUDA Toolkit cuda_9.0.176_384.81_linux.run, which has been fully verified.
    1. Upload the CUDA Toolkit installation package cuda_a.b.cc_xxx.yy_linux.run to the /tmp directory of the ECS.

      To download the CUDA Toolkit, log in at https://developer.nvidia.com/cuda-downloads.

      +
    2. Run the following command to change the permission:

      chmod +x cuda_a.b.cc_xxx.yy_linux.run

      +
    3. Run the following command to install the CUDA Toolkit:

      ./cuda_a.b.cc_xxx.yy_linux.run -toolkit -samples -silent -override --tmpdir=/tmp/

      +
    4. Run the following command to delete the installation package:

      rm -f cuda_a.b.cc_xxx.yy_linux.run

      +
    5. Run the following commands to check whether the installation is successful:

      cd /usr/local/cuda/samples/1_Utilities/deviceQueryDrv/

      +

      make

      +

      ./deviceQueryDrv

      +

      If the terminal display contains "Result = PASS", both CUDA Toolkit and GPU driver have been installed.

      +
      ./deviceQueryDrv Starting...
+ 
+CUDA Device Query (Driver API) statically linked version 
+Detected 1 CUDA Capable device(s)
+ 
+Device 0: "Tesla P100-PCIE-16GB"
+  CUDA Driver Version:                           9.0
+  CUDA Capability Major/Minor version number:    6.0
+  Total amount of global memory:                 16276 MBytes (17066885120 bytes)
+  (56) Multiprocessors, ( 64) CUDA Cores/MP:     3584 CUDA Cores
+  GPU Max Clock rate:                            1329 MHz (1.33 GHz)
+  Memory Clock rate:                             715 Mhz
+  Memory Bus Width:                              4096-bit
+  L2 Cache Size:                                 4194304 bytes
+  Max Texture Dimension Sizes                    1D=(131072) 2D=(131072, 65536) 3D=(16384, 16384, 16384)
+  Maximum Layered 1D Texture Size, (num) layers  1D=(32768), 2048 layers
+  Maximum Layered 2D Texture Size, (num) layers  2D=(32768, 32768), 2048 layers
+  Total amount of constant memory:               65536 bytes
+  Total amount of shared memory per block:       49152 bytes
+  Total number of registers available per block: 65536
+  Warp size:                                     32
+  Maximum number of threads per multiprocessor:  2048
+  Maximum number of threads per block:           1024
+  Max dimension size of a thread block (x,y,z): (1024, 1024, 64)
+  Max dimension size of a grid size (x,y,z):    (2147483647, 65535, 65535)
+  Texture alignment:                             512 bytes
+  Maximum memory pitch:                          2147483647 bytes
+  Concurrent copy and kernel execution:          Yes with 2 copy engine(s)
+  Run time limit on kernels:                     No
+  Integrated GPU sharing Host Memory:            No
+  Support host page-locked memory mapping:       Yes
+  Concurrent kernel execution:                   Yes
+  Alignment requirement for Surfaces:            Yes
+  Device has ECC support:                        Enabled
+  Device supports Unified Addressing (UVA):      Yes
+  Supports Cooperative Kernel Launch:            Yes
+  Supports MultiDevice Co-op Kernel Launch:      Yes
+  Device PCI Domain ID / Bus ID / location ID:   0 / 0 / 6
+  Compute Mode:
+     < Default (multiple host threads can use ::cudaSetDevice() with device simultaneously) >
+Result = PASS
      +
    +
    +

+
+
+
+
+
Parent topic: OS
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0093887081.html b/docs/ims/umn/en-us_topic_0093887081.html new file mode 100644 index 000000000..4802663fb --- /dev/null +++ b/docs/ims/umn/en-us_topic_0093887081.html @@ -0,0 +1,40 @@ + + +

Running Sysprep

+

Scenarios

Running Sysprep ensures that an ECS has a unique SID after it is added to a domain.

+

After installing Cloudbase-Init on an ECS, you need to decide whether the ECS needs to be added to a domain or whether it must have a unique SID. If yes, run Sysprep as instructed in this section.

+
+

Prerequisites

+
+

Procedure

  1. Enter the Cloudbase-Init installation directory.

    C:\Program Files\Cloudbase Solutions\ is used as an example of the Cloudbase-Init installation directory. Switch to the root directory of drive C and run the following command to enter the installation directory:

    +

    cd C:\Program Files\Cloudbase Solutions\Cloudbase-Init\conf

    +
  2. Run the following command to encapsulate Windows:

    C:\Windows\System32\sysprep\sysprep.exe /generalize /oobe /unattend:Unattend.xml

    +
    • Ensure that /unattend:Unattend.xml is contained in the preceding command. Otherwise, the username, password, and other important configuration information of the ECS will be reset, and you must configure the OS manually when you use ECSs created from the Windows private image.
    • After this command is executed, the ECS will be automatically stopped. After the ECS is stopped, use the ECS to create an image. ECSs created using the image have unique SIDs. If you restart a Windows ECS on which Sysprep has been executed, Sysprep takes effect only for the current ECS. Before creating an image using the ECS, you must run Sysprep again.
    • For Windows Server 2012 and Windows Server 2012 R2, the administrator password of the ECS will be deleted after Sysprep is executed on the ECS. You need to log in to the ECS and reset the administrator password. In this case, the administrator password set on the management console will be invalid. Keep the password you set secure.
    • If a domain account is required for logins, run Sysprep on the ECS before using it to create a private image. For details about the impact of running Sysprep, see Why Is Sysprep Required for Creating a Private Image from a Windows ECS?
    • The Cloudbase-Init account of a Windows ECS is an internal account of the Cloudbase-Init agent. This account is used for obtaining metadata and completing relevant configuration when the Windows ECS starts. If you modify or delete this account, or uninstall the Cloudbase-Init agent, you will be unable to inject initial custom information into an ECS created from a Windows private image. Therefore, you are not advised to modify or delete the Cloudbase-Init account.
    +
    +
    Figure 2 Running Sysprep
    +
+
+

Follow-up Procedure

  1. Create a private image from the ECS on which Sysprep is executed. For details, see Creating a System Disk Image from a Windows ECS.
  2. You can use the image to create ECSs. Each ECS has a unique SID.

    Run the following command to query the ECS SID:

    +

    whoami /user

    +
    Figure 3 ECS SID before Sysprep is executed
    +
    Figure 4 ECS SID after Sysprep is executed
    +
+
+
+
+
+
Parent topic: Windows Operations
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0095084510.html b/docs/ims/umn/en-us_topic_0095084510.html new file mode 100644 index 000000000..0a5e5d813 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0095084510.html @@ -0,0 +1,11 @@ + + +

Creating a BMS System Disk Image

+

For how to create a BMS private image, see Bare Metal Server User Guide.

+
+
+
+
Parent topic: Creating a Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0096558549.html b/docs/ims/umn/en-us_topic_0096558549.html new file mode 100644 index 000000000..457c51213 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0096558549.html @@ -0,0 +1,15 @@ + + +

What Do I Do If I Cannot Create an Image in ZVHD2 Format Using an API?

+

Symptom

When you create a ZVHD2 image using an API, the image is created in the ZVHD format.

+
+

Solution

Check whether your token contains the op_gated_lld role (op_gated_lld is the OBT tag, which can be viewed in the body of the response message of the API used to obtain a user token). The ZVHD2 image has the lazy loading feature. If the current environment does not support this feature or this feature is in the OBT phase, the ZVHD2 image will fail to be created.

+

Contact the customer service to ensure that the current environment supports the lazy loading feature, obtain a new token, and use the new token to create an image.

+
+
+
+
+
Parent topic: Image Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0102644450.html b/docs/ims/umn/en-us_topic_0102644450.html new file mode 100644 index 000000000..e9bf1f8b8 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0102644450.html @@ -0,0 +1,37 @@ + + +

Creating a Data Disk Image from an ECS

+

Scenarios

A data disk image contains only service data. You can create a data disk image from an ECS and then use the image to create new EVS disks. This is a convenient way to migrate data from an ECS to EVS disks.

+

For example, you can create a data disk image to clone the data of an ECS whose disk is about to expire.

+
+

Background

The following figure shows the process of creating a data disk image from an ECS.

+
Figure 1 Creating a data disk image and using it to create data disks
+
+

Prerequisites

+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Create a data disk image.

    1. Click Create Image in the upper right corner.
    2. In the Image Type and Source area, select Data disk image for Type.
    3. Select ECS for Source and then select a data disk of the ECS.
      Figure 2 Creating a data disk image
      +
    4. In the Image Information area, set Name, Tag, and Description.
    5. Click Create Now.
    6. Confirm the parameters and click Submit.
    +

  3. Go back to the Private Images page and view the new data disk image.
+
+

Follow-up Procedure

If you want to use the created data disk image to create an EVS disk and attach it to an ECS, you can perform either of the following operations:

+ +
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0106312064.html b/docs/ims/umn/en-us_topic_0106312064.html new file mode 100644 index 000000000..f2940b9cb --- /dev/null +++ b/docs/ims/umn/en-us_topic_0106312064.html @@ -0,0 +1,19 @@ + + +

How Do I Delete Redundant Network Connections from a Windows ECS?

+

Method 1

  1. Press Win+R. In the displayed dialog box, enter regedit and press Enter to open the registry editor.
  2. Open the following registry key:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\NetworkList\Profiles

    +

    Click each item under Profiles and query the Data column of ProfileName in the right pane.

    +
  3. Double-click ProfileName and set Value Data to the name of a new network.
  4. Restart the ECS for the change to take effect.
+
+

Method 2

  1. Press Win+R. In the displayed dialog box, enter regedit and press Enter to open the registry editor.
  2. Open the following registry keys:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\NetworkList\Profiles

    +

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\NetworkList\Signatures\Unmanaged

    +
  3. Delete the directories shown in the following figure.
    Figure 1 Registry directory
    +
+
+
+
+
+
Parent topic: OS
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0106444267.html b/docs/ims/umn/en-us_topic_0106444267.html new file mode 100644 index 000000000..ab3933ed6 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0106444267.html @@ -0,0 +1,14 @@ + + +

How Do I Create a Full-ECS Image Using an ECS That Has a Spanned Volume?

+

An ECS used to create a Windows full-ECS image cannot have a spanned volume. If you attempt to create an image from an ECS with a spanned volume, when the image is used to create new ECSs, data may be lost.

+

If an ECS has a spanned volume, back up data in the spanned volume and then delete this volume from the ECS. Use the ECS to create a full-ECS image. Use the full-ECS image to create an ECS. Then, use the backup to create a spanned volume for the new ECS if necessary.

+

If a Linux ECS has a volume group or a logical volume consisting of multiple physical volumes, to ensure you do not lose any data, back up data in the volume group or logical volume and delete the volume group or logical volume before using this ECS to create a full-ECS image.

+
+
+
+
+
Parent topic: Image Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0107462580.html b/docs/ims/umn/en-us_topic_0107462580.html new file mode 100644 index 000000000..eee67035e --- /dev/null +++ b/docs/ims/umn/en-us_topic_0107462580.html @@ -0,0 +1,17 @@ + + +

Auditing Key Operations

+
+
+ + +
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0107462581.html b/docs/ims/umn/en-us_topic_0107462581.html new file mode 100644 index 000000000..04a8c4eff --- /dev/null +++ b/docs/ims/umn/en-us_topic_0107462581.html @@ -0,0 +1,188 @@ + + +

IMS Operations Recorded by CTS

+

Scenarios

Cloud Trace Service (CTS) is a log audit service provided by the public cloud and intended for cloud security. It allows you to collect, store, and query cloud resource operation records and use these records for security analysis, compliance auditing, resource tracking, and fault locating.

+

You can use CTS to record IMS operations for later querying, auditing, and backtracking.

+
+

Prerequisites

You need to enable CTS before using it. If it is not enabled, IMS operations cannot be recorded. After being enabled, CTS automatically creates a tracker to record all your operations. The tracker stores only the operations of the last seven days. To store the operations for a longer time, store trace files in OBS buckets.

+
+

IMS Operations Recorded by CTS

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 IMS operations that can be recorded by CTS

Operation

+

Resource Type

+

Trace Name

+

Creating an Image

+

ims

+

createImage

+

Modifying an image

+

ims

+

updateImage

+

Deleting images in a batch

+

ims

+

deleteImage

+

Replicating an image

+

ims

+

copyImage

+

Exporting an image

+

ims

+

exportImage

+

Adding a tenant that can use a shared image

+

ims

+

addMember

+

Modifying tenants that can use a shared image

+

ims

+

updateMember

+

Deleting tenants from the group where the members can use a shared image

+

ims

+

deleteMemeber

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 2 Relationship between IMS operations and native OpenStack APIs

Operation

+

Trace Name

+

Service Type

+

Resource Type

+

OpenStack Component

+

Creating an Image

+

createImage

+

IMS

+

image

+

glance

+

Modifying/Uploading an image

+

updateImage

+

IMS

+

image

+

glance

+

Deleting an image

+

deleteImage

+

IMS

+

image

+

glance

+

Tagging an image

+

addTag

+

IMS

+

image

+

glance

+

Deleting an image tag

+

deleteTag

+

IMS

+

image

+

glance

+

Adding a tenant that can use a shared image

+

addMember

+

IMS

+

image

+

glance

+

Modifying information about a tenant that can use a shared image

+

updateMember

+

IMS

+

image

+

glance

+

Deleting a tenant from the group where the members can use a shared image

+

deleteMember

+

IMS

+

image

+

glance

+
+
+
+
+
+
+
Parent topic: Auditing Key Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0107462582.html b/docs/ims/umn/en-us_topic_0107462582.html new file mode 100644 index 000000000..8c65f668c --- /dev/null +++ b/docs/ims/umn/en-us_topic_0107462582.html @@ -0,0 +1,21 @@ + + +

Viewing Traces

+

Scenarios

Once CTS is enabled, it starts recording IMS operations. You can view operations recorded in the last seven days on the CTS management console.

+

This section describes how to view the records.

+
+

Procedure

  1. Access the CTS console.
    1. Log in to the management console.
    2. Click Cloud Trace Service under Management & Governance.
    +
  2. In the navigation pane on the left, choose Trace List.
  3. Set the filter criteria and click Query.
    The following filters are available:
    • Trace Type, Trace Source, Resource Type, and Search By.

      Select Management for Trace Type and IMS for Trace Source.

      +

      Note that:

      +
      • If you select Resource ID for Search By, you need to enter a resource ID. Only whole word match is supported.
      • If you select Resource name for Search By, you need to select or enter a specific resource name.
      +
    • Operator: Select a specific operator from the drop-down list.
    • Trace Status: Available values are All trace statuses, Normal, Warning, and Incident.
    • Time range: You can select Last 1 hour, Last 1 day, Last 1 week, or Customize.
    +
    +
  4. Locate the target trace and click to expand the trace details.
  5. Click View Trace in the upper right corner of the trace details area.
+
+
+
+
+
Parent topic: Auditing Key Operations
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0113403127.html b/docs/ims/umn/en-us_topic_0113403127.html new file mode 100644 index 000000000..dbdb0e278 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0113403127.html @@ -0,0 +1,16 @@ + + +

What Do I Do If an ECS Created from a Windows Image Failed to Start When I Have Enabled Automatic Configuration During Image Registration?

+

Symptom

This issue is probably caused by the failure of offline VirtIO driver injection.

+
+

Solution

When you inject the VirtIO driver for a Windows ECS offline, there are some restrictions:

+ +

To update the VirtIO driver, you must install UVP VMTools. For how to install UVP VMTools, see Optimizing a Windows Private Image.

+
+
+
+
+
Parent topic: ECS Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0113533721.html b/docs/ims/umn/en-us_topic_0113533721.html new file mode 100644 index 000000000..d43a7290a --- /dev/null +++ b/docs/ims/umn/en-us_topic_0113533721.html @@ -0,0 +1,36 @@ + + +

How Is BIOS Different from UEFI?

+
+
+ + + + + + + + + + + + + +
Table 1 Differences between the UEFI and BIOS boot modes

Boot Mode

+

Description

+

Highlight

+

BIOS

+

Basic Input Output System (BIOS) stores important basic input/output programs of ECSs, system settings, self-test programs upon system startup, and automatic startup programs.

+

Provides basic settings and control for ECSs.

+

UEFI

+

Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an OS and platform firmware. UEFI can be used to automatically load an OS from a pre-boot operating environment.

+

Boots up or recovers from sleep state faster.

+
+
+
+
+
+
Parent topic: OS
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0113992021.html b/docs/ims/umn/en-us_topic_0113992021.html new file mode 100644 index 000000000..4d04f74df --- /dev/null +++ b/docs/ims/umn/en-us_topic_0113992021.html @@ -0,0 +1,15 @@ + + +

What Do I Do If Injecting the Key or Password Using Cloud-Init Failed After NetworkManager Is Installed?

+

Symptom

A major cause is that the version of Cloud-Init is incompatible with that of NetworkManager. In Debian 9.0 and later versions, NetworkManager is incompatible with Cloud-Init 0.7.9.

+
+

Solution

Uninstall the current Cloud-Init and install Cloud-Init 0.7.6 or an earlier version.

+

For details about how to install Cloud-Init, see Installing Cloud-Init.

+
+
+
+
+
Parent topic: Cloud-Init
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0116125142.html b/docs/ims/umn/en-us_topic_0116125142.html new file mode 100644 index 000000000..a2c8fc1ea --- /dev/null +++ b/docs/ims/umn/en-us_topic_0116125142.html @@ -0,0 +1,72 @@ + + +

Creating a Full-ECS Image from an ECS

+

Scenarios

You can create an image of an entire ECS, including not just the OS, but also the software and all the service data. You can then use this image to migrate data by quickly provisioning exact clones of the original ECS.

+
+

Background

The following figure shows the process of creating an image from an entire ECS, with both the system and data disks included.

+
Figure 1 Creating a full-ECS image from an ECS
+ +
+

Constraints

+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Create a full-ECS image.

    1. Click Create Image in the upper right corner.
    2. In the Image Type and Source area, select Full-ECS image for Type.
    3. Select ECS for Source and then select an ECS from the list.
      Figure 2 Creating a full-ECS image using an ECS
      +
    4. Specify Server Backup Vault to store backups.

      The created full-ECS image and backup are stored in the server backup vault.

      +

      If no server backup vault is available, click Create Server Backup Vault to create one. Ensure that you select Backup for Protection Type. For more information about CBR backups and vaults, see Cloud Backup and Recovery User Guide.

      +
    5. In the Image Information area, configure basic image details, such as the image name and description.
    6. Click Create Now.
    7. Confirm the parameters and click Submit.
    +

  3. Go back to the Private Images page and view the new full-ECS image.

    • When the image status changes to Normal, the image creation is complete.
    • If Available in AZX is displayed under Normal in the Status column for a full-ECS image, the backup for this ECS has not been created and only a disk snapshot is created. (AZX indicates the AZ where the source ECS of the image resides.)

      In this case, the full-ECS image can be used to provision ECSs only in the specified AZ. If you want to use this image to provision ECSs in other AZs of the region, you need to wait until Available in AZX disappears from under Normal, which indicates that the ECS backup has been successfully created. This process takes about 10 minutes, depending on the data volume of the source ECS.

      +
      Figure 3 Full-ECS image status
      +
    +

+
+

Follow-up Procedure

+
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0117142739.html b/docs/ims/umn/en-us_topic_0117142739.html new file mode 100644 index 000000000..91e011ba6 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0117142739.html @@ -0,0 +1,28 @@ + + +

What Do I Do If an ECS Starts Slowly?

+

Symptom

If an ECS starts slowly, you can change the default timeout duration to speed up the startup.

+
+

Solution

  1. Log in to the ECS.
  2. Run the following command to switch to user root:

    sudo su

    +
  3. Run the following command to query the version of the GRUB file:

    rpm -qa | grep grub

    +
    Figure 1 Querying the GRUB file version
    +
  4. Set timeout in the GRUB file to 0.
    • If the GRUB file version is earlier than 2:

      Open /boot/grub/grub.cfg or /boot/grub/menu.lst and set timeout to 0.

      +
    • If the GRUB file version is 2:

      Open /boot/grub2/grub.cfg and set the value of timeout to 0.

      +
      Figure 2 Modifying the timeout duration
      +
    +
+
+
+
+
+
Parent topic: OS
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0117262219.html b/docs/ims/umn/en-us_topic_0117262219.html new file mode 100644 index 000000000..91bd1018e --- /dev/null +++ b/docs/ims/umn/en-us_topic_0117262219.html @@ -0,0 +1,146 @@ + + +

Converting the Image Format Using qemu-img

+

Scenarios

You can import an image file in VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, QED, ZVHD, or ZVHD2 format to the cloud platform. Image files in other formats need to be converted before being imported. The open-source tool qemu-img is provided for you to convert image file formats.

+
+

Background

+
+

Windows

  1. Install qemu-img.
    1. Download the qemu-img installation package from https://qemu.weilnetz.de/w64/.
    2. Double-click the setup file to install qemu-img in D:\Program Files\qemu (an example installation path).
    +
  2. Configure environment variables.
    1. Choose Start > Computer and right-click Properties.
    2. Click Advanced system settings.
    3. In the System Properties dialog box, click Advanced > Environment Variables.
    4. In the Environment Variables dialog box, search for Path in the System Variable area and click Edit. Add D:\Program Files\qemu to Variable Value. Use semicolons (;) to separate variable values.

      If Path does not exist, add it and set its value to D:\Program Files\qemu.

      +
      +
    5. Click OK.
    +
  3. Verify the installation.

    Choose Start > Run, enter cmd, and press Enter. In the cmd window, enter qemu-img --help. If the qemu-img version information is contained in the command output, the installation is successful.

    +
  4. Convert the image format.
    1. In the cmd window, run the following commands to switch to D:\Program Files\qemu:

      d:

      +

      cd D:\Program Files\qemu

      +
    1. Run the following command to convert the image file format from VMDK to QCOW2:

      qemu-img convert -p -f vmdk -O qcow2 centos6.9.vmdk centos6.9.qcow2

      +

      The parameters are described as follows:

      +
      • -p indicates the image conversion progress.
      • -f indicates the source image format.
      • The part following -O (which must be in upper case) consists of the required format, source image file, and target image file.
      +

      After the conversion is complete, the target image file is displayed in the directory where the source image file is located.

      +

      The following information is displayed:

      +
      # qemu-img convert -p -f vmdk -O qcow2 centos6.9.vmdk centos6.9.qcow2
+    (100.00/100%)
      +
    2. Run the following command to query details about the converted image file in QCOW2 format:

      qemu-img info centos6.9.qcow2

      +

      The following information is displayed:

      +
      # qemu-img info centos6.9.qcow2
+image: centos6.9.qcow2
+file format: qcow2
+virtual size: 1.0G (1073741824 bytes)
+disk size: 200K
+cluster_size: 65536
+Format specific information:
+    compat: 1.1
+    lazy refcounts: false
      +
    +
+
+

Linux

  1. Install qemu-img.
    • For Ubuntu or Debian, run the following command:

      apt install qemu-img

      +
    • For CentOS, Red Hat, or Oracle, run the following command:

      yum install qemu-img

      +
    • For SUSE or openSUSE, run the following command:

      zypper install qemu-img

      +
    +
  2. Run the following command to check whether the installation is successful:

    qemu-img -v

    +

    If the version information and help manual of the qemu-img tool are contained in the command output, the installation is successful. If CentOS 7 is used, the command output is as follows:

    +
    [root@CentOS7 ~]# qemu-img -v
+qemu-img version 1.5.3, Copyright (c) 2004-2008 Fabrice Bellard
+usage: qemu-img command [command options]
+QEMU disk image utility
+
+Command syntax:
+  check [-q] [-f fmt] [--output=ofmt] [-r [leaks | all]] [-T src_cache] filename
+  create [-q] [-f fmt] [-o options] filename [size]
+  commit [-q] [-f fmt] [-t cache] filename
+  compare [-f fmt] [-F fmt] [-T src_cach]
    +
  3. Convert the image format. For example, perform the following steps to convert a VMDK image file running CentOS 7 to a QCOW2 image file:
    1. Run the following command to convert the image file format to QCOW2:

      qemu-img convert -p -f vmdk -O qcow2 centos6.9.vmdk centos6.9.qcow2

      +

      The parameters are described as follows:

      +
      • -p: indicates the conversion progress.
      • -f indicates the source image format.
      • The pat following -O (which must be in upper case) is the converted image format + source image file name + target image file name.
      +

      After the conversion is complete, the target image file is displayed in the directory where the source image file is located.

      +

      The following information is displayed:

      +
      [root@CentOS7 home]# qemu-img convert -p -f vmdk -O qcow2 centos6.9.vmdk centos6.9.qcow2
+    (100.00/100%)
      +
    2. Run the following command to query details about the converted image file in QCOW2 format:

      qemu-img info centos6.9.qcow2

      +

      The following information is displayed:

      +
      [root@CentOS7 home]# qemu-img info centos6.9.qcow2
+image: centos6.9.qcow2
+file format: qcow2
+virtual size: 1.0G (1073741824 bytes)
+disk size: 200K
+cluster_size: 65536
+Format specific information:
+    compat: 1.1
+    lazy refcounts: false
      +
    +
+
+

Examples

A pre-allocated image depends on two files: xxxx.vmdk (configuration file) and xxxx-flat.vmdk (data file) and cannot be directly imported to the cloud platform. When you export a pre-allocated image file in VMDK monolithic Flat format from the VMware platform, you must convert its format to common VMDK or QCOW2 before it can be imported to the cloud platform.

+

The following uses the image files centos6.9-64bit-flat.vmdk and centos6.9-64bit.vmdk as an example to describe how to use qemu-img to convert image formats.

+
  1. Run the following commands to query the image file details:

    ls -lh centos6.9-64bit*

    +

    qemu-img info centos6.9-64bit.vmdk

    +

    qemu-img info centos6.9-64bit-flat.vmdk

    +

    The following information is displayed:

    +
    [root@CentOS7 tmp]# ls -lh centos6.9-64bit*
+-rw-r--r--. 1 root root 10G Jun 13 05:30 centos6.9-64bit-flat.vmdk
+-rw-r--r--. 1 root root 327 Jun 13 05:30 centos6.9-64bit.vmdk
+[root@CentOS7 tmp]# qemu-img info centos6.9-64bit.vmdk
+image: centos6.9-64bit.vmdk
+file format: vmdk
+virtual size: 10G (10737418240 bytes)
+disk size: 4.0K
+Format specific information:
+    cid: 3302005459
+    parent cid: 4294967295
+    create type: monolithicFlat
+    extents:
+        [0]:
+            virtual size: 10737418240
+            filename: centos6.9-64bit-flat.vmdk
+            format: FLAT
+[root@CentOS7 tmp]# qemu-img info centos6.9-64bit-flat.vmdk
+image: centos6.9-64bit-flat.vmdk
+file format: raw
+virtual size: 10G (10737418240 bytes)
+disk size: 0
    +

    The command output shows that the format of centos6.9-64bit.vmdk is VMDK and that of centos6.9-64bit-flat.vmdk is RAW. You can convert the format of only centos6.9-64bit.vmdk. For details about how to convert it, see 3.

    +
    +
  2. Run the following command to query the configuration of the pre-allocated image file:

    cat centos6.9-64bit.vmdk

    +

    The following information is displayed:

    +
    [root@CentOS7 tmp]# cat centos6.9-64bit.vmdk
+# Disk DescriptorFile
+version=1
+CID=c4d09ad3
+parentCID=ffffffff
+createType="monolithicFlat"
+ 
+# Extent description
+RW 20971520 FLAT "centos6.9-64bit-flat.vmdk" 0
+ 
+# The Disk Data Base
+#DDB
+ 
+ddb.virtualHWVersion = "4"
+ddb.geometry.cylinders = "20805"
+ddb.geometry.heads = "16"
+ddb.geometry.sectors = "63"
+ddb.adapterType = "ide"
    +
  3. Place centos6.9-64bit-flat.vmdk and centos6.9-64bit.vmdk in the same directory. Run the following command to convert the format of centos6.9-64bit.vmdk to QCOW2 using qemu-img:
    [root@CentOS7 tmp]# qemu-img convert -p -f vmdk -O qcow2 centos6.9-64bit.vmdk centos6.9-64bit.qcow2
+    (100.00/100%)
    +
  4. Run the following command to query details about the converted image file in QCOW2 format:

    qemu-img info centos6.9-64bit.qcow2

    +

    The following information is displayed:

    +
    [root@CentOS7 tmp]# qemu-img info centos6.9-64bit.qcow2
+image: centos6.9-64bit.qcow2
+file format: qcow2
+virtual size: 10G (10737418240 bytes)
+disk size: 200K
+cluster_size: 65536
+Format specific information:
+    compat: 1.1
+    lazy refcounts: false
    +
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0118990097.html b/docs/ims/umn/en-us_topic_0118990097.html new file mode 100644 index 000000000..ef9d98736 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0118990097.html @@ -0,0 +1,46 @@ + + +

How Do I Import an OVF or OVA File to the Cloud Platform?

+

Scenarios

Open Virtualization Appliance (OVA) is a single file (with the .ova extension) that archives all the files making up an Open Virtualization Format (OVF). OVF is a folder that contains the files required for defining and deploying VMs. An OVF folder always includes .ovf, .mf, and .vmdk files.

+ +

This section describes how to import OVF and OVA files to the cloud platform.

+
+

Procedure

Manually extract VMDK files from an OVF or OVA template and upload them to an OBS bucket. Then, you can select one from the bucket when you use an external file to create a system or data disk image.

+

The following assumes that the OVF or OVA template contains only one VMDK file. If there are multiple VMDK files (for example, there are three VMDK files, one used as a system disk image file and the others as data disk image files), upload them to an OBS bucket and register them as a system disk image and data disk images, respectively.

+
+ +
+
+
+
+
Parent topic: Image Importing
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0122876047.html b/docs/ims/umn/en-us_topic_0122876047.html new file mode 100644 index 000000000..8bf099b6b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0122876047.html @@ -0,0 +1,145 @@ + + +

Configuring Cloud-Init

+

Scenarios

You need to configure Cloud-Init after it is installed.

+
+

Prerequisites

+
+

Procedure

The following operations are required:

+
  1. Configure Cloud-Init.

    For details, see Configure Cloud-Init.

    +
  2. Check whether Cloud-Init is successfully configured.

    For details, see Check the Cloud-Init Configuration.

    +
+
+

Configure Cloud-Init

  1. Configure the user permissions for logging in to the ECS. If you use a common account (not user root) to log in to the ECS, disable the SSH permissions of user root and remote login using a password to improve the ECS security.
    • You can remotely log in to the ECS using SSH and a key pair injected into your account. (It is recommended that you select the key pair login mode when creating an ECS.)
    • You can also use a random password to log in to the ECS through noVNC.
    +

    Run the following command to open the sshd_config file using the vi editor:

    +

    vi /etc/ssh/sshd_config

    +
  2. Change the value of PasswordAuthentication in the sshd_config file to no.

    For SUSE and openSUSE, change the values of the following parameters in the sshd_config file to no:

    +
    • PasswordAuthentication
    • ChallengeResponseAuthentication
    +
    +
  3. Run the following command to open the cloud.cfg file using the vi editor:

    vi /etc/cloud/cloud.cfg

    +
  4. (Optional) In /etc/cloud/cloud.cfg, set apply_network_config to false.

    This step is only for Cloud-Init 18.3 or later.

    +
    Figure 1 Example configuration
    +
  5. Disable the SSH permissions of user root in /etc/cloud/cloud.cfg, add a common user (which is used for logging in to the ECS using VNC), and configure a password for the added user and assign sudo permissions to it.

    For Ubuntu and Debian, set the value of manage_etc_hosts in the /etc/cloud/cloud.cfg file to localhost. Otherwise, switching to user root from a user other than root may time out.

    +
    +

    Take Ubuntu as an example.

    +
    • Run the following command to create script /etc/cloud/set_linux_random_password.sh, which is executable and can be used to generate random passwords:

      cat /etc/cloud/set_linux_random_password.sh

      +
      The file content is as follows:
      #!/bin/bash
+
+password=$(cat /dev/urandom | tr -dc 'A-Za-z0-9!@#$%&+=' | head -c 9)
+
+echo "linux:$password" | chpasswd
+sed -i -e '/^Login/d' /etc/issue
+sed -i -e '/^Initial/d' /etc/issue
+sed -i -c -e '/^$/d' /etc/issue
+echo -e "\nInitial login with linux:$password\n" >> /etc/issue
      +

      You can run the chmod +x /etc/cloud/set_linux_random_password.sh command to add execute permissions of set_linux_random_password.sh.

      +
      +
      +
    • After you log in to the ECS, run the following commands to add a user-friendly prompt "Please change password for user linux after first login."

      echo -e '\e[1;31m#################################\\e[0m' > /etc/motd

      +

      echo -e '\e[1;31m# Important !!! #\e[0m' >> /etc/motd

      +

      echo -e '\e[1;31m# Please change password for user linux after first login. #\e[0m' >> /etc/motd

      +

      echo -e '\e[1;31m#################################\e[0m' >> /etc/motd

      +

      echo -e '' >> /etc/motd

      +
    +
  6. Add a common login user, set its password, assign sudo permissions to it, and use bootcmd to create a script used for generating a random password for each created ECS.

    Ensure that the configuration file format (such as alignment and spaces) is consistent with the provided example.

    +
    +
    system_info: 
+    # This will affect which distro class gets used 
+    distro: rhel 
+    # Default user name + that default users groups (if added/used) 
+    default_user: 
+      name: linux  //Username for login
+      lock_passwd: False  //Login using a password is enabled. Note that some OSs use value 0 to enable the password login.
+      gecos: Cloud User 
+      groups: users  //Optional. Add users to other groups that have been configured in /etc/group.
+      passwd: $6$I63DBVKK$Zh4lchiJR7NuZvtJHsYBQJIg5RoQCRLS1X2Hsgj2s5JwXI7KUO1we8WYcwbzeaS2VNpRmNo28vmxxCyU6LwoD0
+      sudo: ["ALL=(ALL) NOPASSWD:ALL"]  // Assign the root rights to the user.
+      shell: /bin/bash  //Execute shell in bash mode.
+    # Other config here will be given to the distro class and/or path classes 
+    paths: 
+       cloud_dir: /var/lib/cloud/ 
+       templates_dir: /etc/cloud/templates/ 
+    ssh_svcname: sshd
+
+bootcmd:
+- [cloud-init-per, instance, password, bash, 
+/etc/cloud/set_linux_random_password.sh]
    +

    The value of passwd is encrypted using SHA512 (which is used as an example). For more details, see https://cloudinit.readthedocs.io/en/latest/topics/examples.html.

    +

    For details about how to encrypt a password and generate ciphertext, see the following (encrypting password cloud.1234 is used as an example):

    +
    [root@** ~]# python -c "import crypt, getpass, pwd; print crypt.mksalt()"
+$6$I63DBVKK
+[root@** ~]# python -c "import crypt, getpass, pwd; print crypt.crypt('cloud.1234', '\$6\$I63DBVKK')"
+$6$I63DBVKK$Zh4lchiJR7NuZvtJHsYBQJIg5RoQCRLS1X2Hsgj2s5JwXI7KUO1we8WYcwbzeaS2VNpRmNo28vmxxCyU6LwoD0
    +
    +
  7. Enable the agent to access the IaaS OpenStack data source.
    Add the following information to the last line of /etc/cloud/cloud.cfg:
    datasource_list: [ OpenStack ]
+datasource:
+  OpenStack:
+    metadata_urls: ['http://169.254.169.254']
+    max_wait: 120
+    timeout: 5
    +
    • You can decide whether to set max_wait and timeout. The values of max_wait and timeout in the preceding example are only for reference.
    • If the OS version is earlier than Debian 8 or CentOS 5, you cannot enable the agent to access the IaaS OpenStack data source.
    • The default zeroconf route must be disabled for CentOS and EulerOS ECSs for accurate access to the IaaS OpenStack data source.

      echo "NOZEROCONF=yes" >> /etc/sysconfig/network

      +
    +
    +
    +
  8. Prevent Cloud-Init from taking over the network in /etc/cloud/cloud.cfg.

    If the Cloud-Init version is 0.7.9 or later, add the following content to /etc/cloud/cloud.cfg:

    +
    network:
+  config: disabled
    +

    The added content must be in the YAML format.

    +
    +
    Figure 2 Preventing Cloud-Init from taking over the network
    +
  9. Modify the cloud_init_modules configuration file.

    Move ssh from the bottom to the top to speed up the SSH login.

    +
    Figure 3 Speeding up the SSH login to the ECS
    +
  10. Modify the configuration so that the hostname of the ECS created from the image does not contain the .novalocal suffix and can contain a dot (.).
    1. Run the following command to modify the __init__.py file:

      vi /usr/lib/python2.7/site-packages/cloudinit/sources/__init__.py

      +

      Press i to enter editing mode. Search for toks. The following information is displayed:

      +
      if toks:
+    toks = str(toks).split('.')
+else:
+    toks = ["ip-%s" % lhost.replace(".", "-")]
+else:
+    toks = lhost.split(".novalocal")
+
+if len(toks) > 1:
+    hostname = toks[0]
+    #domain = '.'.join(toks[1:])
+else:
+    hostname = toks[0]
+
+if fqdn and domain != defdomain:
+    return "%s.%s" % (hostname, domain)
+else:
+    return hostname
      +

      After the modification is complete, press Esc to exit the editing mode and enter :wq! to save the configuration and exit.

      +
      Figure 4 Modifying the __init__.py file
      +
    2. Run the following command to switch to the cloudinit/sources folder:

      cd /usr/lib/python2.7/site-packages/cloudinit/sources/

      +
    3. Run the following commands to delete the __init__.pyc file and the optimized __init__.pyo file:

      rm -rf __init__.pyc

      +

      rm -rf __init__.pyo

      +
    4. Run the following commands to clear the logs:

      rm -rf /var/lib/cloud/*

      +

      rm -rf /var/log/cloud-init*

      +
    +
  11. Run the following command to edit the /etc/cloud/cloud.cfg.d/05_logging.cfg file to use cloudLogHandler to process logs:

    vim /etc/cloud/cloud.cfg.d/05_logging.cfg

    +
    Figure 5 Setting the parameter value to cloudLogHandler
    +
+
+

Check the Cloud-Init Configuration

Run the following command to check whether Cloud-Init has been properly configured:

+

cloud-init init --local

+
If Cloud-Init has been properly installed, the version information is displayed and no error occurs. For example, messages indicating lack of files will not be displayed.

(Optional) Run the following command to set the password validity period to the maximum:

+

chage -M 99999 $user_name

+

user_name is a system user, such as user root.

+

You are advised to set the password validity period to 99999.

+
+
+
+
+
+
+
Parent topic: Linux Operations
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0125075471.html b/docs/ims/umn/en-us_topic_0125075471.html new file mode 100644 index 000000000..089c6793c --- /dev/null +++ b/docs/ims/umn/en-us_topic_0125075471.html @@ -0,0 +1,23 @@ + + +

Viewing the Virtualization Type of a Windows ECS

+

Open the cmd window and run the following command to query the virtualization type of the ECS:

+

systeminfo

+

If the values of System Manufacturer and BIOS Version are Xen, the ECS uses Xen. If KVM is required, perform the operations in this section to optimize a Windows private image.

+

If the ECS uses KVM, you are also advised to optimize the private image to prevent any exceptions with the ECSs created from the image.

+
+
Figure 1 Viewing the virtualization type of a Windows ECS
+
+
+
+
Parent topic: Optimizing a Windows Private Image
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0125075472.html b/docs/ims/umn/en-us_topic_0125075472.html new file mode 100644 index 000000000..ccf21037b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0125075472.html @@ -0,0 +1,12 @@ + + +

Clearing System Logs

+

After installing the PV driver and UVP VMTools, perform the following operations to clear system logs:

+
  1. For Windows Server 2008 and Windows Server 2012, right-click Computer and select Manage.
  2. In the displayed dialog box, choose System Tools > Event Viewer > Windows Logs and delete logs of five items.
  3. Stop the ECS.
+
+
+
+
Parent topic: Optimizing a Windows Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0125076462.html b/docs/ims/umn/en-us_topic_0125076462.html new file mode 100644 index 000000000..dd5df58aa --- /dev/null +++ b/docs/ims/umn/en-us_topic_0125076462.html @@ -0,0 +1,19 @@ + + +

Clearing System Logs

+

Delete log files and historical records, and stop the ECS.

+
  1. Run the following commands to delete redundant key files:

    echo > /$path/$to/$root/.ssh/authorized_keys

    +

    An example command is echo > /root/.ssh/authorized_keys.

    +

    echo > /$path/$to/$none-root/.ssh/authorized_keys

    +

    An example command is echo > /home/linux/.ssh/authorized_keys.

    +
  1. Run the following command to clear log files in the /var/log directory:

    rm -rf /var/log/*

    +
  2. Run the following commands to delete historical records:

    echo > /root/.bash_history

    +

    history -c

    +
+
+
+
+
Parent topic: Optimizing a Linux Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0130878289.html b/docs/ims/umn/en-us_topic_0130878289.html new file mode 100644 index 000000000..2978cd25d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0130878289.html @@ -0,0 +1,33 @@ + + +

Creating a Private Image

+
+
+ +
+ diff --git a/docs/ims/umn/en-us_topic_0130878748.html b/docs/ims/umn/en-us_topic_0130878748.html new file mode 100644 index 000000000..76c83a06f --- /dev/null +++ b/docs/ims/umn/en-us_topic_0130878748.html @@ -0,0 +1,25 @@ + + +

Optimizing a Windows Private Image

+
+
+ + +
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0130878749.html b/docs/ims/umn/en-us_topic_0130878749.html new file mode 100644 index 000000000..57e371fa6 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0130878749.html @@ -0,0 +1,27 @@ + + +

Optimizing a Linux Private Image

+
+
+ + +
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0133773658.html b/docs/ims/umn/en-us_topic_0133773658.html new file mode 100644 index 000000000..1f39c973b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0133773658.html @@ -0,0 +1,42 @@ + + +

Overview

+

If an image file is larger than 128 GB, you can import it using fast import. Only the RAW and ZVHD2 formats support fast import. The image file to be imported cannot exceed 1 TB.

+

Methods

You can import an image file in any of the following methods depending on the file format:
  • ZVHD2
    1. Optimize the image file.
    2. Upload the image file to an OBS bucket.
    3. Register the image file on the cloud platform.
    +
  • RAW
    1. Optimize the image file.
    2. Generate a bitmap file for the image file.
    3. Upload the image file and bitmap file to an OBS bucket.
    4. Register the image file on the cloud platform.
    +
  • Others
    • If the file format is converted to ZVHD2:
      1. Optimize the image file.
      2. Convert the image file format to ZVHD2.
      3. Upload the image file to an OBS bucket.
      4. Register the image file on the cloud platform.
      +
    • If the file format is converted to RAW:
      1. Optimize the image file.
      2. Convert the image file format to RAW and generate a bitmap file for the image file.
      3. Upload the image file and bitmap file to an OBS bucket.
      4. Register the image file on the cloud platform.
      +
    +
+
+
  • The import of large files depends on lazy loading which defers loading of file data until it is needed. This reduces the initial loading time. However, RAW files do not support this feature. When you upload a RAW file, you need to upload its bitmap together.
  • For details about how to optimize an image file, see Optimization Process or Optimization Process depending on the OS type specified in the image file.
+
+
+

Import Process

The following describes how to import an external image file. Assume that you need to convert the file format to ZVHD2 or RAW.

+

You can use qemu-img-hw or the open-source tool qemu-img to convert the image format. qemu-img-hw can only be used in Linux.

+

The tool package contains qemu-img-hw (for converting image formats) and CreateMF.jar (for generating bitmap files).

+
+ +
+
+
+
+
Parent topic: Quickly Importing an Image File
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0133773660.html b/docs/ims/umn/en-us_topic_0133773660.html new file mode 100644 index 000000000..512a2853c --- /dev/null +++ b/docs/ims/umn/en-us_topic_0133773660.html @@ -0,0 +1,138 @@ + + +

Quickly Importing an Image File (Linux)

+

Scenarios

This section describes how to convert the format of an image file on a Linux server and then quickly import it to the cloud platform. You are advised to use an EulerOS ECS for converting image file formats and generating bitmap files.

+

In Linux, you are advised to use qemu-img-hw to convert image formats.

+
+

Prerequisites

+
+

Procedure

  1. Upload an image file.

    • If the image file is uploaded from a Linux PC, run the scp command.

      For example, to upload image01.qcow2 to the /usr/ directory of the ECS, run the following command:

      +

      scp /var/image01.qcow2 root@xxx.xxx.xx.xxx:/usr/

      +

      xxx.xxx.xx.xxx indicates the EIP bound to the ECS.

      +
    • If the image file is uploaded from a Windows PC, use a file transfer tool, such as WinSCP, to upload the image file.
    +

  2. Obtain the fast import tool package, upload it to the ECS, and then decompress the package.

    Obtain the fast import tool package from the following link in the table. +
    + + + + + + + +
    Table 1 Fast import tool package

    Tool Package

    +

    How to Obtain

    +

    quick-import-tools

    +

    https://obs-20181128.ims.obs.eu-de.otc.t-systems.com/DT-image-convert-tools.zip

    +
    +
    +
    +

  3. Use qemu-img-hw to convert the image format.

    1. Go to the directory where qemu-img-hw is stored, for example, /usr/quick-import-tools/qemu-img-hw.

      cd /usr/quick-import-tools/qemu-img-hw

      +
    2. Run the following command to make qemu-img-hw executable:

      chmod +x qemu-img-hw

      +
    3. Execute qemu-img-hw to convert the image file format to ZVHD2 (recommended) or RAW.

      Command format:

      +

      ./qemu-img-hw convert -p -O Target_image_format Source_image_file Target_image_file

      +

      For example, run the following command to convert an image01.qcow2 file to an image01.zvhd2 file:

      +

      ./qemu-img-hw convert -p -O zvhd2 image01.qcow2 image01.zvhd2

      +
      • If the image file is converted to the ZVHD2 format, go to 5.
      • If the image file is converted to the RAW format, go to 4.
      +
    +

  4. Use CreateMF.jar to generate a bitmap file.

    1. Ensure that JDK has been installed on the ECS.

      Run the following commands to check whether JDK is installed:

      +

      source /etc/profile

      +

      java -version

      +

      If a Java version is displayed, JDK has been installed.

      +
    2. Run the following command to enter the directory where CreateMF.jar is stored:

      cd /usr/quick-import-tools/createMF

      +
    3. Run the following command to generate a bitmap file:

      java -jar CreateMF.jar /Original RAW file path/Generated .mf file path

      +

      Example:

      +

      java -jar CreateMF.jar image01.raw image01.mf

      +

      The generated .mf bitmap file must have the same name as the RAW image file. For example, if the image file name is image01.raw, the generated bitmap name is image01.mf.

      +
      +
    +

  5. Use s3cmd to upload the file(s) to an OBS bucket.

    1. Install s3cmd on the ECS.

      If s3cmd has been installed, skip this step.

      +
      1. Run the following command to install setuptools:

        yum install python-setuptools

        +
      2. Run the following command to install wget:

        yum install wget

        +
      3. Run the following commands to obtain the s75pxd software package:

        wget https://github.com/s3tools/s3cmd/archive/master.zip

        +

        mv master.zip s3cmd-master.zip

        +
      4. Run the following commands to install s3cmd:

        unzip s3cmd-master.zip

        +

        cd s3cmd-master

        +

        python setup.py install

        +
      +
    2. Configure s3cmd.

      Run the following command to configure s3cmd:

      +
      s3cmd --configure
+Access Key: Enter an AK.
+Secret Key: Enter an SK.
+Default Region: Enter the region where the bucket is located.
+S3 Endpoint: Refer to the OBS endpoint.
+DNS-style bucket+hostname:port template for accessing a bucket: Enter a server address with a bucket name, for example, mybucket.obs.myclouds.com.
+Encryption password: Press Enter.
+Path to GPG program: Press Enter.
+Use HTTPS protocol: Specifies whether to use HTTPS. The value can be Yes or No.
+HTTP Proxy server name: Specifies the proxy address used to connect the cloud from an external network. (If you do not need it, press Enter.)
+HTTP Proxy server port: Specifies the proxy port used to connect to the cloud from an external network (If you do not need it, press Enter.)
+Test access with supplied credentials? y
+(If "Success. Your access key and secret key worked fine :-)" is displayed, the connection is successful.)
+Save settings? y (Specifies whether to save the configurations. If you enter y, the configuration will be saved.)
      +

      The configurations will be stored in /root/.s3cfg. If you want to modify these configurations, run the s3cmd --configure command to configure the parameters or run the vi .s3cfg command to edit the .s3cfg file.

      +
      +
    3. Run the following command to upload the ZVHD2 image file (or the RAW image file and its bitmap file) to an OBS bucket.

      s3cmd put image01.zvhd2 s3://mybucket/

      +

      The .mf bitmap file must be in the same OBS bucket as the RAW image file.

      +
      +
    +

  6. Register a private image.

    You can register a private image using the converted ZVHD2 or RAW file on the console or using an API.

    +

    Method 1: Register a private image on the console.

    +
    1. Access the IMS console.
      1. Log in to the management console.
      2. Under Compute, click Image Management Service.

        The IMS console is displayed.

        +
      +
    2. In the upper right corner, click Create Image.
    3. In the Image Type and Source area, select System disk image or Data disk image for Type.
    4. Select Image File for Source. Select the bucket storing the ZVHD2 or RAW image file and then select the image file. If the image file is in the RAW format, you also need to select its bitmap file.
    5. Select Enable Fast Create, and select the sentence following Image File Preparation.
      Figure 1 Quickly importing an image file
      +
    6. Set parameters as prompted.

      For details about the parameters, see Registering an External Image File as a Private Image and Registering an External Image File as a Private Image.

      +
      • The OS must be the same as that in the image file.
      • The system disk size must be greater than the one specified in the image file.

        Run the following command to check the system disk size in the image file:

        +

        qemu-img-hw info test.zvhd2

        +
      +
      +
    +

    Method 2: Register a private image using an API.

    +

    You can use the POST /v2/cloudimages/quickimport/action API to quickly import an image file.

    +

    For details about how to call this API, see "Importing an Image File Quickly" in Image Management Service API Reference.

    +

+
+

Appendix 1: Common qemu-img-hw Commands

+
+

Appendix 2: Common Errors During qemu-img-hw Running

+
+
+
+
+
Parent topic: Quickly Importing an Image File
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0133773782.html b/docs/ims/umn/en-us_topic_0133773782.html new file mode 100644 index 000000000..52f8b0c93 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0133773782.html @@ -0,0 +1,23 @@ + + +

OS

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0138455714.html b/docs/ims/umn/en-us_topic_0138455714.html new file mode 100644 index 000000000..225cbdeca --- /dev/null +++ b/docs/ims/umn/en-us_topic_0138455714.html @@ -0,0 +1,19 @@ + + +

Image Consulting

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0138479468.html b/docs/ims/umn/en-us_topic_0138479468.html new file mode 100644 index 000000000..66c37744d --- /dev/null +++ b/docs/ims/umn/en-us_topic_0138479468.html @@ -0,0 +1,21 @@ + + +

Cloud-Init

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0148873774.html b/docs/ims/umn/en-us_topic_0148873774.html new file mode 100644 index 000000000..bb1158069 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0148873774.html @@ -0,0 +1,18 @@ + + +

What Can I Do with a Cloud-Init ECS?

+

Introduction to Cloud-Init

Cloud-Init is an open-source tool for cloud instance initialization. When creating ECSs from an image with Cloud-Init, you can use user data injection to inject customized initialization details (for example, an ECS login password) to the ECSs. You can also configure and manage a running ECS by querying and using metadata. If Cloud-Init is not installed, you cannot apply custom configurations to the ECSs. You will have to use the original password in the image file to log in to the ECSs.

+
+

Installation Methods

You are advised to install Cloud-Init or Cloudbase-Init on the ECS to be used to create a private image so that new ECSs created from the private image support custom configurations.

+ +
+
+
+
+
Parent topic: Cloud-Init
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0153114116.html b/docs/ims/umn/en-us_topic_0153114116.html new file mode 100644 index 000000000..ad69e4fd5 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0153114116.html @@ -0,0 +1,24 @@ + + +

How Do I Increase the Image Quota?

+

What Is Quota?

Quotas can limit the number or amount of resources available to users, such as the maximum number of ECSs or EVS disks that can be created.

+

If the existing resource quota cannot meet your service requirements, you can apply for a higher quota.

+
+

How Do I View My Quotas?

  1. Log in to the management console.
  2. Click in the upper left corner and select the desired region and project.
  3. In the upper right corner of the page, click .

    The Service Quota page is displayed.

    +
  4. View the used and total quota of each type of resources on the displayed page.

    If a quota cannot meet service requirements, apply for a higher quota.

    +
+
+

How Do I Apply for a Higher Quota?

The system does not support online quota adjustment. If you need to adjust a quota, call the hotline or send an email to the customer service mailbox. Customer service personnel will timely process your request for quota adjustment and inform you of the real-time progress by making a call or sending an email.

+

Before dialing the hotline number or sending an email, make sure that the following information has been obtained:

+ +

Learn how to obtain the service hotline and email address.

+
+
+
+
+
Parent topic: Image Consulting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0161870891.html b/docs/ims/umn/en-us_topic_0161870891.html new file mode 100644 index 000000000..2e5d7180b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0161870891.html @@ -0,0 +1,18 @@ + + +

What Do I Do If an Exception Occurs When I Start an ECS Created from an Image Using the UEFI Boot Mode?

+

Symptom

An ECS created from a private image using the UEFI boot mode cannot start.

+
+

Possible Causes

The image OS uses the UEFI boot mode, but the uefi attribute is not added to the image.

+
+

Solution

  1. Delete the ECS that failed to start.
  2. Call the API to update the image attributes and change the value of hw_firmware_type to uefi.

    API URI: PATCH /v2/cloudimages/{image_id}

    +

    For details about how to call the API, see "Updating Image Information" in Image Management Service API Reference.

    +
  3. Use the updated image to create an ECS.
+
+
+
+
+
Parent topic: ECS Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0170853315.html b/docs/ims/umn/en-us_topic_0170853315.html new file mode 100644 index 000000000..b1a03be01 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0170853315.html @@ -0,0 +1,167 @@ + + +

OSs Supporting UEFI Boot Mode

+

The ECS boot mode can be BIOS or UEFI. For details about the differences between the two modes, see How Is BIOS Different from UEFI?

+

Table 1 lists the OSs that support the UEFI boot mode.

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 OSs supporting UEFI boot mode

OS

+

OS Version

+

Windows

+

Windows Server 2019 Datacenter 64bit

+

Windows Server 2019 Standard 64bit

+

Windows Server 2016 Standard 64bit

+

Windows Server 2016 Datacenter 64bit

+

Windows Server 2012 R2 Standard 64bit

+

Windows Server 2012 R2 Datacenter 64bit

+

Windows Server 2012 Essentials R2 64bit

+

Windows Server 2012 Standard 64bit

+

Windows Server 2012 Datacenter 64bit

+

Windows 10 64bit

+

Ubuntu

+

Ubuntu 19.04 Server 64bit

+

Ubuntu 18.04 Server 64bit

+

Ubuntu 16.04 Server 64bit

+

Ubuntu 14.04 Server 64bit

+

Red Hat

+

Red Hat Linux Enterprise 7.4 64bit

+

Red Hat Linux Enterprise 7.3 64bit

+

Red Hat Linux Enterprise 7.1 64bit

+

Red Hat Linux Enterprise 7.0 64bit

+

Red Hat Linux Enterprise 6.9 64bit

+

Red Hat Linux Enterprise 6.6 32bit

+

Red Hat Linux Enterprise 6.5 64bit

+

Oracle Linux

+

Oracle Linux Server release 7.4 64bit

+

Oracle Linux Server release 6.9 64bit

+

openSUSE

+

openSUSE 42.1 64bit

+

SUSE

+

SUSE Linux Enterprise Server 12 SP5 64bit

+

SUSE Linux Enterprise Server 12 SP1 64bit

+

SUSE Linux Enterprise Server 11 SP3 64bit

+

Fedora

+

Fedora 29 64bit

+

Fedora 24 64bit

+

Debian

+

Debian GNU/Linux 8.8.0 64bit

+

CentOS

+

CentOS 7.6 64bit

+

CentOS 7.5 64bit

+

CentOS 7.4 64bit

+

CentOS 7.0 64bit

+

CentOS 6.9 64bit

+

CentOS 6.6 64bit

+

EulerOS

+

EulerOS 2.8 64bit

+

EulerOS 2.5 64bit

+

EulerOS 2.3 64bit

+

EulerOS 2.2 64bit

+

openEuler

+

openEuler 20.03 64bit

+
+
+
+
+
+
Parent topic: Supported OSs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0171668652.html b/docs/ims/umn/en-us_topic_0171668652.html new file mode 100644 index 000000000..f6d03be49 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0171668652.html @@ -0,0 +1,73 @@ + + +

Converting the Image Format Using qemu-img-hw

+

Scenarios

You can import an image file in VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, QED, ZVHD, or ZVHD2 format to the cloud platform. Image files in other formats need to be converted into any of these formats using the open-source tool qemu-img before being imported. However, the qemu-img tool cannot convert image files to the ZVHD or ZVHD2 format. To convert image files to any of the two formats, use the self-developed tool qemu-img-hw. This section describes how to use qemu-img-hw to convert an image file to ZVHD2.

+
+

Background

qemu-img-hw can be used only in Linux. You can run it on a local Linux server or a Linux ECS on the cloud platform. The following procedure uses an EulerOS ECS as an example.

+
+

Procedure

  1. Upload the image file to be converted to the ECS.
    • If the local host runs a Linux OS, run the scp command.

      For example, to upload image01.qcow2 to the /usr/ directory on the ECS, run the following command:

      +

      scp /var/image01.qcow2 root@xxx.xxx.xx.xxx:/usr/

      +

      xxx.xxx.xx.xxx indicates the EIP bound to the ECS.

      +
    • If the local host runs a Windows OS, use a file transfer tool, such as WinSCP, to upload the image file to the ECS.
    +
  2. Obtain the qemu-img-hw software package, upload it to the ECS, and then decompress the package. +
    + + + + + + + +
    Table 1 qemu-img-hw package

    Tool Package

    +

    How to Obtain

    +

    quick-import-tools

    +

    https://obs-20181128.ims.obs.eu-de.otc.t-systems.com/DT-image-convert-tools.zip

    +
    +
    +

    This tool can be used only on x86 servers.

    +
    +
  3. Convert the image format.
    1. Go to the directory where qemu-img-hw is stored, for example, /usr/quick-import-tools/qemu-img-hw.

      cd /usr/quick-import-tools/qemu-img-hw

      +
    2. Run the following command to change file permissions:

      chmod +x qemu-img-hw

      +
    3. Run the qemu-img-hw command to convert the image file to the ZVHD2 format.

      The command format of qemu-img-hw is as follows:

      +

      ./qemu-img-hw convert -p -O Target_image_format Source_image_file Target_image_file

      +

      For example, run the following command to convert an image01.qcow2 file to an image01.zvhd2 file:

      +

      ./qemu-img-hw convert -p -O zvhd2 image01.qcow2 image01.zvhd2

      +
    +
+
+

Appendix 1: Common qemu-img-hw Commands

+
+

Appendix 2: Common Errors During qemu-img-hw Running

+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0171668653.html b/docs/ims/umn/en-us_topic_0171668653.html new file mode 100644 index 000000000..5027f31b8 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0171668653.html @@ -0,0 +1,17 @@ + + +

Image Sharing

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0171754221.html b/docs/ims/umn/en-us_topic_0171754221.html new file mode 100644 index 000000000..b0e54980c --- /dev/null +++ b/docs/ims/umn/en-us_topic_0171754221.html @@ -0,0 +1,22 @@ + + +

Region and AZ

+

Concept

A region and availability zone (AZ) identify the location of a data center. You can create resources in a specific region and AZ.

+ +

Figure 1 shows the relationship between regions and AZs.

+
Figure 1 Regions and AZs
+
+

Selecting a Region

Select a region closest to your target users for lower network latency and quick access.

+
+

Selecting an AZ

When deploying resources, consider your applications' requirements on disaster recovery (DR) and network latency.

+ +
+

Regions and Endpoints

Before you use an API to call resources, specify its region and endpoint. For more details, see Regions and Endpoints.

+
+
+
+
+
Parent topic: Basic Concepts
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0173986473.html b/docs/ims/umn/en-us_topic_0173986473.html new file mode 100644 index 000000000..717f9e3d8 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0173986473.html @@ -0,0 +1,12 @@ + + +

Can I Use Private Images of Other Tenants?

+

Yes.

+

Other tenants can share a private image with you. You can use it after accepting it. For details about image sharing, see Sharing Specified Images.

+
+
+
+
Parent topic: Image Consulting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0174703579.html b/docs/ims/umn/en-us_topic_0174703579.html new file mode 100644 index 000000000..dd2cd72ff --- /dev/null +++ b/docs/ims/umn/en-us_topic_0174703579.html @@ -0,0 +1,64 @@ + + +

Quickly Importing an Image File (Windows)

+

Scenarios

This section describes how to convert the format of an image file on a Windows server and then quickly import it to the cloud platform. You are advised to use a local Windows PC for converting image formats and generating bitmap files.

+

In Windows, use the open-source tool qemu-img to convert image formats. qemu-img supports conversion between image files of the VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, and QED formats. Convert an image to the RAW format and then use the CreateMF.jar tool to generate a bitmap file.

+
+

Prerequisites

+
+

Procedure

  1. Install the open-source tool qemu-img.
  2. Run the cmd command to go to the qemu-img installation directory and run the qemu-img command to convert the image file to the RAW format.

    For example, run the following command to convert an image.qcow2 file to an image.raw file:

    +

    qemu-img convert -p -O raw image.qcow2 image.raw

    +

  3. Use CreateMF.jar to generate a bitmap file.

    1. Obtain the CreateMF.jar package and decompress it. +
      + + + + + + + +
      Table 1 CreateMF.jar package

      Tool Package

      +

      How to Obtain

      +

      quick-import-tools

      +

      https://obs-20181128.ims.obs.eu-de.otc.t-systems.com/DT-image-convert-tools.zip

      +
      +
      +
    2. Ensure that JDK has been installed in the current environment.

      You can verify the installation by running cmd.exe and then java -version. If Java version information is displayed, JDK has been installed.

      +
    3. Go to the directory where CreateMF.jar is stored.

      For example, if you have downloaded CreateMF.jar to D:/test, run the following commands to access the directory:

      +

      D:

      +

      cd test

      +
    4. Run the following command to generate a bitmap file for the RAW image file:

      java -jar CreateMF.jar D:/image01.raw D:/image01.mf

      +
    +

  4. Use OBS Browser to upload the converted image file and its bitmap file to an OBS bucket.

    You must upload the RAW image file and its bitmap file to the same OBS bucket.

    +

  5. Register a private image.

    You can register a private image using the converted ZVHD2 or RAW file on the console or using an API.

    +

    Method 1: Register a private image on the console.

    +
    1. Access the IMS console.
      1. Log in to the management console.
      2. Under Compute, click Image Management Service.

        The IMS console is displayed.

        +
      +
    2. In the upper right corner, click Create Image.
    3. In the Image Type and Source area, select System disk image or Data disk image for Type.
    4. Select Image File for Source. Select the bucket storing the ZVHD2 or RAW image file and then select the image file. If the image file is in the RAW format, you also need to select its bitmap file.
    5. Select Enable Fast Create, and select the sentence following Image File Preparation.
      Figure 1 Quickly importing an image file
      +
    6. Set parameters as prompted.

      For details about the parameters, see Registering an External Image File as a Private Image and Registering an External Image File as a Private Image.

      +
      • The OS must be the same as that in the image file.
      • The system disk size must be greater than the one specified in the image file.

        Run the following command to check the system disk size in the image file:

        +

        qemu-img-hw info test.zvhd2

        +
      +
      +
    +

    Method 2: Register a private image using an API.

    +

    You can use the POST /v2/cloudimages/quickimport/action API to quickly import an image file.

    +

    For details about how to call this API, see "Importing an Image File Quickly" in Image Management Service API Reference.

    +

+
+
+
+
+
Parent topic: Quickly Importing an Image File
+
+
+ + + \ No newline at end of file diff --git a/docs/ims/umn/en-us_topic_0176812699.html b/docs/ims/umn/en-us_topic_0176812699.html new file mode 100644 index 000000000..1cf20f531 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0176812699.html @@ -0,0 +1,27 @@ + + +

Creating a Full-ECS Image from a CBR Backup

+

Scenarios

You can use a Cloud Backup and Recovery (CBR) backup to create a full-ECS image, which can be used to create ECSs.

+
+

Background

+
+

Constraints

+
+

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +

  2. Create a full-ECS image.

    1. Click Create Image in the upper right corner.
    2. In the Image Type and Source area, select Full-ECS image for Type.
    3. Select Cloud Server Backup for Source and then select a backup from the list.
    4. In the Image Information area, configure basic image details, such as the image name and description.
    5. Click Create Now.
    6. Confirm the parameters and click Submit.
    +

  3. Switch back to the Image Management Service page to monitor the image status.

    When the image status changes to Normal, the image creation is complete.

    +

+
+

Follow-up Procedure

After the full-ECS image creation is complete, you can perform the following operations:

+ +
+
+
+
+
Parent topic: Creating a Private Image
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0183293890.html b/docs/ims/umn/en-us_topic_0183293890.html new file mode 100644 index 000000000..c0f078f8b --- /dev/null +++ b/docs/ims/umn/en-us_topic_0183293890.html @@ -0,0 +1,25 @@ + + +

Image Sharing FAQs

+

How Many Tenants Can I Share an Image with?

128

+
+

How Many Images Can Be Shared with Me?

There is no limit.

+
+

Do Shared Images Affect My Private Image Quota?

No.

+
+

I Shared an Image to an Account But the Account Did Not Accept or Reject the Image. Will My Image Sharing Quota Be Consumed?

No.

+
+

Can I Use an Image I Have Shared with Others to Create an ECS?

Yes. After sharing an image with other tenants, you can still use the image to create an ECS and use the created ECS to create a private image.

+
+

When Can I Do If I Want to Use a Rejected Image?

If you have rejected an image shared by another tenant, but now want to use it, two methods are available:

+ +
+
+
+
+
Parent topic: Image Sharing
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0187108863.html b/docs/ims/umn/en-us_topic_0187108863.html new file mode 100644 index 000000000..376f99b13 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0187108863.html @@ -0,0 +1,22 @@ + + +

How Do I Make a System Disk Image Support Fast ECS Creation?

+

Scenarios

Fast Create greatly reduces the time required for creating ECSs from a system disk image. Currently, this feature is supported by all newly created system disk images by default. Some existing system disk images may not support this feature, you can make them support it through image replication.

+

For example, if image A does not support fast ECS creation, you can replicate it to generate image copy_A that supports fast ECS creation.

+
+

Constraints

Full-ECS images cannot be configured using this method.

+
+

Check Whether an Image Supports Fast ECS Creation

  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab to display the image list.
  3. Click the name of the target image.
  4. On the displayed image details page, check the value of Fast ECS Creation.
+
+

Configure an Image to Make It Support Fast ECS Creation

  1. Locate the target system disk image, click More in the Operation column, and select Replicate from the drop-down list.

    The Replicate Image dialog box is displayed.

    +
  2. Set parameters based on Replicating Images.
  3. After the image is successfully replicated, the generated image can be used to quickly create ECSs.
+
+
+
+
+
Parent topic: Image Optimization
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0193137621.html b/docs/ims/umn/en-us_topic_0193137621.html new file mode 100644 index 000000000..d22ecb2e8 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0193137621.html @@ -0,0 +1,21 @@ + + +

Image Creation

+
+
+ + +
+
Parent topic: FAQs
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0193146244.html b/docs/ims/umn/en-us_topic_0193146244.html new file mode 100644 index 000000000..6994a69d5 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0193146244.html @@ -0,0 +1,17 @@ + + +

Image Creation FAQs

+

How Many Private Images Can I Create Under an Account?

Currently, you can create a maximum of 100 private images under an account in a region.

+
+

Do I Have to Stop the ECS Before Using It to Create a Private Image?

No. You can create an image from a running ECS. However, if data is written to the ECS during image creation, that new data will not be included in the created image.

+
+

Where Can I View the Image Creation Progress? How Long Does It Take to Create an Image?

Log in to the management console. Choose Compute > Image Management Service and click the Private Images tab. Monitor the image creation progress in the Status column.

+

The image creation involves the installation of Xen and KVM drivers, OS kernel loading, and GRUB boot configuration, which may take a long time. In addition, the network speed, image file type, and disk size have an impact on how long image creation takes.

+
+
+
+
+
Parent topic: Image Creation
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0194137262.html b/docs/ims/umn/en-us_topic_0194137262.html new file mode 100644 index 000000000..cec93fd89 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0194137262.html @@ -0,0 +1,17 @@ + + +

Basic Concepts

+
+
+ + +
+
Parent topic: Overview
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0195253327.html b/docs/ims/umn/en-us_topic_0195253327.html new file mode 100644 index 000000000..08246158f --- /dev/null +++ b/docs/ims/umn/en-us_topic_0195253327.html @@ -0,0 +1,71 @@ + + +

How Do I Select an Image?

+

When creating an ECS or BMS, you can select an image based on the following factors:

+ +

Region and AZ

An image is a regional resource. You cannot use an image to create an instance in a different region. For example, when creating an instance in region A, you can only select an image that is already in region A. For more regions, see Region and AZ.

+
+

Image Type

Images are classified into public images, private images, and shared images. A private image can be a system disk image, data disk image, or full-ECS image. For details, see What Is Image Management Service?

+
+

OS

When selecting an OS, consider the following factors:

+ +
+
+
+
+
Parent topic: Image Consulting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0199394934.html b/docs/ims/umn/en-us_topic_0199394934.html new file mode 100644 index 000000000..737f66822 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0199394934.html @@ -0,0 +1,19 @@ + + +

Windows Operations

+
+
+ +
+ diff --git a/docs/ims/umn/en-us_topic_0199394935.html b/docs/ims/umn/en-us_topic_0199394935.html new file mode 100644 index 000000000..92c7e7fa9 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0199394935.html @@ -0,0 +1,23 @@ + + +

Linux Operations

+
+
+ +
+ diff --git a/docs/ims/umn/en-us_topic_0199396601.html b/docs/ims/umn/en-us_topic_0199396601.html new file mode 100644 index 000000000..6438182f4 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0199396601.html @@ -0,0 +1,12 @@ + + +

What Do I Do If the Export Option Is Unavailable for My Image?

+

Some images cannot be exported. Therefore, the Export option is not provided for them in the Operation column. The following images cannot be exported:

+ +
+
+
+
Parent topic: Image Exporting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0199451475.html b/docs/ims/umn/en-us_topic_0199451475.html new file mode 100644 index 000000000..250a95093 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0199451475.html @@ -0,0 +1,59 @@ + + +

What Are the Differences Between Import/Export and Fast Import/Export?

+
+
+ + + + + + + + + + + + + + + + + + + + + +

Item

+

Description

+

Helpful Link

+

Import

+

Import an external image file to the management console for creating a private image.

+

External image files in the following formats can be imported: VMDK, VHD, QCOW2, RAW, VHDX, QED, VDI, QCOW, ZVHD2, and ZVHD.

+

Maximum file size: 128 GB

+

During the import, operations such as driver injection will be performed in the background. Therefore, the import takes a longer time than fast import.

+		 +

Fast import

+

When importing an external image file in the RAW or ZVHD2 format to the management console, you can select Enable Fast Create. The system does not perform any operations such as driver injection. Verify that:

+
  • The image file converted to the RAW format has been optimized as required and a bitmap file has been generated for it.
  • The image file converted to the ZVHD2 format has been optimized as required.
+

Maximum file size: 1 TB

+

Quickly Importing an Image File

+

Export

+

You can export private images to OBS buckets and download them to your local PC for further use on other cloud platforms.

+

Maximum file size: 128 GB (If an image file is larger than 128 GB, use fast export to export it.)

+

You can specify the format of the exported image file. Currently, only QCOW2, VMDK, VHD, and ZVHD are supported.

+

Exporting an Image

+

Fast export

+

On the Export Image page, select Enable following Fast Export. You cannot specify the format of the exported image file. After the export is complete, you can use a tool to convert the exported image to your desired format.

+

The file size is not limited.

+

Encrypted images do not support fast export.

+

Exporting an Image

+
+
+
+
+
+
Parent topic: Image Exporting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0249675952.html b/docs/ims/umn/en-us_topic_0249675952.html new file mode 100644 index 000000000..1eb9a6b03 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0249675952.html @@ -0,0 +1,11 @@ + + +

Can I Download My Private Images to a Local PC?

+

Yes. You can download private images in VMDK, VHD, QCOW2, or ZVHD format as instructed in Exporting an Image.

+
+
+
+
Parent topic: Image Exporting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0274352601.html b/docs/ims/umn/en-us_topic_0274352601.html new file mode 100644 index 000000000..f9c5001ed --- /dev/null +++ b/docs/ims/umn/en-us_topic_0274352601.html @@ -0,0 +1,14 @@ + + +

Why Is the Image Size in an OBS Bucket Different from That Displayed in IMS?

+

Symptom

After a private image is exported to an OBS bucket, the image size in the bucket is different from that displayed in IMS. For example, the size of a private image is 1.04 GB on the IMS console. After it is exported to an OBS bucket, the size is displayed as 2.91 GB.

+
+

Cause Analysis

The size of an image in an OBS bucket varies depending on the file's storage format in the bucket.

+
+
+
+
+
Parent topic: Image Exporting
+
+
+ diff --git a/docs/ims/umn/en-us_topic_0300978092.html b/docs/ims/umn/en-us_topic_0300978092.html new file mode 100644 index 000000000..496f52a82 --- /dev/null +++ b/docs/ims/umn/en-us_topic_0300978092.html @@ -0,0 +1,27 @@ + + +

Checking the Disk Capacity of an Image

+

Scenarios

You can check the disk capacity of a private image.

+ +
+

Check the Disk Capacity of a System Disk Image, Data Disk Image, or ISO Image

Check the disk capacity in the Disk Capacity column of the private image list.

+
  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab to display the image list.
  3. Check the value in the Disk Capacity column. The unit is GB.
+
+

Check the Disk Capacity of a Full-ECS Image

The disk capacity of a full-ECS image is the sum of the system disk capacity and data disk capacity in the backup from which the full-ECS image is created.

+
  1. Access the IMS console.
    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

      +
    +
  2. Click the Private Images tab to display the image list.

    The value in the Disk Capacity column is --.

    +
  3. Click the full-ECS image name.
  4. Click the Backups tab and view the capacities of the system disk and data disks in the backup.

    Disk capacity of a full-ECS image = Capacity of the system disk in the backup + Capacity of data disks in the backup

    +

    For example:

    +
    • If the system disk capacity is 40 GB and no data disk is attached, the capacity of the full-ECS image disk is 40 GB.
    • If the system disk capacity is 40 GB and data disk capacity is 40 GB, the full-ECS image disk capacity is 80 GB.
    +
+
+
+
+
+
Parent topic: Managing Private Images
+
+
+ diff --git a/docs/ims/umn/public_sys-resources/ExpandCollapse.js b/docs/ims/umn/public_sys-resources/ExpandCollapse.js new file mode 100644 index 000000000..3f1b7db00 --- /dev/null +++ b/docs/ims/umn/public_sys-resources/ExpandCollapse.js @@ -0,0 +1 @@ +var expandClassName="dropdownexpand";var collapseClassName="dropdowncollapse";var collapseTableClassName="dropdowncollapsetable";var href="";function ExpandorCollapseNode(a){a=a.parentNode;if(a.className==expandClassName){a.className=collapseClassName}else{a.className=expandClassName}}function ExpandorCollapseTableNode(a){a=a.parentNode;if(a.className==expandClassName){a.className=collapseTableClassName}else{a.className=expandClassName}}function ExpandorCollapseAllNodes(g,h,c){var a=g.getAttribute("title");var b=g.parentNode;if(a=="collapse"){g.setAttribute("title","expand");g.className="dropdownAllButtonexpand";g.innerHTML=h}else{g.setAttribute("title","collapse");g.className="dropdownAllButtoncollapse";g.innerHTML=c}var f=b.getElementsByTagName("*");for(var d=0;d-1){ExpandForHref(href.substring(href.lastIndexOf("#")+1))}}catch(a){}}; \ No newline at end of file diff --git a/docs/ims/umn/public_sys-resources/caution_3.0-en-us.png b/docs/ims/umn/public_sys-resources/caution_3.0-en-us.png new file mode 100644 index 000000000..60f607621 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/caution_3.0-en-us.png differ diff --git a/docs/ims/umn/public_sys-resources/commonltr.css b/docs/ims/umn/public_sys-resources/commonltr.css new file mode 100644 index 000000000..c5480b0ab --- /dev/null +++ b/docs/ims/umn/public_sys-resources/commonltr.css @@ -0,0 +1 @@ +body{font-size:10pt;font-family:Arial;margin:1.5em;border-top:2pt;padding-top:1em;padding-bottom:2em}.msgph{font-family:Courier New}.rowlinecopyright{color:red;margin-top:10pt}.unresolved{background-color:skyblue}.noTemplate{background-color:yellow}.base{background-color:#fff}.nested0{margin-top:1em}.p{margin-top:.6em;margin-bottom:.6em}p{margin-top:.5em;margin-bottom:.5em}.note p{margin-top:.5em;margin-bottom:.5em}.tip p{margin-top:.5em;margin-bottom:.5em}.danger p{margin-top:.5em;margin-bottom:.5em}.notice p{margin-top:.5em;margin-bottom:.5em}.warning p{margin-top:.5em;margin-bottom:.5em}.caution p{margin-top:.5em;margin-bottom:.5em}.attention p{margin-top:.5em;margin-bottom:.5em}table p{margin-top:.2em;margin-bottom:.2em}table .p{margin-top:.4em;margin-bottom:.2em}.figcap{font-size:10pt}img{margin-top:.3em}.figdesc{font-style:normal}.figborder{border-style:solid;padding-left:3px;border-width:2px;padding-right:3px;margin-top:1em;border-color:Silver}.figsides{border-left:2px solid;padding-left:3px;border-right:2px solid;padding-right:3px;margin-top:1em;border-color:Silver}.figtop{border-top:2px solid;margin-top:1em;border-color:Silver}.figbottom{border-bottom:2px solid;border-color:Silver}.figtopbot{border-top:2px solid;border-bottom:2px solid;margin-top:1em;border-color:Silver}.fignone{font-size:10pt;margin-top:8pt;margin-bottom:8pt}.familylinks{margin-top:1.5em;margin-bottom:1em}.ullinks{list-style-type:none}.linklist{margin-bottom:1em}.linklistwithchild{margin-left:1.5em;margin-bottom:1em}.sublinklist{margin-left:1.5em;margin-bottom:1em}.relconcepts{margin-top:.6em;margin-bottom:.6em}.reltasks{margin-top:.6em;margin-bottom:.6em}.relref{margin-top:.6em;margin-bottom:.6em}.relinfo{margin-top:.6em;margin-bottom:.6em}.breadcrumb{font-size:smaller;margin-bottom:.6em}.prereq{margin-left:20px}.parentlink{margin-top:.6em;margin-bottom:.6em}.nextlink{margin-top:.6em;margin-bottom:.6em}.previouslink{margin-top:.6em;margin-bottom:.6em}.topictitle1{margin-top:0;margin-bottom:1em;font-size:14pt;color:#007af4}.topictitle2{margin-top:1pc;margin-bottom:.45em;font-size:1.17em;color:#007af4}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-size:1.17em;font-weight:bold;color:#007af4}.topictitle4{margin-top:.83em;font-size:1.17em;font-weight:bold}.topictitle5{font-size:1.17em;font-weight:bold}.topictitle6{font-size:1.17em;font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:1em;color:black;font-size:10.5pt;font-weight:bold;color:#007af4;overflow:auto}.section{margin-top:1em;margin-bottom:1em}.example{margin-top:1em;margin-bottom:1em}.sectiontitle2contents:link{color:#007af4}.sectiontitle2contents:visited{color:#800080}.note{margin-top:1em;margin-bottom:1em;background-color:#ffc}.notetitle{font-weight:bold}.notelisttitle{font-weight:bold}.tip{margin-top:1em;margin-bottom:1em;background-color:#ffc}.tiptitle{font-weight:bold}.fastpath{margin-top:1em;margin-bottom:1em;background-color:#ffc}.fastpathtitle{font-weight:bold}.important{margin-top:1em;margin-bottom:1em;background-color:#ffc}.importanttitle{font-weight:bold}.remember{margin-top:1em;margin-bottom:1em;background-color:#ffc}.remembertitle{font-weight:bold}.restriction{margin-top:1em;margin-bottom:1em;background-color:#ffc}.restrictiontitle{font-weight:bold}.attention{margin-top:1em;margin-bottom:1em;background-color:#ffc}.attentiontitle{font-weight:bold}.dangertitle{font-weight:bold}.danger{margin-top:1em;margin-bottom:1em;background-color:#ffc}.noticetitle{font-weight:bold}.notice{margin-top:1em;margin-bottom:1em;background-color:#ffc}.warningtitle{font-weight:bold}.warning{margin-top:1em;margin-bottom:1em;background-color:#ffc}.cautiontitle{font-weight:bold}.caution{margin-top:1em;margin-bottom:1em;background-color:#ffc}ul.simple{list-style-type:none}li ul{margin-top:.6em}li{margin-top:.6em;margin-bottom:.6em}.note li{margin-top:.2em;margin-bottom:.2em}.tip li{margin-top:.2em;margin-bottom:.2em}.danger li{margin-top:.2em;margin-bottom:.2em}.warning li{margin-top:.2em;margin-bottom:.2em}.notice li{margin-top:.2em;margin-bottom:.2em}.caution li{margin-top:.2em;margin-bottom:.2em}.attention li{margin-top:.2em;margin-bottom:.2em}table li{margin-top:.2em;margin-bottom:.2em}ol{margin-top:1em;margin-bottom:1em;margin-left:2.4em;padding-left:0}ul{margin-top:1em;margin-bottom:1em;margin-left:2.0em;padding-left:0}ol ul{list-style:disc}ul ul{list-style:square}ol ul ul{list-style:square}ol ul{list-style-type:disc}table ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}table ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ul{margin-top:.4em;margin-bottom:.4em;list-style:square}table ol ol{margin-top:.4em;margin-bottom:.4em;list-style:lower-alpha}table ol ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}.substepthirdol{list-style-type:lower-roman}.firstcol{font-weight:bold}th{background-color:#cfcfcf}table{margin-top:8pt;margin-bottom:12pt;width:100%}table caption{margin-top:8pt;text-align:left}.bold{font-weight:bold}.boldItalic{font-weight:bold;font-style:italic}.italic{font-style:italic}.underlined{text-decoration:underline}.var{font-style:italic}.shortcut{text-decoration:underline}.dlterm{font-weight:bold}dd{margin-top:.5em;margin-bottom:.5em}.dltermexpand{font-weight:bold;margin-top:1em}*[compact="yes"]>li{margin-top:0}*[compact="no"]>li{margin-top:.53em}.liexpand{margin-top:1em;margin-bottom:1em}.sliexpand{margin-top:1em;margin-bottom:1em}.dlexpand{margin-top:1em;margin-bottom:1em}.ddexpand{margin-top:1em;margin-bottom:1em}.stepexpand{margin-top:.3em;margin-bottom:.3em}.substepexpand{margin-top:.3em;margin-bottom:.3em}div.imageleft{text-align:left}div.imagecenter{text-align:center}div.imageright{text-align:right}div.imagejustify{text-align:justify}div.noblankline{text-align:center}div.noblankline img{margin-top:0}pre.screen{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;background-color:#ddd;white-space:pre}pre.codeblock{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;background-color:#ddd;white-space:pre}.hrcopyright{color:#3f4e5d;margin-top:18pt}.hwcopyright{text-align:center}.comment{margin:2px 2px 2px 2px;font-family:Arial;font-size:10pt;background-color:#bfb;color:#000}.dropdownAllButtonexpand{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdownAllButtoncollapse{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;text-decoration:underline;color:#007af4}.dropdowntitle{background-repeat:no-repeat;background-position:0 4px;padding-left:15px;cursor:pointer;text-decoration:underline;color:#007af4}.dropdownexpand .dropdowntitle{background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapse .dropdowncontext{display:none}.dropdowncollapse .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdowncollapsetable{border:0}.dropdowncollapsetable .dropdowncontext{display:none}.dropdowncollapsetable .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}pre{font-size:10pt;font-weight:normal;margin-left:9;margin-top:2;margin-bottom:2}.termcolor{color:blue;cursor:pointer}#dhtmlgoodies_tooltip{background-color:#f0f0d2;border:1px solid #000;position:absolute;display:none;z-index:20000;padding:2px;font-size:.9em;-moz-border-radius:6px;font-family:"Trebuchet MS","Lucida Sans Unicode",Arial,sans-serif}#dhtmlgoodies_tooltipShadow{position:absolute;background-color:#555;display:none;z-index:10000;opacity:.7;filter:alpha(opacity=70);-khtml-opacity:.7;-moz-opacity:.7;-moz-border-radius:6px}.freeze{position:fixed;_position:absolute;_top:expression(eval(document.documentElement.scrollTop));left:10;top:0} \ No newline at end of file diff --git a/docs/ims/umn/public_sys-resources/commonltr_print.css b/docs/ims/umn/public_sys-resources/commonltr_print.css new file mode 100644 index 000000000..a59823141 --- /dev/null +++ b/docs/ims/umn/public_sys-resources/commonltr_print.css @@ -0,0 +1 @@ +body{font-size:12.0pt;margin:1.5em;margin-left:1.6cm}.msgph{font-family:Courier New}.rowlinecopyright{color:red;margin-top:10pt}.unresolved{background-color:skyblue}.noTemplate{background-color:yellow}.base{background-color:#fff}.nested0{margin-top:1em}.p{margin-top:1em}p{margin-top:.5em;margin-bottom:.5em}.note p{margin-top:.5em;margin-bottom:.5em}.tip p{margin-top:.5em;margin-bottom:.5em}.danger p{margin-top:.5em;margin-bottom:.5em}.warning p{margin-top:.5em;margin-bottom:.5em}.notice p{margin-top:.5em;margin-bottom:.5em}.caution p{margin-top:.5em;margin-bottom:.5em}.attention p{margin-top:.5em;margin-bottom:.5em}table p{margin-top:.2em;margin-bottom:.2em}table .p{margin-top:.4em;margin-bottom:.2em}.covertable{border:0;width:100% cellpadding:8pt;cellspacing:8pt}.cover_productname{font-size:15.0pt;font-family:"Arial"}.cover_manualtitle{font-size:24.0pt;font-weight:bold;font-family:"Arial"}.cover_manualsubtitle{font-size:18.0pt;font-weight:bold;font-family:"Arial"}.cover_heading{font-size:12.0pt;font-weight:bold;font-family:"Arial"}.cover_text{font-size:9.0pt;font-family:"Arial"}.tocheading,.heading1,.topictitle1{margin-top:40.0pt;margin-right:0;margin-bottom:20.0pt;margin-left:-1cm;text-align:left;border:0;border-bottom:solid windowtext .5pt;font-size:22.0pt;font-family:"Arial";font-weight:bold}.topictitlenumber1{font-size:72.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle2{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:-1cm;text-indent:0;font-size:18.0pt;font-family:"Arial";font-weight:bold}.topictitle3{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:16.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle4{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:14.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle5{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.blocklabel,.topictitle6{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.sectiontitle{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:-1cm;text-indent:0;font-size:13.0pt;font-family:"Arial";font-weight:bold}.tocentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:12.0pt;font-family:"Book Antiqua";font-weight:bold}.tocentry2{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry3{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry4{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry5{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tofentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman";font-weight:normal}.totentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman";font-weight:normal}.indexheading{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.indexentry1{margin-top:4pt;margin-right:0;margin-bottom:0;margin-left:0;line-height:12.0pt;font-size:12.0pt;font-family:"Times New Roman"}.indexentry2{margin-top:0;margin-right:0;margin-bottom:0;margin-left:24.0pt;line-height:12.0pt;font-size:12.0pt}.indexentry3{margin-top:0;margin-right:0;margin-bottom:0;margin-left:48pt;line-height:12.0pt;font-size:12.0pt}.figurenumber{font-weight:bold}.tablenumber{font-weight:bold}.familylinks{margin-top:1.5em;margin-bottom:1em}.figcap{font-size:11.0pt}.tablecap{font-size:11.0pt}.figdesc{font-style:normal}.fignone{margin-top:8.0pt}.figborder{border-style:solid;padding-left:3px;border-width:2px;padding-right:3px;margin-top:1em;border-color:Silver}.figsides{border-left:2px solid;padding-left:3px;border-right:2px solid;padding-right:3px;margin-top:1em;border-color:Silver}.figtop{border-top:2px solid;margin-top:1em;border-color:Silver}.figbottom{border-bottom:2px solid;border-color:Silver}.figtopbot{border-top:2px solid;border-bottom:2px solid;margin-top:1em;border-color:Silver}.ullinks{margin-left:0;list-style-type:none}.ulchildlink{margin-top:1em;margin-bottom:1em}.olchildlink{margin-top:1em;margin-bottom:1em;margin-left:1em}.linklist{margin-bottom:1em}.linklistwithchild{margin-left:1.5em;margin-bottom:1em}.sublinklist{margin-left:1.5em;margin-bottom:1em}.relconcepts{margin-left:1cm;margin-top:1em;margin-bottom:1em}.reltasks{margin-left:1cm;margin-top:1em;margin-bottom:1em}.relref{margin-left:1cm;margin-top:1em;margin-bottom:1em}.relinfo{margin-top:1em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-left:0}.parentlink{margin-top:.6em;margin-bottom:.6em}.nextlink{margin-top:.6em;margin-bottom:.6em}.previouslink{margin-top:.6em;margin-bottom:.6em}.section{margin-top:1em;margin-bottom:1em}.example{margin-top:1em;margin-bottom:1em}table .note{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.note{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.notetitle{font-weight:bold;font-size:11.0pt}.notelisttitle{font-weight:bold}table .tip{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.tip{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.tiptitle{font-weight:bold;font-size:11.0pt}table .fastpath{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.fastpath{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.fastpathtitle{font-weight:bold;font-size:11.0pt}table .important{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.important{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.importanttitle{font-weight:bold;font-size:11.0pt}table .remember{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.remember{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.remembertitle{font-weight:bold;font-size:11.0pt}table .restriction{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.restriction{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.restrictiontitle{font-weight:bold;font-size:11.0pt}table .attention{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.attention{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}.attentiontitle{font-weight:bold}table .danger{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.dangertitle{font-weight:bold}.danger{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .notice{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.noticetitle{font-weight:bold}.notice{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .warning{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.warningtitle{font-weight:bold}.warning{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .caution{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}table caption{margin-top:8pt;text-align:left;font-weight:bold}.tablenoborder{margin-top:8pt}.cautiontitle{font-weight:bold}.caution{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}ul.simple{list-style-type:none}li ul{margin-top:.6em}li{margin-top:.6em;margin-bottom:.6em}.note li{margin-top:.2em;margin-bottom:.2em}.tip li{margin-top:.2em;margin-bottom:.2em}.danger li{margin-top:.2em;margin-bottom:.2em}.warning li{margin-top:.2em;margin-bottom:.2em}.notice li{margin-top:.2em;margin-bottom:.2em}.caution li{margin-top:.2em;margin-bottom:.2em}.attention li{margin-top:.2em;margin-bottom:.2em}table li{margin-top:.2em;margin-bottom:.2em}.firstcol{font-weight:bold}th{background-color:#cfcfcf}.bold{font-weight:bold}.boldItalic{font-weight:bold;font-style:italic}.italic{font-style:italic}.underlined{text-decoration:underline}.var{font-style:italic}.shortcut{text-decoration:underline}.dlterm{font-weight:bold}dd{margin-top:.5em;margin-bottom:.5em}.dltermexpand{font-weight:bold;margin-top:1em}*[compact="yes"]>li{margin-top:0}*[compact="no"]>li{margin-top:.53em}.liexpand{margin-top:1em;margin-bottom:1em}.sliexpand{margin-top:1em;margin-bottom:1em}.dlexpand{margin-top:1em;margin-bottom:1em}.ddexpand{margin-top:1em;margin-bottom:1em}.stepexpand{margin-top:1em;margin-bottom:1em}.substepexpand{margin-top:1em;margin-bottom:1em}table{margin-top:8pt;margin-bottom:10.0pt;width:100%}thead{font-size:10.0pt;font-family:"Book Antiqua";font-weight:bold}tbody{font-size:11.0pt}ol{margin-top:1em;margin-bottom:1em;margin-left:1.7em;-webkit-padding-start:0}ul{margin-top:1em;margin-bottom:1em;margin-left:1.2em;-webkit-padding-start:0}ol ul{list-style:disc}ul ul{list-style:square}ol ol{list-style-type:lower-alpha}table ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}table ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ul{margin-top:.4em;margin-bottom:.4em;list-style:square}table ol ol{margin-top:.4em;margin-bottom:.4em;list-style:lower-alpha}table ol ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}.substepthirdol{list-style-type:lower-roman}div.imageleft{text-align:left}div.imagecenter{text-align:center}div.imageright{text-align:right}div.imagejustify{text-align:justify}div.noblankline{text-align:center}div.noblankline img{margin-top:0}pre{font-size:10.0pt;border-width:2px;padding:2px;margin-top:5px;margin-bottom:5px;white-space:pre-wrap;white-space:-moz-pre-wrap;white-space:-pre-wrap;white-space:-o-pre-wrap;word-wrap:break-word}pre.screen{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;white-space:pre}pre.codeblock{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;white-space:pre}.dropdownAllButtonexpand{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdownAllButtoncollapse{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;text-decoration:underline;color:#007af4}.dropdowntitle{background-repeat:no-repeat;background-position:0 4px;padding-left:15px;cursor:pointer;text-decoration:underline;color:#007af4}.dropdownexpand .dropdowntitle{background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapse .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapsetable .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.prefacesectiontitle1{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:-1cm;text-indent:0;font-size:18.0pt;font-family:"Book Antiqua";font-weight:bold;overflow:auto}.termcolor{color:blue;cursor:pointer}#dhtmlgoodies_tooltip{background-color:#f0f0d2;border:1px solid #000;position:absolute;display:none;z-index:20000;padding:2px;font-size:.9em;-moz-border-radius:6px;font-family:"Trebuchet MS","Lucida Sans Unicode",Arial,sans-serif}#dhtmlgoodies_tooltipShadow{position:absolute;background-color:#555;display:none;z-index:10000;opacity:.7;filter:alpha(opacity=70);-khtml-opacity:.7;-moz-opacity:.7;-moz-border-radius:6px}.freeze{position:fixed;_position:absolute;_top:expression(eval(document.documentElement.scrollTop));left:10;top:0}.hrcopyright{color:#3f4e5d;margin-top:18pt;margin-left:-1cm}.hwcopyright{text-align:center;font-family:Arial;margin-left:-1cm} \ No newline at end of file diff --git a/docs/ims/umn/public_sys-resources/commonrtl.css b/docs/ims/umn/public_sys-resources/commonrtl.css new file mode 100644 index 000000000..947a9a033 --- /dev/null +++ b/docs/ims/umn/public_sys-resources/commonrtl.css @@ -0,0 +1,2 @@ +.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with
. Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式 +*//*! Default of bold for definition list terms *//*! Use CSS to expand lists with @compact="no" */.dltermexpand{font-weight:700;margin-top:1em}[compact="yes"]>li{margin-top:0}[compact="no"]>li{margin-top:.53em}/*! Align images based on @align on topic/image */div.imageleft,.text-align-left{text-align:left}div.imagecenter,.text-align-center{text-align:center}div.imageright,.text-align-right{text-align:right}div.imagejustify,.text-align-justify{text-align:justify}.cellrowborder{border-right:0;border-top:0;border-left:1px solid;border-bottom:1px solid}.row-nocellborder{border-left:hidden;border-right:0;border-top:0;border-bottom:1px solid}.cell-norowborder{border-top:0;border-bottom:hidden;border-right:0;border-left:1px solid}.nocellnorowborder{border:0;border-left:hidden;border-bottom:hidden}pre.codeblock,pre.screen{padding:5px;border:outset;background-color:#ccc;margin-top:2px;margin-bottom:2px;white-space:pre} \ No newline at end of file diff --git a/docs/ims/umn/public_sys-resources/danger_3.0-en-us.png b/docs/ims/umn/public_sys-resources/danger_3.0-en-us.png new file mode 100644 index 000000000..47a9c7235 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/danger_3.0-en-us.png differ diff --git a/docs/ims/umn/public_sys-resources/delta.gif b/docs/ims/umn/public_sys-resources/delta.gif new file mode 100644 index 000000000..0d1b1f674 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/delta.gif differ diff --git a/docs/ims/umn/public_sys-resources/deltaend.gif b/docs/ims/umn/public_sys-resources/deltaend.gif new file mode 100644 index 000000000..cc7da0fc8 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/deltaend.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-arrowdn.gif b/docs/ims/umn/public_sys-resources/icon-arrowdn.gif new file mode 100644 index 000000000..84eec9be2 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-arrowdn.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-arrowrt.gif b/docs/ims/umn/public_sys-resources/icon-arrowrt.gif new file mode 100644 index 000000000..39583d168 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-arrowrt.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-caution.gif b/docs/ims/umn/public_sys-resources/icon-caution.gif new file mode 100644 index 000000000..079c79b26 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-caution.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-danger.gif b/docs/ims/umn/public_sys-resources/icon-danger.gif new file mode 100644 index 000000000..079c79b26 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-danger.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-huawei.gif b/docs/ims/umn/public_sys-resources/icon-huawei.gif new file mode 100644 index 000000000..a31d60f89 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-huawei.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-note.gif b/docs/ims/umn/public_sys-resources/icon-note.gif new file mode 100644 index 000000000..31be2b039 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-note.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-notice.gif b/docs/ims/umn/public_sys-resources/icon-notice.gif new file mode 100644 index 000000000..409070650 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-notice.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-tip.gif b/docs/ims/umn/public_sys-resources/icon-tip.gif new file mode 100644 index 000000000..c47bae05c Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-tip.gif differ diff --git a/docs/ims/umn/public_sys-resources/icon-warning.gif b/docs/ims/umn/public_sys-resources/icon-warning.gif new file mode 100644 index 000000000..079c79b26 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/icon-warning.gif differ diff --git a/docs/ims/umn/public_sys-resources/imageResize.js b/docs/ims/umn/public_sys-resources/imageResize.js new file mode 100644 index 000000000..e4c520739 --- /dev/null +++ b/docs/ims/umn/public_sys-resources/imageResize.js @@ -0,0 +1,4 @@ +/** IDP renames $ to $$$,jQueryHW2 */ +var $$$,jQueryHW2; +jQueryHW2 = $$$ = $; +function image_size(a){$$$(window).on('load',function(){$$$(a).each(function(){var e=$$$(this);var f=e.width();var d=e.height();var b=f;var c=d;e.click(function(){tb_show("",this.src,false)})})})}; \ No newline at end of file diff --git a/docs/ims/umn/public_sys-resources/imageclose.gif b/docs/ims/umn/public_sys-resources/imageclose.gif new file mode 100644 index 000000000..56818c26b Binary files /dev/null and b/docs/ims/umn/public_sys-resources/imageclose.gif differ diff --git a/docs/ims/umn/public_sys-resources/imageclosehover.gif b/docs/ims/umn/public_sys-resources/imageclosehover.gif new file mode 100644 index 000000000..3bcf231f1 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/imageclosehover.gif differ diff --git a/docs/ims/umn/public_sys-resources/imagemax.gif b/docs/ims/umn/public_sys-resources/imagemax.gif new file mode 100644 index 000000000..49fe390b1 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/imagemax.gif differ diff --git a/docs/ims/umn/public_sys-resources/imagemaxhover.gif b/docs/ims/umn/public_sys-resources/imagemaxhover.gif new file mode 100644 index 000000000..387b0a981 Binary files /dev/null and b/docs/ims/umn/public_sys-resources/imagemaxhover.gif differ diff --git a/docs/ims/umn/public_sys-resources/jquery-migrate-1.2.1.min.js b/docs/ims/umn/public_sys-resources/jquery-migrate-1.2.1.min.js new file mode 100644 index 000000000..fc18734e9 --- /dev/null +++ b/docs/ims/umn/public_sys-resources/jquery-migrate-1.2.1.min.js @@ -0,0 +1,2 @@ +/*! jQuery Migrate v1.2.1 | (c) 2005, 2013 jQuery Foundation, Inc. and other contributors | jquery.org/license */ +jQueryHW2.migrateMute===void 0&&(jQueryHW2.migrateMute=!0),function(e,t,n){function r(n){var r=t.console;i[n]||(i[n]=!0,e.migrateWarnings.push(n),r&&r.warn&&!e.migrateMute&&(r.warn("JQMIGRATE: "+n),e.migrateTrace&&r.trace&&r.trace()))}function a(t,a,i,o){if(Object.defineProperty)try{return Object.defineProperty(t,a,{configurable:!0,enumerable:!0,get:function(){return r(o),i},set:function(e){r(o),i=e}}),n}catch(s){}e._definePropertyBroken=!0,t[a]=i}var i={};e.migrateWarnings=[],!e.migrateMute&&t.console&&t.console.log&&t.console.log("JQMIGRATE: Logging is active"),e.migrateTrace===n&&(e.migrateTrace=!0),e.migrateReset=function(){i={},e.migrateWarnings.length=0},"BackCompat"===document.compatMode&&r("jQueryHW2 is not compatible with Quirks Mode");var o=e("",{size:1}).attr("size")&&e.attrFn,s=e.attr,u=e.attrHooks.value&&e.attrHooks.value.get||function(){return null},c=e.attrHooks.value&&e.attrHooks.value.set||function(){return n},l=/^(?:input|button)$/i,d=/^[238]$/,p=/^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i,f=/^(?:checked|selected)$/i;a(e,"attrFn",o||{},"jQueryHW2.attrFn is deprecated"),e.attr=function(t,a,i,u){var c=a.toLowerCase(),g=t&&t.nodeType;return u&&(4>s.length&&r("jQueryHW2.fn.attr( props, pass ) is deprecated"),t&&!d.test(g)&&(o?a in o:e.isFunction(e.fn[a])))?e(t)[a](i):("type"===a&&i!==n&&l.test(t.nodeName)&&t.parentNode&&r("Can't change the 'type' of an input or button in IE 6/7/8"),!e.attrHooks[c]&&p.test(c)&&(e.attrHooks[c]={get:function(t,r){var a,i=e.prop(t,r);return i===!0||"boolean"!=typeof i&&(a=t.getAttributeNode(r))&&a.nodeValue!==!1?r.toLowerCase():n},set:function(t,n,r){var a;return n===!1?e.removeAttr(t,r):(a=e.propFix[r]||r,a in t&&(t[a]=!0),t.setAttribute(r,r.toLowerCase())),r}},f.test(c)&&r("jQueryHW2.fn.attr('"+c+"') may use property instead of attribute")),s.call(e,t,a,i))},e.attrHooks.value={get:function(e,t){var n=(e.nodeName||"").toLowerCase();return"button"===n?u.apply(this,arguments):("input"!==n&&"option"!==n&&r("jQueryHW2.fn.attr('value') no longer gets properties"),t in e?e.value:null)},set:function(e,t){var a=(e.nodeName||"").toLowerCase();return"button"===a?c.apply(this,arguments):("input"!==a&&"option"!==a&&r("jQueryHW2.fn.attr('value', val) no longer sets properties"),e.value=t,n)}};var g,h,v=e.fn.init,m=e.parseJSON,y=/^([^<]*)(<[\w\W]+>)([^>]*)$/;e.fn.init=function(t,n,a){var i;return t&&"string"==typeof t&&!e.isPlainObject(n)&&(i=y.exec(e.trim(t)))&&i[0]&&("<"!==t.charAt(0)&&r("$(html) HTML strings must start with '<' character"),i[3]&&r("$(html) HTML text after last tag is ignored"),"#"===i[0].charAt(0)&&(r("HTML string cannot start with a '#' character"),e.error("JQMIGRATE: Invalid selector string (XSS)")),n&&n.context&&(n=n.context),e.parseHTML)?v.call(this,e.parseHTML(i[2],n,!0),n,a):v.apply(this,arguments)},e.fn.init.prototype=e.fn,e.parseJSON=function(e){return e||null===e?m.apply(this,arguments):(r("jQueryHW2.parseJSON requires a valid JSON string"),null)},e.uaMatch=function(e){e=e.toLowerCase();var t=/(chrome)[ \/]([\w.]+)/.exec(e)||/(webkit)[ \/]([\w.]+)/.exec(e)||/(opera)(?:.*version|)[ \/]([\w.]+)/.exec(e)||/(msie) ([\w.]+)/.exec(e)||0>e.indexOf("compatible")&&/(mozilla)(?:.*? rv:([\w.]+)|)/.exec(e)||[];return{browser:t[1]||"",version:t[2]||"0"}},e.browser||(g=e.uaMatch(navigator.userAgent),h={},g.browser&&(h[g.browser]=!0,h.version=g.version),h.chrome?h.webkit=!0:h.webkit&&(h.safari=!0),e.browser=h),a(e,"browser",e.browser,"jQueryHW2.browser is deprecated"),e.sub=function(){function t(e,n){return new t.fn.init(e,n)}e.extend(!0,t,this),t.superclass=this,t.fn=t.prototype=this(),t.fn.constructor=t,t.sub=this.sub,t.fn.init=function(r,a){return a&&a instanceof e&&!(a instanceof t)&&(a=t(a)),e.fn.init.call(this,r,a,n)},t.fn.init.prototype=t.fn;var n=t(document);return r("jQueryHW2.sub() is deprecated"),t},e.ajaxSetup({converters:{"text json":e.parseJSON}});var b=e.fn.data;e.fn.data=function(t){var a,i,o=this[0];return!o||"events"!==t||1!==arguments.length||(a=e.data(o,t),i=e._data(o,t),a!==n&&a!==i||i===n)?b.apply(this,arguments):(r("Use of jQueryHW2.fn.data('events') is deprecated"),i)};var j=/\/(java|ecma)script/i,w=e.fn.andSelf||e.fn.addBack;e.fn.andSelf=function(){return r("jQueryHW2.fn.andSelf() replaced by jQueryHW2.fn.addBack()"),w.apply(this,arguments)},e.clean||(e.clean=function(t,a,i,o){a=a||document,a=!a.nodeType&&a[0]||a,a=a.ownerDocument||a,r("jQueryHW2.clean() is deprecated");var s,u,c,l,d=[];if(e.merge(d,e.buildFragment(t,a).childNodes),i)for(c=function(e){return!e.type||j.test(e.type)?o?o.push(e.parentNode?e.parentNode.removeChild(e):e):i.appendChild(e):n},s=0;null!=(u=d[s]);s++)e.nodeName(u,"script")&&c(u)||(i.appendChild(u),u.getElementsByTagName!==n&&(l=e.grep(e.merge([],u.getElementsByTagName("script")),c),d.splice.apply(d,[s+1,0].concat(l)),s+=l.length));return d});var Q=e.event.add,x=e.event.remove,k=e.event.trigger,N=e.fn.toggle,T=e.fn.live,M=e.fn.die,S="ajaxStart|ajaxStop|ajaxSend|ajaxComplete|ajaxError|ajaxSuccess",C=RegExp("\\b(?:"+S+")\\b"),H=/(?:^|\s)hover(\.\S+|)\b/,A=function(t){return"string"!=typeof t||e.event.special.hover?t:(H.test(t)&&r("'hover' pseudo-event is deprecated, use 'mouseenter mouseleave'"),t&&t.replace(H,"mouseenter$1 mouseleave$1"))};e.event.props&&"attrChange"!==e.event.props[0]&&e.event.props.unshift("attrChange","attrName","relatedNode","srcElement"),e.event.dispatch&&a(e.event,"handle",e.event.dispatch,"jQueryHW2.event.handle is undocumented and deprecated"),e.event.add=function(e,t,n,a,i){e!==document&&C.test(t)&&r("AJAX events should be attached to document: "+t),Q.call(this,e,A(t||""),n,a,i)},e.event.remove=function(e,t,n,r,a){x.call(this,e,A(t)||"",n,r,a)},e.fn.error=function(){var e=Array.prototype.slice.call(arguments,0);return r("jQueryHW2.fn.error() is deprecated"),e.splice(0,0,"error"),arguments.length?this.bind.apply(this,e):(this.triggerHandler.apply(this,e),this)},e.fn.toggle=function(t,n){if(!e.isFunction(t)||!e.isFunction(n))return N.apply(this,arguments);r("jQueryHW2.fn.toggle(handler, handler...) is deprecated");var a=arguments,i=t.guid||e.guid++,o=0,s=function(n){var r=(e._data(this,"lastToggle"+t.guid)||0)%o;return e._data(this,"lastToggle"+t.guid,r+1),n.preventDefault(),a[r].apply(this,arguments)||!1};for(s.guid=i;a.length>o;)a[o++].guid=i;return this.click(s)},e.fn.live=function(t,n,a){return r("jQueryHW2.fn.live() is deprecated"),T?T.apply(this,arguments):(e(this.context).on(t,this.selector,n,a),this)},e.fn.die=function(t,n){return r("jQueryHW2.fn.die() is deprecated"),M?M.apply(this,arguments):(e(this.context).off(t,this.selector||"**",n),this)},e.event.trigger=function(e,t,n,a){return n||C.test(e)||r("Global events are undocumented and deprecated"),k.call(this,e,t,n||document,a)},e.each(S.split("|"),function(t,n){e.event.special[n]={setup:function(){var t=this;return t!==document&&(e.event.add(document,n+"."+e.guid,function(){e.event.trigger(n,null,t,!0)}),e._data(this,n,e.guid++)),!1},teardown:function(){return this!==document&&e.event.remove(document,n+"."+e._data(this,n)),!1}}})}(jQueryHW2,window); \ No newline at end of file diff --git a/docs/ims/umn/public_sys-resources/jquery-ui.min.js b/docs/ims/umn/public_sys-resources/jquery-ui.min.js new file mode 100644 index 000000000..ba0b043dc --- /dev/null +++ b/docs/ims/umn/public_sys-resources/jquery-ui.min.js @@ -0,0 +1,12 @@ +/*! jQuery UI - v1.12.1 - 2016-10-02 +* Includes: widget.js, position.js, data.js, disable-selection.js, focusable.js, form-reset-mixin.js, jquery-1-7.js, keycode.js, labels.js, scroll-parent.js, tabbable.js, unique-id.js, widgets/draggable.js, widgets/droppable.js, widgets/resizable.js, widgets/selectable.js, widgets/sortable.js, widgets/accordion.js, widgets/autocomplete.js, widgets/button.js, widgets/checkboxradio.js, widgets/controlgroup.js, widgets/datepicker.js, widgets/dialog.js, widgets/menu.js, widgets/mouse.js, widgets/progressbar.js, widgets/selectmenu.js, widgets/slider.js, widgets/spinner.js, widgets/tabs.js, widgets/tooltip.js, effect.js, effects/effect-blind.js, effects/effect-bounce.js, effects/effect-clip.js, effects/effect-drop.js, effects/effect-explode.js, effects/effect-fade.js, effects/effect-fold.js, effects/effect-highlight.js, effects/effect-puff.js, effects/effect-pulsate.js, effects/effect-scale.js, effects/effect-shake.js, effects/effect-size.js, effects/effect-slide.js, effects/effect-transfer.js +* Copyright jQueryHW2 Foundation and other contributors; Licensed MIT */ + +(function(t){"function"==typeof define&&define.amd?define(["jquery"],t):t(jQueryHW2)})(function(t){function e(t){for(var e=t.css("visibility");"inherit"===e;)t=t.parent(),e=t.css("visibility");return"hidden"!==e}function i(t){for(var e,i;t.length&&t[0]!==document;){if(e=t.css("position"),("absolute"===e||"relative"===e||"fixed"===e)&&(i=parseInt(t.css("zIndex"),10),!isNaN(i)&&0!==i))return i;t=t.parent()}return 0}function s(){this._curInst=null,this._keyEvent=!1,this._disabledInputs=[],this._datepickerShowing=!1,this._inDialog=!1,this._mainDivId="ui-datepicker-div",this._inlineClass="ui-datepicker-inline",this._appendClass="ui-datepicker-append",this._triggerClass="ui-datepicker-trigger",this._dialogClass="ui-datepicker-dialog",this._disableClass="ui-datepicker-disabled",this._unselectableClass="ui-datepicker-unselectable",this._currentClass="ui-datepicker-current-day",this._dayOverClass="ui-datepicker-days-cell-over",this.regional=[],this.regional[""]={closeText:"Done",prevText:"Prev",nextText:"Next",currentText:"Today",monthNames:["January","February","March","April","May","June","July","August","September","October","November","December"],monthNamesShort:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],dayNames:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],dayNamesShort:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],dayNamesMin:["Su","Mo","Tu","We","Th","Fr","Sa"],weekHeader:"Wk",dateFormat:"mm/dd/yy",firstDay:0,isRTL:!1,showMonthAfterYear:!1,yearSuffix:""},this._defaults={showOn:"focus",showAnim:"fadeIn",showOptions:{},defaultDate:null,appendText:"",buttonText:"...",buttonImage:"",buttonImageOnly:!1,hideIfNoPrevNext:!1,navigationAsDateFormat:!1,gotoCurrent:!1,changeMonth:!1,changeYear:!1,yearRange:"c-10:c+10",showOtherMonths:!1,selectOtherMonths:!1,showWeek:!1,calculateWeek:this.iso8601Week,shortYearCutoff:"+10",minDate:null,maxDate:null,duration:"fast",beforeShowDay:null,beforeShow:null,onSelect:null,onChangeMonthYear:null,onClose:null,numberOfMonths:1,showCurrentAtPos:0,stepMonths:1,stepBigMonths:12,altField:"",altFormat:"",constrainInput:!0,showButtonPanel:!1,autoSize:!1,disabled:!1},t.extend(this._defaults,this.regional[""]),this.regional.en=t.extend(!0,{},this.regional[""]),this.regional["en-US"]=t.extend(!0,{},this.regional.en),this.dpDiv=n(t("
"))}function n(e){var i="button, .ui-datepicker-prev, .ui-datepicker-next, .ui-datepicker-calendar td a";return e.on("mouseout",i,function(){t(this).removeClass("ui-state-hover"),-1!==this.className.indexOf("ui-datepicker-prev")&&t(this).removeClass("ui-datepicker-prev-hover"),-1!==this.className.indexOf("ui-datepicker-next")&&t(this).removeClass("ui-datepicker-next-hover")}).on("mouseover",i,o)}function o(){t.datepicker._isDisabledDatepicker(p.inline?p.dpDiv.parent()[0]:p.input[0])||(t(this).parents(".ui-datepicker-calendar").find("a").removeClass("ui-state-hover"),t(this).addClass("ui-state-hover"),-1!==this.className.indexOf("ui-datepicker-prev")&&t(this).addClass("ui-datepicker-prev-hover"),-1!==this.className.indexOf("ui-datepicker-next")&&t(this).addClass("ui-datepicker-next-hover"))}function a(e,i){t.extend(e,i);for(var s in i)null==i[s]&&(e[s]=i[s]);return e}function r(t){return function(){var e=this.element.val();t.apply(this,arguments),this._refresh(),e!==this.element.val()&&this._trigger("change")}}t.ui=t.ui||{},t.ui.version="1.12.1";var h=0,l=Array.prototype.slice;t.cleanData=function(e){return function(i){var s,n,o;for(o=0;null!=(n=i[o]);o++)try{s=t._data(n,"events"),s&&s.remove&&t(n).triggerHandler("remove")}catch(a){}e(i)}}(t.cleanData),t.widget=function(e,i,s){var n,o,a,r={},h=e.split(".")[0];e=e.split(".")[1];var l=h+"-"+e;return s||(s=i,i=t.Widget),t.isArray(s)&&(s=t.extend.apply(null,[{}].concat(s))),t.expr[":"][l.toLowerCase()]=function(e){return!!t.data(e,l)},t[h]=t[h]||{},n=t[h][e],o=t[h][e]=function(t,e){return this._createWidget?(arguments.length&&this._createWidget(t,e),void 0):new o(t,e)},t.extend(o,n,{version:s.version,_proto:t.extend({},s),_childConstructors:[]}),a=new i,a.options=t.widget.extend({},a.options),t.each(s,function(e,s){return t.isFunction(s)?(r[e]=function(){function t(){return i.prototype[e].apply(this,arguments)}function n(t){return i.prototype[e].apply(this,t)}return function(){var e,i=this._super,o=this._superApply;return this._super=t,this._superApply=n,e=s.apply(this,arguments),this._super=i,this._superApply=o,e}}(),void 0):(r[e]=s,void 0)}),o.prototype=t.widget.extend(a,{widgetEventPrefix:n?a.widgetEventPrefix||e:e},r,{constructor:o,namespace:h,widgetName:e,widgetFullName:l}),n?(t.each(n._childConstructors,function(e,i){var s=i.prototype;t.widget(s.namespace+"."+s.widgetName,o,i._proto)}),delete n._childConstructors):i._childConstructors.push(o),t.widget.bridge(e,o),o},t.widget.extend=function(e){for(var i,s,n=l.call(arguments,1),o=0,a=n.length;a>o;o++)for(i in n[o])s=n[o][i],n[o].hasOwnProperty(i)&&void 0!==s&&(e[i]=t.isPlainObject(s)?t.isPlainObject(e[i])?t.widget.extend({},e[i],s):t.widget.extend({},s):s);return e},t.widget.bridge=function(e,i){var s=i.prototype.widgetFullName||e;t.fn[e]=function(n){var o="string"==typeof n,a=l.call(arguments,1),r=this;return o?this.length||"instance"!==n?this.each(function(){var i,o=t.data(this,s);return"instance"===n?(r=o,!1):o?t.isFunction(o[n])&&"_"!==n.charAt(0)?(i=o[n].apply(o,a),i!==o&&void 0!==i?(r=i&&i.jquery?r.pushStack(i.get()):i,!1):void 0):t.error("no such method '"+n+"' for "+e+" widget instance"):t.error("cannot call methods on "+e+" prior to initialization; "+"attempted to call method '"+n+"'")}):r=void 0:(a.length&&(n=t.widget.extend.apply(null,[n].concat(a))),this.each(function(){var e=t.data(this,s);e?(e.option(n||{}),e._init&&e._init()):t.data(this,s,new i(n,this))})),r}},t.Widget=function(){},t.Widget._childConstructors=[],t.Widget.prototype={widgetName:"widget",widgetEventPrefix:"",defaultElement:"
",options:{classes:{},disabled:!1,create:null},_createWidget:function(e,i){i=t(i||this.defaultElement||this)[0],this.element=t(i),this.uuid=h++,this.eventNamespace="."+this.widgetName+this.uuid,this.bindings=t(),this.hoverable=t(),this.focusable=t(),this.classesElementLookup={},i!==this&&(t.data(i,this.widgetFullName,this),this._on(!0,this.element,{remove:function(t){t.target===i&&this.destroy()}}),this.document=t(i.style?i.ownerDocument:i.document||i),this.window=t(this.document[0].defaultView||this.document[0].parentWindow)),this.options=t.widget.extend({},this.options,this._getCreateOptions(),e),this._create(),this.options.disabled&&this._setOptionDisabled(this.options.disabled),this._trigger("create",null,this._getCreateEventData()),this._init()},_getCreateOptions:function(){return{}},_getCreateEventData:t.noop,_create:t.noop,_init:t.noop,destroy:function(){var e=this;this._destroy(),t.each(this.classesElementLookup,function(t,i){e._removeClass(i,t)}),this.element.off(this.eventNamespace).removeData(this.widgetFullName),this.widget().off(this.eventNamespace).removeAttr("aria-disabled"),this.bindings.off(this.eventNamespace)},_destroy:t.noop,widget:function(){return this.element},option:function(e,i){var s,n,o,a=e;if(0===arguments.length)return t.widget.extend({},this.options);if("string"==typeof e)if(a={},s=e.split("."),e=s.shift(),s.length){for(n=a[e]=t.widget.extend({},this.options[e]),o=0;s.length-1>o;o++)n[s[o]]=n[s[o]]||{},n=n[s[o]];if(e=s.pop(),1===arguments.length)return void 0===n[e]?null:n[e];n[e]=i}else{if(1===arguments.length)return void 0===this.options[e]?null:this.options[e];a[e]=i}return this._setOptions(a),this},_setOptions:function(t){var e;for(e in t)this._setOption(e,t[e]);return this},_setOption:function(t,e){return"classes"===t&&this._setOptionClasses(e),this.options[t]=e,"disabled"===t&&this._setOptionDisabled(e),this},_setOptionClasses:function(e){var i,s,n;for(i in e)n=this.classesElementLookup[i],e[i]!==this.options.classes[i]&&n&&n.length&&(s=t(n.get()),this._removeClass(n,i),s.addClass(this._classes({element:s,keys:i,classes:e,add:!0})))},_setOptionDisabled:function(t){this._toggleClass(this.widget(),this.widgetFullName+"-disabled",null,!!t),t&&(this._removeClass(this.hoverable,null,"ui-state-hover"),this._removeClass(this.focusable,null,"ui-state-focus"))},enable:function(){return this._setOptions({disabled:!1})},disable:function(){return this._setOptions({disabled:!0})},_classes:function(e){function i(i,o){var a,r;for(r=0;i.length>r;r++)a=n.classesElementLookup[i[r]]||t(),a=e.add?t(t.unique(a.get().concat(e.element.get()))):t(a.not(e.element).get()),n.classesElementLookup[i[r]]=a,s.push(i[r]),o&&e.classes[i[r]]&&s.push(e.classes[i[r]])}var s=[],n=this;return e=t.extend({element:this.element,classes:this.options.classes||{}},e),this._on(e.element,{remove:"_untrackClassesElement"}),e.keys&&i(e.keys.match(/\S+/g)||[],!0),e.extra&&i(e.extra.match(/\S+/g)||[]),s.join(" ")},_untrackClassesElement:function(e){var i=this;t.each(i.classesElementLookup,function(s,n){-1!==t.inArray(e.target,n)&&(i.classesElementLookup[s]=t(n.not(e.target).get()))})},_removeClass:function(t,e,i){return this._toggleClass(t,e,i,!1)},_addClass:function(t,e,i){return this._toggleClass(t,e,i,!0)},_toggleClass:function(t,e,i,s){s="boolean"==typeof s?s:i;var n="string"==typeof t||null===t,o={extra:n?e:i,keys:n?t:e,element:n?this.element:t,add:s};return o.element.toggleClass(this._classes(o),s),this},_on:function(e,i,s){var n,o=this;"boolean"!=typeof e&&(s=i,i=e,e=!1),s?(i=n=t(i),this.bindings=this.bindings.add(i)):(s=i,i=this.element,n=this.widget()),t.each(s,function(s,a){function r(){return e||o.options.disabled!==!0&&!t(this).hasClass("ui-state-disabled")?("string"==typeof a?o[a]:a).apply(o,arguments):void 0}"string"!=typeof a&&(r.guid=a.guid=a.guid||r.guid||t.guid++);var h=s.match(/^([\w:-]*)\s*(.*)$/),l=h[1]+o.eventNamespace,c=h[2];c?n.on(l,c,r):i.on(l,r)})},_off:function(e,i){i=(i||"").split(" ").join(this.eventNamespace+" ")+this.eventNamespace,e.off(i).off(i),this.bindings=t(this.bindings.not(e).get()),this.focusable=t(this.focusable.not(e).get()),this.hoverable=t(this.hoverable.not(e).get())},_delay:function(t,e){function i(){return("string"==typeof t?s[t]:t).apply(s,arguments)}var s=this;return setTimeout(i,e||0)},_hoverable:function(e){this.hoverable=this.hoverable.add(e),this._on(e,{mouseenter:function(e){this._addClass(t(e.currentTarget),null,"ui-state-hover")},mouseleave:function(e){this._removeClass(t(e.currentTarget),null,"ui-state-hover")}})},_focusable:function(e){this.focusable=this.focusable.add(e),this._on(e,{focusin:function(e){this._addClass(t(e.currentTarget),null,"ui-state-focus")},focusout:function(e){this._removeClass(t(e.currentTarget),null,"ui-state-focus")}})},_trigger:function(e,i,s){var n,o,a=this.options[e];if(s=s||{},i=t.Event(i),i.type=(e===this.widgetEventPrefix?e:this.widgetEventPrefix+e).toLowerCase(),i.target=this.element[0],o=i.originalEvent)for(n in o)n in i||(i[n]=o[n]);return this.element.trigger(i,s),!(t.isFunction(a)&&a.apply(this.element[0],[i].concat(s))===!1||i.isDefaultPrevented())}},t.each({show:"fadeIn",hide:"fadeOut"},function(e,i){t.Widget.prototype["_"+e]=function(s,n,o){"string"==typeof n&&(n={effect:n});var a,r=n?n===!0||"number"==typeof n?i:n.effect||i:e;n=n||{},"number"==typeof n&&(n={duration:n}),a=!t.isEmptyObject(n),n.complete=o,n.delay&&s.delay(n.delay),a&&t.effects&&t.effects.effect[r]?s[e](n):r!==e&&s[r]?s[r](n.duration,n.easing,o):s.queue(function(i){t(this)[e](),o&&o.call(s[0]),i()})}}),t.widget,function(){function e(t,e,i){return[parseFloat(t[0])*(u.test(t[0])?e/100:1),parseFloat(t[1])*(u.test(t[1])?i/100:1)]}function i(e,i){return parseInt(t.css(e,i),10)||0}function s(e){var i=e[0];return 9===i.nodeType?{width:e.width(),height:e.height(),offset:{top:0,left:0}}:t.isWindow(i)?{width:e.width(),height:e.height(),offset:{top:e.scrollTop(),left:e.scrollLeft()}}:i.preventDefault?{width:0,height:0,offset:{top:i.pageY,left:i.pageX}}:{width:e.outerWidth(),height:e.outerHeight(),offset:e.offset()}}var n,o=Math.max,a=Math.abs,r=/left|center|right/,h=/top|center|bottom/,l=/[\+\-]\d+(\.[\d]+)?%?/,c=/^\w+/,u=/%$/,d=t.fn.position;t.position={scrollbarWidth:function(){if(void 0!==n)return n;var e,i,s=t("
"),o=s.children()[0];return t("body").append(s),e=o.offsetWidth,s.css("overflow","scroll"),i=o.offsetWidth,e===i&&(i=s[0].clientWidth),s.remove(),n=e-i},getScrollInfo:function(e){var i=e.isWindow||e.isDocument?"":e.element.css("overflow-x"),s=e.isWindow||e.isDocument?"":e.element.css("overflow-y"),n="scroll"===i||"auto"===i&&e.widthi?"left":e>0?"right":"center",vertical:0>r?"top":s>0?"bottom":"middle"};l>p&&p>a(e+i)&&(u.horizontal="center"),c>f&&f>a(s+r)&&(u.vertical="middle"),u.important=o(a(e),a(i))>o(a(s),a(r))?"horizontal":"vertical",n.using.call(this,t,u)}),h.offset(t.extend(D,{using:r}))})},t.ui.position={fit:{left:function(t,e){var i,s=e.within,n=s.isWindow?s.scrollLeft:s.offset.left,a=s.width,r=t.left-e.collisionPosition.marginLeft,h=n-r,l=r+e.collisionWidth-a-n;e.collisionWidth>a?h>0&&0>=l?(i=t.left+h+e.collisionWidth-a-n,t.left+=h-i):t.left=l>0&&0>=h?n:h>l?n+a-e.collisionWidth:n:h>0?t.left+=h:l>0?t.left-=l:t.left=o(t.left-r,t.left)},top:function(t,e){var i,s=e.within,n=s.isWindow?s.scrollTop:s.offset.top,a=e.within.height,r=t.top-e.collisionPosition.marginTop,h=n-r,l=r+e.collisionHeight-a-n;e.collisionHeight>a?h>0&&0>=l?(i=t.top+h+e.collisionHeight-a-n,t.top+=h-i):t.top=l>0&&0>=h?n:h>l?n+a-e.collisionHeight:n:h>0?t.top+=h:l>0?t.top-=l:t.top=o(t.top-r,t.top)}},flip:{left:function(t,e){var i,s,n=e.within,o=n.offset.left+n.scrollLeft,r=n.width,h=n.isWindow?n.scrollLeft:n.offset.left,l=t.left-e.collisionPosition.marginLeft,c=l-h,u=l+e.collisionWidth-r-h,d="left"===e.my[0]?-e.elemWidth:"right"===e.my[0]?e.elemWidth:0,p="left"===e.at[0]?e.targetWidth:"right"===e.at[0]?-e.targetWidth:0,f=-2*e.offset[0];0>c?(i=t.left+d+p+f+e.collisionWidth-r-o,(0>i||a(c)>i)&&(t.left+=d+p+f)):u>0&&(s=t.left-e.collisionPosition.marginLeft+d+p+f-h,(s>0||u>a(s))&&(t.left+=d+p+f))},top:function(t,e){var i,s,n=e.within,o=n.offset.top+n.scrollTop,r=n.height,h=n.isWindow?n.scrollTop:n.offset.top,l=t.top-e.collisionPosition.marginTop,c=l-h,u=l+e.collisionHeight-r-h,d="top"===e.my[1],p=d?-e.elemHeight:"bottom"===e.my[1]?e.elemHeight:0,f="top"===e.at[1]?e.targetHeight:"bottom"===e.at[1]?-e.targetHeight:0,g=-2*e.offset[1];0>c?(s=t.top+p+f+g+e.collisionHeight-r-o,(0>s||a(c)>s)&&(t.top+=p+f+g)):u>0&&(i=t.top-e.collisionPosition.marginTop+p+f+g-h,(i>0||u>a(i))&&(t.top+=p+f+g))}},flipfit:{left:function(){t.ui.position.flip.left.apply(this,arguments),t.ui.position.fit.left.apply(this,arguments)},top:function(){t.ui.position.flip.top.apply(this,arguments),t.ui.position.fit.top.apply(this,arguments)}}}}(),t.ui.position,t.extend(t.expr[":"],{data:t.expr.createPseudo?t.expr.createPseudo(function(e){return function(i){return!!t.data(i,e)}}):function(e,i,s){return!!t.data(e,s[3])}}),t.fn.extend({disableSelection:function(){var t="onselectstart"in document.createElement("div")?"selectstart":"mousedown";return function(){return this.on(t+".ui-disableSelection",function(t){t.preventDefault()})}}(),enableSelection:function(){return this.off(".ui-disableSelection")}}),t.ui.focusable=function(i,s){var n,o,a,r,h,l=i.nodeName.toLowerCase();return"area"===l?(n=i.parentNode,o=n.name,i.href&&o&&"map"===n.nodeName.toLowerCase()?(a=t("img[usemap='#"+o+"']"),a.length>0&&a.is(":visible")):!1):(/^(input|select|textarea|button|object)$/.test(l)?(r=!i.disabled,r&&(h=t(i).closest("fieldset")[0],h&&(r=!h.disabled))):r="a"===l?i.href||s:s,r&&t(i).is(":visible")&&e(t(i)))},t.extend(t.expr[":"],{focusable:function(e){return t.ui.focusable(e,null!=t.attr(e,"tabindex"))}}),t.ui.focusable,t.fn.form=function(){return"string"==typeof this[0].form?this.closest("form"):t(this[0].form)},t.ui.formResetMixin={_formResetHandler:function(){var e=t(this);setTimeout(function(){var i=e.data("ui-form-reset-instances");t.each(i,function(){this.refresh()})})},_bindFormResetHandler:function(){if(this.form=this.element.form(),this.form.length){var t=this.form.data("ui-form-reset-instances")||[];t.length||this.form.on("reset.ui-form-reset",this._formResetHandler),t.push(this),this.form.data("ui-form-reset-instances",t)}},_unbindFormResetHandler:function(){if(this.form.length){var e=this.form.data("ui-form-reset-instances");e.splice(t.inArray(this,e),1),e.length?this.form.data("ui-form-reset-instances",e):this.form.removeData("ui-form-reset-instances").off("reset.ui-form-reset")}}},"1.7"===t.fn.jquery.substring(0,3)&&(t.each(["Width","Height"],function(e,i){function s(e,i,s,o){return t.each(n,function(){i-=parseFloat(t.css(e,"padding"+this))||0,s&&(i-=parseFloat(t.css(e,"border"+this+"Width"))||0),o&&(i-=parseFloat(t.css(e,"margin"+this))||0)}),i}var n="Width"===i?["Left","Right"]:["Top","Bottom"],o=i.toLowerCase(),a={innerWidth:t.fn.innerWidth,innerHeight:t.fn.innerHeight,outerWidth:t.fn.outerWidth,outerHeight:t.fn.outerHeight};t.fn["inner"+i]=function(e){return void 0===e?a["inner"+i].call(this):this.each(function(){t(this).css(o,s(this,e)+"px")})},t.fn["outer"+i]=function(e,n){return"number"!=typeof e?a["outer"+i].call(this,e):this.each(function(){t(this).css(o,s(this,e,!0,n)+"px")})}}),t.fn.addBack=function(t){return this.add(null==t?this.prevObject:this.prevObject.filter(t))}),t.ui.keyCode={BACKSPACE:8,COMMA:188,DELETE:46,DOWN:40,END:35,ENTER:13,ESCAPE:27,HOME:36,LEFT:37,PAGE_DOWN:34,PAGE_UP:33,PERIOD:190,RIGHT:39,SPACE:32,TAB:9,UP:38},t.ui.escapeSelector=function(){var t=/([!"#$%&'()*+,./:;<=>?@[\]^`{|}~])/g;return function(e){return e.replace(t,"\\$1")}}(),t.fn.labels=function(){var e,i,s,n,o;return this[0].labels&&this[0].labels.length?this.pushStack(this[0].labels):(n=this.eq(0).parents("label"),s=this.attr("id"),s&&(e=this.eq(0).parents().last(),o=e.add(e.length?e.siblings():this.siblings()),i="label[for='"+t.ui.escapeSelector(s)+"']",n=n.add(o.find(i).addBack(i))),this.pushStack(n))},t.fn.scrollParent=function(e){var i=this.css("position"),s="absolute"===i,n=e?/(auto|scroll|hidden)/:/(auto|scroll)/,o=this.parents().filter(function(){var e=t(this);return s&&"static"===e.css("position")?!1:n.test(e.css("overflow")+e.css("overflow-y")+e.css("overflow-x"))}).eq(0);return"fixed"!==i&&o.length?o:t(this[0].ownerDocument||document)},t.extend(t.expr[":"],{tabbable:function(e){var i=t.attr(e,"tabindex"),s=null!=i;return(!s||i>=0)&&t.ui.focusable(e,s)}}),t.fn.extend({uniqueId:function(){var t=0;return function(){return this.each(function(){this.id||(this.id="ui-id-"+ ++t)})}}(),removeUniqueId:function(){return this.each(function(){/^ui-id-\d+$/.test(this.id)&&t(this).removeAttr("id")})}}),t.ui.ie=!!/msie [\w.]+/.exec(navigator.userAgent.toLowerCase());var c=!1;t(document).on("mouseup",function(){c=!1}),t.widget("ui.mouse",{version:"1.12.1",options:{cancel:"input, textarea, button, select, option",distance:1,delay:0},_mouseInit:function(){var e=this;this.element.on("mousedown."+this.widgetName,function(t){return e._mouseDown(t)}).on("click."+this.widgetName,function(i){return!0===t.data(i.target,e.widgetName+".preventClickEvent")?(t.removeData(i.target,e.widgetName+".preventClickEvent"),i.stopImmediatePropagation(),!1):void 0}),this.started=!1},_mouseDestroy:function(){this.element.off("."+this.widgetName),this._mouseMoveDelegate&&this.document.off("mousemove."+this.widgetName,this._mouseMoveDelegate).off("mouseup."+this.widgetName,this._mouseUpDelegate)},_mouseDown:function(e){if(!c){this._mouseMoved=!1,this._mouseStarted&&this._mouseUp(e),this._mouseDownEvent=e;var i=this,s=1===e.which,n="string"==typeof this.options.cancel&&e.target.nodeName?t(e.target).closest(this.options.cancel).length:!1;return s&&!n&&this._mouseCapture(e)?(this.mouseDelayMet=!this.options.delay,this.mouseDelayMet||(this._mouseDelayTimer=setTimeout(function(){i.mouseDelayMet=!0},this.options.delay)),this._mouseDistanceMet(e)&&this._mouseDelayMet(e)&&(this._mouseStarted=this._mouseStart(e)!==!1,!this._mouseStarted)?(e.preventDefault(),!0):(!0===t.data(e.target,this.widgetName+".preventClickEvent")&&t.removeData(e.target,this.widgetName+".preventClickEvent"),this._mouseMoveDelegate=function(t){return i._mouseMove(t)},this._mouseUpDelegate=function(t){return i._mouseUp(t)},this.document.on("mousemove."+this.widgetName,this._mouseMoveDelegate).on("mouseup."+this.widgetName,this._mouseUpDelegate),e.preventDefault(),c=!0,!0)):!0}},_mouseMove:function(e){if(this._mouseMoved){if(t.ui.ie&&(!document.documentMode||9>document.documentMode)&&!e.button)return this._mouseUp(e);if(!e.which)if(e.originalEvent.altKey||e.originalEvent.ctrlKey||e.originalEvent.metaKey||e.originalEvent.shiftKey)this.ignoreMissingWhich=!0;else if(!this.ignoreMissingWhich)return this._mouseUp(e)}return(e.which||e.button)&&(this._mouseMoved=!0),this._mouseStarted?(this._mouseDrag(e),e.preventDefault()):(this._mouseDistanceMet(e)&&this._mouseDelayMet(e)&&(this._mouseStarted=this._mouseStart(this._mouseDownEvent,e)!==!1,this._mouseStarted?this._mouseDrag(e):this._mouseUp(e)),!this._mouseStarted)},_mouseUp:function(e){this.document.off("mousemove."+this.widgetName,this._mouseMoveDelegate).off("mouseup."+this.widgetName,this._mouseUpDelegate),this._mouseStarted&&(this._mouseStarted=!1,e.target===this._mouseDownEvent.target&&t.data(e.target,this.widgetName+".preventClickEvent",!0),this._mouseStop(e)),this._mouseDelayTimer&&(clearTimeout(this._mouseDelayTimer),delete this._mouseDelayTimer),this.ignoreMissingWhich=!1,c=!1,e.preventDefault()},_mouseDistanceMet:function(t){return Math.max(Math.abs(this._mouseDownEvent.pageX-t.pageX),Math.abs(this._mouseDownEvent.pageY-t.pageY))>=this.options.distance},_mouseDelayMet:function(){return this.mouseDelayMet},_mouseStart:function(){},_mouseDrag:function(){},_mouseStop:function(){},_mouseCapture:function(){return!0}}),t.ui.plugin={add:function(e,i,s){var n,o=t.ui[e].prototype;for(n in s)o.plugins[n]=o.plugins[n]||[],o.plugins[n].push([i,s[n]])},call:function(t,e,i,s){var n,o=t.plugins[e];if(o&&(s||t.element[0].parentNode&&11!==t.element[0].parentNode.nodeType))for(n=0;o.length>n;n++)t.options[o[n][0]]&&o[n][1].apply(t.element,i)}},t.ui.safeActiveElement=function(t){var e;try{e=t.activeElement}catch(i){e=t.body}return e||(e=t.body),e.nodeName||(e=t.body),e},t.ui.safeBlur=function(e){e&&"body"!==e.nodeName.toLowerCase()&&t(e).trigger("blur")},t.widget("ui.draggable",t.ui.mouse,{version:"1.12.1",widgetEventPrefix:"drag",options:{addClasses:!0,appendTo:"parent",axis:!1,connectToSortable:!1,containment:!1,cursor:"auto",cursorAt:!1,grid:!1,handle:!1,helper:"original",iframeFix:!1,opacity:!1,refreshPositions:!1,revert:!1,revertDuration:500,scope:"default",scroll:!0,scrollSensitivity:20,scrollSpeed:20,snap:!1,snapMode:"both",snapTolerance:20,stack:!1,zIndex:!1,drag:null,start:null,stop:null},_create:function(){"original"===this.options.helper&&this._setPositionRelative(),this.options.addClasses&&this._addClass("ui-draggable"),this._setHandleClassName(),this._mouseInit()},_setOption:function(t,e){this._super(t,e),"handle"===t&&(this._removeHandleClassName(),this._setHandleClassName())},_destroy:function(){return(this.helper||this.element).is(".ui-draggable-dragging")?(this.destroyOnClear=!0,void 0):(this._removeHandleClassName(),this._mouseDestroy(),void 0)},_mouseCapture:function(e){var i=this.options;return this.helper||i.disabled||t(e.target).closest(".ui-resizable-handle").length>0?!1:(this.handle=this._getHandle(e),this.handle?(this._blurActiveElement(e),this._blockFrames(i.iframeFix===!0?"iframe":i.iframeFix),!0):!1)},_blockFrames:function(e){this.iframeBlocks=this.document.find(e).map(function(){var e=t(this);return t("
").css("position","absolute").appendTo(e.parent()).outerWidth(e.outerWidth()).outerHeight(e.outerHeight()).offset(e.offset())[0]})},_unblockFrames:function(){this.iframeBlocks&&(this.iframeBlocks.remove(),delete this.iframeBlocks)},_blurActiveElement:function(e){var i=t.ui.safeActiveElement(this.document[0]),s=t(e.target);s.closest(i).length||t.ui.safeBlur(i)},_mouseStart:function(e){var i=this.options;return this.helper=this._createHelper(e),this._addClass(this.helper,"ui-draggable-dragging"),this._cacheHelperProportions(),t.ui.ddmanager&&(t.ui.ddmanager.current=this),this._cacheMargins(),this.cssPosition=this.helper.css("position"),this.scrollParent=this.helper.scrollParent(!0),this.offsetParent=this.helper.offsetParent(),this.hasFixedAncestor=this.helper.parents().filter(function(){return"fixed"===t(this).css("position")}).length>0,this.positionAbs=this.element.offset(),this._refreshOffsets(e),this.originalPosition=this.position=this._generatePosition(e,!1),this.originalPageX=e.pageX,this.originalPageY=e.pageY,i.cursorAt&&this._adjustOffsetFromHelper(i.cursorAt),this._setContainment(),this._trigger("start",e)===!1?(this._clear(),!1):(this._cacheHelperProportions(),t.ui.ddmanager&&!i.dropBehaviour&&t.ui.ddmanager.prepareOffsets(this,e),this._mouseDrag(e,!0),t.ui.ddmanager&&t.ui.ddmanager.dragStart(this,e),!0)},_refreshOffsets:function(t){this.offset={top:this.positionAbs.top-this.margins.top,left:this.positionAbs.left-this.margins.left,scroll:!1,parent:this._getParentOffset(),relative:this._getRelativeOffset()},this.offset.click={left:t.pageX-this.offset.left,top:t.pageY-this.offset.top}},_mouseDrag:function(e,i){if(this.hasFixedAncestor&&(this.offset.parent=this._getParentOffset()),this.position=this._generatePosition(e,!0),this.positionAbs=this._convertPositionTo("absolute"),!i){var s=this._uiHash();if(this._trigger("drag",e,s)===!1)return this._mouseUp(new t.Event("mouseup",e)),!1;this.position=s.position}return this.helper[0].style.left=this.position.left+"px",this.helper[0].style.top=this.position.top+"px",t.ui.ddmanager&&t.ui.ddmanager.drag(this,e),!1},_mouseStop:function(e){var i=this,s=!1;return t.ui.ddmanager&&!this.options.dropBehaviour&&(s=t.ui.ddmanager.drop(this,e)),this.dropped&&(s=this.dropped,this.dropped=!1),"invalid"===this.options.revert&&!s||"valid"===this.options.revert&&s||this.options.revert===!0||t.isFunction(this.options.revert)&&this.options.revert.call(this.element,s)?t(this.helper).animate(this.originalPosition,parseInt(this.options.revertDuration,10),function(){i._trigger("stop",e)!==!1&&i._clear()}):this._trigger("stop",e)!==!1&&this._clear(),!1},_mouseUp:function(e){return this._unblockFrames(),t.ui.ddmanager&&t.ui.ddmanager.dragStop(this,e),this.handleElement.is(e.target)&&this.element.trigger("focus"),t.ui.mouse.prototype._mouseUp.call(this,e)},cancel:function(){return this.helper.is(".ui-draggable-dragging")?this._mouseUp(new t.Event("mouseup",{target:this.element[0]})):this._clear(),this},_getHandle:function(e){return this.options.handle?!!t(e.target).closest(this.element.find(this.options.handle)).length:!0},_setHandleClassName:function(){this.handleElement=this.options.handle?this.element.find(this.options.handle):this.element,this._addClass(this.handleElement,"ui-draggable-handle")},_removeHandleClassName:function(){this._removeClass(this.handleElement,"ui-draggable-handle")},_createHelper:function(e){var i=this.options,s=t.isFunction(i.helper),n=s?t(i.helper.apply(this.element[0],[e])):"clone"===i.helper?this.element.clone().removeAttr("id"):this.element;return n.parents("body").length||n.appendTo("parent"===i.appendTo?this.element[0].parentNode:i.appendTo),s&&n[0]===this.element[0]&&this._setPositionRelative(),n[0]===this.element[0]||/(fixed|absolute)/.test(n.css("position"))||n.css("position","absolute"),n},_setPositionRelative:function(){/^(?:r|a|f)/.test(this.element.css("position"))||(this.element[0].style.position="relative")},_adjustOffsetFromHelper:function(e){"string"==typeof e&&(e=e.split(" ")),t.isArray(e)&&(e={left:+e[0],top:+e[1]||0}),"left"in e&&(this.offset.click.left=e.left+this.margins.left),"right"in e&&(this.offset.click.left=this.helperProportions.width-e.right+this.margins.left),"top"in e&&(this.offset.click.top=e.top+this.margins.top),"bottom"in e&&(this.offset.click.top=this.helperProportions.height-e.bottom+this.margins.top)},_isRootNode:function(t){return/(html|body)/i.test(t.tagName)||t===this.document[0]},_getParentOffset:function(){var e=this.offsetParent.offset(),i=this.document[0];return"absolute"===this.cssPosition&&this.scrollParent[0]!==i&&t.contains(this.scrollParent[0],this.offsetParent[0])&&(e.left+=this.scrollParent.scrollLeft(),e.top+=this.scrollParent.scrollTop()),this._isRootNode(this.offsetParent[0])&&(e={top:0,left:0}),{top:e.top+(parseInt(this.offsetParent.css("borderTopWidth"),10)||0),left:e.left+(parseInt(this.offsetParent.css("borderLeftWidth"),10)||0)}},_getRelativeOffset:function(){if("relative"!==this.cssPosition)return{top:0,left:0};var t=this.element.position(),e=this._isRootNode(this.scrollParent[0]);return{top:t.top-(parseInt(this.helper.css("top"),10)||0)+(e?0:this.scrollParent.scrollTop()),left:t.left-(parseInt(this.helper.css("left"),10)||0)+(e?0:this.scrollParent.scrollLeft())}},_cacheMargins:function(){this.margins={left:parseInt(this.element.css("marginLeft"),10)||0,top:parseInt(this.element.css("marginTop"),10)||0,right:parseInt(this.element.css("marginRight"),10)||0,bottom:parseInt(this.element.css("marginBottom"),10)||0}},_cacheHelperProportions:function(){this.helperProportions={width:this.helper.outerWidth(),height:this.helper.outerHeight()}},_setContainment:function(){var e,i,s,n=this.options,o=this.document[0];return this.relativeContainer=null,n.containment?"window"===n.containment?(this.containment=[t(window).scrollLeft()-this.offset.relative.left-this.offset.parent.left,t(window).scrollTop()-this.offset.relative.top-this.offset.parent.top,t(window).scrollLeft()+t(window).width()-this.helperProportions.width-this.margins.left,t(window).scrollTop()+(t(window).height()||o.body.parentNode.scrollHeight)-this.helperProportions.height-this.margins.top],void 0):"document"===n.containment?(this.containment=[0,0,t(o).width()-this.helperProportions.width-this.margins.left,(t(o).height()||o.body.parentNode.scrollHeight)-this.helperProportions.height-this.margins.top],void 0):n.containment.constructor===Array?(this.containment=n.containment,void 0):("parent"===n.containment&&(n.containment=this.helper[0].parentNode),i=t(n.containment),s=i[0],s&&(e=/(scroll|auto)/.test(i.css("overflow")),this.containment=[(parseInt(i.css("borderLeftWidth"),10)||0)+(parseInt(i.css("paddingLeft"),10)||0),(parseInt(i.css("borderTopWidth"),10)||0)+(parseInt(i.css("paddingTop"),10)||0),(e?Math.max(s.scrollWidth,s.offsetWidth):s.offsetWidth)-(parseInt(i.css("borderRightWidth"),10)||0)-(parseInt(i.css("paddingRight"),10)||0)-this.helperProportions.width-this.margins.left-this.margins.right,(e?Math.max(s.scrollHeight,s.offsetHeight):s.offsetHeight)-(parseInt(i.css("borderBottomWidth"),10)||0)-(parseInt(i.css("paddingBottom"),10)||0)-this.helperProportions.height-this.margins.top-this.margins.bottom],this.relativeContainer=i),void 0):(this.containment=null,void 0) +},_convertPositionTo:function(t,e){e||(e=this.position);var i="absolute"===t?1:-1,s=this._isRootNode(this.scrollParent[0]);return{top:e.top+this.offset.relative.top*i+this.offset.parent.top*i-("fixed"===this.cssPosition?-this.offset.scroll.top:s?0:this.offset.scroll.top)*i,left:e.left+this.offset.relative.left*i+this.offset.parent.left*i-("fixed"===this.cssPosition?-this.offset.scroll.left:s?0:this.offset.scroll.left)*i}},_generatePosition:function(t,e){var i,s,n,o,a=this.options,r=this._isRootNode(this.scrollParent[0]),h=t.pageX,l=t.pageY;return r&&this.offset.scroll||(this.offset.scroll={top:this.scrollParent.scrollTop(),left:this.scrollParent.scrollLeft()}),e&&(this.containment&&(this.relativeContainer?(s=this.relativeContainer.offset(),i=[this.containment[0]+s.left,this.containment[1]+s.top,this.containment[2]+s.left,this.containment[3]+s.top]):i=this.containment,t.pageX-this.offset.click.lefti[2]&&(h=i[2]+this.offset.click.left),t.pageY-this.offset.click.top>i[3]&&(l=i[3]+this.offset.click.top)),a.grid&&(n=a.grid[1]?this.originalPageY+Math.round((l-this.originalPageY)/a.grid[1])*a.grid[1]:this.originalPageY,l=i?n-this.offset.click.top>=i[1]||n-this.offset.click.top>i[3]?n:n-this.offset.click.top>=i[1]?n-a.grid[1]:n+a.grid[1]:n,o=a.grid[0]?this.originalPageX+Math.round((h-this.originalPageX)/a.grid[0])*a.grid[0]:this.originalPageX,h=i?o-this.offset.click.left>=i[0]||o-this.offset.click.left>i[2]?o:o-this.offset.click.left>=i[0]?o-a.grid[0]:o+a.grid[0]:o),"y"===a.axis&&(h=this.originalPageX),"x"===a.axis&&(l=this.originalPageY)),{top:l-this.offset.click.top-this.offset.relative.top-this.offset.parent.top+("fixed"===this.cssPosition?-this.offset.scroll.top:r?0:this.offset.scroll.top),left:h-this.offset.click.left-this.offset.relative.left-this.offset.parent.left+("fixed"===this.cssPosition?-this.offset.scroll.left:r?0:this.offset.scroll.left)}},_clear:function(){this._removeClass(this.helper,"ui-draggable-dragging"),this.helper[0]===this.element[0]||this.cancelHelperRemoval||this.helper.remove(),this.helper=null,this.cancelHelperRemoval=!1,this.destroyOnClear&&this.destroy()},_trigger:function(e,i,s){return s=s||this._uiHash(),t.ui.plugin.call(this,e,[i,s,this],!0),/^(drag|start|stop)/.test(e)&&(this.positionAbs=this._convertPositionTo("absolute"),s.offset=this.positionAbs),t.Widget.prototype._trigger.call(this,e,i,s)},plugins:{},_uiHash:function(){return{helper:this.helper,position:this.position,originalPosition:this.originalPosition,offset:this.positionAbs}}}),t.ui.plugin.add("draggable","connectToSortable",{start:function(e,i,s){var n=t.extend({},i,{item:s.element});s.sortables=[],t(s.options.connectToSortable).each(function(){var i=t(this).sortable("instance");i&&!i.options.disabled&&(s.sortables.push(i),i.refreshPositions(),i._trigger("activate",e,n))})},stop:function(e,i,s){var n=t.extend({},i,{item:s.element});s.cancelHelperRemoval=!1,t.each(s.sortables,function(){var t=this;t.isOver?(t.isOver=0,s.cancelHelperRemoval=!0,t.cancelHelperRemoval=!1,t._storedCSS={position:t.placeholder.css("position"),top:t.placeholder.css("top"),left:t.placeholder.css("left")},t._mouseStop(e),t.options.helper=t.options._helper):(t.cancelHelperRemoval=!0,t._trigger("deactivate",e,n))})},drag:function(e,i,s){t.each(s.sortables,function(){var n=!1,o=this;o.positionAbs=s.positionAbs,o.helperProportions=s.helperProportions,o.offset.click=s.offset.click,o._intersectsWith(o.containerCache)&&(n=!0,t.each(s.sortables,function(){return this.positionAbs=s.positionAbs,this.helperProportions=s.helperProportions,this.offset.click=s.offset.click,this!==o&&this._intersectsWith(this.containerCache)&&t.contains(o.element[0],this.element[0])&&(n=!1),n})),n?(o.isOver||(o.isOver=1,s._parent=i.helper.parent(),o.currentItem=i.helper.appendTo(o.element).data("ui-sortable-item",!0),o.options._helper=o.options.helper,o.options.helper=function(){return i.helper[0]},e.target=o.currentItem[0],o._mouseCapture(e,!0),o._mouseStart(e,!0,!0),o.offset.click.top=s.offset.click.top,o.offset.click.left=s.offset.click.left,o.offset.parent.left-=s.offset.parent.left-o.offset.parent.left,o.offset.parent.top-=s.offset.parent.top-o.offset.parent.top,s._trigger("toSortable",e),s.dropped=o.element,t.each(s.sortables,function(){this.refreshPositions()}),s.currentItem=s.element,o.fromOutside=s),o.currentItem&&(o._mouseDrag(e),i.position=o.position)):o.isOver&&(o.isOver=0,o.cancelHelperRemoval=!0,o.options._revert=o.options.revert,o.options.revert=!1,o._trigger("out",e,o._uiHash(o)),o._mouseStop(e,!0),o.options.revert=o.options._revert,o.options.helper=o.options._helper,o.placeholder&&o.placeholder.remove(),i.helper.appendTo(s._parent),s._refreshOffsets(e),i.position=s._generatePosition(e,!0),s._trigger("fromSortable",e),s.dropped=!1,t.each(s.sortables,function(){this.refreshPositions()}))})}}),t.ui.plugin.add("draggable","cursor",{start:function(e,i,s){var n=t("body"),o=s.options;n.css("cursor")&&(o._cursor=n.css("cursor")),n.css("cursor",o.cursor)},stop:function(e,i,s){var n=s.options;n._cursor&&t("body").css("cursor",n._cursor)}}),t.ui.plugin.add("draggable","opacity",{start:function(e,i,s){var n=t(i.helper),o=s.options;n.css("opacity")&&(o._opacity=n.css("opacity")),n.css("opacity",o.opacity)},stop:function(e,i,s){var n=s.options;n._opacity&&t(i.helper).css("opacity",n._opacity)}}),t.ui.plugin.add("draggable","scroll",{start:function(t,e,i){i.scrollParentNotHidden||(i.scrollParentNotHidden=i.helper.scrollParent(!1)),i.scrollParentNotHidden[0]!==i.document[0]&&"HTML"!==i.scrollParentNotHidden[0].tagName&&(i.overflowOffset=i.scrollParentNotHidden.offset())},drag:function(e,i,s){var n=s.options,o=!1,a=s.scrollParentNotHidden[0],r=s.document[0];a!==r&&"HTML"!==a.tagName?(n.axis&&"x"===n.axis||(s.overflowOffset.top+a.offsetHeight-e.pageY=0;d--)h=s.snapElements[d].left-s.margins.left,l=h+s.snapElements[d].width,c=s.snapElements[d].top-s.margins.top,u=c+s.snapElements[d].height,h-g>_||m>l+g||c-g>b||v>u+g||!t.contains(s.snapElements[d].item.ownerDocument,s.snapElements[d].item)?(s.snapElements[d].snapping&&s.options.snap.release&&s.options.snap.release.call(s.element,e,t.extend(s._uiHash(),{snapItem:s.snapElements[d].item})),s.snapElements[d].snapping=!1):("inner"!==f.snapMode&&(n=g>=Math.abs(c-b),o=g>=Math.abs(u-v),a=g>=Math.abs(h-_),r=g>=Math.abs(l-m),n&&(i.position.top=s._convertPositionTo("relative",{top:c-s.helperProportions.height,left:0}).top),o&&(i.position.top=s._convertPositionTo("relative",{top:u,left:0}).top),a&&(i.position.left=s._convertPositionTo("relative",{top:0,left:h-s.helperProportions.width}).left),r&&(i.position.left=s._convertPositionTo("relative",{top:0,left:l}).left)),p=n||o||a||r,"outer"!==f.snapMode&&(n=g>=Math.abs(c-v),o=g>=Math.abs(u-b),a=g>=Math.abs(h-m),r=g>=Math.abs(l-_),n&&(i.position.top=s._convertPositionTo("relative",{top:c,left:0}).top),o&&(i.position.top=s._convertPositionTo("relative",{top:u-s.helperProportions.height,left:0}).top),a&&(i.position.left=s._convertPositionTo("relative",{top:0,left:h}).left),r&&(i.position.left=s._convertPositionTo("relative",{top:0,left:l-s.helperProportions.width}).left)),!s.snapElements[d].snapping&&(n||o||a||r||p)&&s.options.snap.snap&&s.options.snap.snap.call(s.element,e,t.extend(s._uiHash(),{snapItem:s.snapElements[d].item})),s.snapElements[d].snapping=n||o||a||r||p)}}),t.ui.plugin.add("draggable","stack",{start:function(e,i,s){var n,o=s.options,a=t.makeArray(t(o.stack)).sort(function(e,i){return(parseInt(t(e).css("zIndex"),10)||0)-(parseInt(t(i).css("zIndex"),10)||0)});a.length&&(n=parseInt(t(a[0]).css("zIndex"),10)||0,t(a).each(function(e){t(this).css("zIndex",n+e)}),this.css("zIndex",n+a.length))}}),t.ui.plugin.add("draggable","zIndex",{start:function(e,i,s){var n=t(i.helper),o=s.options;n.css("zIndex")&&(o._zIndex=n.css("zIndex")),n.css("zIndex",o.zIndex)},stop:function(e,i,s){var n=s.options;n._zIndex&&t(i.helper).css("zIndex",n._zIndex)}}),t.ui.draggable,t.widget("ui.droppable",{version:"1.12.1",widgetEventPrefix:"drop",options:{accept:"*",addClasses:!0,greedy:!1,scope:"default",tolerance:"intersect",activate:null,deactivate:null,drop:null,out:null,over:null},_create:function(){var e,i=this.options,s=i.accept;this.isover=!1,this.isout=!0,this.accept=t.isFunction(s)?s:function(t){return t.is(s)},this.proportions=function(){return arguments.length?(e=arguments[0],void 0):e?e:e={width:this.element[0].offsetWidth,height:this.element[0].offsetHeight}},this._addToManager(i.scope),i.addClasses&&this._addClass("ui-droppable")},_addToManager:function(e){t.ui.ddmanager.droppables[e]=t.ui.ddmanager.droppables[e]||[],t.ui.ddmanager.droppables[e].push(this)},_splice:function(t){for(var e=0;t.length>e;e++)t[e]===this&&t.splice(e,1)},_destroy:function(){var e=t.ui.ddmanager.droppables[this.options.scope];this._splice(e)},_setOption:function(e,i){if("accept"===e)this.accept=t.isFunction(i)?i:function(t){return t.is(i)};else if("scope"===e){var s=t.ui.ddmanager.droppables[this.options.scope];this._splice(s),this._addToManager(i)}this._super(e,i)},_activate:function(e){var i=t.ui.ddmanager.current;this._addActiveClass(),i&&this._trigger("activate",e,this.ui(i))},_deactivate:function(e){var i=t.ui.ddmanager.current;this._removeActiveClass(),i&&this._trigger("deactivate",e,this.ui(i))},_over:function(e){var i=t.ui.ddmanager.current;i&&(i.currentItem||i.element)[0]!==this.element[0]&&this.accept.call(this.element[0],i.currentItem||i.element)&&(this._addHoverClass(),this._trigger("over",e,this.ui(i)))},_out:function(e){var i=t.ui.ddmanager.current;i&&(i.currentItem||i.element)[0]!==this.element[0]&&this.accept.call(this.element[0],i.currentItem||i.element)&&(this._removeHoverClass(),this._trigger("out",e,this.ui(i)))},_drop:function(e,i){var s=i||t.ui.ddmanager.current,n=!1;return s&&(s.currentItem||s.element)[0]!==this.element[0]?(this.element.find(":data(ui-droppable)").not(".ui-draggable-dragging").each(function(){var i=t(this).droppable("instance");return i.options.greedy&&!i.options.disabled&&i.options.scope===s.options.scope&&i.accept.call(i.element[0],s.currentItem||s.element)&&u(s,t.extend(i,{offset:i.element.offset()}),i.options.tolerance,e)?(n=!0,!1):void 0}),n?!1:this.accept.call(this.element[0],s.currentItem||s.element)?(this._removeActiveClass(),this._removeHoverClass(),this._trigger("drop",e,this.ui(s)),this.element):!1):!1},ui:function(t){return{draggable:t.currentItem||t.element,helper:t.helper,position:t.position,offset:t.positionAbs}},_addHoverClass:function(){this._addClass("ui-droppable-hover")},_removeHoverClass:function(){this._removeClass("ui-droppable-hover")},_addActiveClass:function(){this._addClass("ui-droppable-active")},_removeActiveClass:function(){this._removeClass("ui-droppable-active")}});var u=t.ui.intersect=function(){function t(t,e,i){return t>=e&&e+i>t}return function(e,i,s,n){if(!i.offset)return!1;var o=(e.positionAbs||e.position.absolute).left+e.margins.left,a=(e.positionAbs||e.position.absolute).top+e.margins.top,r=o+e.helperProportions.width,h=a+e.helperProportions.height,l=i.offset.left,c=i.offset.top,u=l+i.proportions().width,d=c+i.proportions().height;switch(s){case"fit":return o>=l&&u>=r&&a>=c&&d>=h;case"intersect":return o+e.helperProportions.width/2>l&&u>r-e.helperProportions.width/2&&a+e.helperProportions.height/2>c&&d>h-e.helperProportions.height/2;case"pointer":return t(n.pageY,c,i.proportions().height)&&t(n.pageX,l,i.proportions().width);case"touch":return(a>=c&&d>=a||h>=c&&d>=h||c>a&&h>d)&&(o>=l&&u>=o||r>=l&&u>=r||l>o&&r>u);default:return!1}}}();t.ui.ddmanager={current:null,droppables:{"default":[]},prepareOffsets:function(e,i){var s,n,o=t.ui.ddmanager.droppables[e.options.scope]||[],a=i?i.type:null,r=(e.currentItem||e.element).find(":data(ui-droppable)").addBack();t:for(s=0;o.length>s;s++)if(!(o[s].options.disabled||e&&!o[s].accept.call(o[s].element[0],e.currentItem||e.element))){for(n=0;r.length>n;n++)if(r[n]===o[s].element[0]){o[s].proportions().height=0;continue t}o[s].visible="none"!==o[s].element.css("display"),o[s].visible&&("mousedown"===a&&o[s]._activate.call(o[s],i),o[s].offset=o[s].element.offset(),o[s].proportions({width:o[s].element[0].offsetWidth,height:o[s].element[0].offsetHeight}))}},drop:function(e,i){var s=!1;return t.each((t.ui.ddmanager.droppables[e.options.scope]||[]).slice(),function(){this.options&&(!this.options.disabled&&this.visible&&u(e,this,this.options.tolerance,i)&&(s=this._drop.call(this,i)||s),!this.options.disabled&&this.visible&&this.accept.call(this.element[0],e.currentItem||e.element)&&(this.isout=!0,this.isover=!1,this._deactivate.call(this,i)))}),s},dragStart:function(e,i){e.element.parentsUntil("body").on("scroll.droppable",function(){e.options.refreshPositions||t.ui.ddmanager.prepareOffsets(e,i)})},drag:function(e,i){e.options.refreshPositions&&t.ui.ddmanager.prepareOffsets(e,i),t.each(t.ui.ddmanager.droppables[e.options.scope]||[],function(){if(!this.options.disabled&&!this.greedyChild&&this.visible){var s,n,o,a=u(e,this,this.options.tolerance,i),r=!a&&this.isover?"isout":a&&!this.isover?"isover":null;r&&(this.options.greedy&&(n=this.options.scope,o=this.element.parents(":data(ui-droppable)").filter(function(){return t(this).droppable("instance").options.scope===n}),o.length&&(s=t(o[0]).droppable("instance"),s.greedyChild="isover"===r)),s&&"isover"===r&&(s.isover=!1,s.isout=!0,s._out.call(s,i)),this[r]=!0,this["isout"===r?"isover":"isout"]=!1,this["isover"===r?"_over":"_out"].call(this,i),s&&"isout"===r&&(s.isout=!1,s.isover=!0,s._over.call(s,i)))}})},dragStop:function(e,i){e.element.parentsUntil("body").off("scroll.droppable"),e.options.refreshPositions||t.ui.ddmanager.prepareOffsets(e,i)}},t.uiBackCompat!==!1&&t.widget("ui.droppable",t.ui.droppable,{options:{hoverClass:!1,activeClass:!1},_addActiveClass:function(){this._super(),this.options.activeClass&&this.element.addClass(this.options.activeClass)},_removeActiveClass:function(){this._super(),this.options.activeClass&&this.element.removeClass(this.options.activeClass)},_addHoverClass:function(){this._super(),this.options.hoverClass&&this.element.addClass(this.options.hoverClass)},_removeHoverClass:function(){this._super(),this.options.hoverClass&&this.element.removeClass(this.options.hoverClass)}}),t.ui.droppable,t.widget("ui.resizable",t.ui.mouse,{version:"1.12.1",widgetEventPrefix:"resize",options:{alsoResize:!1,animate:!1,animateDuration:"slow",animateEasing:"swing",aspectRatio:!1,autoHide:!1,classes:{"ui-resizable-se":"ui-icon ui-icon-gripsmall-diagonal-se"},containment:!1,ghost:!1,grid:!1,handles:"e,s,se",helper:!1,maxHeight:null,maxWidth:null,minHeight:10,minWidth:10,zIndex:90,resize:null,start:null,stop:null},_num:function(t){return parseFloat(t)||0},_isNumber:function(t){return!isNaN(parseFloat(t))},_hasScroll:function(e,i){if("hidden"===t(e).css("overflow"))return!1;var s=i&&"left"===i?"scrollLeft":"scrollTop",n=!1;return e[s]>0?!0:(e[s]=1,n=e[s]>0,e[s]=0,n)},_create:function(){var e,i=this.options,s=this;this._addClass("ui-resizable"),t.extend(this,{_aspectRatio:!!i.aspectRatio,aspectRatio:i.aspectRatio,originalElement:this.element,_proportionallyResizeElements:[],_helper:i.helper||i.ghost||i.animate?i.helper||"ui-resizable-helper":null}),this.element[0].nodeName.match(/^(canvas|textarea|input|select|button|img)$/i)&&(this.element.wrap(t("
").css({position:this.element.css("position"),width:this.element.outerWidth(),height:this.element.outerHeight(),top:this.element.css("top"),left:this.element.css("left")})),this.element=this.element.parent().data("ui-resizable",this.element.resizable("instance")),this.elementIsWrapper=!0,e={marginTop:this.originalElement.css("marginTop"),marginRight:this.originalElement.css("marginRight"),marginBottom:this.originalElement.css("marginBottom"),marginLeft:this.originalElement.css("marginLeft")},this.element.css(e),this.originalElement.css("margin",0),this.originalResizeStyle=this.originalElement.css("resize"),this.originalElement.css("resize","none"),this._proportionallyResizeElements.push(this.originalElement.css({position:"static",zoom:1,display:"block"})),this.originalElement.css(e),this._proportionallyResize()),this._setupHandles(),i.autoHide&&t(this.element).on("mouseenter",function(){i.disabled||(s._removeClass("ui-resizable-autohide"),s._handles.show())}).on("mouseleave",function(){i.disabled||s.resizing||(s._addClass("ui-resizable-autohide"),s._handles.hide())}),this._mouseInit()},_destroy:function(){this._mouseDestroy();var e,i=function(e){t(e).removeData("resizable").removeData("ui-resizable").off(".resizable").find(".ui-resizable-handle").remove()};return this.elementIsWrapper&&(i(this.element),e=this.element,this.originalElement.css({position:e.css("position"),width:e.outerWidth(),height:e.outerHeight(),top:e.css("top"),left:e.css("left")}).insertAfter(e),e.remove()),this.originalElement.css("resize",this.originalResizeStyle),i(this.originalElement),this},_setOption:function(t,e){switch(this._super(t,e),t){case"handles":this._removeHandles(),this._setupHandles();break;default:}},_setupHandles:function(){var e,i,s,n,o,a=this.options,r=this;if(this.handles=a.handles||(t(".ui-resizable-handle",this.element).length?{n:".ui-resizable-n",e:".ui-resizable-e",s:".ui-resizable-s",w:".ui-resizable-w",se:".ui-resizable-se",sw:".ui-resizable-sw",ne:".ui-resizable-ne",nw:".ui-resizable-nw"}:"e,s,se"),this._handles=t(),this.handles.constructor===String)for("all"===this.handles&&(this.handles="n,e,s,w,se,sw,ne,nw"),s=this.handles.split(","),this.handles={},i=0;s.length>i;i++)e=t.trim(s[i]),n="ui-resizable-"+e,o=t("
"),this._addClass(o,"ui-resizable-handle "+n),o.css({zIndex:a.zIndex}),this.handles[e]=".ui-resizable-"+e,this.element.append(o);this._renderAxis=function(e){var i,s,n,o;e=e||this.element;for(i in this.handles)this.handles[i].constructor===String?this.handles[i]=this.element.children(this.handles[i]).first().show():(this.handles[i].jquery||this.handles[i].nodeType)&&(this.handles[i]=t(this.handles[i]),this._on(this.handles[i],{mousedown:r._mouseDown})),this.elementIsWrapper&&this.originalElement[0].nodeName.match(/^(textarea|input|select|button)$/i)&&(s=t(this.handles[i],this.element),o=/sw|ne|nw|se|n|s/.test(i)?s.outerHeight():s.outerWidth(),n=["padding",/ne|nw|n/.test(i)?"Top":/se|sw|s/.test(i)?"Bottom":/^e$/.test(i)?"Right":"Left"].join(""),e.css(n,o),this._proportionallyResize()),this._handles=this._handles.add(this.handles[i])},this._renderAxis(this.element),this._handles=this._handles.add(this.element.find(".ui-resizable-handle")),this._handles.disableSelection(),this._handles.on("mouseover",function(){r.resizing||(this.className&&(o=this.className.match(/ui-resizable-(se|sw|ne|nw|n|e|s|w)/i)),r.axis=o&&o[1]?o[1]:"se")}),a.autoHide&&(this._handles.hide(),this._addClass("ui-resizable-autohide"))},_removeHandles:function(){this._handles.remove()},_mouseCapture:function(e){var i,s,n=!1;for(i in this.handles)s=t(this.handles[i])[0],(s===e.target||t.contains(s,e.target))&&(n=!0);return!this.options.disabled&&n},_mouseStart:function(e){var i,s,n,o=this.options,a=this.element;return this.resizing=!0,this._renderProxy(),i=this._num(this.helper.css("left")),s=this._num(this.helper.css("top")),o.containment&&(i+=t(o.containment).scrollLeft()||0,s+=t(o.containment).scrollTop()||0),this.offset=this.helper.offset(),this.position={left:i,top:s},this.size=this._helper?{width:this.helper.width(),height:this.helper.height()}:{width:a.width(),height:a.height()},this.originalSize=this._helper?{width:a.outerWidth(),height:a.outerHeight()}:{width:a.width(),height:a.height()},this.sizeDiff={width:a.outerWidth()-a.width(),height:a.outerHeight()-a.height()},this.originalPosition={left:i,top:s},this.originalMousePosition={left:e.pageX,top:e.pageY},this.aspectRatio="number"==typeof o.aspectRatio?o.aspectRatio:this.originalSize.width/this.originalSize.height||1,n=t(".ui-resizable-"+this.axis).css("cursor"),t("body").css("cursor","auto"===n?this.axis+"-resize":n),this._addClass("ui-resizable-resizing"),this._propagate("start",e),!0},_mouseDrag:function(e){var i,s,n=this.originalMousePosition,o=this.axis,a=e.pageX-n.left||0,r=e.pageY-n.top||0,h=this._change[o];return this._updatePrevProperties(),h?(i=h.apply(this,[e,a,r]),this._updateVirtualBoundaries(e.shiftKey),(this._aspectRatio||e.shiftKey)&&(i=this._updateRatio(i,e)),i=this._respectSize(i,e),this._updateCache(i),this._propagate("resize",e),s=this._applyChanges(),!this._helper&&this._proportionallyResizeElements.length&&this._proportionallyResize(),t.isEmptyObject(s)||(this._updatePrevProperties(),this._trigger("resize",e,this.ui()),this._applyChanges()),!1):!1},_mouseStop:function(e){this.resizing=!1;var i,s,n,o,a,r,h,l=this.options,c=this;return this._helper&&(i=this._proportionallyResizeElements,s=i.length&&/textarea/i.test(i[0].nodeName),n=s&&this._hasScroll(i[0],"left")?0:c.sizeDiff.height,o=s?0:c.sizeDiff.width,a={width:c.helper.width()-o,height:c.helper.height()-n},r=parseFloat(c.element.css("left"))+(c.position.left-c.originalPosition.left)||null,h=parseFloat(c.element.css("top"))+(c.position.top-c.originalPosition.top)||null,l.animate||this.element.css(t.extend(a,{top:h,left:r})),c.helper.height(c.size.height),c.helper.width(c.size.width),this._helper&&!l.animate&&this._proportionallyResize()),t("body").css("cursor","auto"),this._removeClass("ui-resizable-resizing"),this._propagate("stop",e),this._helper&&this.helper.remove(),!1},_updatePrevProperties:function(){this.prevPosition={top:this.position.top,left:this.position.left},this.prevSize={width:this.size.width,height:this.size.height}},_applyChanges:function(){var t={};return this.position.top!==this.prevPosition.top&&(t.top=this.position.top+"px"),this.position.left!==this.prevPosition.left&&(t.left=this.position.left+"px"),this.size.width!==this.prevSize.width&&(t.width=this.size.width+"px"),this.size.height!==this.prevSize.height&&(t.height=this.size.height+"px"),this.helper.css(t),t},_updateVirtualBoundaries:function(t){var e,i,s,n,o,a=this.options;o={minWidth:this._isNumber(a.minWidth)?a.minWidth:0,maxWidth:this._isNumber(a.maxWidth)?a.maxWidth:1/0,minHeight:this._isNumber(a.minHeight)?a.minHeight:0,maxHeight:this._isNumber(a.maxHeight)?a.maxHeight:1/0},(this._aspectRatio||t)&&(e=o.minHeight*this.aspectRatio,s=o.minWidth/this.aspectRatio,i=o.maxHeight*this.aspectRatio,n=o.maxWidth/this.aspectRatio,e>o.minWidth&&(o.minWidth=e),s>o.minHeight&&(o.minHeight=s),o.maxWidth>i&&(o.maxWidth=i),o.maxHeight>n&&(o.maxHeight=n)),this._vBoundaries=o},_updateCache:function(t){this.offset=this.helper.offset(),this._isNumber(t.left)&&(this.position.left=t.left),this._isNumber(t.top)&&(this.position.top=t.top),this._isNumber(t.height)&&(this.size.height=t.height),this._isNumber(t.width)&&(this.size.width=t.width)},_updateRatio:function(t){var e=this.position,i=this.size,s=this.axis;return this._isNumber(t.height)?t.width=t.height*this.aspectRatio:this._isNumber(t.width)&&(t.height=t.width/this.aspectRatio),"sw"===s&&(t.left=e.left+(i.width-t.width),t.top=null),"nw"===s&&(t.top=e.top+(i.height-t.height),t.left=e.left+(i.width-t.width)),t},_respectSize:function(t){var e=this._vBoundaries,i=this.axis,s=this._isNumber(t.width)&&e.maxWidth&&e.maxWidtht.width,a=this._isNumber(t.height)&&e.minHeight&&e.minHeight>t.height,r=this.originalPosition.left+this.originalSize.width,h=this.originalPosition.top+this.originalSize.height,l=/sw|nw|w/.test(i),c=/nw|ne|n/.test(i);return o&&(t.width=e.minWidth),a&&(t.height=e.minHeight),s&&(t.width=e.maxWidth),n&&(t.height=e.maxHeight),o&&l&&(t.left=r-e.minWidth),s&&l&&(t.left=r-e.maxWidth),a&&c&&(t.top=h-e.minHeight),n&&c&&(t.top=h-e.maxHeight),t.width||t.height||t.left||!t.top?t.width||t.height||t.top||!t.left||(t.left=null):t.top=null,t},_getPaddingPlusBorderDimensions:function(t){for(var e=0,i=[],s=[t.css("borderTopWidth"),t.css("borderRightWidth"),t.css("borderBottomWidth"),t.css("borderLeftWidth")],n=[t.css("paddingTop"),t.css("paddingRight"),t.css("paddingBottom"),t.css("paddingLeft")];4>e;e++)i[e]=parseFloat(s[e])||0,i[e]+=parseFloat(n[e])||0;return{height:i[0]+i[2],width:i[1]+i[3]}},_proportionallyResize:function(){if(this._proportionallyResizeElements.length)for(var t,e=0,i=this.helper||this.element;this._proportionallyResizeElements.length>e;e++)t=this._proportionallyResizeElements[e],this.outerDimensions||(this.outerDimensions=this._getPaddingPlusBorderDimensions(t)),t.css({height:i.height()-this.outerDimensions.height||0,width:i.width()-this.outerDimensions.width||0})},_renderProxy:function(){var e=this.element,i=this.options;this.elementOffset=e.offset(),this._helper?(this.helper=this.helper||t("
"),this._addClass(this.helper,this._helper),this.helper.css({width:this.element.outerWidth(),height:this.element.outerHeight(),position:"absolute",left:this.elementOffset.left+"px",top:this.elementOffset.top+"px",zIndex:++i.zIndex}),this.helper.appendTo("body").disableSelection()):this.helper=this.element},_change:{e:function(t,e){return{width:this.originalSize.width+e}},w:function(t,e){var i=this.originalSize,s=this.originalPosition;return{left:s.left+e,width:i.width-e}},n:function(t,e,i){var s=this.originalSize,n=this.originalPosition;return{top:n.top+i,height:s.height-i}},s:function(t,e,i){return{height:this.originalSize.height+i}},se:function(e,i,s){return t.extend(this._change.s.apply(this,arguments),this._change.e.apply(this,[e,i,s]))},sw:function(e,i,s){return t.extend(this._change.s.apply(this,arguments),this._change.w.apply(this,[e,i,s]))},ne:function(e,i,s){return t.extend(this._change.n.apply(this,arguments),this._change.e.apply(this,[e,i,s]))},nw:function(e,i,s){return t.extend(this._change.n.apply(this,arguments),this._change.w.apply(this,[e,i,s]))}},_propagate:function(e,i){t.ui.plugin.call(this,e,[i,this.ui()]),"resize"!==e&&this._trigger(e,i,this.ui())},plugins:{},ui:function(){return{originalElement:this.originalElement,element:this.element,helper:this.helper,position:this.position,size:this.size,originalSize:this.originalSize,originalPosition:this.originalPosition}}}),t.ui.plugin.add("resizable","animate",{stop:function(e){var i=t(this).resizable("instance"),s=i.options,n=i._proportionallyResizeElements,o=n.length&&/textarea/i.test(n[0].nodeName),a=o&&i._hasScroll(n[0],"left")?0:i.sizeDiff.height,r=o?0:i.sizeDiff.width,h={width:i.size.width-r,height:i.size.height-a},l=parseFloat(i.element.css("left"))+(i.position.left-i.originalPosition.left)||null,c=parseFloat(i.element.css("top"))+(i.position.top-i.originalPosition.top)||null;i.element.animate(t.extend(h,c&&l?{top:c,left:l}:{}),{duration:s.animateDuration,easing:s.animateEasing,step:function(){var s={width:parseFloat(i.element.css("width")),height:parseFloat(i.element.css("height")),top:parseFloat(i.element.css("top")),left:parseFloat(i.element.css("left"))};n&&n.length&&t(n[0]).css({width:s.width,height:s.height}),i._updateCache(s),i._propagate("resize",e)}})}}),t.ui.plugin.add("resizable","containment",{start:function(){var e,i,s,n,o,a,r,h=t(this).resizable("instance"),l=h.options,c=h.element,u=l.containment,d=u instanceof t?u.get(0):/parent/.test(u)?c.parent().get(0):u;d&&(h.containerElement=t(d),/document/.test(u)||u===document?(h.containerOffset={left:0,top:0},h.containerPosition={left:0,top:0},h.parentData={element:t(document),left:0,top:0,width:t(document).width(),height:t(document).height()||document.body.parentNode.scrollHeight}):(e=t(d),i=[],t(["Top","Right","Left","Bottom"]).each(function(t,s){i[t]=h._num(e.css("padding"+s))}),h.containerOffset=e.offset(),h.containerPosition=e.position(),h.containerSize={height:e.innerHeight()-i[3],width:e.innerWidth()-i[1]},s=h.containerOffset,n=h.containerSize.height,o=h.containerSize.width,a=h._hasScroll(d,"left")?d.scrollWidth:o,r=h._hasScroll(d)?d.scrollHeight:n,h.parentData={element:d,left:s.left,top:s.top,width:a,height:r}))},resize:function(e){var i,s,n,o,a=t(this).resizable("instance"),r=a.options,h=a.containerOffset,l=a.position,c=a._aspectRatio||e.shiftKey,u={top:0,left:0},d=a.containerElement,p=!0;d[0]!==document&&/static/.test(d.css("position"))&&(u=h),l.left<(a._helper?h.left:0)&&(a.size.width=a.size.width+(a._helper?a.position.left-h.left:a.position.left-u.left),c&&(a.size.height=a.size.width/a.aspectRatio,p=!1),a.position.left=r.helper?h.left:0),l.top<(a._helper?h.top:0)&&(a.size.height=a.size.height+(a._helper?a.position.top-h.top:a.position.top),c&&(a.size.width=a.size.height*a.aspectRatio,p=!1),a.position.top=a._helper?h.top:0),n=a.containerElement.get(0)===a.element.parent().get(0),o=/relative|absolute/.test(a.containerElement.css("position")),n&&o?(a.offset.left=a.parentData.left+a.position.left,a.offset.top=a.parentData.top+a.position.top):(a.offset.left=a.element.offset().left,a.offset.top=a.element.offset().top),i=Math.abs(a.sizeDiff.width+(a._helper?a.offset.left-u.left:a.offset.left-h.left)),s=Math.abs(a.sizeDiff.height+(a._helper?a.offset.top-u.top:a.offset.top-h.top)),i+a.size.width>=a.parentData.width&&(a.size.width=a.parentData.width-i,c&&(a.size.height=a.size.width/a.aspectRatio,p=!1)),s+a.size.height>=a.parentData.height&&(a.size.height=a.parentData.height-s,c&&(a.size.width=a.size.height*a.aspectRatio,p=!1)),p||(a.position.left=a.prevPosition.left,a.position.top=a.prevPosition.top,a.size.width=a.prevSize.width,a.size.height=a.prevSize.height)},stop:function(){var e=t(this).resizable("instance"),i=e.options,s=e.containerOffset,n=e.containerPosition,o=e.containerElement,a=t(e.helper),r=a.offset(),h=a.outerWidth()-e.sizeDiff.width,l=a.outerHeight()-e.sizeDiff.height;e._helper&&!i.animate&&/relative/.test(o.css("position"))&&t(this).css({left:r.left-n.left-s.left,width:h,height:l}),e._helper&&!i.animate&&/static/.test(o.css("position"))&&t(this).css({left:r.left-n.left-s.left,width:h,height:l})}}),t.ui.plugin.add("resizable","alsoResize",{start:function(){var e=t(this).resizable("instance"),i=e.options;t(i.alsoResize).each(function(){var e=t(this);e.data("ui-resizable-alsoresize",{width:parseFloat(e.width()),height:parseFloat(e.height()),left:parseFloat(e.css("left")),top:parseFloat(e.css("top"))})})},resize:function(e,i){var s=t(this).resizable("instance"),n=s.options,o=s.originalSize,a=s.originalPosition,r={height:s.size.height-o.height||0,width:s.size.width-o.width||0,top:s.position.top-a.top||0,left:s.position.left-a.left||0}; +t(n.alsoResize).each(function(){var e=t(this),s=t(this).data("ui-resizable-alsoresize"),n={},o=e.parents(i.originalElement[0]).length?["width","height"]:["width","height","top","left"];t.each(o,function(t,e){var i=(s[e]||0)+(r[e]||0);i&&i>=0&&(n[e]=i||null)}),e.css(n)})},stop:function(){t(this).removeData("ui-resizable-alsoresize")}}),t.ui.plugin.add("resizable","ghost",{start:function(){var e=t(this).resizable("instance"),i=e.size;e.ghost=e.originalElement.clone(),e.ghost.css({opacity:.25,display:"block",position:"relative",height:i.height,width:i.width,margin:0,left:0,top:0}),e._addClass(e.ghost,"ui-resizable-ghost"),t.uiBackCompat!==!1&&"string"==typeof e.options.ghost&&e.ghost.addClass(this.options.ghost),e.ghost.appendTo(e.helper)},resize:function(){var e=t(this).resizable("instance");e.ghost&&e.ghost.css({position:"relative",height:e.size.height,width:e.size.width})},stop:function(){var e=t(this).resizable("instance");e.ghost&&e.helper&&e.helper.get(0).removeChild(e.ghost.get(0))}}),t.ui.plugin.add("resizable","grid",{resize:function(){var e,i=t(this).resizable("instance"),s=i.options,n=i.size,o=i.originalSize,a=i.originalPosition,r=i.axis,h="number"==typeof s.grid?[s.grid,s.grid]:s.grid,l=h[0]||1,c=h[1]||1,u=Math.round((n.width-o.width)/l)*l,d=Math.round((n.height-o.height)/c)*c,p=o.width+u,f=o.height+d,g=s.maxWidth&&p>s.maxWidth,m=s.maxHeight&&f>s.maxHeight,_=s.minWidth&&s.minWidth>p,v=s.minHeight&&s.minHeight>f;s.grid=h,_&&(p+=l),v&&(f+=c),g&&(p-=l),m&&(f-=c),/^(se|s|e)$/.test(r)?(i.size.width=p,i.size.height=f):/^(ne)$/.test(r)?(i.size.width=p,i.size.height=f,i.position.top=a.top-d):/^(sw)$/.test(r)?(i.size.width=p,i.size.height=f,i.position.left=a.left-u):((0>=f-c||0>=p-l)&&(e=i._getPaddingPlusBorderDimensions(this)),f-c>0?(i.size.height=f,i.position.top=a.top-d):(f=c-e.height,i.size.height=f,i.position.top=a.top+o.height-f),p-l>0?(i.size.width=p,i.position.left=a.left-u):(p=l-e.width,i.size.width=p,i.position.left=a.left+o.width-p))}}),t.ui.resizable,t.widget("ui.selectable",t.ui.mouse,{version:"1.12.1",options:{appendTo:"body",autoRefresh:!0,distance:0,filter:"*",tolerance:"touch",selected:null,selecting:null,start:null,stop:null,unselected:null,unselecting:null},_create:function(){var e=this;this._addClass("ui-selectable"),this.dragged=!1,this.refresh=function(){e.elementPos=t(e.element[0]).offset(),e.selectees=t(e.options.filter,e.element[0]),e._addClass(e.selectees,"ui-selectee"),e.selectees.each(function(){var i=t(this),s=i.offset(),n={left:s.left-e.elementPos.left,top:s.top-e.elementPos.top};t.data(this,"selectable-item",{element:this,$element:i,left:n.left,top:n.top,right:n.left+i.outerWidth(),bottom:n.top+i.outerHeight(),startselected:!1,selected:i.hasClass("ui-selected"),selecting:i.hasClass("ui-selecting"),unselecting:i.hasClass("ui-unselecting")})})},this.refresh(),this._mouseInit(),this.helper=t("
"),this._addClass(this.helper,"ui-selectable-helper")},_destroy:function(){this.selectees.removeData("selectable-item"),this._mouseDestroy()},_mouseStart:function(e){var i=this,s=this.options;this.opos=[e.pageX,e.pageY],this.elementPos=t(this.element[0]).offset(),this.options.disabled||(this.selectees=t(s.filter,this.element[0]),this._trigger("start",e),t(s.appendTo).append(this.helper),this.helper.css({left:e.pageX,top:e.pageY,width:0,height:0}),s.autoRefresh&&this.refresh(),this.selectees.filter(".ui-selected").each(function(){var s=t.data(this,"selectable-item");s.startselected=!0,e.metaKey||e.ctrlKey||(i._removeClass(s.$element,"ui-selected"),s.selected=!1,i._addClass(s.$element,"ui-unselecting"),s.unselecting=!0,i._trigger("unselecting",e,{unselecting:s.element}))}),t(e.target).parents().addBack().each(function(){var s,n=t.data(this,"selectable-item");return n?(s=!e.metaKey&&!e.ctrlKey||!n.$element.hasClass("ui-selected"),i._removeClass(n.$element,s?"ui-unselecting":"ui-selected")._addClass(n.$element,s?"ui-selecting":"ui-unselecting"),n.unselecting=!s,n.selecting=s,n.selected=s,s?i._trigger("selecting",e,{selecting:n.element}):i._trigger("unselecting",e,{unselecting:n.element}),!1):void 0}))},_mouseDrag:function(e){if(this.dragged=!0,!this.options.disabled){var i,s=this,n=this.options,o=this.opos[0],a=this.opos[1],r=e.pageX,h=e.pageY;return o>r&&(i=r,r=o,o=i),a>h&&(i=h,h=a,a=i),this.helper.css({left:o,top:a,width:r-o,height:h-a}),this.selectees.each(function(){var i=t.data(this,"selectable-item"),l=!1,c={};i&&i.element!==s.element[0]&&(c.left=i.left+s.elementPos.left,c.right=i.right+s.elementPos.left,c.top=i.top+s.elementPos.top,c.bottom=i.bottom+s.elementPos.top,"touch"===n.tolerance?l=!(c.left>r||o>c.right||c.top>h||a>c.bottom):"fit"===n.tolerance&&(l=c.left>o&&r>c.right&&c.top>a&&h>c.bottom),l?(i.selected&&(s._removeClass(i.$element,"ui-selected"),i.selected=!1),i.unselecting&&(s._removeClass(i.$element,"ui-unselecting"),i.unselecting=!1),i.selecting||(s._addClass(i.$element,"ui-selecting"),i.selecting=!0,s._trigger("selecting",e,{selecting:i.element}))):(i.selecting&&((e.metaKey||e.ctrlKey)&&i.startselected?(s._removeClass(i.$element,"ui-selecting"),i.selecting=!1,s._addClass(i.$element,"ui-selected"),i.selected=!0):(s._removeClass(i.$element,"ui-selecting"),i.selecting=!1,i.startselected&&(s._addClass(i.$element,"ui-unselecting"),i.unselecting=!0),s._trigger("unselecting",e,{unselecting:i.element}))),i.selected&&(e.metaKey||e.ctrlKey||i.startselected||(s._removeClass(i.$element,"ui-selected"),i.selected=!1,s._addClass(i.$element,"ui-unselecting"),i.unselecting=!0,s._trigger("unselecting",e,{unselecting:i.element})))))}),!1}},_mouseStop:function(e){var i=this;return this.dragged=!1,t(".ui-unselecting",this.element[0]).each(function(){var s=t.data(this,"selectable-item");i._removeClass(s.$element,"ui-unselecting"),s.unselecting=!1,s.startselected=!1,i._trigger("unselected",e,{unselected:s.element})}),t(".ui-selecting",this.element[0]).each(function(){var s=t.data(this,"selectable-item");i._removeClass(s.$element,"ui-selecting")._addClass(s.$element,"ui-selected"),s.selecting=!1,s.selected=!0,s.startselected=!0,i._trigger("selected",e,{selected:s.element})}),this._trigger("stop",e),this.helper.remove(),!1}}),t.widget("ui.sortable",t.ui.mouse,{version:"1.12.1",widgetEventPrefix:"sort",ready:!1,options:{appendTo:"parent",axis:!1,connectWith:!1,containment:!1,cursor:"auto",cursorAt:!1,dropOnEmpty:!0,forcePlaceholderSize:!1,forceHelperSize:!1,grid:!1,handle:!1,helper:"original",items:"> *",opacity:!1,placeholder:!1,revert:!1,scroll:!0,scrollSensitivity:20,scrollSpeed:20,scope:"default",tolerance:"intersect",zIndex:1e3,activate:null,beforeStop:null,change:null,deactivate:null,out:null,over:null,receive:null,remove:null,sort:null,start:null,stop:null,update:null},_isOverAxis:function(t,e,i){return t>=e&&e+i>t},_isFloating:function(t){return/left|right/.test(t.css("float"))||/inline|table-cell/.test(t.css("display"))},_create:function(){this.containerCache={},this._addClass("ui-sortable"),this.refresh(),this.offset=this.element.offset(),this._mouseInit(),this._setHandleClassName(),this.ready=!0},_setOption:function(t,e){this._super(t,e),"handle"===t&&this._setHandleClassName()},_setHandleClassName:function(){var e=this;this._removeClass(this.element.find(".ui-sortable-handle"),"ui-sortable-handle"),t.each(this.items,function(){e._addClass(this.instance.options.handle?this.item.find(this.instance.options.handle):this.item,"ui-sortable-handle")})},_destroy:function(){this._mouseDestroy();for(var t=this.items.length-1;t>=0;t--)this.items[t].item.removeData(this.widgetName+"-item");return this},_mouseCapture:function(e,i){var s=null,n=!1,o=this;return this.reverting?!1:this.options.disabled||"static"===this.options.type?!1:(this._refreshItems(e),t(e.target).parents().each(function(){return t.data(this,o.widgetName+"-item")===o?(s=t(this),!1):void 0}),t.data(e.target,o.widgetName+"-item")===o&&(s=t(e.target)),s?!this.options.handle||i||(t(this.options.handle,s).find("*").addBack().each(function(){this===e.target&&(n=!0)}),n)?(this.currentItem=s,this._removeCurrentsFromItems(),!0):!1:!1)},_mouseStart:function(e,i,s){var n,o,a=this.options;if(this.currentContainer=this,this.refreshPositions(),this.helper=this._createHelper(e),this._cacheHelperProportions(),this._cacheMargins(),this.scrollParent=this.helper.scrollParent(),this.offset=this.currentItem.offset(),this.offset={top:this.offset.top-this.margins.top,left:this.offset.left-this.margins.left},t.extend(this.offset,{click:{left:e.pageX-this.offset.left,top:e.pageY-this.offset.top},parent:this._getParentOffset(),relative:this._getRelativeOffset()}),this.helper.css("position","absolute"),this.cssPosition=this.helper.css("position"),this.originalPosition=this._generatePosition(e),this.originalPageX=e.pageX,this.originalPageY=e.pageY,a.cursorAt&&this._adjustOffsetFromHelper(a.cursorAt),this.domPosition={prev:this.currentItem.prev()[0],parent:this.currentItem.parent()[0]},this.helper[0]!==this.currentItem[0]&&this.currentItem.hide(),this._createPlaceholder(),a.containment&&this._setContainment(),a.cursor&&"auto"!==a.cursor&&(o=this.document.find("body"),this.storedCursor=o.css("cursor"),o.css("cursor",a.cursor),this.storedStylesheet=t("").appendTo(o)),a.opacity&&(this.helper.css("opacity")&&(this._storedOpacity=this.helper.css("opacity")),this.helper.css("opacity",a.opacity)),a.zIndex&&(this.helper.css("zIndex")&&(this._storedZIndex=this.helper.css("zIndex")),this.helper.css("zIndex",a.zIndex)),this.scrollParent[0]!==this.document[0]&&"HTML"!==this.scrollParent[0].tagName&&(this.overflowOffset=this.scrollParent.offset()),this._trigger("start",e,this._uiHash()),this._preserveHelperProportions||this._cacheHelperProportions(),!s)for(n=this.containers.length-1;n>=0;n--)this.containers[n]._trigger("activate",e,this._uiHash(this));return t.ui.ddmanager&&(t.ui.ddmanager.current=this),t.ui.ddmanager&&!a.dropBehaviour&&t.ui.ddmanager.prepareOffsets(this,e),this.dragging=!0,this._addClass(this.helper,"ui-sortable-helper"),this._mouseDrag(e),!0},_mouseDrag:function(e){var i,s,n,o,a=this.options,r=!1;for(this.position=this._generatePosition(e),this.positionAbs=this._convertPositionTo("absolute"),this.lastPositionAbs||(this.lastPositionAbs=this.positionAbs),this.options.scroll&&(this.scrollParent[0]!==this.document[0]&&"HTML"!==this.scrollParent[0].tagName?(this.overflowOffset.top+this.scrollParent[0].offsetHeight-e.pageY=0;i--)if(s=this.items[i],n=s.item[0],o=this._intersectsWithPointer(s),o&&s.instance===this.currentContainer&&n!==this.currentItem[0]&&this.placeholder[1===o?"next":"prev"]()[0]!==n&&!t.contains(this.placeholder[0],n)&&("semi-dynamic"===this.options.type?!t.contains(this.element[0],n):!0)){if(this.direction=1===o?"down":"up","pointer"!==this.options.tolerance&&!this._intersectsWithSides(s))break;this._rearrange(e,s),this._trigger("change",e,this._uiHash());break}return this._contactContainers(e),t.ui.ddmanager&&t.ui.ddmanager.drag(this,e),this._trigger("sort",e,this._uiHash()),this.lastPositionAbs=this.positionAbs,!1},_mouseStop:function(e,i){if(e){if(t.ui.ddmanager&&!this.options.dropBehaviour&&t.ui.ddmanager.drop(this,e),this.options.revert){var s=this,n=this.placeholder.offset(),o=this.options.axis,a={};o&&"x"!==o||(a.left=n.left-this.offset.parent.left-this.margins.left+(this.offsetParent[0]===this.document[0].body?0:this.offsetParent[0].scrollLeft)),o&&"y"!==o||(a.top=n.top-this.offset.parent.top-this.margins.top+(this.offsetParent[0]===this.document[0].body?0:this.offsetParent[0].scrollTop)),this.reverting=!0,t(this.helper).animate(a,parseInt(this.options.revert,10)||500,function(){s._clear(e)})}else this._clear(e,i);return!1}},cancel:function(){if(this.dragging){this._mouseUp(new t.Event("mouseup",{target:null})),"original"===this.options.helper?(this.currentItem.css(this._storedCSS),this._removeClass(this.currentItem,"ui-sortable-helper")):this.currentItem.show();for(var e=this.containers.length-1;e>=0;e--)this.containers[e]._trigger("deactivate",null,this._uiHash(this)),this.containers[e].containerCache.over&&(this.containers[e]._trigger("out",null,this._uiHash(this)),this.containers[e].containerCache.over=0)}return this.placeholder&&(this.placeholder[0].parentNode&&this.placeholder[0].parentNode.removeChild(this.placeholder[0]),"original"!==this.options.helper&&this.helper&&this.helper[0].parentNode&&this.helper.remove(),t.extend(this,{helper:null,dragging:!1,reverting:!1,_noFinalSort:null}),this.domPosition.prev?t(this.domPosition.prev).after(this.currentItem):t(this.domPosition.parent).prepend(this.currentItem)),this},serialize:function(e){var i=this._getItemsAsjQueryHW2(e&&e.connected),s=[];return e=e||{},t(i).each(function(){var i=(t(e.item||this).attr(e.attribute||"id")||"").match(e.expression||/(.+)[\-=_](.+)/);i&&s.push((e.key||i[1]+"[]")+"="+(e.key&&e.expression?i[1]:i[2]))}),!s.length&&e.key&&s.push(e.key+"="),s.join("&")},toArray:function(e){var i=this._getItemsAsjQueryHW2(e&&e.connected),s=[];return e=e||{},i.each(function(){s.push(t(e.item||this).attr(e.attribute||"id")||"")}),s},_intersectsWith:function(t){var e=this.positionAbs.left,i=e+this.helperProportions.width,s=this.positionAbs.top,n=s+this.helperProportions.height,o=t.left,a=o+t.width,r=t.top,h=r+t.height,l=this.offset.click.top,c=this.offset.click.left,u="x"===this.options.axis||s+l>r&&h>s+l,d="y"===this.options.axis||e+c>o&&a>e+c,p=u&&d;return"pointer"===this.options.tolerance||this.options.forcePointerForContainers||"pointer"!==this.options.tolerance&&this.helperProportions[this.floating?"width":"height"]>t[this.floating?"width":"height"]?p:e+this.helperProportions.width/2>o&&a>i-this.helperProportions.width/2&&s+this.helperProportions.height/2>r&&h>n-this.helperProportions.height/2},_intersectsWithPointer:function(t){var e,i,s="x"===this.options.axis||this._isOverAxis(this.positionAbs.top+this.offset.click.top,t.top,t.height),n="y"===this.options.axis||this._isOverAxis(this.positionAbs.left+this.offset.click.left,t.left,t.width),o=s&&n;return o?(e=this._getDragVerticalDirection(),i=this._getDragHorizontalDirection(),this.floating?"right"===i||"down"===e?2:1:e&&("down"===e?2:1)):!1},_intersectsWithSides:function(t){var e=this._isOverAxis(this.positionAbs.top+this.offset.click.top,t.top+t.height/2,t.height),i=this._isOverAxis(this.positionAbs.left+this.offset.click.left,t.left+t.width/2,t.width),s=this._getDragVerticalDirection(),n=this._getDragHorizontalDirection();return this.floating&&n?"right"===n&&i||"left"===n&&!i:s&&("down"===s&&e||"up"===s&&!e)},_getDragVerticalDirection:function(){var t=this.positionAbs.top-this.lastPositionAbs.top;return 0!==t&&(t>0?"down":"up")},_getDragHorizontalDirection:function(){var t=this.positionAbs.left-this.lastPositionAbs.left;return 0!==t&&(t>0?"right":"left")},refresh:function(t){return this._refreshItems(t),this._setHandleClassName(),this.refreshPositions(),this},_connectWith:function(){var t=this.options;return t.connectWith.constructor===String?[t.connectWith]:t.connectWith},_getItemsAsjQueryHW2:function(e){function i(){r.push(this)}var s,n,o,a,r=[],h=[],l=this._connectWith();if(l&&e)for(s=l.length-1;s>=0;s--)for(o=t(l[s],this.document[0]),n=o.length-1;n>=0;n--)a=t.data(o[n],this.widgetFullName),a&&a!==this&&!a.options.disabled&&h.push([t.isFunction(a.options.items)?a.options.items.call(a.element):t(a.options.items,a.element).not(".ui-sortable-helper").not(".ui-sortable-placeholder"),a]);for(h.push([t.isFunction(this.options.items)?this.options.items.call(this.element,null,{options:this.options,item:this.currentItem}):t(this.options.items,this.element).not(".ui-sortable-helper").not(".ui-sortable-placeholder"),this]),s=h.length-1;s>=0;s--)h[s][0].each(i);return t(r)},_removeCurrentsFromItems:function(){var e=this.currentItem.find(":data("+this.widgetName+"-item)");this.items=t.grep(this.items,function(t){for(var i=0;e.length>i;i++)if(e[i]===t.item[0])return!1;return!0})},_refreshItems:function(e){this.items=[],this.containers=[this];var i,s,n,o,a,r,h,l,c=this.items,u=[[t.isFunction(this.options.items)?this.options.items.call(this.element[0],e,{item:this.currentItem}):t(this.options.items,this.element),this]],d=this._connectWith();if(d&&this.ready)for(i=d.length-1;i>=0;i--)for(n=t(d[i],this.document[0]),s=n.length-1;s>=0;s--)o=t.data(n[s],this.widgetFullName),o&&o!==this&&!o.options.disabled&&(u.push([t.isFunction(o.options.items)?o.options.items.call(o.element[0],e,{item:this.currentItem}):t(o.options.items,o.element),o]),this.containers.push(o));for(i=u.length-1;i>=0;i--)for(a=u[i][1],r=u[i][0],s=0,l=r.length;l>s;s++)h=t(r[s]),h.data(this.widgetName+"-item",a),c.push({item:h,instance:a,width:0,height:0,left:0,top:0})},refreshPositions:function(e){this.floating=this.items.length?"x"===this.options.axis||this._isFloating(this.items[0].item):!1,this.offsetParent&&this.helper&&(this.offset.parent=this._getParentOffset());var i,s,n,o;for(i=this.items.length-1;i>=0;i--)s=this.items[i],s.instance!==this.currentContainer&&this.currentContainer&&s.item[0]!==this.currentItem[0]||(n=this.options.toleranceElement?t(this.options.toleranceElement,s.item):s.item,e||(s.width=n.outerWidth(),s.height=n.outerHeight()),o=n.offset(),s.left=o.left,s.top=o.top);if(this.options.custom&&this.options.custom.refreshContainers)this.options.custom.refreshContainers.call(this);else for(i=this.containers.length-1;i>=0;i--)o=this.containers[i].element.offset(),this.containers[i].containerCache.left=o.left,this.containers[i].containerCache.top=o.top,this.containers[i].containerCache.width=this.containers[i].element.outerWidth(),this.containers[i].containerCache.height=this.containers[i].element.outerHeight();return this},_createPlaceholder:function(e){e=e||this;var i,s=e.options;s.placeholder&&s.placeholder.constructor!==String||(i=s.placeholder,s.placeholder={element:function(){var s=e.currentItem[0].nodeName.toLowerCase(),n=t("<"+s+">",e.document[0]);return e._addClass(n,"ui-sortable-placeholder",i||e.currentItem[0].className)._removeClass(n,"ui-sortable-helper"),"tbody"===s?e._createTrPlaceholder(e.currentItem.find("tr").eq(0),t("",e.document[0]).appendTo(n)):"tr"===s?e._createTrPlaceholder(e.currentItem,n):"img"===s&&n.attr("src",e.currentItem.attr("src")),i||n.css("visibility","hidden"),n},update:function(t,n){(!i||s.forcePlaceholderSize)&&(n.height()||n.height(e.currentItem.innerHeight()-parseInt(e.currentItem.css("paddingTop")||0,10)-parseInt(e.currentItem.css("paddingBottom")||0,10)),n.width()||n.width(e.currentItem.innerWidth()-parseInt(e.currentItem.css("paddingLeft")||0,10)-parseInt(e.currentItem.css("paddingRight")||0,10)))}}),e.placeholder=t(s.placeholder.element.call(e.element,e.currentItem)),e.currentItem.after(e.placeholder),s.placeholder.update(e,e.placeholder)},_createTrPlaceholder:function(e,i){var s=this;e.children().each(function(){t(" ",s.document[0]).attr("colspan",t(this).attr("colspan")||1).appendTo(i)})},_contactContainers:function(e){var i,s,n,o,a,r,h,l,c,u,d=null,p=null;for(i=this.containers.length-1;i>=0;i--)if(!t.contains(this.currentItem[0],this.containers[i].element[0]))if(this._intersectsWith(this.containers[i].containerCache)){if(d&&t.contains(this.containers[i].element[0],d.element[0]))continue;d=this.containers[i],p=i}else this.containers[i].containerCache.over&&(this.containers[i]._trigger("out",e,this._uiHash(this)),this.containers[i].containerCache.over=0);if(d)if(1===this.containers.length)this.containers[p].containerCache.over||(this.containers[p]._trigger("over",e,this._uiHash(this)),this.containers[p].containerCache.over=1);else{for(n=1e4,o=null,c=d.floating||this._isFloating(this.currentItem),a=c?"left":"top",r=c?"width":"height",u=c?"pageX":"pageY",s=this.items.length-1;s>=0;s--)t.contains(this.containers[p].element[0],this.items[s].item[0])&&this.items[s].item[0]!==this.currentItem[0]&&(h=this.items[s].item.offset()[a],l=!1,e[u]-h>this.items[s][r]/2&&(l=!0),n>Math.abs(e[u]-h)&&(n=Math.abs(e[u]-h),o=this.items[s],this.direction=l?"up":"down"));if(!o&&!this.options.dropOnEmpty)return;if(this.currentContainer===this.containers[p])return this.currentContainer.containerCache.over||(this.containers[p]._trigger("over",e,this._uiHash()),this.currentContainer.containerCache.over=1),void 0;o?this._rearrange(e,o,null,!0):this._rearrange(e,null,this.containers[p].element,!0),this._trigger("change",e,this._uiHash()),this.containers[p]._trigger("change",e,this._uiHash(this)),this.currentContainer=this.containers[p],this.options.placeholder.update(this.currentContainer,this.placeholder),this.containers[p]._trigger("over",e,this._uiHash(this)),this.containers[p].containerCache.over=1}},_createHelper:function(e){var i=this.options,s=t.isFunction(i.helper)?t(i.helper.apply(this.element[0],[e,this.currentItem])):"clone"===i.helper?this.currentItem.clone():this.currentItem;return s.parents("body").length||t("parent"!==i.appendTo?i.appendTo:this.currentItem[0].parentNode)[0].appendChild(s[0]),s[0]===this.currentItem[0]&&(this._storedCSS={width:this.currentItem[0].style.width,height:this.currentItem[0].style.height,position:this.currentItem.css("position"),top:this.currentItem.css("top"),left:this.currentItem.css("left")}),(!s[0].style.width||i.forceHelperSize)&&s.width(this.currentItem.width()),(!s[0].style.height||i.forceHelperSize)&&s.height(this.currentItem.height()),s},_adjustOffsetFromHelper:function(e){"string"==typeof e&&(e=e.split(" ")),t.isArray(e)&&(e={left:+e[0],top:+e[1]||0}),"left"in e&&(this.offset.click.left=e.left+this.margins.left),"right"in e&&(this.offset.click.left=this.helperProportions.width-e.right+this.margins.left),"top"in e&&(this.offset.click.top=e.top+this.margins.top),"bottom"in e&&(this.offset.click.top=this.helperProportions.height-e.bottom+this.margins.top)},_getParentOffset:function(){this.offsetParent=this.helper.offsetParent();var e=this.offsetParent.offset();return"absolute"===this.cssPosition&&this.scrollParent[0]!==this.document[0]&&t.contains(this.scrollParent[0],this.offsetParent[0])&&(e.left+=this.scrollParent.scrollLeft(),e.top+=this.scrollParent.scrollTop()),(this.offsetParent[0]===this.document[0].body||this.offsetParent[0].tagName&&"html"===this.offsetParent[0].tagName.toLowerCase()&&t.ui.ie)&&(e={top:0,left:0}),{top:e.top+(parseInt(this.offsetParent.css("borderTopWidth"),10)||0),left:e.left+(parseInt(this.offsetParent.css("borderLeftWidth"),10)||0)}},_getRelativeOffset:function(){if("relative"===this.cssPosition){var t=this.currentItem.position();return{top:t.top-(parseInt(this.helper.css("top"),10)||0)+this.scrollParent.scrollTop(),left:t.left-(parseInt(this.helper.css("left"),10)||0)+this.scrollParent.scrollLeft()}}return{top:0,left:0}},_cacheMargins:function(){this.margins={left:parseInt(this.currentItem.css("marginLeft"),10)||0,top:parseInt(this.currentItem.css("marginTop"),10)||0}},_cacheHelperProportions:function(){this.helperProportions={width:this.helper.outerWidth(),height:this.helper.outerHeight()}},_setContainment:function(){var e,i,s,n=this.options;"parent"===n.containment&&(n.containment=this.helper[0].parentNode),("document"===n.containment||"window"===n.containment)&&(this.containment=[0-this.offset.relative.left-this.offset.parent.left,0-this.offset.relative.top-this.offset.parent.top,"document"===n.containment?this.document.width():this.window.width()-this.helperProportions.width-this.margins.left,("document"===n.containment?this.document.height()||document.body.parentNode.scrollHeight:this.window.height()||this.document[0].body.parentNode.scrollHeight)-this.helperProportions.height-this.margins.top]),/^(document|window|parent)$/.test(n.containment)||(e=t(n.containment)[0],i=t(n.containment).offset(),s="hidden"!==t(e).css("overflow"),this.containment=[i.left+(parseInt(t(e).css("borderLeftWidth"),10)||0)+(parseInt(t(e).css("paddingLeft"),10)||0)-this.margins.left,i.top+(parseInt(t(e).css("borderTopWidth"),10)||0)+(parseInt(t(e).css("paddingTop"),10)||0)-this.margins.top,i.left+(s?Math.max(e.scrollWidth,e.offsetWidth):e.offsetWidth)-(parseInt(t(e).css("borderLeftWidth"),10)||0)-(parseInt(t(e).css("paddingRight"),10)||0)-this.helperProportions.width-this.margins.left,i.top+(s?Math.max(e.scrollHeight,e.offsetHeight):e.offsetHeight)-(parseInt(t(e).css("borderTopWidth"),10)||0)-(parseInt(t(e).css("paddingBottom"),10)||0)-this.helperProportions.height-this.margins.top])},_convertPositionTo:function(e,i){i||(i=this.position);var s="absolute"===e?1:-1,n="absolute"!==this.cssPosition||this.scrollParent[0]!==this.document[0]&&t.contains(this.scrollParent[0],this.offsetParent[0])?this.scrollParent:this.offsetParent,o=/(html|body)/i.test(n[0].tagName);return{top:i.top+this.offset.relative.top*s+this.offset.parent.top*s-("fixed"===this.cssPosition?-this.scrollParent.scrollTop():o?0:n.scrollTop())*s,left:i.left+this.offset.relative.left*s+this.offset.parent.left*s-("fixed"===this.cssPosition?-this.scrollParent.scrollLeft():o?0:n.scrollLeft())*s}},_generatePosition:function(e){var i,s,n=this.options,o=e.pageX,a=e.pageY,r="absolute"!==this.cssPosition||this.scrollParent[0]!==this.document[0]&&t.contains(this.scrollParent[0],this.offsetParent[0])?this.scrollParent:this.offsetParent,h=/(html|body)/i.test(r[0].tagName);return"relative"!==this.cssPosition||this.scrollParent[0]!==this.document[0]&&this.scrollParent[0]!==this.offsetParent[0]||(this.offset.relative=this._getRelativeOffset()),this.originalPosition&&(this.containment&&(e.pageX-this.offset.click.leftthis.containment[2]&&(o=this.containment[2]+this.offset.click.left),e.pageY-this.offset.click.top>this.containment[3]&&(a=this.containment[3]+this.offset.click.top)),n.grid&&(i=this.originalPageY+Math.round((a-this.originalPageY)/n.grid[1])*n.grid[1],a=this.containment?i-this.offset.click.top>=this.containment[1]&&i-this.offset.click.top<=this.containment[3]?i:i-this.offset.click.top>=this.containment[1]?i-n.grid[1]:i+n.grid[1]:i,s=this.originalPageX+Math.round((o-this.originalPageX)/n.grid[0])*n.grid[0],o=this.containment?s-this.offset.click.left>=this.containment[0]&&s-this.offset.click.left<=this.containment[2]?s:s-this.offset.click.left>=this.containment[0]?s-n.grid[0]:s+n.grid[0]:s)),{top:a-this.offset.click.top-this.offset.relative.top-this.offset.parent.top+("fixed"===this.cssPosition?-this.scrollParent.scrollTop():h?0:r.scrollTop()),left:o-this.offset.click.left-this.offset.relative.left-this.offset.parent.left+("fixed"===this.cssPosition?-this.scrollParent.scrollLeft():h?0:r.scrollLeft())}},_rearrange:function(t,e,i,s){i?i[0].appendChild(this.placeholder[0]):e.item[0].parentNode.insertBefore(this.placeholder[0],"down"===this.direction?e.item[0]:e.item[0].nextSibling),this.counter=this.counter?++this.counter:1;var n=this.counter;this._delay(function(){n===this.counter&&this.refreshPositions(!s)})},_clear:function(t,e){function i(t,e,i){return function(s){i._trigger(t,s,e._uiHash(e))}}this.reverting=!1;var s,n=[];if(!this._noFinalSort&&this.currentItem.parent().length&&this.placeholder.before(this.currentItem),this._noFinalSort=null,this.helper[0]===this.currentItem[0]){for(s in this._storedCSS)("auto"===this._storedCSS[s]||"static"===this._storedCSS[s])&&(this._storedCSS[s]="");this.currentItem.css(this._storedCSS),this._removeClass(this.currentItem,"ui-sortable-helper")}else this.currentItem.show();for(this.fromOutside&&!e&&n.push(function(t){this._trigger("receive",t,this._uiHash(this.fromOutside))}),!this.fromOutside&&this.domPosition.prev===this.currentItem.prev().not(".ui-sortable-helper")[0]&&this.domPosition.parent===this.currentItem.parent()[0]||e||n.push(function(t){this._trigger("update",t,this._uiHash())}),this!==this.currentContainer&&(e||(n.push(function(t){this._trigger("remove",t,this._uiHash())}),n.push(function(t){return function(e){t._trigger("receive",e,this._uiHash(this))}}.call(this,this.currentContainer)),n.push(function(t){return function(e){t._trigger("update",e,this._uiHash(this))}}.call(this,this.currentContainer)))),s=this.containers.length-1;s>=0;s--)e||n.push(i("deactivate",this,this.containers[s])),this.containers[s].containerCache.over&&(n.push(i("out",this,this.containers[s])),this.containers[s].containerCache.over=0);if(this.storedCursor&&(this.document.find("body").css("cursor",this.storedCursor),this.storedStylesheet.remove()),this._storedOpacity&&this.helper.css("opacity",this._storedOpacity),this._storedZIndex&&this.helper.css("zIndex","auto"===this._storedZIndex?"":this._storedZIndex),this.dragging=!1,e||this._trigger("beforeStop",t,this._uiHash()),this.placeholder[0].parentNode.removeChild(this.placeholder[0]),this.cancelHelperRemoval||(this.helper[0]!==this.currentItem[0]&&this.helper.remove(),this.helper=null),!e){for(s=0;n.length>s;s++)n[s].call(this,t);this._trigger("stop",t,this._uiHash())}return this.fromOutside=!1,!this.cancelHelperRemoval},_trigger:function(){t.Widget.prototype._trigger.apply(this,arguments)===!1&&this.cancel()},_uiHash:function(e){var i=e||this;return{helper:i.helper,placeholder:i.placeholder||t([]),position:i.position,originalPosition:i.originalPosition,offset:i.positionAbs,item:i.currentItem,sender:e?e.element:null}}}),t.widget("ui.accordion",{version:"1.12.1",options:{active:0,animate:{},classes:{"ui-accordion-header":"ui-corner-top","ui-accordion-header-collapsed":"ui-corner-all","ui-accordion-content":"ui-corner-bottom"},collapsible:!1,event:"click",header:"> li > :first-child, > :not(li):even",heightStyle:"auto",icons:{activeHeader:"ui-icon-triangle-1-s",header:"ui-icon-triangle-1-e"},activate:null,beforeActivate:null},hideProps:{borderTopWidth:"hide",borderBottomWidth:"hide",paddingTop:"hide",paddingBottom:"hide",height:"hide"},showProps:{borderTopWidth:"show",borderBottomWidth:"show",paddingTop:"show",paddingBottom:"show",height:"show"},_create:function(){var e=this.options;this.prevShow=this.prevHide=t(),this._addClass("ui-accordion","ui-widget ui-helper-reset"),this.element.attr("role","tablist"),e.collapsible||e.active!==!1&&null!=e.active||(e.active=0),this._processPanels(),0>e.active&&(e.active+=this.headers.length),this._refresh()},_getCreateEventData:function(){return{header:this.active,panel:this.active.length?this.active.next():t()}},_createIcons:function(){var e,i,s=this.options.icons;s&&(e=t(""),this._addClass(e,"ui-accordion-header-icon","ui-icon "+s.header),e.prependTo(this.headers),i=this.active.children(".ui-accordion-header-icon"),this._removeClass(i,s.header)._addClass(i,null,s.activeHeader)._addClass(this.headers,"ui-accordion-icons")) +},_destroyIcons:function(){this._removeClass(this.headers,"ui-accordion-icons"),this.headers.children(".ui-accordion-header-icon").remove()},_destroy:function(){var t;this.element.removeAttr("role"),this.headers.removeAttr("role aria-expanded aria-selected aria-controls tabIndex").removeUniqueId(),this._destroyIcons(),t=this.headers.next().css("display","").removeAttr("role aria-hidden aria-labelledby").removeUniqueId(),"content"!==this.options.heightStyle&&t.css("height","")},_setOption:function(t,e){return"active"===t?(this._activate(e),void 0):("event"===t&&(this.options.event&&this._off(this.headers,this.options.event),this._setupEvents(e)),this._super(t,e),"collapsible"!==t||e||this.options.active!==!1||this._activate(0),"icons"===t&&(this._destroyIcons(),e&&this._createIcons()),void 0)},_setOptionDisabled:function(t){this._super(t),this.element.attr("aria-disabled",t),this._toggleClass(null,"ui-state-disabled",!!t),this._toggleClass(this.headers.add(this.headers.next()),null,"ui-state-disabled",!!t)},_keydown:function(e){if(!e.altKey&&!e.ctrlKey){var i=t.ui.keyCode,s=this.headers.length,n=this.headers.index(e.target),o=!1;switch(e.keyCode){case i.RIGHT:case i.DOWN:o=this.headers[(n+1)%s];break;case i.LEFT:case i.UP:o=this.headers[(n-1+s)%s];break;case i.SPACE:case i.ENTER:this._eventHandler(e);break;case i.HOME:o=this.headers[0];break;case i.END:o=this.headers[s-1]}o&&(t(e.target).attr("tabIndex",-1),t(o).attr("tabIndex",0),t(o).trigger("focus"),e.preventDefault())}},_panelKeyDown:function(e){e.keyCode===t.ui.keyCode.UP&&e.ctrlKey&&t(e.currentTarget).prev().trigger("focus")},refresh:function(){var e=this.options;this._processPanels(),e.active===!1&&e.collapsible===!0||!this.headers.length?(e.active=!1,this.active=t()):e.active===!1?this._activate(0):this.active.length&&!t.contains(this.element[0],this.active[0])?this.headers.length===this.headers.find(".ui-state-disabled").length?(e.active=!1,this.active=t()):this._activate(Math.max(0,e.active-1)):e.active=this.headers.index(this.active),this._destroyIcons(),this._refresh()},_processPanels:function(){var t=this.headers,e=this.panels;this.headers=this.element.find(this.options.header),this._addClass(this.headers,"ui-accordion-header ui-accordion-header-collapsed","ui-state-default"),this.panels=this.headers.next().filter(":not(.ui-accordion-content-active)").hide(),this._addClass(this.panels,"ui-accordion-content","ui-helper-reset ui-widget-content"),e&&(this._off(t.not(this.headers)),this._off(e.not(this.panels)))},_refresh:function(){var e,i=this.options,s=i.heightStyle,n=this.element.parent();this.active=this._findActive(i.active),this._addClass(this.active,"ui-accordion-header-active","ui-state-active")._removeClass(this.active,"ui-accordion-header-collapsed"),this._addClass(this.active.next(),"ui-accordion-content-active"),this.active.next().show(),this.headers.attr("role","tab").each(function(){var e=t(this),i=e.uniqueId().attr("id"),s=e.next(),n=s.uniqueId().attr("id");e.attr("aria-controls",n),s.attr("aria-labelledby",i)}).next().attr("role","tabpanel"),this.headers.not(this.active).attr({"aria-selected":"false","aria-expanded":"false",tabIndex:-1}).next().attr({"aria-hidden":"true"}).hide(),this.active.length?this.active.attr({"aria-selected":"true","aria-expanded":"true",tabIndex:0}).next().attr({"aria-hidden":"false"}):this.headers.eq(0).attr("tabIndex",0),this._createIcons(),this._setupEvents(i.event),"fill"===s?(e=n.height(),this.element.siblings(":visible").each(function(){var i=t(this),s=i.css("position");"absolute"!==s&&"fixed"!==s&&(e-=i.outerHeight(!0))}),this.headers.each(function(){e-=t(this).outerHeight(!0)}),this.headers.next().each(function(){t(this).height(Math.max(0,e-t(this).innerHeight()+t(this).height()))}).css("overflow","auto")):"auto"===s&&(e=0,this.headers.next().each(function(){var i=t(this).is(":visible");i||t(this).show(),e=Math.max(e,t(this).css("height","").height()),i||t(this).hide()}).height(e))},_activate:function(e){var i=this._findActive(e)[0];i!==this.active[0]&&(i=i||this.active[0],this._eventHandler({target:i,currentTarget:i,preventDefault:t.noop}))},_findActive:function(e){return"number"==typeof e?this.headers.eq(e):t()},_setupEvents:function(e){var i={keydown:"_keydown"};e&&t.each(e.split(" "),function(t,e){i[e]="_eventHandler"}),this._off(this.headers.add(this.headers.next())),this._on(this.headers,i),this._on(this.headers.next(),{keydown:"_panelKeyDown"}),this._hoverable(this.headers),this._focusable(this.headers)},_eventHandler:function(e){var i,s,n=this.options,o=this.active,a=t(e.currentTarget),r=a[0]===o[0],h=r&&n.collapsible,l=h?t():a.next(),c=o.next(),u={oldHeader:o,oldPanel:c,newHeader:h?t():a,newPanel:l};e.preventDefault(),r&&!n.collapsible||this._trigger("beforeActivate",e,u)===!1||(n.active=h?!1:this.headers.index(a),this.active=r?t():a,this._toggle(u),this._removeClass(o,"ui-accordion-header-active","ui-state-active"),n.icons&&(i=o.children(".ui-accordion-header-icon"),this._removeClass(i,null,n.icons.activeHeader)._addClass(i,null,n.icons.header)),r||(this._removeClass(a,"ui-accordion-header-collapsed")._addClass(a,"ui-accordion-header-active","ui-state-active"),n.icons&&(s=a.children(".ui-accordion-header-icon"),this._removeClass(s,null,n.icons.header)._addClass(s,null,n.icons.activeHeader)),this._addClass(a.next(),"ui-accordion-content-active")))},_toggle:function(e){var i=e.newPanel,s=this.prevShow.length?this.prevShow:e.oldPanel;this.prevShow.add(this.prevHide).stop(!0,!0),this.prevShow=i,this.prevHide=s,this.options.animate?this._animate(i,s,e):(s.hide(),i.show(),this._toggleComplete(e)),s.attr({"aria-hidden":"true"}),s.prev().attr({"aria-selected":"false","aria-expanded":"false"}),i.length&&s.length?s.prev().attr({tabIndex:-1,"aria-expanded":"false"}):i.length&&this.headers.filter(function(){return 0===parseInt(t(this).attr("tabIndex"),10)}).attr("tabIndex",-1),i.attr("aria-hidden","false").prev().attr({"aria-selected":"true","aria-expanded":"true",tabIndex:0})},_animate:function(t,e,i){var s,n,o,a=this,r=0,h=t.css("box-sizing"),l=t.length&&(!e.length||t.index()",delay:300,options:{icons:{submenu:"ui-icon-caret-1-e"},items:"> *",menus:"ul",position:{my:"left top",at:"right top"},role:"menu",blur:null,focus:null,select:null},_create:function(){this.activeMenu=this.element,this.mouseHandled=!1,this.element.uniqueId().attr({role:this.options.role,tabIndex:0}),this._addClass("ui-menu","ui-widget ui-widget-content"),this._on({"mousedown .ui-menu-item":function(t){t.preventDefault()},"click .ui-menu-item":function(e){var i=t(e.target),s=t(t.ui.safeActiveElement(this.document[0]));!this.mouseHandled&&i.not(".ui-state-disabled").length&&(this.select(e),e.isPropagationStopped()||(this.mouseHandled=!0),i.has(".ui-menu").length?this.expand(e):!this.element.is(":focus")&&s.closest(".ui-menu").length&&(this.element.trigger("focus",[!0]),this.active&&1===this.active.parents(".ui-menu").length&&clearTimeout(this.timer)))},"mouseenter .ui-menu-item":function(e){if(!this.previousFilter){var i=t(e.target).closest(".ui-menu-item"),s=t(e.currentTarget);i[0]===s[0]&&(this._removeClass(s.siblings().children(".ui-state-active"),null,"ui-state-active"),this.focus(e,s))}},mouseleave:"collapseAll","mouseleave .ui-menu":"collapseAll",focus:function(t,e){var i=this.active||this.element.find(this.options.items).eq(0);e||this.focus(t,i)},blur:function(e){this._delay(function(){var i=!t.contains(this.element[0],t.ui.safeActiveElement(this.document[0]));i&&this.collapseAll(e)})},keydown:"_keydown"}),this.refresh(),this._on(this.document,{click:function(t){this._closeOnDocumentClick(t)&&this.collapseAll(t),this.mouseHandled=!1}})},_destroy:function(){var e=this.element.find(".ui-menu-item").removeAttr("role aria-disabled"),i=e.children(".ui-menu-item-wrapper").removeUniqueId().removeAttr("tabIndex role aria-haspopup");this.element.removeAttr("aria-activedescendant").find(".ui-menu").addBack().removeAttr("role aria-labelledby aria-expanded aria-hidden aria-disabled tabIndex").removeUniqueId().show(),i.children().each(function(){var e=t(this);e.data("ui-menu-submenu-caret")&&e.remove()})},_keydown:function(e){var i,s,n,o,a=!0;switch(e.keyCode){case t.ui.keyCode.PAGE_UP:this.previousPage(e);break;case t.ui.keyCode.PAGE_DOWN:this.nextPage(e);break;case t.ui.keyCode.HOME:this._move("first","first",e);break;case t.ui.keyCode.END:this._move("last","last",e);break;case t.ui.keyCode.UP:this.previous(e);break;case t.ui.keyCode.DOWN:this.next(e);break;case t.ui.keyCode.LEFT:this.collapse(e);break;case t.ui.keyCode.RIGHT:this.active&&!this.active.is(".ui-state-disabled")&&this.expand(e);break;case t.ui.keyCode.ENTER:case t.ui.keyCode.SPACE:this._activate(e);break;case t.ui.keyCode.ESCAPE:this.collapse(e);break;default:a=!1,s=this.previousFilter||"",o=!1,n=e.keyCode>=96&&105>=e.keyCode?""+(e.keyCode-96):String.fromCharCode(e.keyCode),clearTimeout(this.filterTimer),n===s?o=!0:n=s+n,i=this._filterMenuItems(n),i=o&&-1!==i.index(this.active.next())?this.active.nextAll(".ui-menu-item"):i,i.length||(n=String.fromCharCode(e.keyCode),i=this._filterMenuItems(n)),i.length?(this.focus(e,i),this.previousFilter=n,this.filterTimer=this._delay(function(){delete this.previousFilter},1e3)):delete this.previousFilter}a&&e.preventDefault()},_activate:function(t){this.active&&!this.active.is(".ui-state-disabled")&&(this.active.children("[aria-haspopup='true']").length?this.expand(t):this.select(t))},refresh:function(){var e,i,s,n,o,a=this,r=this.options.icons.submenu,h=this.element.find(this.options.menus);this._toggleClass("ui-menu-icons",null,!!this.element.find(".ui-icon").length),s=h.filter(":not(.ui-menu)").hide().attr({role:this.options.role,"aria-hidden":"true","aria-expanded":"false"}).each(function(){var e=t(this),i=e.prev(),s=t("").data("ui-menu-submenu-caret",!0);a._addClass(s,"ui-menu-icon","ui-icon "+r),i.attr("aria-haspopup","true").prepend(s),e.attr("aria-labelledby",i.attr("id"))}),this._addClass(s,"ui-menu","ui-widget ui-widget-content ui-front"),e=h.add(this.element),i=e.find(this.options.items),i.not(".ui-menu-item").each(function(){var e=t(this);a._isDivider(e)&&a._addClass(e,"ui-menu-divider","ui-widget-content")}),n=i.not(".ui-menu-item, .ui-menu-divider"),o=n.children().not(".ui-menu").uniqueId().attr({tabIndex:-1,role:this._itemRole()}),this._addClass(n,"ui-menu-item")._addClass(o,"ui-menu-item-wrapper"),i.filter(".ui-state-disabled").attr("aria-disabled","true"),this.active&&!t.contains(this.element[0],this.active[0])&&this.blur()},_itemRole:function(){return{menu:"menuitem",listbox:"option"}[this.options.role]},_setOption:function(t,e){if("icons"===t){var i=this.element.find(".ui-menu-icon");this._removeClass(i,null,this.options.icons.submenu)._addClass(i,null,e.submenu)}this._super(t,e)},_setOptionDisabled:function(t){this._super(t),this.element.attr("aria-disabled",t+""),this._toggleClass(null,"ui-state-disabled",!!t)},focus:function(t,e){var i,s,n;this.blur(t,t&&"focus"===t.type),this._scrollIntoView(e),this.active=e.first(),s=this.active.children(".ui-menu-item-wrapper"),this._addClass(s,null,"ui-state-active"),this.options.role&&this.element.attr("aria-activedescendant",s.attr("id")),n=this.active.parent().closest(".ui-menu-item").children(".ui-menu-item-wrapper"),this._addClass(n,null,"ui-state-active"),t&&"keydown"===t.type?this._close():this.timer=this._delay(function(){this._close()},this.delay),i=e.children(".ui-menu"),i.length&&t&&/^mouse/.test(t.type)&&this._startOpening(i),this.activeMenu=e.parent(),this._trigger("focus",t,{item:e})},_scrollIntoView:function(e){var i,s,n,o,a,r;this._hasScroll()&&(i=parseFloat(t.css(this.activeMenu[0],"borderTopWidth"))||0,s=parseFloat(t.css(this.activeMenu[0],"paddingTop"))||0,n=e.offset().top-this.activeMenu.offset().top-i-s,o=this.activeMenu.scrollTop(),a=this.activeMenu.height(),r=e.outerHeight(),0>n?this.activeMenu.scrollTop(o+n):n+r>a&&this.activeMenu.scrollTop(o+n-a+r))},blur:function(t,e){e||clearTimeout(this.timer),this.active&&(this._removeClass(this.active.children(".ui-menu-item-wrapper"),null,"ui-state-active"),this._trigger("blur",t,{item:this.active}),this.active=null)},_startOpening:function(t){clearTimeout(this.timer),"true"===t.attr("aria-hidden")&&(this.timer=this._delay(function(){this._close(),this._open(t)},this.delay))},_open:function(e){var i=t.extend({of:this.active},this.options.position);clearTimeout(this.timer),this.element.find(".ui-menu").not(e.parents(".ui-menu")).hide().attr("aria-hidden","true"),e.show().removeAttr("aria-hidden").attr("aria-expanded","true").position(i)},collapseAll:function(e,i){clearTimeout(this.timer),this.timer=this._delay(function(){var s=i?this.element:t(e&&e.target).closest(this.element.find(".ui-menu"));s.length||(s=this.element),this._close(s),this.blur(e),this._removeClass(s.find(".ui-state-active"),null,"ui-state-active"),this.activeMenu=s},this.delay)},_close:function(t){t||(t=this.active?this.active.parent():this.element),t.find(".ui-menu").hide().attr("aria-hidden","true").attr("aria-expanded","false")},_closeOnDocumentClick:function(e){return!t(e.target).closest(".ui-menu").length},_isDivider:function(t){return!/[^\-\u2014\u2013\s]/.test(t.text())},collapse:function(t){var e=this.active&&this.active.parent().closest(".ui-menu-item",this.element);e&&e.length&&(this._close(),this.focus(t,e))},expand:function(t){var e=this.active&&this.active.children(".ui-menu ").find(this.options.items).first();e&&e.length&&(this._open(e.parent()),this._delay(function(){this.focus(t,e)}))},next:function(t){this._move("next","first",t)},previous:function(t){this._move("prev","last",t)},isFirstItem:function(){return this.active&&!this.active.prevAll(".ui-menu-item").length},isLastItem:function(){return this.active&&!this.active.nextAll(".ui-menu-item").length},_move:function(t,e,i){var s;this.active&&(s="first"===t||"last"===t?this.active["first"===t?"prevAll":"nextAll"](".ui-menu-item").eq(-1):this.active[t+"All"](".ui-menu-item").eq(0)),s&&s.length&&this.active||(s=this.activeMenu.find(this.options.items)[e]()),this.focus(i,s)},nextPage:function(e){var i,s,n;return this.active?(this.isLastItem()||(this._hasScroll()?(s=this.active.offset().top,n=this.element.height(),this.active.nextAll(".ui-menu-item").each(function(){return i=t(this),0>i.offset().top-s-n}),this.focus(e,i)):this.focus(e,this.activeMenu.find(this.options.items)[this.active?"last":"first"]())),void 0):(this.next(e),void 0)},previousPage:function(e){var i,s,n;return this.active?(this.isFirstItem()||(this._hasScroll()?(s=this.active.offset().top,n=this.element.height(),this.active.prevAll(".ui-menu-item").each(function(){return i=t(this),i.offset().top-s+n>0}),this.focus(e,i)):this.focus(e,this.activeMenu.find(this.options.items).first())),void 0):(this.next(e),void 0)},_hasScroll:function(){return this.element.outerHeight()",options:{appendTo:null,autoFocus:!1,delay:300,minLength:1,position:{my:"left top",at:"left bottom",collision:"none"},source:null,change:null,close:null,focus:null,open:null,response:null,search:null,select:null},requestIndex:0,pending:0,_create:function(){var e,i,s,n=this.element[0].nodeName.toLowerCase(),o="textarea"===n,a="input"===n;this.isMultiLine=o||!a&&this._isContentEditable(this.element),this.valueMethod=this.element[o||a?"val":"text"],this.isNewMenu=!0,this._addClass("ui-autocomplete-input"),this.element.attr("autocomplete","off"),this._on(this.element,{keydown:function(n){if(this.element.prop("readOnly"))return e=!0,s=!0,i=!0,void 0;e=!1,s=!1,i=!1;var o=t.ui.keyCode;switch(n.keyCode){case o.PAGE_UP:e=!0,this._move("previousPage",n);break;case o.PAGE_DOWN:e=!0,this._move("nextPage",n);break;case o.UP:e=!0,this._keyEvent("previous",n);break;case o.DOWN:e=!0,this._keyEvent("next",n);break;case o.ENTER:this.menu.active&&(e=!0,n.preventDefault(),this.menu.select(n));break;case o.TAB:this.menu.active&&this.menu.select(n);break;case o.ESCAPE:this.menu.element.is(":visible")&&(this.isMultiLine||this._value(this.term),this.close(n),n.preventDefault());break;default:i=!0,this._searchTimeout(n)}},keypress:function(s){if(e)return e=!1,(!this.isMultiLine||this.menu.element.is(":visible"))&&s.preventDefault(),void 0;if(!i){var n=t.ui.keyCode;switch(s.keyCode){case n.PAGE_UP:this._move("previousPage",s);break;case n.PAGE_DOWN:this._move("nextPage",s);break;case n.UP:this._keyEvent("previous",s);break;case n.DOWN:this._keyEvent("next",s)}}},input:function(t){return s?(s=!1,t.preventDefault(),void 0):(this._searchTimeout(t),void 0)},focus:function(){this.selectedItem=null,this.previous=this._value()},blur:function(t){return this.cancelBlur?(delete this.cancelBlur,void 0):(clearTimeout(this.searching),this.close(t),this._change(t),void 0)}}),this._initSource(),this.menu=t("