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: modules/support-installing-packages-to-a-toolbox-container.adoc
+3-2Lines changed: 3 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -7,16 +7,17 @@
7
7
= Installing packages to a `toolbox` container
8
8
9
9
ifndef::openshift-origin[]
10
-
By default, running the `toolbox` command starts a container with the `registry.redhat.io/rhel8/support-tools:latest` image. This image contains the most frequently used support tools. If you need to collect node-specific data that requires a support tool that is not part of the image, you can install additional packages.
10
+
By default, running the `toolbox` command starts a container with the `registry.redhat.io/rhel9/support-tools:latest` image. This image contains the most frequently used support tools. If you need to collect node-specific data that requires a support tool that is not part of the image, you can install additional packages.
11
11
endif::openshift-origin[]
12
12
13
13
ifdef::openshift-origin[]
14
-
By default, running the `toolbox` command starts a container with the `quay.io/fedora/fedora:36` image. This image contains the most frequently used support tools. If you need to collect node-specific data that requires a support tool that is not part of the image, you can install additional packages.
14
+
By default, running the `toolbox` command starts a container with the `quay.io/fedora/fedora` image. This image contains the most frequently used support tools. If you need to collect node-specific data that requires a support tool that is not part of the image, you can install additional packages.
15
15
endif::openshift-origin[]
16
16
17
17
.Prerequisites
18
18
19
19
* You have accessed a node with the `oc debug node/<node_name>` command.
20
+
* You can access your system as a user with root privileges.
Copy file name to clipboardExpand all lines: modules/support-starting-an-alternative-image-with-toolbox.adoc
+14-13Lines changed: 14 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -7,16 +7,22 @@
7
7
= Starting an alternative image with `toolbox`
8
8
9
9
ifndef::openshift-origin[]
10
-
By default, running the `toolbox` command starts a container with the `registry.redhat.io/rhel8/support-tools:latest` image. You can start an alternative image by creating a `.toolboxrc` file and specifying the image to run.
10
+
By default, running the `toolbox` command starts a container with the `registry.redhat.io/rhel9/support-tools:latest` image.
11
+
12
+
[NOTE]
13
+
====
14
+
You can start an alternative image by creating a `.toolboxrc` file and specifying the image to run. However, running an older version of the `support-tools` image, such as `registry.redhat.io/rhel8/support-tools:latest`, is not supported on {product-title} {product-version}.
15
+
====
11
16
endif::openshift-origin[]
12
17
13
18
ifdef::openshift-origin[]
14
-
By default, running the `toolbox` command starts a container with the `quay.io/fedora/fedora:36` image. You can start an alternative image by creating a `.toolboxrc` file and specifying the image to run.
19
+
By default, running the `toolbox` command starts a container with the `quay.io/fedora/fedora` image. You can start an alternative image by creating a `.toolboxrc` file and specifying the image to run.
15
20
endif::openshift-origin[]
16
21
17
22
.Prerequisites
18
23
19
24
* You have accessed a node with the `oc debug node/<node_name>` command.
25
+
* You can access your system as a user with root privileges.
20
26
21
27
.Procedure
22
28
@@ -27,24 +33,19 @@ endif::openshift-origin[]
27
33
# chroot /host
28
34
----
29
35
30
-
. Create a `.toolboxrc` file in the home directory for the root user ID:
31
-
+
32
-
[source,terminal]
33
-
----
34
-
# vi ~/.toolboxrc
35
-
----
36
+
. Optional: If you need to use an alternative image instead of the default image, create a `.toolboxrc` file in the home directory for the root user ID, and specify the image metadata:
36
37
+
37
38
[source,text]
38
39
----
39
-
REGISTRY=quay.io <1>
40
-
IMAGE=fedora/fedora:33-x86_64 <2>
41
-
TOOLBOX_NAME=toolbox-fedora-33 <3>
40
+
REGISTRY=quay.io <1>
41
+
IMAGE=fedora/fedora:latest <2>
42
+
TOOLBOX_NAME=toolbox-fedora-latest <3>
42
43
----
43
44
<1> Optional: Specify an alternative container registry.
44
45
<2> Specify an alternative image to start.
45
46
<3> Optional: Specify an alternative name for the toolbox container.
46
47
47
-
. Start a toolbox container with the alternative image:
48
+
. Start a toolbox container by entering the following command:
If an existing `toolbox` pod is already running, the `toolbox` command outputs `'toolbox-' already exists. Trying to start...`. Remove the running toolbox container with `podman rm toolbox-` and spawn a new toolbox container, to avoid issues with `sosreport` plugins.
57
+
If an existing `toolbox` pod is already running, the `toolbox` command outputs `'toolbox-' already exists. Trying to start...`. To avoid issues with `sosreport` plugins, remove the running toolbox container with `podman rm toolbox-` and then spawn a new toolbox container.
0 commit comments