# Aliyun Object Storage Service This guide describes how to configure [Aliyun OSS](https://intl.aliyun.com/product/oss) as Alluxio's under storage system. Object Storage Service (OSS) is a massive, secure and highly reliable cloud storage service provided by Aliyun. ## Prerequisites The Alluxio binaries must be available on the machine. In preparation for using OSS with Alluxio, follow the [OSS quick start guide](https://www.alibabacloud.com/help/doc-detail/31883.htm) to sign up for OSS and create an OSS bucket. ## Basic Setup To configure Alluxio to use OSS as under storage, you will need to modify the configuration file `conf/alluxio-site.properties`. If the file does not exist, create the configuration file from the template. ``` $ cp conf/alluxio-site.properties.template conf/alluxio-site.properties ``` Edit `conf/alluxio-site.properties` file to set the under storage address to the OSS bucket and the OSS directory you want to mount to Alluxio. For example, the under storage address can be `oss://alluxio-bucket/` if you want to mount the whole bucket to Alluxio, or `oss://alluxio-bucket/alluxio/data` if only the directory `/alluxio/data` inside the oss bucket `alluxio-bucket` is mapped to Alluxio. ``` alluxio.master.mount.table.root.ufs=oss:/// ``` Specify the Aliyun credentials for OSS access. In `conf/alluxio-site.properties`, add: ``` fs.oss.accessKeyId= fs.oss.accessKeySecret= fs.oss.endpoint= ``` `fs.oss.accessKeyId` and `fs.oss.accessKeySecret` is the [AccessKey](https://www.alibabacloud.com/help/doc-detail/29009.htm) for OSS, which are created and managed in [Aliyun AccessKey management console](https://ak-console.aliyun.com). `fs.oss.endpoint` is the internet endpoint of this bucket, which can be found in the bucket overview page with values like `oss-us-west-1.aliyuncs.com` and `oss-cn-shanghai.aliyuncs.com`. Available endpoints are listed in the [OSS Internet Endpoints documentation](https://intl.aliyun.com/help/doc-detail/31837.htm). ## Example: Running Alluxio Locally with OSS Start the Alluxio servers: ```console $ ./bin/alluxio format $ ./bin/alluxio-start.sh local ``` This will start an Alluxio master and an Alluxio worker. You can see the master UI at . Run a simple example program: ```console $ ./bin/alluxio runTests ``` Visit your OSS directory `oss:///` to verify the files and directories created by Alluxio exist. For this test, you should see files named like `//default_tests_files/BasicFile_CACHE_PROMOTE_MUST_CACHE`. Stop Alluxio by running: ```console $ ./bin/alluxio-stop.sh local ``` ## Advanced Setup ### Nested Mount An OSS location can be mounted at a nested directory in the Alluxio namespace to have unified access to multiple under storage systems. Alluxio's [Mount Command](/ee-da-en/da-2.10/operations/user-cli.md#mount) can be used for this purpose. For example, the following command mounts a directory inside an OSS bucket into Alluxio directory `/oss`: ```console $ ./bin/alluxio fs mount --option fs.oss.accessKeyId= \ --option fs.oss.accessKeySecret= \ --option fs.oss.endpoint= \ /oss oss://// ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://documentation.alluxio.io/ee-da-en/da-2.10/storage-integrations/oss.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.