The procedure for updating the software of this product is described below.
Preparation
Stopping operation
Creating a snapshot
Updating software
Deleting the snapshot
Restarting operation
Point
Creating a snapshot is optional. However, create a snapshot to revert the system back to the previous environment in case the software update is canceled or the software update fails.
Follow the steps described below before upgrading the previous 1.1 version of this product.
Check the cloud provider URI.
If you are using Amazon S3 as your cloud provider, confirm that the URI format matches the one described in "3.1.2 Information Required for Registering a Cloud Provider." If the format is different, change the URI to the correct format.
Refer to "5.3 Changing Cloud Provider Settings" for details on how to change the cloud provider URI.
Check the NAS access user for local authentication.
If the name of the NAS access user for local authentication is set to "sftpadmin," change the name. To change the name, delete the corresponding user first, and then create another one under a new name. Next, change the owner of the shared folder to the NAS access user under the new name.
Refer to "2.7.1 Settings When Accessing the NAS with the Local Authentication User" for details on how to change the name of the NAS access user. Refer to "5.1 Changing Shared Folder Settings" for details on how to change the owner of the shared folder.
Check the shared folder settings
If the following items of the shared folder are specified with spaces using CSG REST API, delete the settings. Refer to "5.1.2 Procedure for Changing Shared Folder Settings" to delete the shared folder settings.
NFS allow hosts (nfs_allow_hosts)
NFS root squash hosts (nfs_no_root_squash_hosts)
SMB allow hosts (smb_allow_hosts)
SMB deny hosts (smb_deny_hosts)
Follow the procedure described below to stop operation.
Make sure that the shared folder is not being accessed. If it is being accessed, wait until the access is completed or stop the operation that is accessing it.
In the Used cache capacity panel of CSG Web GUI, check that Untransferred data is indicating No. If it is indicating Yes, wait until it changes to No. You can estimate the completion time of the data transfer as follows:
Calculate the average cloud transfer performance (MB/s) from the performance data in the Cloud transfer performance panel of CSG Web GUI.
Check the Untransferred value (GB) in the Used cache capacity panel of CSG Web GUI.
Estimate the transfer completion time using the following formula with the values obtained above in a and b.
Estimated transfer completion time (s) = (amount of untransferred data + 1) x 1024 / average cloud transfer performance
Log out of CSG Web GUI, and close the web browser.
Stop the virtual machine of this product.
For environments other than Microsoft Azure
Use the administrator account (administrator) to log in to the console of this product, and stop the virtual machine with the following command.
# csgadm power stop
For Microsoft Azure environments
Go to the Virtual Machines service on the Azure portal, select the virtual machine of this product, and click Stop.
Note
The virtual machine of this product may be restarted during the software update procedure. However, do not access the shared folder until the update procedure is completed. It is recommended that you disable the shared folder before stopping this product. Refer to "5.1 Changing Shared Folder Settings" for details on how to change the settings of the shared folder.
Refer to "D.1 Creating a Snapshot" for details on how to create a snapshot.
Follow the procedure described below to update the software.
Start the virtual machine of this product.
Note
Do not access the shared folder after you start the virtual machine.
Log in to this product via SFTP, and transfer the update module to this product.
Log in as "sftpadmin" via SFTP. Transfer the module to the following directory.
/Administrator/ftp/
Point
When updating an unpatched version (V1.1.0) of this product, log in using "administrator" and transfer with FTP.
Use the administrator account (administrator) to log in to the console, and update the software.
In the example below, the file name of the update module is CSG120UP.tgz.
Change the file name according to the update module you want to use.
# csgadm system patch-add -file /Administrator/ftp/CSG120UP.tgz
Stop the virtual machine of this product.
For environments other than Microsoft Azure
Use the administrator account (administrator) to log in to the console of this product, and stop the virtual machine with the following command.
# csgadm power stop
For Microsoft Azure environments
Go to the Virtual Machines service on the Azure portal, select the virtual machine of this product, and click Stop.
Note
If step 3 fails, remove the cause of the failure, use the snapshot to restore the system, and then re-perform the procedure described in "6.5.1.4 Updating Software" Refer to "D.2 Snapshot Restoration for details on how to restore the system with a snapshot.
Follow the message may be output to the console during the operation of updating software. Ignore this message and do not have to take any action.
blk_update_request: I/O error, dev fd0, sector0
Delete the snapshot you created using the procedure described in "6.5.1.3 Creating a Snapshot" and apply the software updates to the virtual machine of this product.
Refer to "D.3 Deleting a Snapshot" for details on how to delete the snapshot.
Start the virtual machine of this product to restart operation.
If you disabled the shared folder, enable it now.
If an unpatched version (V1.1.0) of this product is updated, run the Configuration Wizard and set a password for the SFTP account to use SFTP for file transfers. In addition, if you will only be using SFTP for file transfers and will not be using FTP from this point forward, run the following command to disable the FTP function in this product. Use the administrator account (administrator) to log in to the console and run the command.
# csgadm system ftp-disable
Log in to this product via SFTP and then delete the update module that is transferred to this product in "6.5.1.4 Updating Software". If an unpatched version (V1.1.0) of this product is updated and the above command is not executed, deletions can be performed with FTP.
Note
In order to use CSG Web GUI in the same web browser as before the software update, be sure to clear the web browser cache first. If you do not clear the cache, CSG Web GUI may not be displayed correctly.
