Interactive mode commands

At any time, running the command help, help <command>, <command> ?, or ? will display help in the interface.


The Replicator actively monitors the state of exporters and collectors. If either one is in an alarm state, the acknowledge command can be used to stop the Replicator from sending notifications about unavailable resources.

  • acknowledge <exporter|collector> ip_address:port
REPLICATOR> acknowledge exporter
REPLICATOR> acknowledge collector


Creates a backup of the database in /home/replicator/backups/<filename>. Lists the files in /home/replicator/backups with the date they were last accessed. Backups can be restored using the restore command. Backup names can not contain any spaces.

  • backup [filename]
  • show backups [filename]
  • restore [filename]
REPLICATOR> backup replicator_backup
REPLICATOR> show backups
REPLICATOR> restore replicator_backup

collect supportfiles

Gathers all relevant logs and configuration files and compresses them into a tar.gz file.

REPLICATOR> collect supportfiles


The collected files can be found in the /home/replicator/supportfiles directory.


The collector command is used to add or remove collectors from profiles.

  • collector <add|remove> collector_ip profile
REPLICATOR> collector add maineStreet
REPLICATOR> collector remove maineStreet

The allremove directive will remove the specified collector IP address from all profiles.

  • collector allremove collector_ip
REPLICATOR> collector allremove

Collectors receive replicated packets. Some collectors may not be able to handle high volume. Use this option to set or remove a packet per second threshold.

  • collector threshold collector_ip threshold
REPLICATOR> collector threshold 100000


The exporter command is used to add or remove exporters from profiles.

  • exporter <add|remove> exporter_ip profile
REPLICATOR> exporter add maineStreet
REPLICATOR> exporter remove maineStreet

The allremove directive will remove the specified exporter IP address from all profiles.

  • exporter allremove exporter_ip
REPLICATOR> exporter allremove

The noprofile directive will list all exporters actively sending packets to the Replicator that are not configured in any profiles.

It’s recommended to either add these exporters to a profile or configure them to stop sending packets to the Replicator.

exporter noprofile

REPLICATOR> exporters noprofile

|         Fri Nov 15 13:48:52 2019         1 packet(s)
|        Fri Nov 15 13:48:52 2019         2 packet(s)
|      Fri Nov 15 13:48:52 2019         5 packet(s)
|       Fri Nov 15 13:48:52 2019        32 packet(s)
|     Fri Nov 15 13:48:52 2019         1 packet(s)
Done in 0.035998 secs

This list contains the IP address of the exporter, the last time stamp a packet was received, and the number of packets counted since the last packet summary.


It is possible to have 0 packet(s) for exporters that export data infrequently.


Set the admin password for ldap configuration.


The license command is used to manage the Replicator license key.

To generate a license key, Plixer or the reseller will need the Replicator’s unique machine ID. The machine ID is displayed when issuing the license check command:

  • license <check|status>
REPLICATOR> license check

Machine ID : 6YZ6XEPT66FPH6364A1VQ8NY
Customer ID : austin replicator
Licensed Version : 18.5
Licensed Type : subscription (standalone/primary)
Expiration : 11/30/2020

The license key can be configured on the Replicator using the license set command.

  • license <set|update>
REPLICATOR> license set


When applying the license key, make sure it is a continuous string without any line feeds or carriage returns on the same line as the license=.


In the new window, under “license=” paste in the license key. Press CTRL+x to save.


Issuing either the license check or show status command will verify the key is properly installed. Contact technical support to acquire a new license key.


The notate command can be used to add a description to a profile or IP Address. The description does not require enclosure quotation marks.

  • notate <profile|ip> <profile_name|ip_address> description
REPLICATOR> notate profile maineStreet A fun and happy place
REPLICATOR> notate ip my awesome router

This description will show up in various reports generated by the show command.


The password command will change the password used for the replicator user in interactive mode and the admin user in the web interface.


When changing the interactive password, the utility will prompt for the current replicator user’s password, i.e (current) UNIX password.

  • password <interactive|webui>
REPLICATOR> password interactive
(current) UNIX password:
New password:
Retype new password:

Successful password changes will be applied to the next log in.


The policy command manages what exporters are automatically included or excluded in profiles. Policy inclusion policies are checked first, then exclusion policies. Policies are defined in subnet/cidr notation.

  • policies <add|remove> subnet/cidr profile <include|exclude>
REPLICATOR> policy add maineStreet include
REPLICATOR> policy add maineStreet exclude
REPLICATOR> policy remove maineStreet

The include/exclude option is only required if using the add directive.

Collectors are not affected by policies.


The profile command is used to add, update, remove, enable, disable, and rename profiles.

The name, listening port, and sending port are required when adding or updating a profile.

  • profile <add|update> name listen_port send_port
REPLICATOR> profile add maineStreet 2002 2055
REPLICATOR> profile update maineStreet 2003 2056

Removing a profile will also remove any policies assigned to it. However, other profiles will remain unmodified.

Disabling a profile will keep its settings, policies, exporters, and collectors intact. However, replication will not occur.

  • profile <remove|disable|enable> name
REPLICATOR> profile remove maineStreet
REPLICATOR> profile disable maineStreet
REPLICATOR> profile enable maineStreet

Profiles can also be renamed with the rename directive. Only the name of the profile will be updated. Use profile update to change other details such as the sending port or listening port.

  • profile rename old_name new_name
REPLICATOR> profile rename maineStreet streetOfMaine

profile singularity

Singularity mode will replicate packets as the replicator IP instead of the original exporter’s IP. This allows users to combine packets from multiple exporters into a single exporter IP.

REPLICATOR> profile singularity maineStreet <enable|disable>

By default, the replicator will replicate packets using the original sources of those packets as the exporter.


The rebuild command is only necessary when replication services are down and the administrator wishes to rewrite the internal configuration. Otherwise, the Replicator manages all configurations as real time changes are detected.


The sampcfg command is an alias to the rebuild command.


The restore command is used to recover a database from backup <filename> in /home/replicator/backups


Restore to the same version of PostgreSQL that was used during the backup.


The role command is used when setting up a fault tolerant environment.

  • role set ha master <ip_address>
  • role set ha off
  • role set ha on <priority> <virtual_ip> <ifname> <master|backup>
  • role set primary
  • role set secondary <primary_replicator_ip:listener_port> [timeout]
  • role test <ha|secondary>
REPLICATOR> role set master <ip_address>
REPLICATOR> role set ha off
REPLICATOR> role set ha on 101 eth0 master
REPLICATOR> role set primary
REPLICATOR> role set secondary 10
REPLICATOR> role test secondary

Reference the section on fault tolerance for more information.


The setting command manages the global configuration for the Replicator. Features can be enabled, disabled, and set.

  • setting set name value
  • setting <enable|disable> name
REPLICATOR> setting set metricsSent
REPLICATOR> setting disable convertSyslog

Use the show setting command to get a list of settings in the global configuration.


The show command generates reports based on configuration settings and real time data.

  • show alarm [filter]
  • show asset [filter]
  • show backups
  • show collector [filter]
  • show config
  • show exporter [filter]
  • show profile [filter]
  • show realtime [filter]
  • show setting [filter]
  • show status

Most show commands also have a [filter] option which will only display details that match the filter. The entire report is displayed if no filter is included.

The list and sh commands are aliases to the show command.


Lists exporters that have stopped sending data to the replicator and collectors that are no longer reachable by the replicator.

  • show alarm [filter]
REPLICATOR> show alarm
REPLICATOR> show alarm 10.1.4


Generates a report detailing IP addresses, whether the IP address is an exporter and/or collector, dns names, and descriptions.

  • show asset [filter]
REPLICATOR> show asset
REPLICATOR> show asset plxr.local


Lists the files in /home/replicator/backups with the date they were last accessed.

REPLICATOR> show backups


Generates a report showing the collector(s) IP address, dns name, description, and which profiles currently include the collector(s).

  • show collector [filter]
REPLICATOR> show collector
REPLICATOR> show collector


Lists all commands necessary to rebuild all profile settings.

  • show config
REPLICATOR> show config


Generates a report showing the exporter(s) IP address, dns name, description, and which profiles are currently including the exporter(s).

  • show exporter [filter]
REPLICATOR> show exporter
REPLICATOR> show exporter


Lists profiles and all policies, exporters, and collectors associated.

  • show profile [filter]
REPLICATOR> show profile
REPLICATOR> show profile maineStreet


Peers into the live stream and shows statistics of exporters, in and out statistics, and CPU usage.

  • show realtime [filter]
REPLICATOR> show realtime
REPLICATOR> show realtime 192.168

Press CTRL+C to exit the realtime report.


Displays a list of all global configuration settings, the current values, and whether they are enabled or disabled.

  • show setting [filter]
REPLICATOR> show setting
REPLICATOR> show setting metric


Lists all replicator services and licenses, and shows the status of each.

  • show status
REPLICATOR> show status

| Version                        v18.5.24.2345
| Replicating Port 2055          ACTIVE
| Replicator Vitalizer           ACTIVE
| Replicator API                 ACTIVE
| Replicator Monitor             ACTIVE
| Replicator State               ACTIVE
| Replicator License             License Expires: 380
+ process checking took 0.22578 secs


The snoop command can be used to verify that packets are being received by or sent from the replicator for a certain IP address.

  • snoop <ip_address>

Specifying the interface will display activity from it.

  • snoop interface <interface_name> [port <port_number>]
REPLICATOR> snoop eth0


Press CTRL+C to exit the snoop command.


The system command is used to change state of the replicator. The directive change is used to change the host name or IP address.

  • system <change|restart|shutdown>
REPLICATOR> system change
REPLICATOR> system restart
REPLICATOR> system shutdown
  • system virtualip enable <ifname> <virtual_ip>
  • system virtualip disable <ifname> <virtual_ip>
REPLICATOR> system virtualip enable eth0
REPLICATOR> system virtualip disable eth0

These commands allow users to add or remove a virtual IP address for high availability (HA) configurations.

upload supportfiles

Sends collected support files to Plixer supportfor analysis. Make sure to run collect supportfiles.

REPLICATOR> upload supportfiles


Shows the current version of the Replicator appliance.