Toolkit Modules
6connect provides customers with additional CLI modules for ProVision power users in the /tools directory. These tools are outlined below.
Users / Permissions
Add User
File: add-user.php
Description: Adds a new user to Provision. Especially useful if an admin has locked themselves out and has access to the local server, or for adding additional credentials to a new local installation. The tool walks through the required information.
Command: “php add-user.php"
Rebuild Permissions
File: rebuild-permissions.php
Description: Will rebuild the cached permissions for the specified resource id. Should not be used outside of a db reset, or a corruption of the permissions cache.
Command: “php rebuild-permissions.php"
DNS
Audit Forward DNS
File: audit_forward_dns.php
Description: Audits the forward DNS for a specified IP block, comparing the DNS records in ProVision to a publicly facing server. Will provide detail output showing resolved records, if records conflict and why.
Command: “php audit_forward_dns.php”
Options:
-v Sets verbose mode to print debug information
-a ﹤message key﹥ run as asycronous request (note: you should not use this, it is for the GUI)
-b ﹤ip block﹥ IP block in cird notation to audit dns for.
-n ﹤name server﹥ FQDN or IP address of specific name server to resolve records against. Defaults to 8.8.8.8.
-h print help
Audit Reverse DNS
File: audit_reverse_dns.php
Description: Audits the reverse DNS for a specified IP block, comparing the DNS records in ProVision to a publicly facing server. Will provide detail output showing resolved records, if records conflict and why.
Command: "php audit_reverse_dns.php"
Options:
-v Sets verbose mode to print debug information
-a ﹤message key﹥ run as asycronous request (note: you should not use this, it is for the GUI)
-b ﹤ip block﹥ IP block in cird notation to audit dns for.
-n ﹤name server﹥ FQDN or IP address of specific name server to resolve records against. Defaults to 8.8.8.8.
-h print help
Database
Database Analyzer
File: databaseAnalyzer.php
Description: Takes two MySQL dump files for input, one thought to be the “good” database, and one the “bad” to compare against each other for differences. Is used internally to audit database changes after an upgrade to ensure all changes for the upgrade were committed by comparing against the template database for that release. Can be useful for diagnosing missed upgrades, or other database issues. Could be used on any set of databases, and is not ProVision specific.
Command: "php databaseAnalyzer.php"
Options:
-v Sets verbose mode to print debug information
-a ﹤database name﹥ Required - the 'good' database to comapre against.
-b ﹤database name﹥ Required - the 'bad' database to check for incorrect information.
-g ﹤globals file﹥ Optional - The script will automatically look to the globals.php file for database connection information. This option can be used to specify and alternate file, or file location.
-h print help
Database Reset
File: dbReset.php
Description: This tool resets portions or all of the database to factory defaults. Can reset only IP, DNS, or Resource information or all all three. If erasing resource information, you need to enter a user to assume global admin permission to log back in with. Even if this isn’t specified, the add-user tool can be used to add a user back after. We recommend creating a backup prior to using this tool, and only use if you are sure you know what you are doing!
Command:"php dbReset.php"
Options:
-v Sets verbose mode to print debug information
-i Erases any and all IP information. Tags, regions, and other IPAM preference settings are not changed.
-d Erases any and all DNS information including zones, records, and archive data. Does not affect DNS perference settings, or configured DNS servers.
-r Resets all resource information back to the factory defaults, and removes all associated information (user groups, files, etc).
-u ﹤user name﹥ User name that will have Global Admin permissions restored on the default resources
-h print help
Import
IPPlan Importer:
File: ipplan_import.php
Description: The IPPlan Importer is a command-line tool to import IPs from an IPPlan database into ProVision. Details on how to use this tool are available at IPPlan Importer.
Command: "php ipplan_import.php"
Options:
For options, refer to IPPlan Importer.
PHPIPAM Importer:
File: phpipam_import.php
Description: Generates a CSV or imports data from a phpipam instance
Command: "php phpipam_import.php"
Options: Contact support if you have any questions
Internal Tools
The following tools contained in the /tools folder are for 6connect internal use only:
File: scp_wrapper.php - Internal tool, not meant for command line use.
File: s64_restart_master - Internal tool, not meant for command line use.
File: s64_restart_slave - Internal tool, not meant for command line use.
File: async_import.php - Internal tool, not meant for command line use.
File: importBigDump.php - Internal tool supporting IPPlan Importer, not meant for command line use.
File: ipplan_functions.php - Internal tool supporting IPPlan Importer, not meant for command line use.
File: dns_transfer_server.php - Internal tool, not meant for command line use.
File: observium_import.php - Internal tool, not meant for command line use.
File: digAndLookup.php
File: pullLAMPInfo.php