K6IB IRLPvMon
Download & Installation
Instructions
 


To Install The IRLPvMon Monitor, Your IRLP Computer Requires The Following Prior To Installation:

  • A Working IRLP Node Is Installed
  • The Apache HTTPD Webserver Is Installed
  • The Perl Interpreter Package Is Installed

Before Installing This, Or Any New IRLP Software,
Please Make Sure You Have A Full Backup Of Your Node - JUST IN CASE!

---------- Installing Apache HTTPD and Perl ----------
Skip If Apache and Perl Are Already Installed

If your system is running Fedora Core 3 or 5, you probably have YUM installed and can use it to install Apache HTTPD and Perl. To install these packages using YUM, type the following commands as user root and follow directions.

yum install httpd

yum install perl

Note: The loading and installation of these programs can require a bit of time.


If your system does not have YUM installed (Redhat 7.3 or 9), you will need to get and install the Apache and Perl programs yourself. Information about these programs is available at these websites.

www.apache.org

www.perl.com


-------- Downloading & Installing The IRLPvMon Package --------

Once Apache and Perl are installed on your IRLP Node computer, you are ready to proceed with the download and installation.

Note: The installation will perform several modifications to the Apache server and IRLP scripts which the installation program will explain. You will have the option to cancel the installation if these operations are not desired.

Note: That This Installation Will Overwrite Any Existing IRLPvMon Installation Including Any IRLPvMon Custom Pages Or Modifications you may have made.

Note: By downloading this package you are accepting the terms of the agreement at the end of this document.

To Download and Install the latest version of IRLPvMon, Login as user root on your IRLP computer and then enter the following three commands:

wget -nd -nc k6ib.com/downloads/k6ib-load-a
chmod +x k6ib-load-a
./k6ib-load-a irlpvmon


After the installation is completed, you will need to setup you nodes Frequency, PL Tone and Echolink Node Number if EchoIRLP is installed. To do this, as user root, type the following command and follow directions.

/var/www/irlpvutil/VMON_SETUP

Note: This utility may be used anytime to change your nodes information.


---------- Using IRLPvMon ----------

To access IRLPvMon point your browser to

your-ip-address/irlpvmon

!! Be Aware: If you have installed the IRLP remote admin program, Apache has been set to listen on port 15426. If that is the case All Browser Calls to the Apache server Must be made with that port number.
  Example:
  http://your-ip-address:15426/irlpvmon


After installation additional information on IRLPvMon and the included utilities can be found by pointing your browser to:

your-ip-address/irlpvmon/help



I hope you will find IRLPvMon a usefull tool on your IRLP node.
If you encounter problems or have questions or comments, let me know.
Please include the word "irlpvmon" in the subject line of any E-Mails.

 Brent - K6IB
 IRLP: 3173


-------- Possible Problem --------

Connection Information Does Not Display

If the connection information does not display and the node already had the scripts "custom_on" & "custom_off" installed for other operations it is possible that the new lines for IRLPvMon were not placed in a location where they would be executed. To fix this problem, make sure the lines below are located in their respective script file where they will always be executed and not after an Exit statement or in a Conditional Section.

Make sure that the line
/var/www/irlpvutil/vstat_on $1
in the /home/irlp/custom/custom_on file Will Always Be Executed.

and the line:
/var/www/irlpvutil/vstat_off
in the /home/irlp/custom/custom_off file Will Always Be Executed


IRLPvMon - License Agreement

By Downloading, Installing, Copying, or Otherwise Using the IRLPvMon Software Package you agree to be bound by the following terms of agreement.

IRLPvMon is a copyrighted package that is provided on a royalty free license basis to Radio Amateurs for use on their Personal or Club IRLP Nodes. Modification is permitted as long as the Copyright Information Remains Intact. Any Copying, Distribution, Modification For Distribution or Any Commercial Use Requires Written Permission.

While a great deal of effort has gone into testing and verifying the package, the IRLPvMon package is provided "AS IS," without warranty of any kind. There is no guarantee that it will work on all IRLP nodes. The Person Downloading And Or Using The Package assumes any and all consequences arising out of the installation and use or inability to use this software package.

Copyright © B.W.Sylvester - 2007