Edit, Stage, and Publish Configs

Learn how to use NGINX Management Suite Instance Manager to view, edit, stage, and publish NGINX configuration files.


This documentation applies to NGINX Management Suite Instance Manager 2.0.0 and later.


Overview

You can use NGINX Management Suite Instance Manager (NIM) to edit, stage, and publish NGINX configurations to your NGINX and NGINX Plus instances. The NGINX config analyzer automatically checks your configuration for errors as you work.

Before You Begin

To complete the instructions in this guide, you need the following:

  • An installed version of Instance Manager
  • One or more NGINX data plane instances

How to Access the User Interface

This guide provides instructions on how to complete tasks using the Instance Manager web interface.

To access the web interface, go to the FQDN for your NGINX Management Suite host in a web browser and log in. Once you’re logged in, select “Instance Manager” from the Launchpad menu.

Edit and Publish an NGINX Configuration

  1. In the Instance Manager user interface, go to Instances and select an instance from the list.
  2. Select Edit Config.
  3. Make your desired changes to the instance’s configuration files.
  4. When ready to publish your changes to the instance, select Publish.

Stage Configuration Changes

Create a Staged Configuration

  1. In the Instance Manager user interface, go to Instances and select an instance from the list.
  2. Select Edit Config.
  3. Make your desired changes to the instance’s config files.
  4. To stage your changes and publish them later, select Save as and then provide a name for the staged config.

Update a Staged Configuration

  1. In the Instance Manager user interface, go to Instances and select an instance from the list.
  2. Select Staged Configs, then select a staged config from the list.
  3. Make your desired changes to the staged config’s files.
  4. Select Save to save the configuration.

Publish a Staged Configuration

You can publish a staged config to a target instance or instance group.

  1. In the Instance Manager user interface, go to Instances and select an instance from the list.
  2. Select Staged Configs, then select a staged config from the list.
  3. Select Publish to.
  4. In the publish target list, select the instance or instance group that you want to publish the staged config to.