ProVision First Steps
Overview Video: First Steps - Part 1
This video gives a high level overview of the "Before you Begin" content on this page, as well as an introduction to ProVision's Resource System.
Note: Recorded in ProVision v5.1.x, newer versions may have interface updates.
This video may also be viewed at https://www.youtube.com/watch?v=apJRcQv3ZQ0.
Before you Begin
We recommend that new users work through the following questions with their internal team to plan their ProVision instance:
Remember that 6connect's engineers are here to help. If you have questions, or want to test out some ideas, our team has worked with a variety of data sets and can help get you started on the right path. You can reach us any time at email@example.com.
1) What type of physical and non-physical components do you wish to track?
Impacts: What Sections and Resources are created
An important first step is determining what items you currently are, or will be, tracking, and what relationship they have with each other. ProVision's flexible Resource system allows you create and customize detailed entries for any type of item you may want to track: Customers, Contacts, Data Centers, Routers, VMs, and more. These types of resources are labeled as "Sections" in ProVision. Once a section is made, individual items (resources) may be created as a part of that Section. Each Section may have different Gadgets selected, which then provide additional functionality on a resource entry page.
2) What is your current data structure? What is your ideal data structure?
Impacts: Resource Hierarchy, Assignment Behavior
The resource hierarchy structure in ProVision allows for "child" resources to be created under a parent resource (for example: servers as children under a datacenter resource entry, or subsidiaries under a parent company, who then share IP aggregates). The structure decided upon will influence how resources are set up in ProVision, as well as the behaviors of functions while working with items such as IP blocks or DNS zones.
3) Who needs access to what data?
Impacts: User and Group Permissions
In ProVision, standard user permissions are set by resource and functional area (IPAM, Resource, Peering, etc). Global Admin permissions give access to additional functions such as configuration settings, importing, and Scheduler tasks. Determine which users will require administrative access, and which will have access to only specific resources or functional areas. You will need to get more specific later, but having some high level groups to work with is a great start.
See: Users & Permissions
Overview Video: First Steps - Part 2
This video gives a high level overview of the "Getting your Data into ProVision" content on this page.
Note: Recorded in ProVision v5.1.x, newer versions may have interface updates.
This video may also be viewed at https://www.youtube.com/watch?v=2e0H1H4rTTs.
Getting your Data into ProVision
After determining your internal goals and processes, it's time to get your data into ProVision!
When importing data into ProVision, data validation is a key step to ensure that everything is accurate. Upon importing your data, you may see some errors that result in a stop in the import process! It is recommended that you break up your imports to both keep them manageable and give you a chance to normalize your data prior to importing.
1) Gather and Prep your data
Determine where your data will be from:
Excel / Spreadsheets:
May be used to import: Resources, IP Aggregates/ Blocks, DNS BIND Zones
If you currently use Excel or other spreadsheet program for tracking, you will need to verify that your spreadsheets are "cleaned up" according to the information on the Importing Your Data page under "Preparing for Data Import". Make sure that you use UTF-8 encoding, remove extraneous blank rows, and compare your data to the data fields available in ProVision, shown under "Which Import Tool Should I Use?". Review sample files if desired to see example formats. If you plan to track custom types of Resources by creating Sections, you will need to create a Section with custom fields, and verify that your spreadsheet contains the same fields.
Once your verification / cleanup is complete, export your spreadsheet as a .csv file.
May be used to import: IP Aggregates
No advance preparation is needed for aggregates imported from RIR. ProVision's built-in importer will ask for your ORGID or an IP, and then populate an aggregate list from that information. Simply choose which aggregates you wish to import.
May be used to import: DNS Zones
ProVision provides automated tools for importing DNS zones from the following server types: BIND, PowerDNS, InfoBlox, NS One, Dyn DNS, and DNSMadeEasy servers, as well as IPPlan MySQL Databases.
For specific DNS zone import instructions for each DNS server type, see: Import DNS Zones
Manually Adding Data
ProVision allows manual adding of data at any time. We recommend verifying that the item has not already been added beforehand (to prevent duplicates), and keeping your desired data structure in mind.
2) Import or Manually Add Data
The order in which items are added will depend on what ProVision functional area (Resources, IPAM, DNS) you will be using, and what the current / desired data structure is. In general, the following order is recommended:
Importing or creating your resources first allows subsequent items to be associated with those resources.
Note: If you already have "Resource" data associated with your IP block data (ie, as fields in a spreadsheet with Resource Name and Resource ID), you may choose not to create those resources ahead of time. The IP Import from CSV tool will give you an option to create those Resources during the IP import process.
Import customers, physical devices, locations, and so forth through the Resource Import from CSV tool. If you wish for additional customization, you can create a custom Section, add the desired fields, and import resources under that Section through the Resource Import Tool.
Adding resources manually may be done at any time under the Resources Tab, by clicking the "Add Entry" button.
B) IP Aggregates and Blocks
The Import from CSV tool will create Top-Level Aggregates and place blocks under those aggregates based on the following method:
First, the importer will parse through the provided data, order all blocks from largest to smallest, then attempt to split the largest block out of an existing block matching the IP space and RIR. If that fails (no larger block exists), then that block is added in the system as its own Top-Level-Aggregate. Subsequent blocks will undergo the same process.
This method ensures that your list of IP blocks does not need to be organized in any particular order.
If your import includes a large number of small blocks (/30s, /32s), be sure you've included at least one large block which encompasses them (/24, /22). This will ensure that the smaller blocks are neatly organized under the larger block, rather than imported as their own Top-Level Aggregates.
See: Importing Your Data
C) Add DNS servers and zones
If using the DNS functionality in ProVision, you will need to add your servers prior to importing zones.
Add DNS Severs
Adding DNS Servers requires administrative access.
Servers are added under the DNS Tab of ProVision, under "DNS Servers". Click on "Add Server" and fill out the server information.
Information for specific server types and options is available under the following sections:
Import DNS Zones
After creating the applicable servers in ProVision, you may import or manually add DNS zones.
BIND Zone Import
- Imports using the named.conf configuration file tied to the zones you are uploading, a .zip or .tar file of the zones themselves, and an optional .csv file mapping zones to customers.
PowerDNS Zone Import
- Option is available after configuring a PowerDNS server with a MySQL backend. Connects to the selected server and imports all zones.
InfoBlox Zone Import
- Imports DNS zones using a provided Host, Username, and Password. The InfoBlox import pulls all zones on the InfoBlox LOCAL grid and adds them to a designated Group. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records.
NS One Zone Import
- Imports DNS zones using a NS One API Key. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records.
Dyn DNS Zone Import
- Imports DNS zones using a Dyn DNS Customer Name, Username, and Password. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records.
DNSMadeEasy Zone Import
- Imports DNS zones using a DNSMadeEasy API Key and API Secret. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records.
IPPlan Zone Import
- Imports DNS zones using IPPlan MySQL database options. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records.
3) Add Users and Groups
In ProVision, the permissions structure is handled by assigning users to groups, then setting specific resource-level C/R/U/D permissions for that group. It is designed to give you as much flexibility as you need to accommodate most use cases. When mapping out the permissions structure for your organization, keep in mind who you want to access to application:
- Internal Users and Roles (Admins, Read Only, etc.)
- Partners related to multiple specific Resources/Accounts
- Customers/Departments with limited view to only their respective Resources/Accounts
Working In Provision
With the basic data now imported, and users set up, you (and your team) are ready to work in ProVision!