forked from tsawyer/allmon2
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
124 lines (116 loc) · 6.46 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
Allmon README
Updated July 8, 2016
Allmon is a web site for managing one or more app_rpt (aka Allstar) nodes.
Each managed local node shows a list of connected nodes. The list is
sorted in reverse order of the most recently received node. So the last
node to talk is always at the top of the list. Any node that is currently
being received will be highlighted by a green background as well as moving
to the top of the list. The node list is updated once a second giving near-
real-time status.
Nodes may be grouped together when configuring Allmon. Groups enable two
or mode nodes to be displayed on the same page. This can be handy if you
use devices with smaller screens or you want to see a couple of your nodes
at the same time. Don't try to display more than a few per group as performance
will suffer.
Logged in users can perform connect and disconnects. Users are maintained
with the Apache htpasswd utility. There is only one login level, admin.
Allmon will also monitor VOTER clients. Each VOTER instance displays a list
attached Radio Thin Client Modules (RTCM). The RSSI for each RTCM is displayed
in bar graph style along with a color to indicate the currently voted RTCM.
Install instructions
- If you installed your node(s) from the Allstar web portal and never
touched the command line, you have a fairly steep learning curve ahead
of you. On the other hand, if you know Apache and Linux then installation
should be a piece of cake.
- Apache and PHP need to be installed on your server. The Apache password
utility htpasswd must be available if you want to install an administrator.
- Allmon 2 requires PHP 5.2 or above. If you run Allmon or your ACID node or
your web server is RedHat 5 you will have to update your yum repo to get a
current enough php with
wget -q -O - http://www.atomicorp.com/installers/atomic | sh
and then
yum update php
That should pring you up to php 5.4 as of this writing. Alternatively,
the pecl json package may work but I’ve not tried it.
- The web server can be local to your node or on a stand alone server. If you
are concerned about performance of your node use a stand alone server. Also,
you will be able to view two or mode of your nodes (even if on separate app_rpt
servers). The Asterisk Manager port 5038 (or another of your choosing) must
be open towards your web server.
- Put these files somewhere in your web servers document tree. That can be
the docroot or any subdir you like.
- Copy allmon.ini.txt to allmon.ini.php and then edit it for your node(s)
information. The user ID and passwords you enter here are the one you will
use in manager.conf on your node server(s).
- Optionally copy voter.ini.txt to voter.ini.php and edit with your voter info.
- Create your .htpasswd file for the admin user(s). In your web server
directory, on the command line do: htpasswd -c .htpasswd username
Some systems will need the -d option to force crypr() encryption
needed by php
- Make sure you have the latest Allstar source from svn as there are special
Allmon commands in later verions of rpt.c.
- Edit /etc/asterisk/manager.conf
- Mark astdb.php executable and add to cron. Run just once a day please. ie
01 03 * * * cd /var/www/html/allmon; ./astdb.php
- If you have private nodes rename the privatenodes.sample.txt to
privatenodes.txt and edit it with your information.
The line with NODE|CALL|INFO|LOCATION can be removed. It's there to show
the format only.
- Edit controlpanel.ini.php for your desired commands. Be sure to keep the
labels[] and the cmds[] tags in assoicated pairs.
Allstar Database
- If you don't have the Allstar "database" (really just a text file) the
Node Information column will only show the IP address of the remote nodes.
- ACID and Limey users should run the astdb.php script to get an initial
copy of the database. It should be periodically updated with the
astdb.php script. Please set your cron job to a reasonable time, like
once a day and manually run when you need the occasional adhoc update.
- The Beagle Bone Black already has a daily updated astdb.txt file. BBB
users should add a symbolic link to that file with
"ln -s /var/log/asterisk/astdb.txt astdb.txt".
Known Bugs
- If you have only a group and no individual nodes displayed (menu=yes)
index.php will not redirect to the group.
Updates
- 2012/12/06 Private nodes may be appended to astdb.txt
- 2012/12/10 Fixed groups where more than one group is used
- 2012/12/17 Menu items may be added to allmon.ini
- 2013/04/19 Changes to Voter Menu, see github for details.
- 2014/04/05 Allmon II branch
- Internet Explorer is no longer supported. But every other modern
browser on earth works fine.
- Uses HTML 5 sever-sent events. SSE replaces JavaScript long poling to
increase update frequency and reduce the load on Asterisk. IE does
not support SSE.
- The way the node list is updated has changed because sometimes it
took 5 or 6 clicks before a response. That’s been solved by on-demand
updating parts of the table when the data changes.
- The header rows (with grey background) only update when the page is
first loaded.
- The time columns update every second or so.
- Everything else updates only when something other than the time
columns change.
- Clicks now work first time - every time.
- Other UI improvements.
- Groups are now handled with the nodes=x,x,x key/value in the node
stanza of allmon.ini.php. Groups.ini is no longer used.
- Voter display is a selected node rather than all nodes on the server.
- 2014/04/13 Updated README
- 2014/04/22 Lots of code changes to make this few things hapening:
- Bad login to a server should not prevent sucessfully logged in
node display
- Connecting to AMI, connection failed and login failed status
messages now show
- Show "No Connections." when there aren't any.
- astdb.php won't loop forever when file is not found
- 2014/04/24 Added the Control Panel
- See controlpanel.ini.txt to set up.
- 2014/11/30 Bringing git repository up to date.
- Added astdb.txt changes to README.
- astdb.txt is no longer distributed with Allmon for BBB
compatibility. ACID/Limey users just run astdb.php as before.
- Updated .ini.txt sample files.
- menu.php has a bit more flexibility.
- Better compatibility with private systems.
- Added more example control panel commands.
- 2016/07/07 Added favicon. Thanks KC9ONA