Downloading and Installing obsutil

Download Links

Table 1 lists the download links of obsutil for different OSs.

**Table 1** Download links of obsutil
OS	Download Link	How to Use	View Help
Windows (64-bit)	obsutil_windows64 obsutil_windows64_sha256	After the download completes, refer to Quick Start to quickly get started with obsutil. Basic functions Listing Buckets Uploading an Object Listing Objects	Use the help command to get familiar with more functions of obsutil.
Linux AMD (64-bit)	obsutil_linux_amd64 obsutil_linux_amd64_sha256
Linux ARM (64-bit)	obsutil_linux_arm64 obsutil_linux_arm64_sha256
macOS (64-bit)	obsutil_mac64 obsutil_mac64_sha256

For details about the version revision records of obsutil, see ChangeLog. The download address with sha256 contained indicates the verification file of a software package. For example, if the address for downloading the software package for Windows x64 is obsutil_windows64, the address for downloading the package's verification file is obsutil_windows64_sha256.

Quick Installation

Methods of downloading obsutil vary depending on the OS type. For details, see the following:

The following operations require that the ECS be connected to the Internet, or the obsutil installation will fail.

In Windows
1. Open the required download link given in the table above in a browser to download obsutil to your local PC.
2. Decompress the downloaded package to a specified folder.
3. Double-click obsutil.exe to start using obsutil.
  
  Alternatively, you can open the CLI to go to the upper-level directory of obsutil.exe and run obsutil commands. The command line structures of the two modes are different. For details, see Command Line Structure.
In Linux
1. Open the CLI and run the wget command to download obsutil.
```
wget https://obs-community-intl.obs.ap-southeast-1.myhuaweicloud.com/obsutil/current/obsutil_linux_amd64.tar.gz
```
  You can also download the obsutil package from a PC running the Windows operating system and then use a cross-platform transfer tool (such as WinSCP) to transfer the package to your host running the Linux operating system.
2. Run the following command in the directory where the tool package resides:
```
tar -xzvf obsutil_linux_amd64.tar.gz
```
3. Go to the directory where obsutil resides and run the following command to grant the execute permission on obsutil:
```
chmod 755 obsutil
```
  You must grant the execute permission on obsutil, or error "No such file or directory" will be reported during a query of the obsutil version number.
4. Continue to run the following command in the directory. If the version number of obsutil is returned, the installation is successful.
```
./obsutil version
```
In macOS
1. Open the required download link given in the table above in a browser to download obsutil to your local PC.
2. Decompress the downloaded package to a specified folder.
3. Open the CLI, go to the directory where obsutil resides, and run the following command to grant the execute permission to obsutil:
```
chmod 755 obsutil
```

If you need to use obsutil on a Huawei Cloud ECS, you can configure to access OBS using obsutil over an intranet to reduce costs on traffic.
To improve the usability of obsutil, you can set obsutil commands as built-in commands by running the shell or batch script in the software package. This way, obsutil commands can be run in any directory. For details, see Setting obsutil Commands as Built-in Commands.

Previous topic: Introduction to obsutil

Next topic: Getting Started