How do I install ossutil? - Object Storage Service - Alibaba Cloud Documentation Center

ossutil allows you to efficiently manage objects in Object Storage Service (OSS). For example, you can use ossutil to upload large objects, download objects, and delete objects whose names contain a specific prefix. ossutil supports the following OSs: Windows, Linux, and macOS. You need to download and install an ossutil version that suits your OS.

Versions

Latest version: 2.0.2-beta.08282000

Download ossutil

Download link	SHA-256 checksum
Linux x86 32bit	0c6955620e592daf60a19c1dda2d0b051e4d4834af2025e72b64f4782bd1b8cb
Linux x86 64bit	eceb1a74c4f024639817122af4a43febf2b1a780491f4c106c6e89472a27756f
Linux ARM 32bit	c8cf6ea4d027ed4f4c3322150d3cab85a80622bfdd15be7e025b1a68387fae88
Linux ARM 64bit	c960684e956638a1cb2475cd0e8b16c7b766d0654ebabc5f89cf5ac7f6faa446
macOS x86 64bit	207cc25bdf3f23f9c33aad8ac45a0919cc28d4ae7ff3bc2fb006f385d7169577
macOS ARM 64bit	949dc5b654be3b12d30cf4c9751b28e8f099aac476bfa6a07c499b2cbe7cdd15
Windows x86 32bit	6178f21a7e40a73ca8eb73d9bc16df89400a2be375ef94823ec622688cd60b21
Windows x86 64bit	a0241988c3b75a56e944bf37e4479ecd1c4e2ff786d5ef82d28b399384de7f91

Install ossutil

Linux

Install ossutil.
1. Download the ossutil package.
```
curl -o ossutil-2.0.2-beta.08282000-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.2-beta.08282000/ossutil-2.0.2-beta.08282000-linux-amd64.zip
```
  Note
  The command downloads ossutil for a 64-bit Linux x86 system. To download ossutil for another system, see Download ossutil.
2. Go to the directory in which the ossutil package is stored and run the following unzip command:
```
unzip ossutil-2.0.2-beta.08282000-linux-amd64.zip
```
3. Go to the directory to which the package is decompressed and run the following command:
```
chmod 755 ossutil
```
4. Execute the following command in the current directory for global invocation of ossutil.
```
sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
```
5. Execute the following command. If a version number is returned, the installation is successful.
```
ossutil version
```
Configure ossutil.
1. Execute the following command to configure ossutil:
```
ossutil config
```
2. Configure the path of the configuration file.
```
Please enter the config file name,the file name can include path(default /root/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):
```
  By default, ossutil uses ~/.ossutilconfig as the configuration file. If you specify a different configuration file, you must add the -c option to specify the configuration file every time you run a command. For example, if you save the configuration file as /home/config, add the -c option in the following format when you run the ls command:
```
ossutil ls oss://examplebucket -c /home/config
```
3. Provide configuration information such as the endpoint, AccessKey ID, and AccessKey secret from prompts. For information on creating AccessKeys and obtaining Endpoints, see Obtain an AccessKey pair and Regions and endpoints. For more configuration sets, see Configuration file settings.
Execute the following command to check whether ossutil is installed:
```
ossutil
```
If a list of ossutil commands are displayed, ossutil is installed.

Windows

Install ossutil.
1. Decompress the ossutil package.
2. Go to the directory in which the ossutil package is stored.
Configure ossutil.
1. Run the following command to configure ossutil:
```
ossutil config
```
2. Configure the path of the configuration file.
```
Please enter the config file name,the file name can include path(default "C:\Users\issuser\.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):
```
  By default, ossutil uses ~\.ossutilconfig as the configuration file. If you specify a different configuration file, you must add the -c option to specify the configuration file every time you run a command. For example, if you save the configuration file as c:\ossutil\config, add the -c option in the following format when you run the ls command:
```
ossutil ls oss://examplebucket -c c:\ossutil\config
```
3. Configure the AccessKey ID, AccessKey Secret, and Region parameters. For more information, see Configuration file settings.
Run the following command to check whether ossutil is installed:
```
ossutil
```
If a list of ossutil commands are displayed, ossutil is installed.

macOS

Install ossutil.
1. Download the ossutil package.
```
curl -o ossutil-2.0.0-beta.06261100-mac-arm64.zip https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.0-beta.06261100/ossutil-2.0.0-beta.06261100-mac-arm64.zip
```
  Note
  The command downloads ossutil for a 64-bit macOS ARM system. For more information about how to download ossutil for other operating systems, see Download ossutil.
2. Go to the directory in which the ossutil package is stored and run the following unzip command:
```
unzip ossutil-2.0.0-beta.06261100-mac-arm64.zip
```
3. Go to the directory to which the package is decompressed and run the following command:
```
chmod 755 ossutil
```
4. Remain in the directory and run the following command. If a version number is returned, the installation is successful.
```
ossutil version
```
Configure ossutil.
1. Run the following command to configure ossutil:
```
ossutil config
```
2. Configure the path of the configuration file.
```
Please enter the config file name,the file name can include path(default "/Users/user/.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands): 
```
  By default, ossutil uses ~/.ossutilconfig as the configuration file. If you specify a different configuration file, you must add the -c option to specify the configuration file every time you run a command. For example, if you save the configuration file as /home/config, add the -c option in the following format when you run the ls command:
```
ossutil ls oss://examplebucket -c /home/config
```
3. Follow the on-screen instructions to specify the display language of ossutil. Enter CH or EN. By default, ossutil is displayed in the language that is used by the OS. The configuration takes effect after you run the config command.
4. Configure parameters, such as Endpoint, and AccessKey ID, and AccessKey Secret. For more information, see Configuration file settings.
Run the following command to check whether ossutil is installed:
```
ossutil
```
If a list of ossutil commands are displayed, ossutil is installed.