Differences Between SwaggerHub On-Premise 1.x and 2.x

Last modified on June 22, 2022

This page summarizes the configuration changes between SwaggerHub On-Premise versions 1.x and 2.x. It is intended for administrators who are planning to migrate from v. 1.x to 2.x or have already done so.

Limitations

The following features of SwaggerHub On-Premise 1.x are currently not supported in version 2.x, but will be added in future releases:

Configuration changes

  • The built-in Admin Center (http(s)://SERVER/ui) was replaced with the Admin Console provided by Replicated KOTS. The new Admin Console has similar functionality, but with a few key differences:

  • Updates are now managed by Replicated KOTS.

    • In Internet-connected installations, you can check for updates and install updates directly from the KOTS Admin Console. You can also enable automatic update checks to see new release notifications in the Admin Console.

    • To update an airgapped (offline) installation, you need to download the new airgap bundle from your SwaggerHub Download Portal and then upload it to the Admin Console.

    • You can also install updates from the command line by using the kubectl kots upstream upgrade command.

  • System logs (diagnostic data) are included in support bundles.

  • Maintenance scripts were replaced with the swaggerhub-operator commands.

  • Some configuration options and administrator features were replaced with the swaggerhub-operator commands:

    1.x feature Replacement

    Default organization name option

    set-default-org

    Test Proxy button

    test-url

    Sent Test Email button

    test-smtp

    Admin Center: License page and users list

    license-usage

    list-users

    delete-user

    User Management API

Removed features

The following configuration settings were removed in SwaggerHub On-Premise 2.x because these things can be configured at the cluster level or operating system level:

  • SSH users

  • NTP settings

See Also

Migrating Data From SwaggerHub On-Premise 1.x to 2.x
SwaggerHub 2.x Configuration

Highlight search results