/panos-bootstrapper-ui

PAN-OS Bootstrapper UI provides a simple, example web-UI that consumes the PAN-OS Bootstrapper utility API.

Primary LanguagePython

PAN-OS Bootstrapper UI

This project will quickly spin up the PAN-OS bootstrapper service and a simple UI to consume the bootstrapper API. Using this tool, an architect or designer can create and manage the templates necessary to configure a Palo Alto Networks device upon first boot. A fully customized UI can then use those templates to allow an operator to input only those variables necessary to compile those templates into a bootstrap package.

For details about the bootstrapping process, refer to the official documentation.

Installation

  1. Install docker and docker-compose

2: clone or download this repository

git clone https://github.com/PaloAltoNetworks/panos-bootstrapper-ui.git

3: Init the required submodules

cd panos-bootstrapper-ui
git submodule init
git submodule update

4: Build the docker containers

docker-compose build

5: Launch the docker containers

docker-compose up

6: Browse to http://localhost

7: Default Login is 'paloalto' and 'bootstrapper'

Upgrading to the latest version

Upgrading to the latest version should be quick and easy:

cd panos-bootstrapper-ui
git pull
docker-compose build 
docker-compose up --force-recreate

Examples

Examples can be found in the project documentation on here: https://panos-bootstrapper.readthedocs.io/en/latest/

Troubleshooting

If you have issues pulling the images, try to log in to the docker CLI tool using:

docker login

Verify basic docker functionality with:

docker run hello-world

You can also force the recreation of all the service using these commands:

cd panos-bootstrapper-ui
git pull
docker-compose up --force-recreate

If you are not using git then download the zip archive again and issue the following:

docker-compose up --force-recreate

If you are still having problems, you can try these steps as a last resort

# Delete every Docker container
# Must be run first because images are attached to containers
docker rm -f $(docker ps -a -q)

# Delete every Docker image
docker rmi -f $(docker images -q)

To completely start over with docker and remove all cached content and recreate the database, try this:

# enter the bootstrapper-ui directory
cd panos-bootstrapper-ui
# ensure all containers and networks are removed
docker-compose down
# push directory into /var/lib
pushd /var/lib
# stop docker service
sudo service docker stop
# nuke the docker directory (not for the faint of heart)
sudo mv docker docker.nuke
# restart docker
sudo service docker start
# jump back to our bootstrapper-ui dir
popd
# bring up the containers as normal by recreateing all layers, inages, and containers
docker-compose up