SwaggerHub On-Premise 2.x uses Replicated KOTS to manage the installation, upgrades, and licensing. KOTS provides a web-based Admin Console that runs alongside the SwaggerHub application and can be used to configure and manage it.
How to access the Admin Console
On a machine with
kubectl access to the cluster, run:
kubectl kots admin-console -n swaggerhub
This makes the Admin Console available at http://localhost:8800 on the
kubectl machine. The Admin Console remains accessible as long as the command is running. Pressing Ctrl+C will stop the Admin Console.
Note: If the
kubectl machine is a headless server (such as a jumpbox to which you connect via SSH), you then need to set up an SSH tunnel from your desktop to the
kubectl machine so you can access the Admin Console locally. To do this, open another terminal window on your desktop and run:
ssh user@JUMPBOX -L 8800:localhost:8800
This will open a connection to the jumpbox and forward any connection to port 8800 on the local machine to port 8800 on the jumpbox. This way, you can access the Admin Console on your desktop as http://localhost:8800.
VM (embedded cluster)
Connect to the VM using SSH and run:
kubectl kots admin-console
This makes the Admin Console available at:
The Admin Console remains accessible for as long as the
kubectl kots admin-console command is running. Pressing Ctrl+C in the command-line window will stop the Admin Console.
While the Admin Console is running, you can optionally set up an SSH tunnel from your local computer to the VM. This will let you access the Admin Console locally on http://localhost:8800:
ssh -N -L 8800:localhost:8800 VM_DNS_or_IP
To log in to the Admin Console, use the password that you specified during the SwaggerHub installation. If you forgot the password, you can reset it.
Note: The Admin Console password is different from the SwaggerHub admin user password. The latter is used to log in to the SwaggerHub application as the admin user (if internal authentication is used) and also in some
Admin Console tabs
The Admin Console has the following tabs:
Cluster Management (not used)
The dashboard shows your SwaggerHub deployment status.
If you are using your own Prometheus instance to collect SwaggerHub metrics, you can configure the dashboard to display graphs showing relevant information.
This tab displays your current SwaggerHub version and the update history along with the date and time of each update. The history includes the following types of changes:
|Online Install||Initial installation, online mode.|
|Airgap Install||Initial installation, airgapped mode.|
|Config Change||SwaggerHub settings on the Config tab have been changed.|
|Upstream Update||A new release of SwaggerHub On-Premise is available.|
|Airgap Update||SwaggerHub update installed in airgapped mode.|
|License Change||License update (for example, prolongation or added seats).|
If automatic update checks are enabled, new release notifications will appear on the Version history tab. You can also check for updates manually by clicking the Check for updates link.
In airgapped instances, you can use the Upload a new version button to upload airgap bundles containing SwaggerHub application upgrades.
This tab contains SwaggerHub configuration settings. For details, see:
Use this tab to create and download support bundles containing the logs and diagnostic data.
This tab shows your SwaggerHub license information, including the total number of seats and the number of Designer seats. Here, you can also fetch license updates (such as additional seats or prolongations) from our licensing server. In airgapped installations, you can upload a new license manually.
|Tip:||You can use the
This tab shows SwaggerHub internal configuration files.
|Do not edit these files unless instructed to do so by SmartBear Support.|
If your SwaggerHub On-Premise installation is airgapped (offline), this is where you can change the container registry path or credentials used to store SwaggerHub and KOTS Docker images.
This tab also appears in online installations if the license allows airgapped installation.
This page is currently not used by SwaggerHub On-Premise.
Snapshots are used to back up and restore your SwaggerHub installation. On this tab, you can configure the storage location and schedule for snapshots, or create snapshots manually.
Snapshots are powered by Velero, an open-source tool for backing up and restoring Kubernetes clusters. VM (embedded cluster) installations come with Velero pre-installed. If you deployed SwaggerHub to an existing Kubernetes cluster, you can install Velero manually to make use of the snapshot management features in the Admin Console.
|Snapshots do not include external databases. You must back them up separately.|
SwaggerHub 2.x Configuration
Deploying Configuration Changes
Resetting the Admin Console Password