Allmon2 Install: Difference between revisions

From AllStarLink Wiki
Jump to navigation Jump to search
No edit summary
 
(10 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/tsawyer/allmon2.git /var/www/html/allmon2
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 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>'''.
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 ==

Latest revision as of 21:24, 29 June 2024

Legacy Version - This page is about a legacy version of AllStarLink. See https://allstarlink.github.io/allmon3/

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.