Skip to content

Commit 1ab8377

Browse files
Updating Authorization documentation (#972)
* updating generating token * updating generating token * updating generating token doc * updating troubleshooting page
1 parent 130d2ae commit 1ab8377

File tree

2 files changed

+34
-4
lines changed

2 files changed

+34
-4
lines changed

content/docs/authorization/cli.md

+5
Original file line numberDiff line numberDiff line change
@@ -247,6 +247,11 @@ Usually, you will want to pipe the output to kubectl to apply the secret
247247
```bash
248248
karavictl generate token --tenant Alice --admin-token admintoken.yaml --addr csm-authorization.host.com | kubectl apply -f -
249249
```
250+
The token is read once when the driver pods are started and is not dynamically updated. If you are applying a new token in an existing driver installation, restart the driver pods for the new token to take effect.
251+
```bash
252+
kubectl -n <driver-namespace> rollout restart deploy/<driver>-controller
253+
kubectl -n <driver-namespace> rollout restart ds/<driver>-node
254+
```
250255

251256
### karavictl role
252257

content/docs/authorization/troubleshooting.md

+29-4
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,7 @@ The CSM Authorization RPM will be deprecated in a future release. It is highly r
1515
- [Running `karavictl tenant` commands result in an HTTP 504 error](#running-karavictl-tenant-commands-result-in-an-http-504-error)
1616
- [Installation fails to install policies](#installation-fails-to-install-policies)
1717
- [After installation, the create-pvc Pod is in an Error state](#after-installation-the-create-pvc-pod-is-in-an-error-state)
18-
19-
## Helm Deployment
20-
- [The CSI Driver for Dell PowerFlex v2.3.0 is in an Error or CrashLoopBackoff state due to "request denied for path" errors](#the-csi-driver-for-dell-powerflex-v230-is-in-an-error-or-crashloopbackoff-state-due-to-request-denied-for-path-errors)
21-
18+
- [Intermittent 401 issues with generated token](#intermittent-401-issues-with-generated-token)
2219
---
2320

2421
### The Failure of Building an Authorization RPM
@@ -97,6 +94,23 @@ Run the following commands to allow the PVC to be created:
9794
semanage fcontext -a -t container_file_t "/var/lib/rancher/k3s/storage(/.*)?"
9895
restorecon -R /var/lib/rancher/k3s/storage/
9996
```
97+
### Intermittent 401 issues with generated token
98+
This issue occurs when a new access token is generated in an existing driver installation.
99+
100+
__Resolution__
101+
102+
If you are applying a new token in an existing driver installation, restart the driver pods for the new token to take effect. The token is read once when the driver pods are started and is not dynamically updated.
103+
```bash
104+
kubectl -n <driver-namespace> rollout restart deploy/<driver>-controller
105+
kubectl -n <driver-namespace> rollout restart ds/<driver>-node
106+
```
107+
108+
## Helm Deployment
109+
- [The CSI Driver for Dell PowerFlex v2.3.0 is in an Error or CrashLoopBackoff state due to "request denied for path" errors](#the-csi-driver-for-dell-powerflex-v230-is-in-an-error-or-crashloopbackoff-state-due-to-request-denied-for-path-errors)
110+
- [Intermittent 401 issues with generated token](#intermittent-401-issues-with-generated-token)
111+
112+
---
113+
100114

101115
### The CSI Driver for Dell PowerFlex v2.3.0 is in an Error or CrashLoopBackoff state due to "request denied for path" errors
102116
The vxflexos-controller pods will have logs similar to:
@@ -184,3 +198,14 @@ kubectl -n <namespace> rollout restart deploy/proxy-server
184198
kubectl -n <driver-namespace> rollout restart deploy/vxflexos-controller
185199
kubectl -n <driver-namespace> rollout restart daemonSet/vxflexos-node
186200
```
201+
202+
### Intermittent 401 issues with generated token
203+
This issue occurs when a new access token is generated in an existing driver installation.
204+
205+
__Resolution__
206+
207+
If you are applying a new token in an existing driver installation, restart the driver pods for the new token to take effect. The token is read once when the driver pods are started and is not dynamically updated.
208+
```bash
209+
kubectl -n <driver-namespace> rollout restart deploy/<driver>-controller
210+
kubectl -n <driver-namespace> rollout restart ds/<driver>-node
211+
```

0 commit comments

Comments
 (0)