Difference between revisions of "Allmon2 Install"

From AllStarLink Wiki
Jump to navigation Jump to search
 
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
[[Category:How to]]
 
[[Category:How to]]
 
[[Category:Node Configuration]]
 
[[Category:Node Configuration]]
 +
The full original text of installation instruction is available where the source code resides.
 +
https://github.com/AllStarLink/AllMon2
 +
 +
Note that you will also need to install Apache or lighttpd(small memory footprint version for a Pi), and PHP to make it work on the web as a prerequisite if not already installed.
 +
Those instructions can change with subsequent updates/releases so check the web for current instruction for them.
  
 
The first thing to do is to log on your node as user 'repeater' command line, you can log in with a keyboard and monitor or using SSH as in the initial node setup.
 
The first thing to do is to log on your node as user 'repeater' command line, you can log in with a keyboard and monitor or using SSH as in the initial node setup.
  
−
repeater@repeater:~$
+
repeater@repeater:~$
−
 
 
  
 
Once you are there you have to type the following commands:
 
Once you are there you have to type the following commands:
  
−
 
+
<pre>
 
repeater@repeater:~$ sudo apt install git
 
repeater@repeater:~$ sudo apt install git
−
 
+
repeater@repeater:~$ sudo git clone https://github.com/AllStarLink/AllMon2.git /var/www/html/allmon2
−
repeater@repeater:~$ sudo git clone https://github.com/tsawyer/allmon2.git /var/www/html/allmon2
 
−
 
 
 
repeater@repeater:~$ cd /var/www/html/allmon2
 
repeater@repeater:~$ cd /var/www/html/allmon2
−
 
 
repeater@repeater:~$ sudo mv allmon.ini.txt allmon.ini.php
 
repeater@repeater:~$ sudo mv allmon.ini.txt allmon.ini.php
−
 
 
repeater@repeater:~$ sudo mv controlpanel.ini.txt controlpanel.ini.php
 
repeater@repeater:~$ sudo mv controlpanel.ini.txt controlpanel.ini.php
 +
</pre>
  
 +
== Configuration ==
  
−
 
+
Now you have to edit the allmon.ini.php file
−
==  Allmon2 Configuration.  ==
 
−
 
 
−
Now you have to edit the allmon.ini.php file:
 
−
 
 
  
 
repeater@repeater:~$ sudo nano allmon.ini.php
 
repeater@repeater:~$ sudo nano allmon.ini.php
Line 31: Line 29:
 
# Change: the '500' number [500] to your node number.
 
# Change: the '500' number [500] to your node number.
 
# Change: host=127.0.0.1:5038
 
# Change: host=127.0.0.1:5038
−
# Change: passwd=yourpassword
+
# Change: passwd=yourpassword  
−
# (note: 'llcgi' is the default password acording to the initial node setup)
+
# Note: 'llcgi' is the default password according to the initial node setup. However look at 'secret = xxxxx' in /etc/asterisk/manager.conf to be sure of the correct password.
 
# Change: menu=yes
 
# Change: menu=yes
  
 +
After making your changes type '''<CTRL> + <X>''' and then type '''<Y>''' followed by '''<Enter>'''. You will be back to the previous menu and choose '''<Back>'''.
 +
 +
Example almond.ini.php with node(s) listed under a menu item. In this example named MySites.
 +
 +
<pre>
 +
[1234]
 +
system=MySites
 +
host=127.0.0.1
 +
user=admin
 +
passwd=yourpassword
 +
nomenu=yes
 +
[1234 My Node]
 +
system=MySites
 +
nodes=1234
 +
[1234 My Node RTCM]
 +
system=MySites
 +
rtcmnode=1234
  
−
After making your changes type '''<CTRL> + <X>''' and then type '''<Y>''' followed by '''<Enter>'''. You will be back to the previous menu and choose '''<Back>'''.
+
[1235]
 +
system=MySites
 +
host=127.0.0.1
 +
user=admin
 +
passwd=yourpassword
 +
nomenu=yes
 +
[1235 Another Node]
 +
system=MySites
 +
nodes=2510
 +
</pre>
  
 +
== Password to Enable Buttons and Control Panel ==
  
 +
While in the /var/www/html/allmon2 directory
 +
<pre>
 
repeater@repeater:~$ htpasswd -cB .htpasswd admin
 
repeater@repeater:~$ htpasswd -cB .htpasswd admin
 +
repeater@repeater:~$ chmod 777 astdb.php
 +
</pre>
 +
Note: don't use an exclamation mark in the .htpasswd password.
 +
 +
== Setup Database/DB file ==
 +
On initial install, you will need to manually create the file which has a PHP script to run and do it for you.
 +
 +
From inside the active Allmon directory at the command line,
 +
 +
./astdb.php
 +
 +
as root or
  
−
repeater@repeater:~$ chmod 777 astdb.php
+
sudo ./astdb.php
 +
 
 +
To keep it up to date, you need to run that command from the system cron or crontab. Once a day is suggested.
 +
Adjust location as needed.
  
  
−
== Allmon2 Test and Use.  ==
+
== Test and Use ==
  
 
Using your web browser go to:
 
Using your web browser go to:
−
 
  
 
Note: 192.168.x.x is your nodes IP.
 
Note: 192.168.x.x is your nodes IP.
  
−
http:192.168.x.x/allmon2
+
http://192.168.x.x/allmon2
  
 
There you can login with the user 'admin' and your password 'yourpassword' or remember default password is 'llcgi'.
 
There you can login with the user 'admin' and your password 'yourpassword' or remember default password is 'llcgi'.
 +
 +
== Lighttpd Notes ==
 +
'''If you are using Lighttpd, you must modify your configuration to work with Allmon2.'''
 +
 +
Add
 +
server.stream-response-body = 2
 +
to /etc/lighttpd/lighttpd.conf and restart lighttpd.

Latest revision as of 13:50, 7 June 2023

The full original text of installation instruction is available where the source code resides. https://github.com/AllStarLink/AllMon2

Note that you will also need to install Apache or lighttpd(small memory footprint version for a Pi), and PHP to make it work on the web as a prerequisite if not already installed. Those instructions can change with subsequent updates/releases so check the web for current instruction for them.

The first thing to do is to log on your node as user 'repeater' command line, you can log in with a keyboard and monitor or using SSH as in the initial node setup. 

repeater@repeater:~$

Once you are there you have to type the following commands: 

repeater@repeater:~$ sudo apt install git
repeater@repeater:~$ sudo git clone https://github.com/AllStarLink/AllMon2.git /var/www/html/allmon2
repeater@repeater:~$ cd /var/www/html/allmon2
repeater@repeater:~$ sudo mv allmon.ini.txt allmon.ini.php
repeater@repeater:~$ sudo mv controlpanel.ini.txt controlpanel.ini.php

Configuration

Now you have to edit the allmon.ini.php file

repeater@repeater:~$ sudo nano allmon.ini.php

  1. Change: the '500' number [500] to your node number.
  2. Change: host=127.0.0.1:5038
  3. Change: passwd=yourpassword
  4. Note: 'llcgi' is the default password according to the initial node setup. However look at 'secret = xxxxx' in /etc/asterisk/manager.conf to be sure of the correct password.
  5. Change: menu=yes

After making your changes type <CTRL> + <X> and then type <Y> followed by <Enter>. You will be back to the previous menu and choose <Back>.

Example almond.ini.php with node(s) listed under a menu item. In this example named MySites. 

[1234]
system=MySites
host=127.0.0.1
user=admin
passwd=yourpassword
nomenu=yes
[1234 My Node]
system=MySites
nodes=1234
[1234 My Node RTCM]
system=MySites
rtcmnode=1234

[1235]
system=MySites
host=127.0.0.1
user=admin
passwd=yourpassword
nomenu=yes
[1235 Another Node]
system=MySites
nodes=2510

Password to Enable Buttons and Control Panel

While in the /var/www/html/allmon2 directory 

repeater@repeater:~$ htpasswd -cB .htpasswd admin
repeater@repeater:~$ chmod 777 astdb.php

Note: don't use an exclamation mark in the .htpasswd password.

Setup Database/DB file

On initial install, you will need to manually create the file which has a PHP script to run and do it for you.

From inside the active Allmon directory at the command line,

./astdb.php

as root or

sudo ./astdb.php

To keep it up to date, you need to run that command from the system cron or crontab. Once a day is suggested. Adjust location as needed.


Test and Use

Using your web browser go to:

Note: 192.168.x.x is your nodes IP. 

http://192.168.x.x/allmon2

There you can login with the user 'admin' and your password 'yourpassword' or remember default password is 'llcgi'.

Lighttpd Notes

If you are using Lighttpd, you must modify your configuration to work with Allmon2.

Add 

server.stream-response-body = 2

to /etc/lighttpd/lighttpd.conf and restart lighttpd.

Retrieved from "https://wiki.allstarlink.org/index.php?title=Allmon2_Install&oldid=7334"