This topic describes how to download and install ossutil.

Version and runtime environment

  • The current version: 1.7.0
  • Source code: ossutil
  • Runtime environment
    • Windows/Linux/Mac
    • Supported architectures: x86 (32-bit and 64-bit) and ARM (32-bit and 64-bit)

Download URLs

Installation

Download the package based on your operating system and run the corresponding binary file.
  • Install ossutil in Linux (the 64-bit Linux system is used as an example)
    1. Download the ossutil installation package.
      wget http://gosspublic.alicdn.com/ossutil/1.7.0/ossutil64                           
    2. Modify the file execution permissions.
      chmod 755 ossutil64
    3. Generate a configuration file based on the interactive processing.
      ./ossutil64 config
      Enter the name of the configuration file. The file name can contain a path. The default path is /home/user/.ossutilconfig. If you press Enter without specifying a different destination, the file is generated in the default path. If you want to generate the file in another path, set the --config-file option to the path. 
      If you do not specify the path of the configuration file, the default path is used. The default path is /home/user/.ossutilconfig. 
      The following parameters are ignored if you press Enter without configuring them. To obtain more information about the parameters, run the help config command.
      Enter the language: CH or EN. The default language is CH. This parameter takes effect after the config command is run. 
      Enter the endpoint: http://oss-cn-shenzhen.aliyuncs.com 
      Enter the AccessKey ID: yourAccessKeyID 
      Enter the AccessKey secret: yourAccessKeySecret
      Enter the STS token: 
      • endpoint: specifies the domain name of the region to which the bucket belongs. For more information, see Regions and endpoints. You can also add http:// or https:// to specify the protocol that ossutil uses to access OSS. The default protocol is HTTP.
      • accessKeyID: For more information about how to view the AccessKey ID, see Create an AccessKey pair.
      • accessKeySecret: For more information about how to view the AccessKey secret, see Create an AccessKey pair.
      • stsToken: This option is required only when you use a temporary STS token to access OSS buckets. Otherwise, you can leave this parameter empty. For more information about how to generate an STS token, see Authorized third-party upload.
      Note For more information about the configuration file, see config.
  • Install ossutil in Windows (the 64-bit Windows system is used as an example)
    1. Download the ossutil installation package.
    2. Decompress the package to a specified folder. Double-click and run theossutil.bat file.
    3. Generate the configuration file. For more information about the parameters, see the configuration parameters described in the preceding Linux section.
      D:\ossutil>ossutil64.exe config
  • Install ossutil in macOS (the 64-bit macOS system is used as an example)
    1. Download the ossutil installation package.
      curl -o ossutilmac64 http://gosspublic.alicdn.com/ossutil/1.7.0/ossutilmac64
    2. Modify the file execution permissions.
      chmod 755 ossutilmac64
    3. Generate the configuration file. For more information about the parameters, see the configuration parameters described in the preceding Linux section.
      ./ossutilmac64 config