ReSTNSX v2.2

Release and Configuration Notes

First Published: 8/1/2018. Updated 8/21/2018

This document contains system requirements, supported features and bugs for ReSTNSX v2.2

Important Notes


The ReSTNSX appliance ships with a 45 day Evaluation License.  In this mode, the following limitations are enforced:

  • A limit of two data sources (NSX Managers) can be configured
  • Tenants count limited to 2
  • No additional users may be provisioned
  • Maximum of 10 workflow items to be published to NSX Manager
  • For Operations -> dFW, a limit of  20 rule changes / 4 section changes total is enforced when importing NSX rules from CSV or published to NSX Manager

In evaluation mode, the default login information is as follows:

Username: admin

Password:  default


System Requirements

Support matrix and system requirements for ReSTNSX.

RoleVersionCPUMemoryStorage
ReSTNSX2.24 vCPU8GB50GB
vCenter6.0+---
NSX Manager (-v)6.3+---
NSX Manager (-T)2.2

For REST API access, HTTPS (TCP Port 443) must be allowed through any transient firewalls for the ReSTNSX Appliance to access vCenter and NSX Manager

Browser Support

  • Chrome 62+ for the best user experience
  • Firefox  52+ (Limited Interop Testing)

 

ReSTNSX - New Features


Administration


Enterprise license support.  Beginning with ReSTNSX 2.2, customers will have the option of a Standard or Enterprise license.  Standard licenses enable all the core features of the platform whereas Enterprise provides advanced functionality such as NSX Mover and Multi-Tenant Administration without requiring separate feature licenses for each capability.  To learn more about the different ReSTNSX licensing options, please visit the licensing page.

Note: NSX Mover is available in the current release as a tech preview for non-Enterprise licensed customers.  Future releases will require Enterprise licensing to enable this feature

 


System Features


Universal object filter added as a search option under Query widget for the following two items:

  • Services
  • Service Groups

Logging functionality under Admin -> Logging has been updated to include the following new features:

  • Column toggles to hide or show select columns
  • Row select and multi-select that will filter results for printing and export
  • Data export (Clipboard, CSV, Excel, PDF) will now will only export the rows manually selected or filtered in the search box.

Note: If no rows are selected or filtered, the default behavior is to export all rows in the table

  • A native printing button to the table for additional functionality while selecting data for print:

If a Search filter is in place, the print scope is limited to these items

If the user selects a single or multiple rows, the print scope is limited to these items

Note: If no rows are selected or filtered, the default behavior is to print all rows in the table

 


Operations


ReSTNSX Operations section introduces real-time, instant creation, modification and deletion of NSX objects.  In comparison to work-flows with bulk object creation and roll-back, Operations is designed for performing the typical Day 2 tasks and common management functions.  Operations is divided up into NSX System for managing the NSX Manager settings and Networking/Security Objects; Networking for logical switching, DLR and ESG management; and Security for dFW and eFW.

 

NSX System

Real-time operations for NSX Manager settings 

  • Network settings, including IP, DNS, NTP and Syslog
  • Security modes (FIPS) and Cipher selection
  • Service status and status toggle for vPostgres, RabbitMQ, Universal Synch, Management, SSH and Lookup URL
  • Backup settings, including FTP server, scheduling and items to be excluded

Networking and Security Objects (N&S)

Real-time operations for N&S objects

Create, Edit and Delete N&S objects instantly through ReSTNSX.  The following objects are supported in this release:

  • IP Pools
  • IP Sets
  • Security Groups.  Static inclusion / exclusion to be supported in a future release.
  • Security Tags
  • Security Tag associations
  • Services
  • Service Groups

Logical Switching

  • Create, Edit, Delete - Logical Switches
  • Attach / Detach virtual machines
  • Create, Edit, Delete - Transport Zones
  • Edit Segment IDs

Routing

  • Create, Edit, Delete - DLRs
  • Create, Edit, Delete - ESG Templates
  • Edit Logical Switch associations

NSX Mover

Real-time replication of Networking and Security N&S Objects

With NSX Mover, Administrators can easily copy N&S objects between NSX Managers of the same or different type instantly.  Objects are copied in real-time to the destination NSX-v or NSX-T Manager without having to login to the remote system.

To access the Mover tool, navigate to the N&S object types of interest in your origin datasource, select a single or multiple object, and navigate to the drop-down menu and select "Migrate Selected."

 

Supported objects types are listed below. To learn more about NSX Mover, please see the ReSTNSX Overview page.

ObjectNSX -v 6.3NSX -v 6.4NSX -T 2.2
IP SetYYY
IP PoolYYY
ServicesYYY
Service Groups *YYY
Security Groups* , **YYN
Security TagsYYN

 

* NSX Mover's analytics engine determines if dependent objects exist and will prompt the user if they wish to create the dependent objects on the destination system. Examples of objects that could have dependencies include Service Groups and Security Groups where they may be referencing other objects that do not yet exist.

 

** NSX Mover supports Security Groups for migrating dependent objects such as IPSets and Security Tags.  Static Inclusions/Exclusions, Logical Switches and Virtual Machines will be supported in future release.

 


Reporting


Administrators, Auditors and IT Managers now have access to a unified reporting fabric to gain visibility into all of the ReSTNSX managed domains - regardless of NSX version or location.  ReSTNSX now provides three report types:

System Reports -   Environment summary, service status and configuration details of each NSX Manager under ReSTNSX management are provided by a daily report or on-demand.  

Activity Reports - Filtered real-time, system log events that can be sorted by username for insight into a user’s action over time.

Tenant Reports - A combination of the System and Activity reports. Data is filtered to provide insight into any given ReSTNSX configured tenant.  Similar to the System reports, the Tenant report provides Administrators and Auditors a configuration summary on a tenant-by-tenant basis.  Tenant reports reflect real-time information for configuration and user activity.

Read more about ReSTNSX reports ...

 


Workflow


For each bulk configuration option in any given workflow where CSVs are leveraged,  pipe "|" delimited entries are now supported and provided in the templates.  Previously, separate columns were required for each entry.  For example, in IP Sets, each IP Set (192.168.1.0/24, 192.168.2.0/24, etc...) would be a separate column.  With ReSTNSX 2.2, all addresses would be collapsed into a single column and separated by a "|" pipe  (192.168.1.0/24 | 192.168.2.0/24, etc...).

 

Illustration showing a pre-2.2 CSV template format with mulitple columns and the changes in 2.2 and above using pipe delimiting fields

Note: eFW rule sets do not support pipe separation in the current release.

 

Multi-Tenant Feature - New Features

NONE

Upgrading ReSTNSX

Upgrades to ReST NSX leverage configuration export for easy migrations.  When exported, the following information is retained:

  • Local Users
  • Saved Workflows
  • Custom Wizards
  • Tenant Information
  • Data Sources
  • System Settings

By exporting this information, upgrades are performed in parallel to the production platform.  Once the new version of ReSTNSX is online, simply import the previously exported configuration file and the system is online.  Administrators can manage the same NSX environment(s) with both ReSTNSX versions at the same time and

Note: When both systems are online, configuration settings are not synchronized between the different versions and must be maintained separately until the old version is decommissioned.

For a step-by-step upgrade, please refer to the ReSTNSX Upgrade Guide