Deploy AIStor on macOS

This section documents steps for installing and managing AIStor Server on macOS™ host machines.

1. Install AIStor Server onto the macOS host

   The easiest way to install AIStor Server on macOS is using Homebrew.

   Alternatively, AIStor provides binaries for M-series processors (ARM64) and older Intel-based processors (AMD64). Download the binary, set it as executable, and copy it to a location in your $PATH such as /usr/local/bin

   Homebrew

   brew install minio/aistor/minio
   

   M-Series ARM64

   curl --progress-bar -L https://dl.min.io/aistor/minio/release/darwin-arm64/minio -o minio
   chmod +x ./minio
   mv ./minio /usr/local/bin #may require sudo permissions
   
   minio --version
   

   Intel AMD64

   curl --progress-bar -L https://dl.min.io/aistor/minio/release/darwin-amd64/minio -o minio
   chmod +x ./minio
   mv ./minio /usr/local/bin #may require sudo permissions
   
   minio --version
   

2. Retrieve your License File.

   Log in to SUBNET and select the License button in the Deployments view.

   

   Download this file as minio.license onto your local host machine, such as ~/minio/minio.license

3. Run the Server

   The following command runs the server against the /tmp/minio directory. Specify your preferred folder, drive, or volume path for use with the server:

   minio server /tmp/minio --license ~/minio/minio.license
   

   The output resembles the following:

   MinIO Enterprise Object Store
   API: http://192.168.86.35:9000  http://127.0.0.1:9000 
      RootUser: minioadmin 
      RootPass: minioadmin 
   
   WebUI: http://192.168.86.35:9001 http://127.0.0.1:9001         
      RootUser: minioadmin 
      RootPass: minioadmin 
   
   CLI: https://min.io/docs/aistor-custom/object-store/reference/minio-mc.html#quickstart
      $ mc alias set 'myminio' 'http://192.168.86.35:9000' 'minioadmin' 'minioadmin'
   
   Docs: https://min.io/docs/aistor-custom/object-store
   WARN: Detected default credentials 'minioadmin:minioadmin', we recommend that you change these values with 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD' environment variables
   

4. Connect to the Deployment

   You can connect to the deployment using the built-in AIStor Server console in a browser, by using the MinIO mc commandline tool, or by using an S3-compatible SDK:

   AIStor Console

   Open your browser to the hostname and port of any node in the deployment. The WebUI output from the previous step indicates which hostnames and ports the minio process listens on.

   Log in using the default minioadmin:minioadmin username and password.

   CLI

   1. Download the mc tool to your local host machine:

      The mv command may require sudo permissions.

      Homebrew

      brew install minio/aistor/mc
      

      Intel AMD64

      curl --progress-bar -L https://dl.min.io/aistor/mc/release/darwin-amd64/mc -o mc
      chmod +x ./mc
      mv ./mc /usr/local/bin/
      mc --version
      

      M-Series ARM64

      curl --progress-bar -L https://dl.min.io/aistor/mc/release/darwin-arm64/mc -o mc
      chmod +x ./mc
      mv ./mc /usr/local/bin
      mc --version
      

   2. Create a new alias for the AIStor server:

      mc alias set myminio http://localhost:9000
      

   3. Create a bucket and copy a file to that bucket:

      mc mb myminio/data
      mc cp ~/somefile.txt myminio/data