Skip to content

Commit 9959751

Browse files
committed
doc : Add steps to remove CRC pull secret from OS provided tools (#2572)
Add steps for Windows, Linux (GNOME) and MacOS to instruct user on how to remove the CRC pull secret from credential managers on abovementioned Operating Systems. Signed-off-by: Rohan Kumar <rohaan@redhat.com>
1 parent 1ea8e75 commit 9959751

File tree

1 file changed

+60
-0
lines changed

1 file changed

+60
-0
lines changed

modules/ROOT/pages/using.adoc

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,66 @@ Only one preset can be active at a time.
2323
* xref:installing.adoc#minimum-system-requirements[Minimum system requirements].
2424
* xref:configuring.adoc#changing-the-selected-preset[Changing the selected preset].
2525

26+
[id='about-pullsecrets']
27+
== About Pull Secrets
28+
While starting cluster configured with {openshift} or {ushift} preset, {prod} would request you to provide a pull secret. It's required to pull container images from Red Hat container registries.
29+
You need to download it from the Pull Secret section of the link:https://console.redhat.com/openshift/create/local[{prod} page on the {rh} Hybrid Cloud Console].
30+
31+
Once you provide this pull secret, it gets stored in Operating System's credential manager so that {prod} doesn't ask for pull secret again in case you delete existing cluster and create
32+
a new one.
33+
34+
Please note that this pull secret would only be removed from the Operating System's credential manager when user runs [command]`{bin} cleanup` command.
35+
36+
If you manually want to remove/update pull secret from your Operating System's credential manager configuration.
37+
38+
[id='clearning-credential-manager-pullsecret']
39+
=== Clearing Pull Secret from Credential Manager
40+
Steps to clear entries from the Credential Manager on different operating systems.
41+
42+
==== Windows
43+
44+
1. Open the Control Panel.
45+
2. Go to `User Accounts` > `Credential Manager`.
46+
3. Choose `Windows Credentials`.
47+
4. Find the {prod} pull secret entry you want to delete.
48+
5. Click on the entry to expand it.
49+
6. Click `Remove` to delete the credential.
50+
51+
==== Linux
52+
53+
If you're using https://wiki.gnome.org/Projects/GnomeKeyring[GNOME Keyring]:
54+
55+
1. Open the `Activities` overview and start typing `Passwords`.
56+
2. Click on `Passwords and Keys` to open https://wiki.gnome.org/Projects/GnomeKeyring[GNOME Keyring].
57+
3. Click on `Login` entry under `Passwords`
58+
4. Find the {prod} pull secret entry you want to delete.
59+
5. Right-click the entry you want to delete.
60+
6. Select `Delete` and confirm the deletion.
61+
62+
If you're using https://github.com/KDE/kwallet[KDE Wallet]:
63+
[NOTE]
64+
====
65+
By default, https://github.com/KDE/kwallet[KDE Wallet] doesn't operate as a Secret Service Provider. We need to explicitly
66+
enable it by going to `System Settings` > `KDE Wallet` and enable Use KWallet for the Secret Service interface. Then you should
67+
be able to use {prod} with https://github.com/KDE/kwallet[KDE Wallet]
68+
====
69+
70+
71+
1. Open the `Application Launcher` and start typing `KWalletManager`.
72+
2. Under `Contents` tab, click on `Secret Service` and expand it.
73+
3. Under expanded `Secret Service` entry, click on `Passwords` and expand it.
74+
4. Find the {prod} pull secret entry you want to delete.
75+
5. Right-click the entry you want to delete.
76+
6. Select `Delete` and confirm the deletion.
77+
78+
==== MacOS
79+
80+
1. Open `Keychain Access` from the `Applications` > `Utilities` folder.
81+
2. Select the keychain where the credential is stored (e.g., `login`, `iCloud`).
82+
3. Find the {prod} pull secret entry you want to delete.
83+
4. Right-click the entry and select `Delete`.
84+
5. Confirm the deletion when prompted.
85+
2686
[id='setting-up']
2787
== Setting up {prod}
2888

0 commit comments

Comments
 (0)