Admin Console Overview

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.

SwaggerHub On-Premise Admin Console

Supported browsers

See Supported Browsers for KOTS Apps.

How to access the Admin Console

Kubernetes cluster

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 Admin Console at:

http(s)://VM_DNS_or_IP:8800

Password

Login prompt

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 swaggerhub-operator commands.

Admin Console tabs

The Admin Console has the following tabs:

Application

Dashboard

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.

Version history

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:

Type

Description

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.

Config

This tab contains SwaggerHub configuration settings. For details, see:

go.gifSwaggerHub 2.x Configuration

go.gifDeploying Configuration Changes

Troubleshoot

Use this tab to create and download support bundles containing the logs and diagnostic data.

License

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 license-usage command to get license information from the command line.

View files

This tab shows SwaggerHub internal configuration files.

Important

Do not edit these files unless instructed to do so by SmartBear Support.

Registry settings

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.

Cluster Management

This page is currently not used by SwaggerHub On-Premise.

Snapshots

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.

Important

Snapshots do not include external databases. You must back them up separately.

Activate Changes

It's not enough to save your configuration changes on the Admin Console. You must also deploy them to have your changes take effect.

See Also

Publication date: