FlowPro APM Administration

Getting Started

Using an SSH Client, ssh to the FlowPro APM and log in as the flowpro user using the password configured during the installation process.

[root@VA_DC_5 ~]# ssh flowpro@10.1.4.31
Password:
Last login: Mon May  4 12:25:11 2015 from 10.1.10.65
FlowPro Application Performance Monitor (TM) v15.4.30.277
[2015-04-30 16:01:05 -0400 (Thu, 30 Apr 2015)]
Copyright (C) 2012 - 2015 Plixer
All rights reserved. Plixer
Need an IPFIX Collector? Download Scrutinizer at http://www.plixer.com
           Machine ID  : xxxxxxxxxxxxxxxx-xxxxxxxxx
      Licensed Version : 15.8
         Licensed Type : valid
           Expiration  : Tue Apr 12 2016
License expires in 343 day(s)

FLOWPRO>

The FLOWPRO> prompt indicates the FlowPro APM is ready for commands. If the initial steps are done correctly, the FlowPro APM is already processing traffic and sending feedback to the IPFIX collector specified.

Server Maintenance

Hardware Failure

If any hardware malfunctions occur, contact technical support for assistance.

Applying Security Patches

Although efforts are made to minimize the risk for security breaches on the appliance, updates to core OS components may be applied.

It is recommended that updates are not installed unless technical support advises or assists. For more information, contact technical support.

Upgrades

Customers are entitled to upgrades provided that maintenance is active. For further instructions, contact technical support.

Backing up the FlowPro APM

The FlowPro APM stores all its details in the plixer.ini file. From the FLOWPRO> prompt, type edit plixer.ini and copy the file contents to a safe location.

Restoring a FlowPro APM from Backup

To restore the FlowPro APM backup, use ssh to log into the appliance. From the FLOWPRO> prompt, type edit plixer.ini and hit enter. Overwrite the contents of the file with the backed up plixer.ini content. Save the changes. FlowPro APM will rebuild the appropriate files and begin operations.

If a new server is being used or server configurations have changed, a new license key may need to be applied.

Commands

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

disable

The disable command is used to stop collection of the specified interface.

FLOWPRO> disable mgmt

edit

The edit command is used to modify system files used in the day to day operations of FlowPro APM. The plixer.ini file is the main configuration file for FlowPro APM. It contains settings used by FlowPro to configure licensing, IPFIX collector, and more.

FLOWPRO> edit plixer.ini

enable

The enable command can be used to enable metrics collection on the specified interface.

FLOWPRO> enable <interface_name> <voip|latency|both>

A list of interfaces is available by using the show command. The modes available to FlowPro APM are latency, VoIP, or both.

FLOWPRO> enable mgmt latency

The above example enables latency monitoring on the mgmt interface.

license

The license command is used to manage the FlowPro APM license key. To generate a license key, Plixer or the reseller will need the FlowPro APM’s unique machine ID. The machine ID is displayed when issuing the license check command.

The following command can be used to show licensing details:

license <check|status>

FLOWPRO> license check
        Machine ID : 5YZ6XEPV66C766369W8DBN2A-XSAAAAASSSWW
  Licensed Version : 15.8
     Licensed Type : valid
        Expiration : Thu Jul 28 2016
License expires in 730 day(s)

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

license <set|update>

FLOWPRO> license set

When applying the license key, it must be one continuous string without any line feeds or carriage returns on the same line as the license=.

[flowpro] collector=10.1.4.94:2055
trackProcessMetrics=0
apmMode=mgmt-latency;
license=Nb7RuIh35R1Uv9uOWTWhBUuLX4mLNtYCxfqlL0j3IEV2r//
hkHhl3EnTTFdZZPK+0jprzFIlW10dmIN7sZOiwlCcA+L5g6HTzQJ/
b8l6hLeLEsoHiYXgj0SsWkKeCu2IBb6Alpv3msIf1k+ps2cbf8abUR/
kdLVkwOwAwozq2kY7/RzTwvj7$

In the new window, beside license= paste in the license key and Press CTRL+X to save. Issuing the license check or license status will verify the key is properly installed.

Contact technical support to acquire a new license key

password

The password command will change the password used for the flowpro username.

FLOWPRO> password
(current) UNIX password:
New password:
Retype new password:

Successful password changes will be applied to the next log in. This password is used when logging in remotely or on the server directly.

service

The service command can be used to manually start, stop, or restart the FlowPro APM service/

service <service_name> <start|stop|restart>

FLOWPRO> service flowpro restart

set

The set command is used to set certain system parameters� At this time, it is used to set the IPFIX Collector. It is primarily an alias to the command edit plixer.ini.

FLOWPRO> set collector

Future versions of FlowPro APM may allow users to utilize the set command without modifying the full configuration.

show

The show command is used to display state or list details available for modification and customization by the user.

The show interfaces command lists the available network interfaces that the FlowPro can utilizes for its operations.

FLOWPRO> show interfaces
 mgmt
 mon1
2 interface(s) available

The show status command displays all running components of the FlowPro APM system, the state of those services, and the current license details.

FLOWPRO> show status
+--------------------------------------------------------------------+
| (mgmt) Latency             ACTIVE
| FlowPro Process Monitor    ACTIVE
| FlowPro License            License expires in 343 day(s)
+--------------------------------------------------------------------+

snoop

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

snoop ip <ip_address> Snoop interfaces <interface_name>

FLOWPRO> snoop ip 10.1.1.1
FLOWPRO> snoop interfaces mgmt

Press CTRL+C to exit the snoop command.

system

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

system <change|restart|shutdown>

FLOWPRO> system change
FLOWPRO> system restart
FLOWPRO> system shutdown