Skip to content

Commit 9e7d821

Browse files
committed
1 parent 6c83e19 commit 9e7d821

File tree

1 file changed

+105
-105
lines changed

1 file changed

+105
-105
lines changed

install/install_connected.md

Lines changed: 105 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -23,185 +23,185 @@ You must meet the following requirements before you install Red Hat Advanced Clu
2323

2424
1. Create a namespace where the operator requirements are contained:
2525

26-
```
27-
oc create namespace <namespace>
28-
```
26+
```
27+
oc create namespace <namespace>
28+
```
2929

30-
Replace _namespace_ with a name for your namespace.
30+
Replace _namespace_ with a name for your namespace.
3131

32-
**Important:** The Red Hat Advanced Cluster Management operator must be installed in its own namespace. A `ServiceAccount` with a `ClusterRoleBinding` automatically gives cluster administrator privileges to Red Hat Advanced Cluster Management and to any ID with access to the namespace. For security, make sure that anyone who is given access to this namespace already has cluster-administrator access.
32+
**Important:** The Red Hat Advanced Cluster Management operator must be installed in its own namespace. A `ServiceAccount` with a `ClusterRoleBinding` automatically gives cluster administrator privileges to Red Hat Advanced Cluster Management and to any ID with access to the namespace. For security, make sure that anyone who is given access to this namespace already has cluster-administrator access.
3333

3434
2. Switch your project namespace to the one that you created:
3535

36-
```
37-
oc project <namespace>
38-
```
39-
Replace _namespace_ with the name of the namespace that you created in step 1.
36+
```
37+
oc project <namespace>
38+
```
39+
Replace _namespace_ with the name of the namespace that you created in step 1.
4040

4141
3. Create an operator group. Each namespace can have only one operator group.
4242

43-
1. Create a `.yaml` file that defines the operator group. Your file should look similar to the following example:
44-
45-
```
46-
apiVersion: operators.coreos.com/v1
47-
kind: OperatorGroup
48-
metadata:
49-
name: <default>
50-
spec:
51-
targetNamespaces:
52-
- <namespace>
53-
```
54-
55-
Replace _default_ with the name of your operator group.
56-
Replace _namespace_ with the name of your project namespace.
43+
1. Create a `.yaml` file that defines the operator group. Your file should look similar to the following example:
44+
45+
```
46+
apiVersion: operators.coreos.com/v1
47+
kind: OperatorGroup
48+
metadata:
49+
name: <default>
50+
spec:
51+
targetNamespaces:
52+
- <namespace>
53+
```
54+
55+
Replace _default_ with the name of your operator group.
56+
Replace _namespace_ with the name of your project namespace.
5757
5858
2. Apply the file that you created to define the operator group:
5959
60-
```
61-
oc apply -f local/<operator-group>.yaml
62-
```
63-
Replace _operator-group_ with the name of the operator group `.yaml` file that you created.
60+
```
61+
oc apply -f local/<operator-group>.yaml
62+
```
63+
Replace _operator-group_ with the name of the operator group `.yaml` file that you created.
6464
6565
4. Apply the subscription.
6666
67-
1. Create a `.yaml` file that defines the subscription. Your file should look similar to the following example:
68-
69-
```
70-
apiVersion: operators.coreos.com/v1alpha1
71-
kind: Subscription
72-
metadata:
73-
name: acm-operator-subscription
74-
spec:
75-
sourceNamespace: openshift-marketplace
76-
source: redhat-operators
77-
channel: release-1.0
78-
installPlanApproval: Automatic
79-
name: advanced-cluster-management
80-
```
67+
1. Create a `.yaml` file that defines the subscription. Your file should look similar to the following example:
68+
69+
```
70+
apiVersion: operators.coreos.com/v1alpha1
71+
kind: Subscription
72+
metadata:
73+
name: acm-operator-subscription
74+
spec:
75+
sourceNamespace: openshift-marketplace
76+
source: redhat-operators
77+
channel: release-1.0
78+
installPlanApproval: Automatic
79+
name: advanced-cluster-management
80+
```
8181
8282
2. Apply the subscription:
8383
84-
```
85-
oc apply -f local/<subscription>.yaml
86-
```
84+
```
85+
oc apply -f local/<subscription>.yaml
86+
```
8787
8888
5. Generate a pull secret to access the entitled content from the distribution registry. **Important:** Pull secrets are namespace-specific, so make sure that you are in the namespace that you created in step 1.
8989
90-
```
91-
oc create secret docker-registry <secret> --docker-server=registry.access.redhat.com/rhacm1-tech-preview --docker-username=<docker_username> --docker-password=<docker_password>
92-
```
93-
Replace _secret_ with the name of the secret that you created.
94-
Replace _docker_username_ with your username for the distribution registry that you identified as the `docker-server`.
95-
Replace _docker_password_ with your password or token for the distribution registry that you identified as the `docker-server`.
90+
```
91+
oc create secret docker-registry <secret> --docker-server=registry.access.redhat.com/rhacm1-tech-preview --docker-username=<docker_username> --docker-password=<docker_password>
92+
```
93+
Replace _secret_ with the name of the secret that you created.
94+
Replace _docker_username_ with your username for the distribution registry that you identified as the `docker-server`.
95+
Replace _docker_password_ with your password or token for the distribution registry that you identified as the `docker-server`.
9696
9797
6. Create the MultiClusterHub custom resource by creating a `.yaml` file that defines the custom resource. Your file should look similar to the following example:
9898
99-
```
100-
apiVersion: operators.open-cluster-management.io/v1beta1
101-
kind: MultiClusterHub
102-
metadata:
103-
name: multiclusterhub
104-
namespace: <namespace>
105-
spec:
106-
imagePullSecret: <secret>
107-
```
99+
```
100+
apiVersion: operators.open-cluster-management.io/v1beta1
101+
kind: MultiClusterHub
102+
metadata:
103+
name: multiclusterhub
104+
namespace: <namespace>
105+
spec:
106+
imagePullSecret: <secret>
107+
```
108108
109-
Replace _namespace_ with your project namespace.
110-
Replace _secret_ with the name of the secret that you created.
109+
Replace _namespace_ with your project namespace.
110+
Replace _secret_ with the name of the secret that you created.
111111
112-
If this step fails with the following error, the resources are still being created and applied:
112+
If this step fails with the following error, the resources are still being created and applied:
113113
114-
```
115-
error: unable to recognize "./mch.yaml": no matches for kind "MultiClusterHub" in version "operators.open-cluster- management.io/v1beta1"
116-
```
114+
```
115+
error: unable to recognize "./mch.yaml": no matches for kind "MultiClusterHub" in version "operators.open-cluster- management.io/v1beta1"
116+
```
117117
118-
Run the command again in a few minutes when the resources are created.
118+
Run the command again in a few minutes when the resources are created.
119119
120120
7. View the list of routes after about 10 minutes to find your route:
121121
122-
```
123-
oc get routes
124-
```
122+
```
123+
oc get routes
124+
```
125125
126126
## Installing Red Hat Advanced Cluster Management from the console
127127
128128
1. Create a namespace for the operator requirements:
129129
130-
1. In the Red Hat OpenShift Container Platform console navigation, select **Administration** > **Namespaces**.
130+
1. In the Red Hat OpenShift Container Platform console navigation, select **Administration** > **Namespaces**.
131131
132-
2. Select **Create Namespace**.
132+
2. Select **Create Namespace**.
133133
134-
3. Provide a name for your namespace. This is the namespace that you use throughout the installation process.
134+
3. Provide a name for your namespace. This is the namespace that you use throughout the installation process.
135135
136-
4. Select **Create**.
136+
4. Select **Create**.
137137
138-
**Important:** The Red Hat Advanced Cluster Management operator must be installed in its own namespace. A `ServiceAccount` with a `ClusterRoleBinding` automatically gives cluster administrator privileges to Red Hat Advanced Cluster Management and to any ID with access to the namespace. For security, make sure that anyone who is given access to this namespace already has cluster-administrator access.
138+
**Important:** The Red Hat Advanced Cluster Management operator must be installed in its own namespace. A `ServiceAccount` with a `ClusterRoleBinding` automatically gives cluster administrator privileges to Red Hat Advanced Cluster Management and to any ID with access to the namespace. For security, make sure that anyone who is given access to this namespace already has cluster-administrator access.
139139
140140
2. Switch your project namespace to the one that you created in step 1. This ensures that the steps are completed in the correct namespace. Some resources are namespace-specific.
141141
142-
1. In the Red Hat OpenShift Container Platform console navigation, select **Administration** > **Namespaces**.
142+
1. In the Red Hat OpenShift Container Platform console navigation, select **Administration** > **Namespaces**.
143143
144-
2. In the *Projects* field, select the namespace that you created in step 1 from the dropdown list.
144+
2. In the *Projects* field, select the namespace that you created in step 1 from the dropdown list.
145145
146146
3. Create a pull secret that provides the entitlement to the downloads.
147147
148-
1. In the Red Hat OpenShift Container Platform console navigation, select **Workloads** > **Secrets**.
148+
1. In the Red Hat OpenShift Container Platform console navigation, select **Workloads** > **Secrets**.
149149
150-
2. Select **Create** > **Image Pull Secret**.
150+
2. Select **Create** > **Image Pull Secret**.
151151
152-
3. Enter a name for your secret.
152+
3. Enter a name for your secret.
153153
154-
4. Select **Image Registry Credentials** as the authentication type.
154+
4. Select **Image Registry Credentials** as the authentication type.
155155
156-
5. In the *Registry Server Address* field, enter the address of the distribution registry that contains your image. In most cases, it is `registry.access.redhat.com/rhacm1-tech-preview`.
156+
5. In the *Registry Server Address* field, enter the address of the distribution registry that contains your image. In most cases, it is `registry.access.redhat.com/rhacm1-tech-preview`.
157157
158-
6. Enter your username and password or token for the distribution registry that contains the image.
158+
6. Enter your username and password or token for the distribution registry that contains the image.
159159
160-
7. Select **Create** to create the pull secret.
160+
7. Select **Create** to create the pull secret.
161161
162162
4. Subscribe to the operator.
163163
164-
1. In the Red Hat OpenShift Container Platform console navigation, select **Operators** > **OperatorHub**.
164+
1. In the Red Hat OpenShift Container Platform console navigation, select **Operators** > **OperatorHub**.
165165
166-
2. Select **Red Hat Advanced Cluster Management**. **Tip:** You can filter on the *Integration & Delivery* category to narrow the choices.
166+
2. Select **Red Hat Advanced Cluster Management**. **Tip:** You can filter on the *Integration & Delivery* category to narrow the choices.
167167
168-
3. Select **Install**.
168+
3. Select **Install**.
169169
170-
4. Update the values, if necessary.
170+
4. Update the values, if necessary.
171171
172-
5. Select **Subscribe**.
172+
5. Select **Subscribe**.
173173
174174
5. Create the *MultiClusterHub* custom resource.
175175
176-
1. In the Red Hat OpenShift Container Platform console navigation, select **Installed Operators** > **MultiClusterHub**.
176+
1. In the Red Hat OpenShift Container Platform console navigation, select **Installed Operators** > **MultiClusterHub**.
177177
178-
2. Select the **MultiClusterHub** tab.
178+
2. Select the **MultiClusterHub** tab.
179179
180-
3. Select **Create MultiClusterHub**.
180+
3. Select **Create MultiClusterHub**.
181181
182-
4. Update the default values in the `.yaml` file, according to your needs. The following example shows some sample data:
182+
4. Update the default values in the `.yaml` file, according to your needs. The following example shows some sample data:
183183
184-
```
185-
apiVersion: operators.open-cluster-management.io/v1beta1
186-
kind: MultiClusterHub
187-
metadata:
188-
name: multiclusterhub
189-
namespace: <namespace>
190-
spec:
191-
imagePullSecret: <secret>
192-
```
184+
```
185+
apiVersion: operators.open-cluster-management.io/v1beta1
186+
kind: MultiClusterHub
187+
metadata:
188+
name: multiclusterhub
189+
namespace: <namespace>
190+
spec:
191+
imagePullSecret: <secret>
192+
```
193193
194-
Replace _secret_ with the name of the pull secret that you created.
195-
Confirm that the _namespace_ is your project namespace.
194+
Replace _secret_ with the name of the pull secret that you created.
195+
Confirm that the _namespace_ is your project namespace.
196196
197197
5. Select **Create** to initialize the custom resource. It can take up to 10 minutes for the hub to build and start.
198198
199199
After the hub is created, the status for the operator is *Running* on the *Installed Operators* page.
200200
201201
6. Access the console for the hub.
202202
203-
1. In the Red Hat OpenShift Container Platform console navigation, select **Networking** > **Routes**.
203+
1. In the Red Hat OpenShift Container Platform console navigation, select **Networking** > **Routes**.
204204
205-
2. View the URL for your hub in the list, and navigate to it to access the console for your hub.
205+
2. View the URL for your hub in the list, and navigate to it to access the console for your hub.
206206
207207

0 commit comments

Comments
 (0)