Interactive mode commands¶
At any time, running the command help, help <command>, <command> ?, or ? will display help in the interface.
acknowledge¶
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 10.1.1.2
REPLICATOR> acknowledge collector 10.1.1.1:2055
backup¶
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
Hint
The collected files can be found in the /home/replicator/supportfiles directory.
collector¶
The collector command is used to add or remove collectors from profiles.
- collector <add|remove> collector_ip profile
REPLICATOR> collector add 10.1.1.1 maineStreet
REPLICATOR> collector remove 10.1.1.1 maineStreet
The allremove directive will remove the specified collector IP address from all profiles.
- collector allremove collector_ip
REPLICATOR> collector allremove 10.1.1.1
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 10.1.1.1 100000
exporter¶
The exporter command is used to add or remove exporters from profiles.
- exporter <add|remove> exporter_ip profile
REPLICATOR> exporter add 10.1.1.2 maineStreet
REPLICATOR> exporter remove 10.1.1.2 maineStreet
The allremove directive will remove the specified exporter IP address from all profiles.
- exporter allremove exporter_ip
REPLICATOR> exporter allremove 10.1.1.2
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
+--------------------------------------------------------------------------+
| 10.1.73.1 Fri Nov 15 13:48:52 2019 1 packet(s)
| 10.1.29.60 Fri Nov 15 13:48:52 2019 2 packet(s)
| 10.202.0.103 Fri Nov 15 13:48:52 2019 5 packet(s)
| 10.200.10.1 Fri Nov 15 13:48:52 2019 32 packet(s)
| 172.20.124.41 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.
Note
It is possible to have 0 packet(s) for exporters that export data infrequently.
ldapadmin¶
Set the admin password for ldap configuration.
license¶
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
Important
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=.
[replicator]
engine=pg
dbname=/home/replicator/html/db/replicator.db
user=
pass=
license=Nb7RuYhxJWxUv9u+nTdHCnRj5R9EiXQv5qDS9WO41jC4XBBYkErNZ6Q+Oi+Q+6uGwfaQJZO6QzE3wjgWsf2CfqlCp3SdO5/txz6yhFurK7Cz4Js1kuraTt96Q1pRru9zCk5gUxbNjISzI3BlY75eMMDddTFv2XKJRxzDe8CK8N1Ov4Okkod1gx9tWW2xFToAJmTyYXGYgIWGFhWOrPTvCB+t1j3kuqnaf/HgVYMahQgDjPHhbuq2ft2HA1iuhRZU2q0Bt8TbSy+6CmvKLe7tSqht5V9bSLYQSdaJ1/gntqAJaa4dGG4fBGmDgK30zLkC+OEFm402axzCmQ==
In the new window, under “license=” paste in the license key. Press CTRL+x to save.
Hint
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.
notate¶
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 10.1.1.2 my awesome router
This description will show up in various reports generated by the show command.
password¶
The password command will change the password used for the replicator user in interactive mode and the admin user in the web interface.
Hint
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.
policy¶
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 192.168.0.0/16 maineStreet include
REPLICATOR> policy add 192.168.2.0/24 maineStreet exclude
REPLICATOR> policy remove 192.168.2.0/24 maineStreet
The include/exclude option is only required if using the add directive.
Collectors are not affected by policies.
profile¶
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.
rebuild¶
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.
REPLICATOR> rebuild
The sampcfg command is an alias to the rebuild command.
restore¶
The restore command is used to recover a database from backup <filename> in /home/replicator/backups
Important
Restore to the same version of PostgreSQL that was used during the backup.
role¶
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 10.1.4.223 eth0 master
REPLICATOR> role set primary
REPLICATOR> role set secondary 10.1.4.66:2002 10
REPLICATOR> role test secondary
Reference the section on fault tolerance for more information.
setting¶
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 10.1.4.66:2003
REPLICATOR> setting disable convertSyslog
Use the show setting command to get a list of settings in the global configuration.
show¶
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.
alarm¶
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
asset¶
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
backups¶
Lists the files in /home/replicator/backups with the date they were last accessed.
REPLICATOR> show backups
collector¶
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 10.1.1.1
config¶
Lists all commands necessary to rebuild all profile settings.
- show config
REPLICATOR> show config
exporter¶
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 10.1.2.5
profile¶
Lists profiles and all policies, exporters, and collectors associated.
- show profile [filter]
REPLICATOR> show profile
REPLICATOR> show profile maineStreet
realtime¶
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.
setting¶
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
status¶
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
snoop¶
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>
REPLICATOR> snoop 10.1.1.1
Specifying the interface will display activity from it.
- snoop interface <interface_name> [port <port_number>]
REPLICATOR> snoop eth0
Hint
Press CTRL+C to exit the snoop command.
system¶
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 10.1.4.223
REPLICATOR> system virtualip disable eth0 10.1.4.223
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