mirror of
https://github.com/minio/docs.git
synced 2025-07-30 07:03:26 +03:00
Attempting to reduce docs to single platform
This commit is contained in:
Ravind Kumar
@ -1,77 +0,0 @@
|
||||
.. start-install-minio-binary-desc
|
||||
|
||||
.. tab-set::
|
||||
|
||||
.. tab-item:: Homebrew
|
||||
|
||||
Open a Terminal and run the following command to install the latest stable MinIO package using `Homebrew <https://brew.sh>`_.
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
brew install minio/stable/minio
|
||||
|
||||
.. important::
|
||||
|
||||
If you previously installed the MinIO server using ``brew install minio``, then we recommend that you reinstall from ``minio/stable/minio`` instead.
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
brew uninstall minio
|
||||
brew install minio/stable/minio
|
||||
|
||||
.. tab-item:: Binary - arm64
|
||||
|
||||
Open a Terminal, then use the following commands to download the latest stable MinIO binary, set it to executable, and install it to the system ``$PATH``:
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
curl -O https://dl.min.io/server/minio/release/darwin-arm64/minio
|
||||
chmod +x ./minio
|
||||
sudo mv ./minio /usr/local/bin/
|
||||
|
||||
.. tab-item:: Binary - amd64
|
||||
|
||||
Open a Terminal, then use the following commands to download the latest stable MinIO binary, set it to executable, and install it to the system ``$PATH``:
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
curl -O https://dl.min.io/server/minio/release/darwin-amd64/minio
|
||||
chmod +x ./minio
|
||||
sudo mv ./minio /usr/local/bin/
|
||||
|
||||
.. end-install-minio-binary-desc
|
||||
|
||||
.. start-run-minio-binary-desc
|
||||
|
||||
From the Terminal, use the :mc:`minio server` to start a local MinIO instance in the ``~/data`` folder.
|
||||
If desired, you can replace ``~/data`` with another location to which the user has read, write, and delete access for the MinIO instance.
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
export MINIO_CONFIG_ENV_FILE=/etc/default/minio
|
||||
minio server --console-address :9001
|
||||
|
||||
.. code-block:: shell
|
||||
|
||||
Status: 1 Online, 0 Offline.
|
||||
API: http://192.168.2.100:9000 http://127.0.0.1:9000
|
||||
RootUser: myminioadmin
|
||||
RootPass: minio-secret-key-change-me
|
||||
Console: http://192.168.2.100:9001 http://127.0.0.1:9001
|
||||
RootUser: myminioadmin
|
||||
RootPass: minio-secret-key-change-me
|
||||
|
||||
Command-line: https://min.io/docs/minio/linux/reference/minio-mc.html
|
||||
$ mc alias set myminio http://10.0.2.100:9000 myminioadmin minio-secret-key-change-me
|
||||
|
||||
Documentation: https://min.io/docs/minio/linux/index.html
|
||||
|
||||
The ``API`` block lists the network interfaces and port on which clients can access the MinIO S3 API.
|
||||
The ``Console`` block lists the network interfaces and port on which clients can access the MinIO Web Console.
|
||||
|
||||
.. end-run-minio-binary-desc
|
||||
@ -1,34 +0,0 @@
|
||||
1) Download the MinIO Server
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
.. include:: /includes/macos/common-installation.rst
|
||||
:start-after: start-install-minio-binary-desc
|
||||
:end-before: end-install-minio-binary-desc
|
||||
|
||||
2) Create the Environment Variable File
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
.. include:: /includes/common/common-deploy.rst
|
||||
:start-after: start-common-deploy-create-environment-file-multi-drive
|
||||
:end-before: end-common-deploy-create-environment-file-multi-drive
|
||||
|
||||
.. include:: /includes/common/common-deploy.rst
|
||||
:start-after: start-common-deploy-create-unique-root-credentials
|
||||
:end-before: end-common-deploy-create-unique-root-credentials
|
||||
|
||||
3) Start the MinIO Deployment
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Issue the following command on the local host to start the MinIO |SNSD| deployment as a foreground process.
|
||||
You must keep the shell or terminal session open to keep the process running.
|
||||
|
||||
.. include:: /includes/macos/common-installation.rst
|
||||
:start-after: start-run-minio-binary-desc
|
||||
:end-before: end-run-minio-binary-desc
|
||||
|
||||
4) Connect to the MinIO Deployment
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
.. include:: /includes/common/common-deploy.rst
|
||||
:start-after: start-common-deploy-connect-to-minio-deployment
|
||||
:end-before: end-common-deploy-connect-to-minio-deployment
|
||||
@ -1,34 +0,0 @@
|
||||
1) Download the MinIO Server
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
.. include:: /includes/macos/common-installation.rst
|
||||
:start-after: start-install-minio-binary-desc
|
||||
:end-before: end-install-minio-binary-desc
|
||||
|
||||
2) Create the Environment Variable File
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
.. include:: /includes/common/common-deploy.rst
|
||||
:start-after: start-common-deploy-create-environment-file-single-drive
|
||||
:end-before: end-common-deploy-create-environment-file-single-drive
|
||||
|
||||
.. include:: /includes/common/common-deploy.rst
|
||||
:start-after: start-common-deploy-create-unique-root-credentials
|
||||
:end-before: end-common-deploy-create-unique-root-credentials
|
||||
|
||||
3) Start the MinIO Deployment
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Issue the following command on the local host to start the MinIO |SNSD| deployment as a foreground process.
|
||||
You must keep the shell or terminal session open to keep the process running.
|
||||
|
||||
.. include:: /includes/macos/common-installation.rst
|
||||
:start-after: start-run-minio-binary-desc
|
||||
:end-before: end-run-minio-binary-desc
|
||||
|
||||
4) Connect to the MinIO Deployment
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
.. include:: /includes/common/common-deploy.rst
|
||||
:start-after: start-common-deploy-connect-to-minio-deployment
|
||||
:end-before: end-common-deploy-connect-to-minio-deployment
|
||||
@ -1,78 +0,0 @@
|
||||
MinIO uses an update-then-restart methodology for upgrading a deployment to a newer release:
|
||||
|
||||
1. Update the MinIO binary with the newer release.
|
||||
2. Restart the deployment using :mc-cmd:`mc admin service restart`.
|
||||
|
||||
This procedure does not require taking downtime and is non-disruptive to ongoing operations.
|
||||
|
||||
This page documents methods for upgrading using the update-then-restart method for both ``systemctl`` and user-managed MinIO deployments.
|
||||
Deployments using Ansible, Terraform, or other management tools can use the procedures here as guidance for implementation within the existing automation framework.
|
||||
|
||||
Considerations
|
||||
--------------
|
||||
|
||||
Upgrades Are Non-Disruptive
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
MinIO's upgrade-then-restart procedure does *not* require taking downtime or scheduling a maintenance period.
|
||||
MinIO restarts are fast, such that restarting all server processes in parallel typically completes in a few seconds.
|
||||
MinIO operations are atomic and strictly consistent, such that applications using MinIO or S3 SDKs can rely on the built-in :aws-docs:`transparent retry <general/latest/gr/api-retries.html>` without further client-side logic.
|
||||
This ensures upgrades are non-disruptive to ongoing operations.
|
||||
|
||||
"Rolling" or serial "one-at-a-time" upgrade methods do not provide any advantage over the recommended "parallel" procedure, and can introduce unnecessary complexity to the upgrade procedure.
|
||||
For virtualized environments which *require* rolling updates, you should modify the recommended procedure as follows:
|
||||
|
||||
1. Update the MinIO Binary in the virtual machine or container one at a time.
|
||||
2. Restart the MinIO deployment using :mc-cmd:`mc admin service restart`.
|
||||
3. Update the virtual machine/container configuration to use the matching newer MinIO image.
|
||||
4. Perform the rolling restart of each machine/container with the updated image.
|
||||
|
||||
Check Release Notes
|
||||
~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
MinIO publishes :minio-git:`Release Notes <minio/releases>` for your reference as part of identifying the changes applied in each release.
|
||||
Review the associated release notes between your current MinIO version and the newer release so you have a complete view of any changes.
|
||||
|
||||
Pay particular attention to any releases that are *not* backwards compatible.
|
||||
You cannot trivially downgrade from any such release.
|
||||
|
||||
Update Using Homebrew
|
||||
---------------------
|
||||
|
||||
For Homebrew installations, you can use homebrew to update the cask:
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
brew upgrade minio/stable/minio
|
||||
|
||||
Restart the MinIO process to complete the update.
|
||||
|
||||
Update using Binary Replacement
|
||||
-------------------------------
|
||||
|
||||
.. tab-set::
|
||||
|
||||
.. tab-item:: Binary - arm64
|
||||
|
||||
Open a Terminal, then use the following commands to download the latest stable MinIO binary, set it to executable, and install it to the system ``$PATH``:
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
curl -O https://dl.min.io/server/minio/release/darwin-arm64/minio
|
||||
chmod +x ./minio
|
||||
sudo mv ./minio /usr/local/bin/
|
||||
|
||||
.. tab-item:: Binary - amd64
|
||||
|
||||
Open a Terminal, then use the following commands to download the latest stable MinIO binary, set it to executable, and install it to the system ``$PATH``:
|
||||
|
||||
.. code-block:: shell
|
||||
:class: copyable
|
||||
|
||||
curl -O https://dl.min.io/server/minio/release/darwin-amd64/minio
|
||||
chmod +x ./minio
|
||||
sudo mv ./minio /usr/local/bin/
|
||||
|
||||
Restart the MinIO process to complete the update.
|
||||
Reference in New Issue
Block a user