diff --git a/README.md b/README.md index d8c83af..710a9c9 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,12 @@ description: 'The native NVMe-oF CAS engine of OpenEBS' # Welcome to Mayastor! +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## What is Mayastor? **Mayastor** is a performance optimised "Container Attached Storage" (CAS) solution of the CNCF project [**OpenEBS**](https://openebs.io/). The goal of OpenEBS is to extend Kubernetes with a declarative data plane, providing flexible persistent storage for stateful applications. @@ -29,7 +35,3 @@ Mayastor's source code and documentation are distributed amongst a number of Git - [openebs/mayastor-api](https://github.com/openebs/mayastor-api) : contains common protocol buffer definitions and OpenAPI specifications for Mayastor components - [openebs/mayastor-dependencies](https://github.com/openebs/mayastor-dependencies) : contains dependencies common to the control and data plane repositories - [openebs/mayastor-docs](https://github.com/openebs/mayastor-docs) : contains Mayastor's user documenation - - - - diff --git a/quickstart/configure-mayastor.md b/quickstart/configure-mayastor.md index 1d31d19..5b74dd0 100644 --- a/quickstart/configure-mayastor.md +++ b/quickstart/configure-mayastor.md @@ -1,7 +1,12 @@ # Configure Mayastor -## Create Mayastor Pool\(s\) +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} +## Create Mayastor Pool\(s\) ### What is a Mayastor Pool? diff --git a/quickstart/deploy-a-test-application.md b/quickstart/deploy-a-test-application.md index fe9f703..6f898c4 100644 --- a/quickstart/deploy-a-test-application.md +++ b/quickstart/deploy-a-test-application.md @@ -1,5 +1,11 @@ # Deploy a Test Application +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Objective If all verification steps in the preceding stages were satisfied, then Mayastor has been successfully deployed within the cluster. In order to verify basic functionality, we will now dynamically provision a Persistent Volume based on a Mayastor StorageClass, mount that volume within a small test pod which we'll create, and use the [**Flexible I/O Tester**](https://github.com/axboe/fio) utility within that pod to check that I/O to the volume is processed correctly. diff --git a/quickstart/deploy-mayastor.md b/quickstart/deploy-mayastor.md index bc4a078..2757e13 100644 --- a/quickstart/deploy-mayastor.md +++ b/quickstart/deploy-mayastor.md @@ -1,5 +1,11 @@ # Deploy Mayastor +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Overview {% hint style="note" %} diff --git a/quickstart/faqs.md b/quickstart/faqs.md index c58c4cf..0f610ad 100644 --- a/quickstart/faqs.md +++ b/quickstart/faqs.md @@ -1,5 +1,11 @@ # FAQs +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## How does it help to keep my data safe? Mayastor's storage engine supports synchronous mirroring to enhance the durability of data at rest within whatever physical persistence layer is in use. When volumes are provisioned which are configured for replication \(a user can control the count of active replicas which should be maintained, on a per StorageClass basis\), write I/O operations issued by an application to that volume are amplified by its controller ("nexus") and dispatched to all its active replicas. Only if every replica completes the write successfully on its own underlying block device will the I/O completion be acknowledged to the controller. Otherwise, the I/O is failed and the caller must make its own decision as to whether it should be retried. If a replica is determined to have faulted \(I/O cannot be serviced within the configured timeout period, or not without error\), the control plane will automatically take corrective action and remove it from the volume. If spare capacity is available within a Mayastor pool, a new replica will be created as a replacement and automatically brought into synchronisation with the existing replicas. The data path for a replicated volume is described in more detail [here](https://github.com/openebs/mayastor-docs/blob/master/reference/i-o-path-description.md#replicated-volume-io-path) diff --git a/quickstart/known-issues.md b/quickstart/known-issues.md index e8a11a9..16f707b 100644 --- a/quickstart/known-issues.md +++ b/quickstart/known-issues.md @@ -1,5 +1,11 @@ # Known Issues +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Installation Issues ### A Mayastor pod restarts unexpectedly with exit code 132 whilst mounting a PVC diff --git a/quickstart/known-limitations.md b/quickstart/known-limitations.md index a468607..53ac0c5 100644 --- a/quickstart/known-limitations.md +++ b/quickstart/known-limitations.md @@ -1,5 +1,11 @@ # Known Limitations +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Volume and Pool Capacity Expansion Once provisioned, neither Mayastor Disk Pools nor Mayastor Volumes can be re-sized. A Mayastor Pool can have only a single block device as a member. Mayastor Volumes are exclusively thick-provisioned. diff --git a/quickstart/performance-tips.md b/quickstart/performance-tips.md index fda7aef..1ebe0af 100644 --- a/quickstart/performance-tips.md +++ b/quickstart/performance-tips.md @@ -1,5 +1,11 @@ # Performance Tips +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## CPU isolation Mayastor will fully utilize each CPU core that it was configured to run on. It will spawn a thread on each and the thread will run in an endless loop serving tasks dispatched to it without sleeping or blocking. There are also other Mayastor threads that are not bound to the CPU and those are allowed to block and sleep. However, the bound threads \(also called reactors\) rely on being interrupted by the kernel and other userspace processes as little as possible. Otherwise, the latency of IO may suffer. @@ -107,3 +113,7 @@ Edit the `mayastor-daemonset.yaml` file and set the `-l` parameter of mayastor t - "-l3,4" ``` +<<<<<<< HEAD +======= +In the above command, `io_engine.coreList={3,4}` specifies that Mayastor's reactors should operate on the third and fourth CPU cores. +>>>>>>> ef5f92a (docs: added EOL info panel (#216)) diff --git a/quickstart/preparing-the-cluster.md b/quickstart/preparing-the-cluster.md index 601c99b..57ecc57 100644 --- a/quickstart/preparing-the-cluster.md +++ b/quickstart/preparing-the-cluster.md @@ -1,5 +1,11 @@ # Preparing the Cluster +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Configure Mayastor Nodes In the context of the Mayastor application, a "Mayastor Node" \(MSN\) is a Kubernetes worker node on which is scheduled an instance of a Mayastor data plane pod and which is thus capable of hosting storage "pools" and exporting Persistent Volumes \(PV\) to application pods within the cluster. A MSN makes use of block storage device\(s\) attached to it to contribute storage capacity to its pool\(s\), which supply backing storage for the Persistent Volumes dynamically-provisioned on the cluster by Mayastor. diff --git a/quickstart/prerequisites.md b/quickstart/prerequisites.md index 61caa9d..8927ee9 100644 --- a/quickstart/prerequisites.md +++ b/quickstart/prerequisites.md @@ -1,5 +1,11 @@ # Prerequisites +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## **General** All worker nodes must satisfy the following requirements: diff --git a/quickstart/scope.md b/quickstart/scope.md index 9673500..b090b09 100644 --- a/quickstart/scope.md +++ b/quickstart/scope.md @@ -1,5 +1,11 @@ # Scope +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + This quickstart guide describes the actions necessary to perform a basic installation of Mayastor on an existing Kubernetes cluster, sufficient for evaluation purposes. It assumes that the target cluster will pull the Mayastor container images directly from OpenEBS public container repositories. Where preferred, it is also possible to [build Mayastor locally from source](https://github.com/openebs/Mayastor/blob/develop/doc/build.md) and deploy the resultant images but this is outside of the scope of this guide. Deploying and operating Mayastor in production contexts requires a foundational knowledge of Mayastor internals and best practices, found elsewhere within this documentation. diff --git a/quickstart/tips-and-tricks.md b/quickstart/tips-and-tricks.md index 7ae8241..239e9fb 100644 --- a/quickstart/tips-and-tricks.md +++ b/quickstart/tips-and-tricks.md @@ -1,5 +1,11 @@ # Tips and Tricks +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## What if I have no Disk Devices available that I can use for testing? For basic test and evaluation purposes it may not always be practical or possible to allocate physical disk devices on a cluster to Mayastor for use within its pools. As a convenience, Mayastor supports two disk device type emulations for this purpose: diff --git a/quickstart/troubleshooting.md b/quickstart/troubleshooting.md index a68baa4..abc00fc 100644 --- a/quickstart/troubleshooting.md +++ b/quickstart/troubleshooting.md @@ -1,5 +1,11 @@ # Basic Troubleshooting +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Logs The correct set of log file to collect depends on the nature of the problem. If unsure, then it is best to collect log files for all Mayastor containers. In nearly every case, the logs of all of the control plane component pods will be needed; diff --git a/reference/i-o-path-description.md b/reference/i-o-path-description.md index 93b5795..b10483b 100644 --- a/reference/i-o-path-description.md +++ b/reference/i-o-path-description.md @@ -7,6 +7,12 @@ description: >- # I/O Path Description +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Glossary of Terms ### Mayastor Instance diff --git a/reference/kubectl-plugin.md b/reference/kubectl-plugin.md index 957d78c..33b1317 100644 --- a/reference/kubectl-plugin.md +++ b/reference/kubectl-plugin.md @@ -1,5 +1,11 @@ # Mayastor kubectl plugin +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + The ‘Mayastor kubectl plugin’ can be used to view and manage Mayastor resources such as nodes, pools and volumes. It is also used for operations such as scaling the replica count of volumes. ### Prerequisites diff --git a/reference/replica-operations.md b/reference/replica-operations.md index b33a60a..bf98f20 100644 --- a/reference/replica-operations.md +++ b/reference/replica-operations.md @@ -1,5 +1,11 @@ # Replica Operations +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## Basics When a Mayastor volume is provisioned based on a StorageClass which has a replication factor greater than one \(set by its `repl` parameter)\, the control plane will attempt to maintain through a 'Kubernetes-like' reconciliation loop that number of identical copies of the volume's data "replicas" (a replica is a nexus target "child"\) at any point in time. When a volume is first provisioned the control plane will attempt to create the required number of replicas, whilst adhering to its internal heuristics for their location within the cluster \(which will be discussed shortly\). If it succeeds, the volume will become available and will bind with the PVC. If the control plane cannot identify a sufficient number of eligble Mayastor Pools in which to create required replicas at the time of provisioning, the operation will fail; the Mayastor Volume will not be created and the associated PVC will not be bound. Kubernetes will periodically re-try the volume creation and if at any time the appropriate number of pools can be selected, the volume provisioning should succeed. diff --git a/reference/storage-class-parameters.md b/reference/storage-class-parameters.md index 0c38438..a73486d 100644 --- a/reference/storage-class-parameters.md +++ b/reference/storage-class-parameters.md @@ -1,5 +1,11 @@ # Storage class parameters +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + Storage class resource in Kubernetes is used to supply parameters to volumes when they are created. It is a convenient way of grouping volumes with common characteristics. All parameters take a string value. Brief explanation of each supported Mayastor parameter follows. ## "fsType" diff --git a/reference/tested-third-party-software.md b/reference/tested-third-party-software.md index 775c8b3..ee9a165 100644 --- a/reference/tested-third-party-software.md +++ b/reference/tested-third-party-software.md @@ -1,5 +1,11 @@ # Tested Third Party Software +{% hint style="danger" %} +This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit [OpenEBS Documentation](https://openebs.io/docs/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-installation) for the latest Mayastor documentation (v2.6 and above). + +Mayastor is now also referred to as OpenEBS Replicated PV Mayastor. +{% endhint %} + ## **Cluster Node OS** ## Linux