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.4-beta.10251600

Download ossutil

Download link	SHA-256 checksum
Linux x86 32bit	7b58c1c90046e00f62cfb07332aedd70caf508681cf286c8f687e99b288987e5
Linux x86 64bit	395d5bfec22e069c636a90532f41c22b266ba5b6ee7dd702fdb941f56d5e5ccc
Linux ARM 32bit	6c4b42f390fcfbc95e9faff05310ce94e4665af614823b588bc2e89fa69cc611
Linux ARM 64bit	470ba3876445e27ccf5caf0969f5454accfa2cdc5eda901b81648ca3d86b8899
macOS x86 64bit	11064c240d239a0dba1db2869bac649632c3c6f17f95c6b217885892ed9bfd6b
macOS ARM 64bit	9d2a059d2d80f80935384af2c643ec884f47312204985657cc89130ef2f54026
Windows x86 32bit	eaac11018a37c03c25ca94c2173ab4ea8d1c12ce7ff644186c17557007d0d6c4
Windows x86 64bit	6c9fe4fc78631a0c8c1528e42b87dcb23d03194848d21363c5d02461ece22f85

Install ossutil

Linux

Install ossutil.
1. Download the ossutil package.
```
curl -o ossutil-2.0.4-beta.10251600-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.4-beta.10251600/ossutil-2.0.4-beta.10251600-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 execute the following unzip command:
```
unzip ossutil-2.0.4-beta.10251600-linux-amd64.zip
```
3. Enter the ossutil-2.0.4-beta.10251600-linux-amd64 directory.
```
cd ossutil-2.0.4-beta.10251600-linux-amd64
```
4. Execute the following command in the current directory.
```
chmod 755 ossutil
```
5. Execute the following command for global invocation of ossutil.
```
sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
```
6. 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 execute a command. For example, if you save the configuration file as /home/config, add the -c option in the following format when you execute 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, endpoints and open ports. For more configuration sets, see Configuration file settings.
Execute the following command to check whether ossutil is installed and configured:
```
ossutil
```
If a list of ossutil commands are displayed, ossutil is installed and configured.

Windows

Install ossutil.
1. Click Windows x86 64bit or Windows x86 32bit to download the ossutil installation package based on the configurations of your computer.
2. Decompress the ossutil package.
3. Go to the directory in which the ossutil package is stored.
```
cd ossutil-v1.7.19-windows-amd64
```
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 "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 execute a command. For example, if you save the configuration file as c:\ossutil\config, add the -c option in the following format when you execute 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.
Execute the following command to check whether ossutil is installed and configured:
```
ossutil
```
If a list of ossutil commands are displayed, ossutil is installed and configured.

macOS

Install ossutil.
1. Download the ossutil package.
```
curl -o ossutil-2.0.4-beta.10251600-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.4-beta.10251600/ossutil-2.0.4-beta.10251600-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 execute the following unzip command:
```
unzip ossutil-2.0.4-beta.10251600-mac-arm64.zip
```
3. Enter the ossutil-2.0.4-beta.10251600-mac-arm64 directory.
```
cd ossutil-2.0.4-beta.10251600-mac-arm64
```
4. Execute the following command in the current directory.
```
chmod 755 ossutil
```
5. Execute the following command for global invocation of ossutil.
```
sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
```
6. 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 "/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 execute a command. For example, if you save the configuration file as /home/config, add the -c option in the following format when you execute 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 execute the config command.
4. Configure parameters, such as Endpoint, and AccessKey ID, and AccessKey Secret. For more information, see Configuration file settings.
Execute the following command to check whether ossutil is installed and configured:
```
ossutil
```
If a list of ossutil commands are displayed, ossutil is installed and configured.