• All Files

Install the TCP Collectors

ClosedOn Windows
NoteMicrosoft .NET Framework 4.5.1 and WinPcap 4.1.3 are required for Windows TCP Collector.

To install the Reveille 8 User Analytics TCP Collector, complete the following steps:

  1. Confirm the hardware conforms to System Requirements.
  2. Log on to the previously installed Reveille 8 User Analytics Collector Server (natively) or through Windows Remote Desktop with a local account having local administrator rights.
  3. Verify the server software requirements as documented in System Requirements before installing the Reveille 8 User Analytics TCP Collector.
  4. On the previously installed Reveille 8 User Analytics Connector Server, navigate to the X:<Reveille 8 User Analytics Installation Path>\ReveilleSoftware\ReveilleUserAnalytics\Collector directory. Copy the ReveilleTcpCollectorSetup.msi installation package file to the desired Reveille 8 User Analytics Collector Server.
  5. Double-click ReveilleTcpCollectorSetup.msi. The Welcome window appears.

  6. Complete the installation by answering prompts provided by the wizard. .
  7. When complete, click Finish.
ClosedOn Linux

NoteRed Hat Enterprise Linux is required for running Reveille 8 User Analytics Linux Collector. Check with Reveille Support if you are running other Linux variants.  For a SUSE Enterprise Linux installation follow the below steps.

To install the Linux TCP Collector, complete the following steps:

  1. Confirm the hardware conforms to System Requirements.
  2. Log on to the previously installed Reveille 8 User Analytics Server (natively) or through Windows Remote Desktop with a local account having local administration rights.
  3. Verify the server software as documented in System Requirements before installing Reveille 8 User Analytics Collector.
  4. On the previously installed Reveille 8 User Analytics Connector Server, navigate to the X:<Reveille 8 User Analytics Installation Path>\ReveilleSoftware\ReveilleUserAnalytics\Collector directory. Copy either the reveillelinux32tcpcollector.zip or the reveillelinux64tcpcollector.zip (select the appropriate 32-bit or 64-bit .zip file based on the Linux Operating System mode) installation zip file to the Reveille 8 User Analytics Linux Collector Server.
  1. The Linux collector file can be installed in any directory location; the following steps are based on installing the Linux collector into the folder /opt/reveille_user_analytics. Create a folder /opt/reveille_user_analytics using the following Linux commands:

    sudo mkdir /opt/reveille_user_analytics

    sudo chmod g+rwx /opt/reveille_user_analytics

    cd /opt/reveille_user_analytics

    NoteSome commands may require root privileges on the Linux system to execute. If you are not logged in as root then a recommended way is to use the sudo command. Adding a user to sudo allows that user to execute commands with elevated permissions when not logged in as root. Contact your Linux system administrator for more information on adding a user to sudo.
  2. Copy the Linux collector .zip installation file to the installation folder and unzip the file:

    unzip –a reveillelinux32tcpcollector or unzip –a reveillelinux64tcpcollector

    chmod +x reveilletcpcollector

    ls – t

    The ls command should list these files:

    • rrttcpcollector– The collector executable
    • reveilletcpcollector.config.SAMPLE – The collector sample configuration file
    • reveilletcpcollector.config.FULL – The collector full configuration file
    • DFCMessages.default – DFC messages file
    • MSFTSQLMessages.default – Microsoft SQL messages file
    • OracleMessages.default – Oracle SQL messages file
  3. Verify the Linux collector executable can run by displaying the help file:

    sudo ./rrttcpcollector–help

  4. Update the Linux collector configuration file as shown in the Configure the TCP Collectors section.
  5. Update the Linux collector system to start the Linux collector at system startup:

    sudo gedit /etc/rc.d/rc.local

    Add a command to start the Linux collector:

    # Start the Reveille TCP Collector
    /opt/reveille_user_analytics/rrttcpcollector–start

  6. The Linux collector should now start automatically on system startup. To start the collector, use the following command:

    sudo ./rrttcpcollector-start

ClosedOn Solaris
NoteThe Solaris Collector has been tested on Solaris Version 10 (SunOS 5.10) Update 9 on 64-bit SPARC hardware. The Solaris Reveille Collector is a 32-bit executable. To verify compatibility with your system use the isainfo -v command. The output of this Solaris command will specify what execution modes are supported:
$ isainfo –v
32-bit sparc applications
or
$ isainfo –v
64-bit sparcv9 applications
32-bit sparc applications

To install the Reveille 8 User Analytics Solaris TCP Collector, complete the following steps:

  1. Confirm the hardware conforms to the System Requirements.
  2. Log on to the previously installed Connector Server (natively) or through Windows Remote Desktop with a local account having local administration rights.
  3. Verify the server software as documented in System Requirements before installing Reveille 8 User Analytics Collector.
  1. On the previously installed Connector Server, navigate to the X:<Reveille Installation Path>\ReveilleSoftware\ReveilleUserAnalytics\Collector directory. Copy the reveillesolaristcpcollector.zip installation zip file to the Reveille 8 User Analytics Solaris Collector Server.
  1. The Solaris collector file can be installed in any directory location; the following steps are based on installing the Solaris collector into the folder /opt/reveille_user_analytics. Create a folder /opt/reveille_user_analytics using the following Solaris commands:

    mkdir /opt/reveille_user_analytics

    chmod g+rwx /opt/reveille_user_analytics

    cd /opt/reveille_user_analytics

    NoteSeveral commands require root privileges on the Solaris system to execute. Contact your Solaris system administrator for more information on providing root level access..
  2. Copy the Solaris collector .zip installation file to the installation folder and unzip the file:

    unzip –a solaristcpcollector

    chown root:root reveilletcpcollector

    chmod +x reveilletcpcollector

    chmod u+s reveilletcpcollector

    ls –

    The ls command should list these files:

    • rrttcpcollector– The collector executable
    • reveilletcpcollector.config.SAMPLE – The collector sample configuration file
    • reveilletcpcollector.config.FULL – The collector full configuration file
    • DFCMessages.default – DFC messages file
    • MSFTSQLMessages.default – Microsoft SQL messages file
    • OracleMessages.default – Oracle SQL messages file
  3. Verify the Solaris collector executable can run by displaying the help file:

    ./rrttcpcollector–help

  1. Update the Solaris collector configuration file as shown in the Configure the TCP Collectors section.
  2. Update the Solaris collector system to start the Solaris collector at system startup. Consult with your Solaris system administrator before completing the next step as the information and approach can vary for each Solaris environment.
    • Use an editor such as vi to create a new file startreveilletcpcollector

      vi /tmp/startreveilletcpcollector

    • Add to following commands to the startreveilletcpcollectorfile: 
      #!/sbin/sh
      startcmd () {
         /opt/reveille_user_analytics/rrttcpcollector–start
      }
      stopcmd () {
         /opt/reveille_user_analytics/rrttcpcollector–stop
      }
      case "$1" in
      'start')
           startcmd
           ;;
      'stop')
           stopcmd
           ;;
      ‘restart’)
           stopcmd
           sleep 10
           startcmd
           ;;
      *)
           echo “Usage: $0 { start | stop | restart }”
           exit 1
           ;;
      esac
    • Move the startreveilletcpcollectorstartup file to the proper location and update permissions

      cp /tmp/startreveillehttpcollector /etc/rc3.d/startreveilletcpcollector

      chmod 755 /etc/rc3.d/startreveilletcpcollector

      chown root:root /etc/rc3.d/startreveilletcpcollector

    • Link the startreveilletcpcollectorstartup file to the stopreveilletcpcollectorshutdown file

      ln /etc/rc3.d/startreveilletcpcollector/etc/rc3.d/stopreveilletcpcollectorsudo gedit /etc/rc.d/rc.local

  3. The Solaris collector should now start automatically on system startup. To start the collector, use the following command:

    ./rrttcpcollector-start

ClosedOn AIX

To install the Reveille 8 User Analytics AIX TCP Collector, complete the following steps:

  1. Log on to the previously installed Reveille 8 User Analytics Server (natively) or through Windows Remote Desktop with a local account having local administration rights.
  2. Verify the server software as documented in System Requirements before installing TCP Collector.
  3. On the previously installed Reveille 8 User Analytics Connector Server, navigate to the X:<Reveille 8 User Analytics Installation Path>\ReveilleSoftware\ReveilleUserAnalytics\Collector directory. Copy the reveilleaixtcpcollector.zip installation zip file to the Reveille 8 User Analytics AIX TCP Collector Server.
  4. The AIX collector file can be installed in any directory location; the following steps are based on installing the AIX collector into the folder /opt/reveille_user_analytics. Create a folder /opt/reveille_user_analytics using the following AIX commands:

    sudo mkdir /opt/reveille_user_analytics

    sudo chmod g+rwx /opt/reveille_user_analytics

    cd /opt/reveille_user_analytics

    NoteSome commands may require root privileges on the AIX system to execute. If you are not logged in as root then a recommended way is to use the sudo command. Adding a user to sudo allows that user to execute commands with elevated permissions when not logged in as root. Contact your AIX system administrator for more information on adding a user to sudo.
  5. Copy the AIX collector .zip installation file from step 4 to the installation folder and unzip the file:

    unzip –a reveilleaixtcpcollector

    chmod +x reveilletcpcollector

    ls –

    The ls command should list these files:

    • reveilletcpcollector.config.FULL – The collector full configuration file
    • DFCMessages.default – DFC messages file
    • MSFTSQLMessages.default – Microsoft SQL messages file
    • OracleMessages.default – Oracle SQL messages file
    • rrttcpcollector– The collector executable
    • rrttcpollector.config.SAMPLE – The collector sample configuration file
  6. Verify the AIX collector executable can run by displaying the help file:

    sudo ./rrttcpcollector–help

  7. Update the AIX collector configuration file as shown in the Configure the TCP Collectors section.
  8. Update the AIX collector system to start the AIX collector at system startup.  Modify /etc/inittab or the /etc/rc.local file.  Example rc.local file:

    sudo gedit /etc/rc.d/rc.local

    Add a command to start the AIX collector

    # Start the Reveille TCP Collector
    /opt/reveille_user_analytics/rrttcpcollector–start

  9. The AIX collector should now start automatically on system startup. To start the collector, use the following command:

    sudo ./rrttcpcollector–start

Was this helpful?

Thank you.