Portworx Documentation has moved to https://docs.portworx.com
Portworx Enterprise version 2.13 has reached end of life and end of extended maintenance. Refer to the release support policy doc here.
Upgrade to the latest version of Portworx Enterprise for continued support. Documentation for the latest version of Portworx Enterprise can be found here.
Upgrade to the latest version of Portworx Enterprise for continued support. Documentation for the latest version of Portworx Enterprise can be found here.
Air-gapped install bootstrap script reference
./px-ag-install.sh [image-commands] [options] '[arguments...]'
NOTE: The script name
px-ag-install.sh
reflects the default name specified in the installation instructions, but can be whatever you named the script file when you downloaded it.
Image commands
Command | Description | Required? |
---|---|---|
pull |
Pulls the Portworx container images locally | |
push <registry[/repo]> |
Pushes the Portworx images into remote container registry server | |
load node1 [node2 [...]] |
Loads the images tarball to remote nodes (note: ssh-access required) |
Options
Option | Description | Required? |
---|---|---|
--help |
Displays help output | |
-I , --include <image> |
Specify additional images to include | |
-E , --exclude <glob> |
Specify images to EXCLUDE (e.g. -E ‘csi’) | |
-n , --dry-run |
Show commands instead of running | |
-V , --version |
Print version of the script | |
-v |
Verbose output |
Load-specific options
Option | Description | Required? |
---|---|---|
-e , --rsh <command> |
specify the remote shell to use (default ssh) | |
-L , --load-cmd <command> |
specify the remote container-load command to use (default auto) | |
-t <prefix> |
specify temporary tarball filename (default px-agtmp.tar) | |
--pks |
assume PKS environment; transfer images using ‘bosh’ command |
Examples
Pull images from default container registries, push them to custom registry server (default repositories)
px-ag-install.sh pull push your-registry.company.com:5000
Pull images from default container registries, push them to custom registry server and portworx repository
px-ag-install.sh pull px-ag-install.sh push your-registry.company.com:5000/portworx
Push images to password-protected remote registry, then import docker/podman configuration as kuberentes secret
docker login your-registry.company.com:5000 px-ag-install.sh pull px-ag-install.sh push your-registry.company.com:5000/portworx px-ag-install.sh import-secrets
Pull images, then load to given nodes using ssh
px-ag-install.sh pull px-ag-install.sh load node1 node2 node33 node444
Pull images, then load to given nodes using ssh and root-account
px-ag-install.sh -e "ssh -l root" pull load node1 node2 node33 node444
Load images to given nodes using ssh and password ‘5ecr3t’
px-ag-install.sh -e "sshpass -p 5ecr3t ssh" load node1 node2 node33 node444
Pull ONLY busybox image, load it to given nodes
px-ag-install.sh -E '*' -I docker.io/busybox:latest pull load node1 node2 node33 node444
Last edited: Tuesday, May 16, 2023
Questions? Visit the Portworx forum.