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.
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.
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.
See: Working with Resources, Customizing Sections, Gadgets
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.
See: Working with Resources, Resource Concepts
Impacts: User and Group Permissions
In ProVision, standard user permissions are set by resource and functional area (IPAM, Resource, Peering, etc), with fine-grained permissions able to be set for specific resources.
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
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.
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.
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":
Once your verification / cleanup is complete, export your spreadsheet as a .csv file.
See: Importing Your Data, Working with Resources, Import DNS Zones
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.
See: Import Aggregate Blocks
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.
Before importing DNS zones, it is recommended that a DNS Group be created to hold the zones being imported, and that the DNS server be added into ProVision so that zone updates may be pushed.
For general DNS task, see: DNS Administration, DNS Tab, Working with DNS Groups, Working with DNS Servers
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.
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 may 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.
See: Working with Resources, Importing Your Data
Import your IP Aggregates through the Import from RIR tool, or from a .csv file via IP Import from CSV.
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
If using the DNS module 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.
See: Working with DNS Servers
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.
ProVision offers multiple DNS zone import options, available under the Data Import tab in the Admin section. For more information on importing DNS zones, see Importing your Data and Import DNS Zones.
BIND Zone Import
PowerDNS Zone Import
InfoBlox Zone Import
NS One Zone Import
Dyn DNS Zone Import
DNSMadeEasy Zone Import
IPPlan Zone Import
Manually adding zones may be done at any time from the DNS tab. See Working with DNS Zones - Common Tasks and Editing DNS Zones.
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:
See: Users & Permissions, Working with Users
Users and groups may be added at any time. However, assigning permissions to users and groups is best done after the applicable resource hierarchy has been added into ProVision.
With the basic data now imported, and users set up, you (and your team) are ready to work in ProVision!
Refer to our User Guide and Admin Guide for details on standard user and admin level areas of ProVision. Or, follow the links below for additional details grouped by specific task areas: