tool guide (obs browser+)€¦ · account management logging in, logging out, login with access...

Object Storage Service

Tool Guide (OBS Browser+)

Issue 04

Date 2020-11-15

HUAWEI TECHNOLOGIES CO., LTD.

Copyright © Huawei Technologies Co., Ltd. 2020. All rights reserved.

No part of this document may be reproduced or transmitted in any form or by any means without priorwritten consent of Huawei Technologies Co., Ltd. Trademarks and Permissions

and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.All other trademarks and trade names mentioned in this document are the property of their respectiveholders. NoticeThe purchased products, services and features are stipulated by the contract made between Huawei andthe customer. All or part of the products, services and features described in this document may not bewithin the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,information, and recommendations in this document are provided "AS IS" without warranties, guaranteesor representations of any kind, either express or implied.

The information in this document is subject to change without notice. Every effort has been made in thepreparation of this document to ensure accuracy of the contents, but all statements, information, andrecommendations in this document do not constitute a warranty of any kind, express or implied.

Issue 04 (2020-11-15) Copyright © Huawei Technologies Co., Ltd. i

Contents

1 Introduction.............................................................................................................................. 1

2 OBS Browser+ Function Overview.......................................................................................3

3 Getting Started........................................................................................................................ 53.1 Downloading OBS Browser+............................................................................................................................................... 53.2 Installing OBS Browser+....................................................................................................................................................... 53.3 Logging In to OBS Browser+............................................................................................................................................... 6

4 Best Practices......................................................................................................................... 11

5 FAQs..........................................................................................................................................135.1 Where Can I Obtain Access Keys (AK and SK)?......................................................................................................... 135.2 Can I Install Two OBS Browser+ Tools from Different Sites in One System?.................................................. 145.3 What Are the Differences Between OBS Browser+ and OBS Browser?............................................................. 145.4 Does OBS Browser+ Support the Migration of Account and Task Information From OBS Browser?..... 145.5 Why Does the Task Processing Speed Slow After the Number of Tasks Exceeds a Million?......................145.6 Why Are the Displayed Number of Objects and Used Storage Capacity Different from the ActualNumber of Objects and Storage Capacity?.........................................................................................................................145.7 Why the Deliver Attribute in the Original Settings Is Overwritten to False After the Bucket ACL IsConfigured Through OBS Browser+.......................................................................................................................................15

6 Uninstalling OBS Browser+................................................................................................. 16

7 Change History...................................................................................................................... 17

Object Storage ServiceTool Guide (OBS Browser+) Contents

Issue 04 (2020-11-15) Copyright © Huawei Technologies Co., Ltd. ii

1 Introduction

OBS Browser+ is a GUI-based desktop application for managing OBS buckets andobjects comprehensively. OBS Browser+ is intuitive and easy to use. It allows youto easily manage OBS resources from your local end. You can create buckets,upload and download objects, preview objects, and more.

OBS Browser+ is applicable to Mac OSs, Windows 7, Windows 10, Windows Server2008, and Windows Server 2016. Table 1-1 lists the specifications required by eachOS. Click here to obtain the download addresses and installation methods of OBSBrowser+ versions for different OSs.

NO TE

Before using this tool, bind a valid payment method to avoid any restriction due toinsufficient balance.

Table 1-1 PC specifications required by OBS Browser+

Item Specification Remarks

OS ● Windows 7 Pro SP1 64-bit● Windows 10 Pro 64-bit● Windows Server 2008 R2

Enterprise 64-bit● Windows Server 2016

standard 64-bit● Mac OS X10.13.3

Linux OSs are not supported.Windows 7 or later WindowsOS releases are recommended.

CPU ● Minimum: 2-core 1.6 GHz● Standard: 2-core 2.4 GHz

-

Memory ● Minimum: 4 GB● Standard: 8 GB● Available memory: ≥ 512 MB

-

Requiredspace forinstallation

≥ 512 MB Hard drive space required forinstalling OBS Browser+

Object Storage ServiceTool Guide (OBS Browser+) 1 Introduction

Issue 04 (2020-11-15) Copyright © Huawei Technologies Co., Ltd. 1

Item Specification Remarks

Availablespace ofthe datadrive

≥ 3 GB Hard drive space for storingdata files of the OBS Browser+database

Object Storage ServiceTool Guide (OBS Browser+) 1 Introduction


2 OBS Browser+ Function Overview

Table 2-1 lists the functions supported by OBS Browser+.

Table 2-1 OBS Browser+ supported functions

Function Description

Basic operations on buckets Creating buckets in a specified region,listing buckets, querying basic bucketinformation, configuring bucket ACLs,managing fragments in buckets,modifying bucket storage classes,deleting buckets, and others

Basic operations on objects in buckets Creating folders, uploading objects,listing objects, downloading objects,deleting objects, and more● Batch upload, download, deletion,

copy, and move of objects● Upload by dragging● Preview of objects● Scheduled upload

External bucket management Managing buckets shared by otheraccounts● Adding an external bucket to OBS

Browser+, or removing the addedbucket

● Managing objects (such as uploadand download) in external buckets

Object Storage ServiceTool Guide (OBS Browser+) 2 OBS Browser+ Function Overview


Function Description

System settings Settings of OBS Browser+ parameters● Configuring the maximum number

of concurrent tasks [0, 50]● Configuring part size [9, 5120] MB

for multipart tasks● Changing the language● Configuring network proxy

Task management Listing statuses of all tasks, pausing,deleting, running, and searching fortasks● Viewing real-time running statuses

(progress, time) of tasks● Pausing and deleting a batch of

tasks● Searching for completed and failed

tasks by types● Automatic retry of failed tasks

Account management Logging in, logging out, login withaccess keys, login with theauthorization code● Copying account information from

an earlier OBS Browser version tothe current OBS Browser+ version

● Keeping a maximum of 100accounts login information bydefault

● Clearing and querying login history

Auxiliary functions ● Favorites folder available for you tosave frequently used paths (amaximum of 100 paths by default)

● Shortcut menus available for bucketand object lists, helping you quicklyfind the desired operation

● Changing the theme color (darkblue or light blue) of OBS Browser+

Object Storage ServiceTool Guide (OBS Browser+) 2 OBS Browser+ Function Overview


3 Getting Started

3.1 Downloading OBS Browser+Table 3-1 lists the download links of OBS Browser+ for different operatingsystems.

NO TE

Before using this tool, bind a valid payment method to avoid any restriction due toinsufficient balance.

Table 3-1 List of download addresses

Supported OS Download Link

Windows x32 OBSBrowserPlus-win32

Windows x64 OBSBrowserPlus-win64

Mac OBSBrowserPlus-Mac

3.2 Installing OBS Browser+

Procedure

Step 1 Click the download link of OBS Browser+ to download the tool.

Step 2 Decompress the downloaded software package.

Step 3 Run the obs-browser-plus Setup xxx.exe file to install OBS Browser+.

Step 4 Double-click obs-browser-plus on the Start menu or the desktop shortcut to runOBS Browser+.

----End

Object Storage ServiceTool Guide (OBS Browser+) 3 Getting Started


https://obs-community-intl.obs.ap-southeast-1.myhuaweicloud.com/obsbrowserplus/win32/OBSBrowserPlus-HK-win32.zip

https://obs-community-intl.obs.ap-southeast-1.myhuaweicloud.com/obsbrowserplus/win64/OBSBrowserPlus-HK-win64.zip

https://obs-community-intl.obs.ap-southeast-1.myhuaweicloud.com/obsbrowserplus/mac/OBSBrowserPlus-HK-mac64.zip

3.3 Logging In to OBS Browser+OBS Browser+ supports AK-based login, account-based login, and authorizationcode-based login.

NO TE

If a proxy is required to access your network environment, click More > Settings >Network on the login page to set the proxy before login.

AK LoginIn AK-based login mode, access keys (AK and SK) are used for loginauthentication. You need to enter the AK and SK for login.

Figure 3-1 AK login

Table 3-2 Login parameters

Parameter Description

Account Name Account names are used todifferentiate login accounts of OBSBrowser+, which do not have to be thesame as your cloud service account.




Service Supports HUAWEI CLOUD OBS(default) and other object storageservices compatible with HUAWEICLOUD OBS.● HUAWEI CLOUD OBS (default):

Supports operations on buckets inall regions available on HUAWEICLOUD.

● If you select Other object storageservices, you need to specify theservice address, either the globaldomain name or regional domainname.

Access Key ID & Secret Access Key AK login leverages the access keyauthentication mechanism of IAM. Youcan click Obtain Access Keys on thelogin page to jump to the IAM consoleand create access keys. Moreinformation about access keys (AK andSK) is provided as follows:● An access key ID (AK) defines a

user that accesses the OBS system.An AK belongs to only one user, butone user can have multiple AKs.OBS identifies users through accesskey IDs.

● A secret access key (SK) is the keyused by users to access OBS. It isthe authentication informationgenerated based on the AK and therequest header. An SK matches anAK, and they group into a pair.

Where Can I Obtain Access Keys (AKand SK)?

Access Path You can enter a frequently used pathin the text box, so that you will bedirect to the path upon login. Example:obs://bucketName/folder01/

Remember my access keys If you select this option, the accesskeys (both AK and SK) are saved. Youdo not need to enter the access keysupon next login. To avoid accountinformation leakage, deselect thisoption on a temporary computer.



NO TE

● OBS Browser+ can keep the login information of up to 100 accounts.● If a proxy is required to access your network environment, configure the network proxy

before login.

Account LoginYou can also use your cloud account and password for login. In this login mode,you only need to enter a registered cloud account name (or an IAM user nameunder the account) and its password, relieving you from the troubles of recordingthe complex access keys.

Figure 3-2 Account login

You can use the HUAWEI CLOUD account and password or the account andpassword of another service provider to log in. For details about parametersettings, see Table 3-3 and Table 3-4.

Table 3-3 Login parameter settings for HUAWEI CLOUD accounts


Account name Name of the account registered with HUAWEICLOUD. Mobile numbers or email addresses arenot supported.

IAM user name IAM user name under a registered HUAWEI CLOUDaccount. This parameter is mandatory only whenyou choose to log in with an IAM user name.




Password ● Account: Enter the account password.● IAM user: Enter the IAM user password.

Table 3-4 Login parameter settings for other vendor accounts


IAM address Address of the IAM service address provided by thevendor.

OBS address Address of object storage service provided by thevendor. You can enter either the global domainname or regional domain name.

Account name Account name registered with the service provider.Mobile numbers or email addresses are notsupported.

IAM user name IAM user name under a valid account. Thisparameter is mandatory only when you choose tolog in with an IAM user name.

Password ● Account: Enter the account password.● IAM user: Enter the IAM user password.

Authorization Code LoginYou can also use the shared URL and access code of an OBS folder to log in to theclient and access the shared folder.

Figure 3-3 Authorization code login



Table 3-5 Login parameters


Authorization Code An authorization code can be a sharedfolder URL generated on OBS Console,obsutil, or OBS Browser+.

Access Code The six-digit code specified whengenerating the URL for sharing.

NO TE

● OBS Browser+ does not support the query or deletion of historically authorized logininformation.

● OBS Browser+ will automatically delete expired authorization codes.



4 Best Practices

1. Upload by Dragging

OBS Browser+ supports upload by dragging. You can drag one or more files orfolders from a local path to the object list of a bucket or a parallel file systemon OBS Browser+. You can even drag a file or folder directly to a specifiedfolder on OBS Browser+. This function enables you to easily upload files toOBS.

2. Folder SharingOBS Browser+ provides the folder sharing and authorization code loginfunctions, allowing you to easily share a folder with other accounts within aspecified validity period.To share a folder, log in to OBS Browser+, right-click the folder you want toshare and choose Share, or click Share in the operation column.

Object Storage ServiceTool Guide (OBS Browser+) 4 Best Practices


Then, set the validity period of the shared URL, enter an access code, andcreate the URL and the QR code.Finally, you can send the generated sharing link or QR code to others. Afterobtaining the link information, others can use the authorization code to log into OBS Browser+ and access the shared directory. Alternatively, they can scanthe QR code and enter the access code to access the shared directory.

3. Background RunningIf you have a large number of tasks running on OBS Browser+ but you wantto perform other operations outside OBS Browser+, you can close OBSBrowser+ while tasks are still running at the background. Specifically, click theicon for closing OBS Browser+ on the upper right corner, and then clickBackground Running on the Exit OBS Browser+ dialog box. All your taskswill enter the background running mode. You can double-click the OBSBrowser+ icon in the tray to display the UI later as necessary.

Object Storage ServiceTool Guide (OBS Browser+) 4 Best Practices


5 FAQs

5.1 Where Can I Obtain Access Keys (AK and SK)?When using OBS Browser+ to access OBS, you do not need to provide the accountor IAM user login information. Instead, you use the access keys (a pair of AK andSK) of the account or IAM user for authentication. Therefore, you need to obtainthe access keys in advance.

● Access key ID (AK) is a unique identifier used in conjunction with a secretaccess key (SK) to sign requests cryptographically. AK is used together with SKto obtain an encrypted signature for a request.

● SK is used in conjunction with an AK to sign requests cryptographically. Itidentifies a request sender and prevents the request from being modified.

For more information about AKs and SKs, see Access Keys (AK/SK).

Procedure

Step 1 Log in to OBS Console.

Step 2 Move the mouse pointer over the username in the upper right corner and selectMy Credentials from the drop-down list.

Step 3 In the navigation pane on the left, select Access Keys.

Step 4 Click Create Access Key.

Step 5 On the Create Access Key page, enter the login password. Enter the verificationcode sent to your email or mobile phone.

Note: For IAM users, if no email address or mobile number is specified whencreating the user, use the login password for authentication.

Step 6 Click OK to download the credential file.

Object Storage ServiceTool Guide (OBS Browser+) 5 FAQs


https://support.huaweicloud.com/intl/en-us/productdesc-obs/obs_03_0208.html

NO TE

● The web browser automatically downloads the credentials.csv file. In the file, the valueof Access Key Id is the AK, and the value of Secret Access Key is the SK.

● To prevent the access keys from being leaked, keep them secure.

----End

5.2 Can I Install Two OBS Browser+ Tools fromDifferent Sites in One System?

No. You can install only one OBS Browser+ tool in a system, because OBS Browser+ available at different site provides different functions.

5.3 What Are the Differences Between OBS Browser+and OBS Browser?

OBS Browser+ is an upgraded edition of OBS Browser, with the brand new GUIoffering optimized user experiences. In addition, OBS Browser+ provides morelogin options, better performance, and higher efficiency.

5.4 Does OBS Browser+ Support the Migration ofAccount and Task Information From OBS Browser?

OBS Browser+ can migrate only the account information kept by OBS Browser, butnot the task information. You can migrate such information only once, therefore,you are advised to stick to OBS Browser+ once you start to use it.

5.5 Why Does the Task Processing Speed Slow After theNumber of Tasks Exceeds a Million?

If the number of tasks in OBS Browser+ reaches a million or above, the system willspend more time in searching among massive amounts of tasks, which adds loadto your device. In this case, clear historical task records to improve performance.

5.6 Why Are the Displayed Number of Objects andUsed Storage Capacity Different from the ActualNumber of Objects and Storage Capacity?

The statistics displayed on OBS Browser+ are not real-time statistics, which is forreference only.



5.7 Why the Deliver Attribute in the Original SettingsIs Overwritten to False After the Bucket ACL IsConfigured Through OBS Browser+

OBS Browser+ does not inherit bucket permission settings. You can use OBS SDKsto configure bucket ACLs if you need to inherit original settings.



6 Uninstalling OBS Browser+

On the Windows Start menu, choose Control Panel > Programs > Programs andFeatures. Locate and right-click obs-browser-plus xxx, choose Uninstall, anduninstall the software as instructed.

Object Storage ServiceTool Guide (OBS Browser+) 6 Uninstalling OBS Browser+


7 Change History

ReleaseDate

What's New

2020-11-15 This is the fourth official release.● Added the account login option.● Added the function for sharing folders through QR codes.

2019-11-30 This is the third official release.This issue incorporates the following change:● Added the function of favorites.● Added the function for sharing objects and folders.● Added the authentication code login option.● Added the file preview function.● Added the function for managing parallel file systems.● Added the functions for batch copying, moving, and renaming

objects, as well as modifying object storage classes.● Added the function for managing external buckets.● Optimized the UI design.● Optimized the task management function.

2019-07-03 This is the second official release.This issue incorporates the following change:● Added the function of viewing object properties.● Added the function of copying an object URL.● Added the function of managing fragments.● Added the function of bucket ACLs.● Added the function of uploading a file by dragging.● Updated the description about completed tasks in the task

management module.

2019-06-15 This is the first official release.

Object Storage ServiceTool Guide (OBS Browser+) 7 Change History


tool guide (obs browser+)€¦ · account management logging in, logging out, login with access...

Documents