You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: website/versioned_docs/version-3.10.0/getting-started/installation.md
+66-58
Original file line number
Diff line number
Diff line change
@@ -9,41 +9,33 @@ sidebar_label: Installation
9
9
## Prerequisites
10
10
11
11
- Kubernetes 1.17 or later
12
+
- A persistent volume of 20GB
13
+
-[Helm3](https://v3.helm.sh/) or [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
12
14
13
-
- A Persistent volume of 20GB
14
-
15
-
:::note
16
-
Recommend to have a Persistent volume(PV) of 20GB, You can start with 1GB for test purposes as well. This PV is used as persistent storage to store the chaos config and chaos-metrics in the Portal. By default, litmus install would use the default storage class to allocate the PV. Provide this value
15
+
:::tip
16
+
Litmus recommends you have a persistent volume (PV) of 20GB. You can start with 1GB for test purposes. This PV is used as persistent storage to store the chaos configuration and other chaos metrics in the portal. By default, the `litmus install` command uses the default storage class to allocate the PV.
17
17
:::
18
18
19
-
-[Helm3](https://v3.helm.sh/) or [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
20
-
21
19
## Installation
22
20
23
-
Users looking to use Litmus for the first time have two options available to them today. One way is to use a hosted Litmus service like [Harness Chaos Engineering SaaS](https://app.harness.io/auth/#/signin). Alternatively, users looking for some more flexibility can install Litmus into their own Kubernetes cluster.
21
+
If you are a first time Litmus user, you can install Litmus in two ways:
24
22
25
-
Users choosing the self-hosted option can refer to our Install and Configure docs for installing alternate versions and more detailed instructions.
23
+
- Use a hosted Litmus service like [Harness Chaos Engineering SaaS](https://app.harness.io/auth/#/signin). Go to [install hosted service] to know more.
Refer to the below details for Self-Hosted Litmus installation.
37
-
</TabItem>
38
-
<TabItemvalue="hosted"label="Hosted (Beta)">
39
-
<a href="https://harness.io/">Harness</a> offers a free service for community members which makes getting started with Litmus easy. Create an account to get started. Once logged in, create a new hosted control plane and connect to it via the up CLI. Litmus can be used as a hosted cloud service using <a href="https://app.harness.io/auth/#/signin">Harness Chaos Engineering SaaS</a>. Harness Chaos Engineering SaaS executes your Chaos Experiments in the cloud by managing all your Chaos Control Plane components, while the Chaos Execution Plane components exist on your Kubernetes cluster as part of an external chaos infrastructure.
40
-
<br/><br/>
41
-
To get started with Harness Chaos Engineering SaaS, visit <a href="https://developer.harness.io/docs/chaos-engineering/get-started/learn-more-free-plan">Harness Chaos Engineering SaaS</a> and register for free. You can skip the below installation steps.
42
-
</TabItem>
43
-
</Tabs>
27
+
- Install Litmus in your Kubernetes cluster. Go to [self-hosted service] to know more.
44
28
45
-
:::note
46
-
With 3.9.0 release, Cluster scope installation is deprecated. Now Namespaced mode is the only supported and standard installation mode.
29
+
If you wish to install Litmus in your Kubernetes cluster (that is, self-hosted), Install and Configure docs for installing alternate versions and more detailed instructions.
30
+
31
+
## Self-hosted service
32
+
33
+
You can install self-hosted Litmus in two ways:
34
+
- Using [Helm](#install-litmus-using-helm).
35
+
- Using [kubectl YAML spec file](#install-litmus-using-kubectl).
36
+
37
+
:::tip
38
+
With the 3.9.0 release, cluster scope installation has been deprecated. Only namespaced scope is supported and is the standard installation mode.
47
39
:::
48
40
49
41
### Install Litmus using Helm
@@ -52,30 +44,37 @@ The helm chart will install all the required service account configuration and C
52
44
53
45
The following steps will help you install Litmus ChaosCenter via helm.
> **Note:** If your Kubernetes cluster isn't local, you may want not to expose Litmus via `NodePort`. If so, remove `--set portal.frontend.service.type=NodePort` option. To connect to Litmus UI from your laptop, you can use `port-forward svc/chaos-litmus-frontend-service 9091:9091`. Then you can use your browser and open `127.0.0.1:9091`.
72
+
:::info note
73
+
- your Kubernetes cluster isn't local, you may want not to expose Litmus via `NodePort`. In that case, remove `--set portal.frontend.service.type=NodePort` option.
74
+
- To connect to Litmus UI from your laptop, you can use `port-forward svc/chaos-litmus-frontend-service 9091:9091`. And open `127.0.0.1:9091` on your browser.
75
+
:::
77
76
78
-
-Litmus helm chart depends on `bitnami/mongodb`[helm chart](https://github.com/bitnami/charts/tree/main/bitnami/mongodb), which uses a mongodb image not supported on ARM. If you want to install Litmus on an ARM-based server, please replace the default one with your custom mongodb arm image as shown below.
77
+
Litmus helm chart depends on `bitnami/mongodb`[Helm chart](https://github.com/bitnami/charts/tree/main/bitnami/mongodb), which uses a MongoDB image that is not supported on ARM. If you want to install Litmus on an ARM-based server, replace the default with your custom MongoDB ARM image as shown below.
@@ -102,22 +101,24 @@ Your release is named chaos and its installed to namespace: litmus.
102
101
Visit https://docs.litmuschaos.io to find more info.
103
102
```
104
103
105
-
> **Note:** Litmus uses Kubernetes CRDs to define chaos intent. Helm3 handles CRDs better than Helm2. Before you start running a chaos experiment, verify if Litmus is installed correctly.
104
+
:::tip
105
+
Litmus uses Kubernetes CRDs to define the chaos intent. Helm3 handles CRDs better than Helm2. Before you run a chaos experiment, verify if Litmus is installed correctly.
106
+
:::
106
107
107
-
##**Install Litmus using kubectl**
108
+
### Install Litmus using kubectl
108
109
109
-
In this method the users need to install mongo first via helm and then apply the installation manifest. Follow the instructions [here](https://github.com/litmuschaos/litmus/tree/master/chaoscenter#installation-steps-for-litmus-300-beta9).
110
+
You need to install Mongo via helm and apply the installation manifest. Go to [installation instructions for Litmus Beta](https://github.com/litmuschaos/litmus/tree/master/chaoscenter#installation-steps-for-litmus-300-beta9).
### Advanced installation (HTTPSbased and CORS rules apply)
160
+
### Advanced installation (HTTPS-based and CORS rules apply)
160
161
161
-
For advanced installation visit [here](../user-guides/chaoscenter-advanced-installation.md)
162
+
For advanced installation visit [advanced installation](../user-guides/chaoscenter-advanced-installation.md)
162
163
163
-
---
164
+
## Hosted (beta) service
165
+
166
+
[Harness](https://harness.io/) offers a free service for community members which makes getting started with Litmus easy. Create an account to get started. Once you log in, create a new hosted control plane and connect to it via the CLI.
167
+
168
+
You can use Litmus as a hosted cloud service using [Harness Chaos Engineering SaaS](https://app.harness.io/auth/#/signin). Harness Chaos Engineering SaaS executes your chaos experiments in the cloud by managing all your chaos control plane components. The chaos execution plane components exist on your Kubernetes cluster as part of an external chaos infrastructure.
164
169
165
-
## **Verify your installation**
170
+
To get started with Harness Chaos Engineering SaaS, go to [Harness developer hub](https://developer.harness.io/docs/chaos-engineering/get-started/learn-more-free-plan) and register for free.
166
171
167
-
#### **Verify if the frontend, server, and database pods are running**
172
+
##Verify your installation
168
173
174
+
- Verify if the frontend, server, and database pods are running
169
175
- Check the pods in the namespace where you installed Litmus:
170
176
171
177
```bash
@@ -205,11 +211,9 @@ For advanced installation visit [here](../user-guides/chaoscenter-advanced-insta
> **Note**: In this case, the PORT for `litmusportal-frontend-service` is `31846`. Yours will be different.
233
+
:::note
234
+
In this case, the PORT for `litmusportal-frontend-service` is `31846`. Your port will be a different one.
235
+
:::
230
236
231
-
Once you have the PORT copied in your clipboard, simply use your IP and PORT in this manner `<NODEIP>:<PORT>` to access the Litmus ChaosCenter.
237
+
Once you copy the PORT to your clipboard, use your IP and PORT in the following manner:`<NODEIP>:<PORT>` to access the Litmus ChaosCenter.
232
238
233
239
For example:
234
240
235
241
```yaml
236
242
http://172.17.0.3:31846/
237
243
```
238
244
239
-
> Where `172.17.0.3` is my NodeIP and `31846` is the frontend service PORT. If using a LoadBalancer, the only change would be to provide a `<LoadBalancerIP>:<PORT>`. [Learn more about how to access ChaosCenter with LoadBalancer](../user-guides/setup-without-ingress.md#with-loadbalancer)
245
+
> Where `172.17.0.3` is your NodeIP and `31846` is the frontend service PORT. If you are using a LoadBalancer, provide a `<LoadBalancerIP>:<PORT>`. [Learn more about how to access ChaosCenter with LoadBalancer](../user-guides/setup-without-ingress.md#with-loadbalancer)
240
246
241
-
**NOTE:** With advanced installation CORS rules are applied, once manifest is applied frontend loadbalancer IP needs to be added in the `ALLOWED_ORIGINS` environment in both auth and graphql server deployment.
247
+
:::info note
248
+
With advanced installation, CORS rules are applied. Once the manifest is applied, the frontend LoadBalancer IP needs to be added to the `ALLOWED_ORIGINS` environment in both `auth` and `graphql` server deployment.
249
+
:::
242
250
243
-
You should be able to see the Login Page of Litmus ChaosCenter. The **default credentials** are
251
+
You will see the login page of Litmus ChaosCenter. The **default credentials** are:
Copy file name to clipboardExpand all lines: website/versioned_docs/version-3.10.0/getting-started/resources.md
+9-9
Original file line number
Diff line number
Diff line change
@@ -7,11 +7,11 @@ sidebar_label: Resources
7
7
---
8
8
9
9
## ChaosCenter
10
-
ChaosCenter is a unified pane that controls all the functions provided by Litmus. It can be used for managing the entire lifecycle of the chaos experiments, including all the components within.
10
+
ChaosCenter is a unified pane that controls all the functions Litmus provides. You can use ChaosCenter to manage the entire lifecycle of the chaos experiments, including the components within.
11
11
12
-
ChaosCenter comes pre-packaged as a part of LitmusChaos installation and can be easily accessed via [Ingress](../user-guides/setup-with-ingress.md), [NodePort](../user-guides/setup-without-ingress.md#with-nodeport) or [LoadBalancer](../user-guides/setup-without-ingress.md#with-loadbalancer). Since Litmus has Cross-Cloud support, you get seamless access to the ChaosCenter irrespectively of where you deploy it.
12
+
ChaosCenter comes pre-packaged as a part of LitmusChaos installation and you can easily access it via [ingress](../user-guides/setup-with-ingress.md), [NodePort](../user-guides/setup-without-ingress.md#with-nodeport) or [LoadBalancer](../user-guides/setup-without-ingress.md#with-loadbalancer). Since Litmus has cross-cloud support, you get seamless access to the ChaosCenter regardless of where you deploy it.
13
13
14
-
ChaosCenter gives you access to a plethora of features, the major ones include:
14
+
ChaosCenter gives you a plethora of features, that include:
15
15
16
16
-**Chaos experiment creation**
17
17
- From templates, custom experiments from scratch (using ChaosHubs), from pre-created YAMLs
@@ -27,13 +27,13 @@ ChaosCenter gives you access to a plethora of features, the major ones include:
27
27
- Allowing image addition from custom image server (both public and private)
28
28
- Measure and analyze the Resilience Score of each chaos scenario
29
29
30
-
## Chaos Infrastructures
31
-
Chaos infrastructure is a service that runs in your target environment and aids Litmus in accessing and injecting chaos to your target environment. There should always be at least one or more than one chaos infrastructure connected to the ChaosCenter to execute an experiment.
30
+
## Chaos Infrastructure
31
+
Chaos infrastructure is a service that runs in your target environment and aids Litmus in accessing and injecting chaos into your target environment. To execute an experiment, you need at least one chaos infrastructure connected to the ChaosCenter.
32
32
33
-
## Types of Chaos Infrastructures
33
+
## Types of Chaos Infrastructure
34
34
35
-
In Litmus, chaos infrastructures can be classified into two types:
35
+
In Litmus, you can classify chaos infrastructure into two types:
36
36
37
-
-**Self Chaos Infrastructures:** A Chaos Infrastructure that is connected to the same cluster and namespace where the ChaosCenter is deployed. It can be used to target the workloads executing on that cluster only.
37
+
-**Self chaos infrastructure:** A chaos infrastructure that is connected to the same cluster and namespace where the ChaosCenter is deployed. You can use this to target the workloads executing on that cluster only.
38
38
39
-
-**External Chaos Infrastructures:** A Chaos Infrastructure that is connected to a remote Kubernetes cluster. ChaosCenter can be operated in a cross-cloud manner, which allows connecting multiple External Chaos Infrastructure to the same ChaosCenter with the help of the [litmusctl](../litmusctl/installation.md) CLI. Once connected you can manage, monitor, observe and induce chaos from the ChaosCenter to the respective External Chaos Infrastructures.
39
+
-**External chaos infrastructure:** A chaos infrastructure connected to a remote Kubernetes cluster. You can operate ChaosCenter in a cross-cloud manner, connecting multiple external chaos infrastructures to the same ChaosCenter with the help of the [litmusctl](../litmusctl/installation.md) CLI. Once connected you can manage, monitor, observe, and induce chaos from the ChaosCenter to the respective external chaos infrastructures.
0 commit comments