Migrate from Infoblox NetMRI to rConfig V8 | NetMRI Import Tool

Migrate your Infoblox NetMRI device inventory to rConfig

Migrate from Infoblox NetMRI to rConfig V8 with the NetMRI Import Tool. Unlike file based sources, NetMRI is queried directly over its REST API, so the workflow starts with a one time connection setup, then follows the same map, load, and import pattern used by the other import tools.

Available in rConfig V8. This tool reduces migration time by pulling your NetMRI inventory directly from the API and bulk importing devices with consistent templates, vendors, and categories.

Note

Running rConfig Pro? See the Pro NetMRI migration guide.

Why Migrate from NetMRI?

NetMRI focuses on network discovery and automation. rConfig V8 provides a dedicated network configuration management platform with:

Advanced scheduling: Flexible task scheduling with cron based timing and dependency management

Template engine: Configuration snippet deployment across device groups with variable substitution

Versioned configuration backups: Full history and diffing of every device configuration

The NetMRI Import Tool makes this transition straightforward with automated device onboarding.

Teams evaluating rConfig as an Infoblox NetMRI alternative usually want dedicated configuration backup and versioning rather than NetMRI’s broader discovery focus. If you are still comparing options, see why rConfig is a strong Infoblox NetMRI alternative. This page covers the migration itself.

How It Works

The import process follows four steps:

1. Configure the NetMRI connection: Store and test the NetMRI REST API connection details
2. Create device type mappings: Define how NetMRI device types translate to rConfig templates, vendors, and categories
3. Load devices from NetMRI: Query the NetMRI API and generate import ready JSON
4. Import devices to rConfig: Bulk import devices with validated configurations

File Locations

The import tool uses the following file locations:

• Connection file: storage/app/rconfig/netmri_connection.json
• Temporary files: storage/app/rconfig/tempdir/
• Import JSON files: storage/app/rconfig/tempdir/rconfig_import_YYYY-MM-DD_HH-mm-ss.json

These directories are created automatically if they don’t exist.

Prerequisites

Before importing devices, ensure you have:

• A reachable NetMRI appliance with the REST API enabled (the connection defaults to HTTPS on port 443)
• NetMRI API credentials with permission to read the device inventory
• Administrator access to rConfig V8
• Device templates, vendors, and categories configured in rConfig matching your NetMRI device types
• At least one credential set created in rConfig (NetMRI does not export usable device passwords)
• SSH/command-line access to the rConfig server

Step 1: Configure the NetMRI Connection

Before you can load any devices, tell rConfig how to reach the NetMRI API. The connection details are stored at storage/app/rconfig/netmri_connection.json.

Command

php /var/www/html/rconfig/artisan rconfig:netmri-connection

Options

• --setup - Set up the NetMRI connection interactively
• --test - Test the existing connection
• --show - Show the current connection info
• --edit-filters - Edit the device filters applied when loading
• --set-url=URL - Update the API URL
• --clear - Clear the stored connection info
• --info - Display command help and usage information

Set Up the Connection

php /var/www/html/rconfig/artisan rconfig:netmri-connection --setup

The wizard prompts you for the host, port (defaults to 443), username, password, and whether to verify the TLS certificate.

Tip

After saving the connection, test it before going any further. This confirms rConfig can authenticate against the NetMRI API.

php /var/www/html/rconfig/artisan rconfig:netmri-connection --test

You can review or remove the stored configuration at any time:

php /var/www/html/rconfig/artisan rconfig:netmri-connection --show
php /var/www/html/rconfig/artisan rconfig:netmri-connection --clear

Step 2: Create Device Type Mappings

NetMRI uses its own device type and vendor naming. rConfig uses templates. Before importing, map each NetMRI device type to an rConfig template, vendor, and category.

Command

php /var/www/html/rconfig/artisan rconfig:netmri-device-mappings

This interactive command lets you view, add, edit, and remove mappings between NetMRI device types and rConfig templates. You will be prompted to provide:

NetMRI device type: The device type reported by NetMRI

rConfig template: The device template ID to use for this device type

Vendor: The vendor ID associated with this device type

Category: The category ID for organising devices

Tags: Multi-select tags for device classification

Prompts: Device enable and main prompts (use {device_name} as placeholder)

Caution

Accurate mappings are critical for successful imports. Verify template, vendor, and category IDs exist in rConfig before creating mappings.

Step 3: Load Devices from NetMRI

Use the load command to query the NetMRI API and convert the returned devices into an intermediate JSON file.

Command

php /var/www/html/rconfig/artisan rconfig:netmri-load-devices

Options

• --batch-size=100 - Number of devices to fetch per API request (default: 100)
• --info - Display command help and usage information

The loader fetches devices in batches, applies your device type mappings, and writes a timestamped JSON file to storage/app/rconfig/tempdir.

php /var/www/html/rconfig/artisan rconfig:netmri-load-devices --batch-size=250

Note

The JSON file is an intermediate artifact. Review it before importing to confirm the device details and template mappings look correct.

Step 4: Import Devices to rConfig

Once you are happy with the JSON file, import it into rConfig.

Command

php /var/www/html/rconfig/artisan rconfig:netmri-import-devices /path/to/rconfig_import.json

Options

• --dry-run - Preview the import without modifying the database
• --info - Display command help and usage information

Dry Run Mode

Always preview the import first. The dry run validates each device and reports what would be imported without writing any records:

php /var/www/html/rconfig/artisan rconfig:netmri-import-devices \
  --dry-run \
  /path/to/rconfig_import.json

Production Import

Execute the actual import:

php /var/www/html/rconfig/artisan rconfig:netmri-import-devices \
  /path/to/rconfig_import.json

Note

All imports use database transactions. If any error occurs during import, all changes are rolled back automatically. Devices that already exist are skipped.

Complete Workflow Example

# Step 1: Configure and test the NetMRI connection
php /var/www/html/rconfig/artisan rconfig:netmri-connection --setup
php /var/www/html/rconfig/artisan rconfig:netmri-connection --test

# Step 2: Create device type mappings
php /var/www/html/rconfig/artisan rconfig:netmri-device-mappings

# Step 3: Load devices from NetMRI
php /var/www/html/rconfig/artisan rconfig:netmri-load-devices --batch-size=100

# Review the generated JSON file
cat storage/app/rconfig/tempdir/rconfig_import_2025-01-25_14-30-45.json

# Step 4: Preview import (dry run)
php /var/www/html/rconfig/artisan rconfig:netmri-import-devices \
  --dry-run \
  storage/app/rconfig/tempdir/rconfig_import_2025-01-25_14-30-45.json

# Step 5: Execute production import
php /var/www/html/rconfig/artisan rconfig:netmri-import-devices \
  storage/app/rconfig/tempdir/rconfig_import_2025-01-25_14-30-45.json

Troubleshooting

Connection failures

Symptoms:

• The connection test or load command cannot reach NetMRI

Resolution:

Re-run the connection test and confirm the host, port, and credentials:

php /var/www/html/rconfig/artisan rconfig:netmri-connection --test

If you use a self signed certificate, set verify SSL to off when running --setup.

No credential sets exist

Symptoms:

• Error during loading: “No device credentials found in the system”

Resolution:

Create at least one credential set in rConfig:

• Navigate to Settings > Credentials
• Create a new credential set with valid SSH credentials
• Re-run the load devices command

Device type mapping not found

Symptoms:

• Devices skipped during loading with “No mapping found for device type”

Resolution:

Create the missing mapping:

php /var/www/html/rconfig/artisan rconfig:netmri-device-mappings

Invalid template/vendor/category ID

Symptoms:

• Import fails with “Template ID X does not exist” or “Vendor ID X not found”

Resolution:

Verify the IDs exist in rConfig (Settings > Templates, Vendors, or Categories) and update the mapping with the correct IDs.

Duplicate devices

Symptoms:

• Validation shows “Device with same name or IP already exists”

Resolution:

Duplicates are automatically skipped during import. Review the import summary to confirm which devices were skipped.

Best Practices

Test the connection first: Always run --test before loading devices

Create mappings before loading: Configure all device type mappings so the loader can resolve each device’s template

Pre-create credential sets: Set up credential sets in rConfig before importing devices

Use dry-run mode: Always run --dry-run first to preview changes and catch errors before the production import

Review the JSON file: Check the generated JSON before importing to confirm device details and mappings

Post-Import Tasks

After successful import:

1. Verify device inventory: Navigate to Devices and confirm all devices imported correctly
2. Review credentials: Check that devices have appropriate credential assignments
3. Test connectivity: Use the device debug command to verify connection to sample devices
4. Check relationships: Verify tags, vendors, categories, and templates are correctly assigned
5. Configure schedules: Set up automated backup schedules for device groups

Frequently Asked Questions

Can I export the device inventory from Infoblox NetMRI?

Yes. rConfig queries NetMRI directly over its REST API and converts the returned devices into an import ready JSON file. The load command fetches devices in batches and applies your device type mappings.

Will device credentials transfer from NetMRI?

No. NetMRI does not export usable device passwords. Create at least one credential set in rConfig before loading devices, then assign credentials to the imported devices afterwards.

Does the NetMRI REST API need to be enabled?

Yes. Enable the REST API on the NetMRI appliance and use an account that can read the device inventory. The connection defaults to HTTPS on port 443.

Does rConfig replace NetMRI for configuration management?

Yes, for configuration backup and versioning. See the full feature comparison on rconfig.com for a side by side breakdown.

Related Documentation

• Oxidized Import - Migrating from Oxidized
• Rancid Import - Migrating from RANCID
• SolarWinds NCM Import - Migrating from SolarWinds NCM
• Connection Templates - Configuring device templates
• Scheduled Tasks - Automating configuration backups