Bulk updating the values registered in the Storage Management Information

This section explains how to bulk update the values registered in the Storage Management Information.

In this example, the following values registered in the Cloud Storage DB are modified and then re-registered.

  • Send Storage Management Information: Endpoint URL

  • Receive Storage Management Information: Endpoint URL

 

This example assumes that the contents of the existing Send Storage Management Information and Receive Storage Management Information are registered as follows:

  • Send Storage Management Information

    • Multiple sets of information are registered in the existing Send Storage Management Information.

    • All the Send Storage Management Information IDs are in the "xxxx.system01" format.

    • All the endpoint URLs are not specified in the Send Storage Management Information.

  • Receive Storage Management Information

    • Multiple sets of information are registered in the existing Receive Storage Management Information.

    • All the Receive Storage Management Information IDs are in the "xxxx.system01" format.

    • Some endpoint URLs are not specified and others are specified in the Receive Storage Management Information

 

For the multiple Storage Management Information sets described above, the procedure to update all the endpoint URLs is shown below.

 

  1. Use the export command of management information (utls3infomanage) to export the existing Send Storage Management Information.

    Export the Send Storage Management Information sets whose Send Storage IDs are in the "xxxx.system01" format.

    To export all the Send Storage Management Information sets whose Send Storage IDs are in the "xxxx.system01" format, execute the export command of management information by specifying a wild card for ID.

    utls3infomanage export -t snd --id *.system01 -o info.json

    For details on the export command of management information for Amazon S3, refer to Export command of management information (Amazon S3).

     

  2. Use the export command of management information to export the Receive Storage Management Information.

    Export the Receive Storage Management Information to the output file exported in step 1.

    In the same way as the Send Storage Management Information, execute the export command of management information by specifying a wild card for ID.

    utls3infomanage export -t rcv *.system01 -i info.json -o info.json

    For details on the export command of management information for Amazon S3, refer to Export command of management information (Amazon S3).

     

  3. Open and check the export output file "info.json" with a text editor, and then edit the values of the endpoint URLs.

    Open the output file "info.json" specified in step 1 and 2 with a text editor, and check the management information set for each ID.

    For details on the file structure, refer to Data structure of the input and output files.

     

    This example explains how to edit the following values of the Send Storage Management Information:

    Table D.22 An example of setting values before and after changes in the Send Storage Management Information

    Field Name in Send Storage Management Information

    Setting Value before Change

    		 Setting Value after Change

    Register or Not

    Send Storage Management Information ID

    bucket01.system01

    		 bucket01.system01

    ✓

    Bucket Name

    Not specified

    		 Not specified

    -

    Storage Timeout

    600

    		 600

    ✓

    Maximum number of parallels per transfer

    10

    		 10

    ✓

    Part Size

    10

    		 10

    ✓

    Region (*1)

    us-east-1

    		 us-east-1

    ✓

    Endpoint URL (*1)

    Not specified

    		 https://bucket.vpce-1a2b3c4d-5e6f.s3.us-east-1.vpce.amazonaws.com

    ✓

    Storage Authentication Information ID

    auth-id

    		 auth-id

    ✓

    ✓

    :

    Register after changing the setting value

    -

    :

    Do not register the setting value

    *1

    :

    This field can be set only when you use Amazon S3.

     

    When opening the export output file with a text editor, you can see the exported information as follows:

    …
{
	"id": "bucket01.system01",
	"timeout": 600,
	"parallels": 10,
	"partsize": 10,
	"default_region": "us-east-1",
	"auth_id": "auth-id"
}, 
…

    Add a field for the endpoint URL.

    … 
{ 
	"id": "bucket01.system01", 
	"timeout": 600, 
	"parallels": 10, 
	"partsize": 10, 
	"default_region": "us-east-1", 
	"endpoint_url": "https://bucket.vpce-1a2b3c4d-5e6f.s3.us-east-1.vpce.amazonaws.com", 
	"auth_id": "auth-id" 
}, 
…

    As shown above, add or modify the values of the endpoint URLs for other sets of Send Storage Management Information and Receive Storage Management Information.

     

  4. Use the import command of management information (utls3infomanage) to import the Storage Management Information.

    Use the "info.json" file edited in step 3 to bulk update the existing Send Storage Management Information and Receive Storage Management Information.

    utls3infomanage import -i info.json -r

    For details on the import command of management information for Amazon S3, refer to Import command of management information (Amazon S3).

     

    When you execute the import command of management information, registration confirmation of the imported data is performed for each management ID.

    For the Send Storage Management Information shown in step 3, the following list is output:

    The Send Storage Management Information "bucket01.system01" will be registered. 
Bucket:            Use the default value. 
Timeout:           600 
Parallels:         10 
Part Size:         10 
Default Region:    us-east-1 
Endpoint:          https://bucket.vpce-1a2b3c4d-5e6f.s3.us-east-1.vpce.amazonaws.com 
Auth ID:           auth-id

    Confirm that only the value of the endpoint URL has changed and the other values have not changed.

    If you do not specify "-f" or "--force" for the import command of management information, the following confirmation message is output:

    Are you sure to register? [y/n]:

    After the confirmation message is output, input "y" or "Y" to execute the registration command of the Storage Management Information.

    If you do not want to update the management information set, you can skip registration by inputting "n" or "N".

    Note that when you update the existing management information, you must specify the "-r" or "-f" parameter for the import command of management information.

    If you do not specify this parameter, overwriting the existing management information fails.

 

With this procedure, you can change and bulk overwrite the values registered in the existing Storage Management Information.

 

For details on the command for other object storage, refer to the following: