Allmon2 Install: Difference between revisions
No edit summary |
|||
(11 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{Warning|allmon3/}} | |||
[[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. | ||
Line 9: | Line 17: | ||
<pre> | <pre> | ||
repeater@repeater:~$ sudo apt install git | repeater@repeater:~$ sudo apt install git | ||
repeater@repeater:~$ sudo git clone https://github.com/ | repeater@repeater:~$ sudo git clone https://github.com/AllStarLink/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 | ||
Line 17: | Line 25: | ||
== Configuration == | == Configuration == | ||
Now you have to edit the allmon.ini.php file | 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 23: | Line 31: | ||
# 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 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>'''. | 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 | |||
[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> | <pre> | ||
repeater@repeater:~$ htpasswd -cB .htpasswd admin | repeater@repeater:~$ htpasswd -cB .htpasswd admin | ||
repeater@repeater:~$ chmod 777 astdb.php | repeater@repeater:~$ chmod 777 astdb.php | ||
</pre> | </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 | |||
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 == | == Test and Use == | ||
Line 47: | Line 101: | ||
'''If you are using Lighttpd, you must modify your configuration to work with Allmon2.''' | '''If you are using Lighttpd, you must modify your configuration to work with Allmon2.''' | ||
Add | Add | ||
server.stream-response-body = 2 | |||
to /etc/lighttpd/lighttpd.conf and restart lighttpd. |
Latest revision as of 21:24, 29 June 2024
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
- Change: the '500' number [500] to your node number.
- Change: host=127.0.0.1:5038
- Change: passwd=yourpassword
- 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
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.