Deprecation Notice

This Pre-Built has been deprecated as of 09-01-2024 and will be end of life on 09-01-2025. The capabilities of this Pre-Built have been replaced by the Versa - REST

Versa Create Device Group

Table of Contents

• Overview
• Requirements
• Features
• How to Install
• How to Run
• Additional Information

Overview

This pre-built is used to add a new device group to Versa Director. Device group is a group of all devices that need to share the same configuration (belonging to a template) such as the SD-WAN policies, the FW rules, QoS markings, etc.

Estimated Run Time: 1 minute

Requirements

This Pre-Built requires the following:

• Itential Automation Platform
  • ^2022.1
• A running instance of the Itential OpenSource Versa Director adapter, which can be installed from here.

Features

The main benefits and features of the Pre-Built are outlined below.

Every Itential Pre-built is designed to optimize network performance and configuration by focusing on reliability, flexibility and coordination of network changes with applications and IT processes. As the network evolves, Pre-builts allow customers to focus on effective management and compliance to minimize risks of disruption and outage that can negatively impact quality of service.

How to Install

• Verify you are running a supported version of the Itential Automation Platform (IAP) as listed above in the Requirements section in order to install the Pre-Built.
• The Pre-Built can be installed from within App-Admin_Essential. Simply search for the name of your desired Pre-Built and click the install button (as shown below).

How to Run

Use the following to run the Pre-Built:

The pre-built can be run as a standalone or as part of a parent job.

• To run it as a standalone job, run the respective job from operations manager with the necessary json form.
• The workflow or the job can also be used as part of another parent job.

The description of the formdata needed by the prebuilt is given below: The required values to be passed on are:

Device Group Name: Name of the device group to be created.
Organization Name: Name of the parent organization for which the device group needs to be created.
CA In Data Center: To enable certificate authority. If enabled, during global ZTP, the CSR request goes over the IPSec tunnel, and the branch receives a CA-signed certificate. All tunnels that are established use this certificate.
URL Based ZTP: Will need to be selected if the ZTP process needs be URL Based. When selected, the CPE device will be enabled to provision via a URL that will be generated and sent to an admin who can use that to onboard the device.
Enable 2-factor Authentication (Enable 2 factor to access the device group): To be enabled if 2 factor authentication is to be used during the Zero Touch Provisioning process. When the tunnel is established, before the Orchestrator is notified, an email and/or SMS will be sent to the administrator listed to authorize connectivity to the HeadEnd.
Email and Phone: Email and Phone number of the Administrator. Will be used for notification during ZTP, to provide 2-factor authentication.

Post staging template name: Name of the Post staging template that will be used for onboarding the devices in this device group.
Controller+VPN profile: Name of the Controller and VPN Profile that will need to be used during URL based ZTP process.

Versa instance

The above created service template can be verified on the versa instance by logging in using the credentials provided.

After logging in, select the configuration tab, choose the right organization from the left pane and from the Devices dropdown on the top menu choose 'Device Groups' to view all the device groups created.

Additional Information

Please use your Itential Customer Success account if you need support when using this Pre-Built.