Changes

Jump to navigation Jump to search
Line 1: Line 1:  +
[[Category: How to]]
 
PTTLink for beginners.
 
PTTLink for beginners.
    
== The first step is to create an account. ==
 
== The first step is to create an account. ==
   −
Go to [https://www.pttlink.org/ https://www.pttlink.org/] and click the '''<Sign Up>''' link.
+
Go to https://pttlink.org/ and click on  the '''<Login/Sign Up>''' link.
[[File:Ptt site menu login.png|none|thumb|800x800px]]
+
 
[[File:Ptt_sign_up.png|frameless|border|533x533px]]
+
[[File:Ptt site menu login.png|none|thumb|545x545px]]
 +
 
 +
Next click the '''<Sign Up>''' link.
 +
 
 +
[[File:Ptt_site sign up.png|none|thumb]]
    
== Download PTTLink image file ==
 
== Download PTTLink image file ==
Line 13: Line 18:  
Go to [[Main_Page#Downloads|wiki.pttlink.org]] scroll down to the Downloads section and select the appropriate image for the type of system you will use.
 
Go to [[Main_Page#Downloads|wiki.pttlink.org]] scroll down to the Downloads section and select the appropriate image for the type of system you will use.
   −
[[File:Ptt_download.png|frameless|border|533x533px]]
+
[[File:ASL download.png|none|thumb]]
    
Write the image file to media. Either a USB memory stick, CD or DVD, or a microSD card (Raspberry Pi).
 
Write the image file to media. Either a USB memory stick, CD or DVD, or a microSD card (Raspberry Pi).
Line 19: Line 24:  
== Login to your account ==
 
== Login to your account ==
   −
You will need to login to your account at [https://www.pttlink.org/ https://www.pttlink.org/]
+
You will need to login to your account at [https://pttlink.org/ https://PTTLink.org/]
[[File:Ptt_site_menu_login.png|none|thumb|800x800px]]
+
[[File:Ptt site menu login.png|none|thumb|579x579px]]
    
Click on  <'''Login/Sign Up>'''  as shown in the image above.
 
Click on  <'''Login/Sign Up>'''  as shown in the image above.
 +
 +
[[File:Ptt site login.png|none|thumb]]
    
== Create a Server ==
 
== Create a Server ==
    
You will need to create a "server" :  Click on '''<Portal>''' then '''<Server Settings>'''.  
 
You will need to create a "server" :  Click on '''<Portal>''' then '''<Server Settings>'''.  
[[File:Asl server1 .png|none|thumb|800x800px]]
+
[[File:ptt site server settings.png|none|thumb|579x579px]]
 
Click on '''<Add a new server>'''.
 
Click on '''<Add a new server>'''.
   Line 35: Line 42:     
Fill in all of the information and click '''<Submit>''' at the bottom of the page.
 
Fill in all of the information and click '''<Submit>''' at the bottom of the page.
[[File:Asl_server_settings_.png|none|thumb|800x800px]]
+
[[File:ptt site server settings form.png|none|thumb|800x800px]]
    
== Request a Node number ==
 
== Request a Node number ==
    
At the top of the page,  click '''<Portal>''' and then on '''<Node Settings>'''.  
 
At the top of the page,  click '''<Portal>''' and then on '''<Node Settings>'''.  
[[File:Asl_node_.png|none|thumb|800x800px]]
+
[[File:Ptt site node settings.png|none|thumb|565x565px]]
 +
 
 +
Then click '''<Continue...>'''.
 +
 
 +
[[File:ptt site request node number 1.png|none|thumb]]
   −
Then click '''<Request a new node number>'''.
+
Then click '''<Request>'''.
   −
[[File:Asl_request_node_.png|none|thumb|800x800px]]Select which server you would wish to have a node number assigned to
+
[[File:ptt site request node number 2.png|none|thumb|424x424px]]
   −
if you need more than one node number for the same server, repeat this process
+
Select which server you would wish to have a node number assigned to.
   −
A comment of 'additional node on same server'  would be appropriate
+
A comment of 'additional node on same server'  would be appropriate if you are requesting a second node number.
[[File:Asl_request_node2_.png|none|thumb|800x800px]]
+
[[File:ptt site request node number 3.png|none|thumb|673x673px]]
    
Once your node number request(s) are processed you will receive an email.
 
Once your node number request(s) are processed you will receive an email.
Line 55: Line 66:  
== Edit Node settings ==
 
== Edit Node settings ==
   −
Log into your account on [https://www.pttlink.org/ https://www.pttlink.org/]
+
Log into your account on https://pttlink.org/  
    
Click '''<Portal>''' then '''<Node settings>'''.  
 
Click '''<Portal>''' then '''<Node settings>'''.  
Line 64: Line 75:     
Fill in the information for you node and click '''<Submit>'''.
 
Fill in the information for you node and click '''<Submit>'''.
[[File:Asl node settings .png|none|thumb|800x800px]]
+
[[File:ptt site node settings form.png|none|thumb|800x800px]]
    
Write down your node number, password and the call sign you assigned for the node as you will use them to configure your PTTLink system.
 
Write down your node number, password and the call sign you assigned for the node as you will use them to configure your PTTLink system.
   −
== Install and configure PTTLink to your computer ==
+
 
 +
== Install and configure PttLink to your computer ==
    
Consult your owners manual or your favorite internet search engine for how to install an image for your computer system.
 
Consult your owners manual or your favorite internet search engine for how to install an image for your computer system.
Line 74: Line 86:  
Install the PTTLink disk image to your computer.  Insert the appropriate media for your system and boot the computer.
 
Install the PTTLink disk image to your computer.  Insert the appropriate media for your system and boot the computer.
   −
When the login prompt appears enter the user ID of '''repeater''' and press '''<Enter>'''.
+
When the login prompt appears enter the user ID of  
 +
 
 +
'''repeater'''  
 +
 
 +
and press '''<Enter>'''.
   −
Enter the default password of  '''pttlink'''
+
Enter the default password of
 +
  '''allstarlink'''
    
Follow the on screen instructions for the initial password change.
 
Follow the on screen instructions for the initial password change.
Line 82: Line 99:  
For users familiar with the linux operation system you may proceed to edit the system manually.
 
For users familiar with the linux operation system you may proceed to edit the system manually.
   −
For users not familiar with linux and PTTLink, at the Linux CLI (command line interface)
+
For users not familiar with linux and PttLink, at the Linux CLI (command line interface)
   −
Type  '''sudo pttlink-menu'''  as the example below shows.
+
Type  '''sudo asl-menu'''  as the example below shows.
   −
repeater@repeater:~$ sudo pttlink-menu
+
repeater@repeater:~$ sudo asl-menu
    
This will load the PTTLink configuration menu.
 
This will load the PTTLink configuration menu.
Line 96: Line 113:  
[[File:002_first_time.png|none|thumb|640x640px]]
 
[[File:002_first_time.png|none|thumb|640x640px]]
   −
Cause it is your first time setup, answer  '''<Yes>''' so you can setup a "'''root'''" password. Don't forget to write down your user and password.
+
Since it is your first time setup, answer  '''<Yes>''' so you can setup a "'''root'''" password. Don't forget to write down your user an password.
 
[[File:003_password.png|none|thumb|640x640px]]
 
[[File:003_password.png|none|thumb|640x640px]]
   Line 102: Line 119:  
[[File:004_repeater_password.png|none|thumb|640x640px]]
 
[[File:004_repeater_password.png|none|thumb|640x640px]]
   −
Now let's set time zone '''<Ok>'''.
+
Now lets set time zone '''<Ok>'''.
 
[[File:005_timezone.png|none|thumb|640x640px]]
 
[[File:005_timezone.png|none|thumb|640x640px]]
   Line 159: Line 176:  
[[File:023_n_menu_n2.png|none|thumb|640x640px]]
 
[[File:023_n_menu_n2.png|none|thumb|640x640px]]
   −
Type the node password for your node. Yes the one you previously wrote down from PTTLik site.
+
Type the node password for your node. Yes the one you previously wrote down from PTTLink site.
 
[[File:024_node_password.png|none|thumb|640x640px]]
 
[[File:024_node_password.png|none|thumb|640x640px]]
   Line 226: Line 243:  
[[File:046_a_menu_az.png|none|thumb|640x640px]]
 
[[File:046_a_menu_az.png|none|thumb|640x640px]]
   −
Review what you wrote down with what you have configured on your system and press '''<Enter>'''.
+
Review what you wrote down with what you have configured on your systemand press '''<Enter>'''.
 
[[File:047_review.png|none|thumb|640x640px]]
 
[[File:047_review.png|none|thumb|640x640px]]
   Line 250: Line 267:  
[[File:054_select_menu_sartup.png|none|thumb|640x640px]]
 
[[File:054_select_menu_sartup.png|none|thumb|640x640px]]
   −
If you answer was '''<No>''', remember you can come back to this menu typing  '''sudo pttlink-menu'''  as the following example:
+
If you answer was '''<No>''', remember you can come back to this menu typing  '''sudo asl-menu'''  as the following example:
   −
repeater@repeater:~$ sudo pttlink-menu
+
repeater@repeater:~$ sudo asl-menu
    
[[File:055_message.png|none|thumb|640x640px]]
 
[[File:055_message.png|none|thumb|640x640px]]
Line 260: Line 277:     
== PTTLink Audio settings with SimpleUSB ==
 
== PTTLink Audio settings with SimpleUSB ==
 +
Once you've hooked up a radio with your desired interface, it's time to test and tune the audio from the radio.
   −
type  '''sudo pttlink-menu'''  like the example bellow:
+
type  '''sudo asl-menu'''  like the example below:
   −
repeater@repeater:~$ sudo pttlink-menu
+
repeater@repeater:~$ sudo asl-menu
    
Choose option '''<4>'''.
 
Choose option '''<4>'''.
Line 288: Line 306:  
== PTT and COS polarity settings ==
 
== PTT and COS polarity settings ==
   −
If your radio, need PTT and/or COS/CTCSS polarity to be inverted go to the mail PTTLink menu and choose option '''<6>'''.
+
Your radio may require PTT and/or COS/CTCSS polarity to be inverted to work properly.  To do this, go to the main ASL menu and choose option '''<6>'''.
 
[[File:103_asl_menu_6.png|none|thumb|640x640px]]
 
[[File:103_asl_menu_6.png|none|thumb|640x640px]]
   Line 294: Line 312:  
[[File:104_config_menu_i.png|none|thumb|640x640px]]
 
[[File:104_config_menu_i.png|none|thumb|640x640px]]
   −
You will be logger to a text file where you will need to find and edit some values:
+
You will be taken to a text file where you will need to find and edit some values:
    
PTT invert:
 
PTT invert:
   −
Search for the line beguining with '''invertptt ='''  and change its value as follows:
+
Search for the line begining with '''invertptt ='''  and change its value as follows:
   −
'''0''' = Ground to Transmit.
+
'''0''' = Ground to Transmit (most common).
    
'''1''' = Open to Transmit.
 
'''1''' = Open to Transmit.
[[File:105_invertptt.png|none|thumb|640x640px]]
+
[[File:Ptt_invertptt.png|none|thumb|640x640px]]
    
COS/CTCSS invert:
 
COS/CTCSS invert:
Line 313: Line 331:  
'''no''' = No carrier detection at all.
 
'''no''' = No carrier detection at all.
   −
'''usb''' = Cor line active Hi.
+
'''usb''' = COR (COS) line active Hi.
   −
'''usbinvert''' = Cor line active Low.
+
'''usbinvert''' = COR (COS) line active Low.
[[File:106_invertcos.png|none|thumb|640x640px]]
+
[[File:Ptt_invertcarrier.png|none|thumb|640x640px]]
    
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>'''.
Line 325: Line 343:  
Choose option '''<G>''' to restart PTTLink software and apply changes. Choose '''<Back>''', repeat your audio test if needed.
 
Choose option '''<G>''' to restart PTTLink software and apply changes. Choose '''<Back>''', repeat your audio test if needed.
 
[[File:108_diag_menu_g.png|none|thumb|640x640px]]
 
[[File:108_diag_menu_g.png|none|thumb|640x640px]]
 +
 +
== Ensure the nodelist is downloading ==
 +
Before your node will connect it needs to have the nodelist available.  This file will automatically be downloaded by systems support scripts and placed into /var/lib/asterisk/rpt_nodes.
 +
 +
If for some reason your node never downloads the nodelist, it may mean you are missing the required support scripts and configuration.
 +
 +
=== Add missing NodeUpdate.sh and NodeNameUpdate.sh scripts ===
 +
Copy the following if you are missing the scripts below in /usr/local/bin and do not have contab entries that call them
 +
 +
* Copy the following to /usr/local/bin/NodeUpdate.sh
 +
<syntaxhighlight lang="sh">
 +
#!/bin/bash
 +
#
 +
# A cron job script for downloading the extnodes file with error reporting
 +
#
 +
#
 +
# This is intended to be run from cron every 5 min
 +
#  Copyright 2018 Bryan Fields
 +
#  Licensed under the GNU GPLv2
 +
 +
URL="http://register.pttlink.org/cgi-bin/gennodes.php"
 +
FILEPATH=/var/lib/asterisk
 +
 +
#sleep for a random time of 0-300 seconds
 +
#sleep $[( $RANDOM % 299 )  + 1 ]s
      −
At this point your node should be up and running.
+
# use curl in silent and compressed mode, connect timeout of 5 and
 +
# -f for fail with an error code of 22 on server errors
 +
#-m 20 is a max time for the whole process of 20 seconds
 +
curl -s --compressed --connect-timeout 5 -f -m 20 -o /tmp/rpt_extnodes-temp $URL
 +
#curl --connect-timeout 5 -f -m 20 -o /tmp/rpt_extnodes-temp $URL
 +
exitcode=$?
 +
if [ "$exitcode" = "0" ]; then
 +
    grep -q extnodes /tmp/rpt_extnodes-temp
 +
        if [ $? -eq "0" ] ;then
 +
            chmod 700 /tmp/rpt_extnodes-temp
 +
            cp /tmp/rpt_extnodes-temp $FILEPATH/rpt_extnodes-temp
 +
            mv -f $FILEPATH/rpt_extnodes-temp $FILEPATH/rpt_extnodes
 +
            whenandwhere=`grep "Generated at" /tmp/rpt_extnodes-temp |cut -c2-100`
 +
            #don't print out on good run
 +
    #echo "NodeUpdate installed a new nodes list $whenandwhere"
 +
    logger -i "NodeUpdate installed a new nodes list $whenandwhere"
 +
        else
 +
            #echo "NodeUpdate failed to parse node list; node list not updated"
 +
    logger -i "NodeUpdate failed to parse node list; node list not updated"
 +
            exit 1
 +
        fi
 +
 
 +
else
 +
    #echo "NodeUpdate could not get nodes list from server"
 +
    logger -i "NodeUpdate could not get nodes list from server"
 +
    exit 1
 +
fi
 +
exit 0
 +
</syntaxhighlight>
 +
* Copy the following to /usr/local/bin/NodeNameUpdate.sh
 +
<syntaxhighlight lang="sh">
 +
#!/bin/bash
 +
#
 +
# A cron job script for downloading custom node announcements with error reporting
 +
#
 +
# This is intended to be run from cron every 8 hours and will randomly insert a delay from 0-8 hours
 +
#
 +
#  Copyright 2018 Bryan Fields
 +
#  Licensed under the GNU GPLv2
 +
 
 +
URL="rsync://rsync.pttlink.org/connect-messages"
 +
FILEPATH="/var/lib/asterisk/sounds/rpt/nodenames"
 +
 
 +
#sleep for a random time of 0-28800 seconds (8 hours)
 +
sleep $[ ( $RANDOM % 28799 )  + 1 ]s
 +
 
 +
#assign the filesUpdated var with the number of files changed by rsync.  This is nasty, but it works.
 +
 
 +
filesUpdated=`rsync -a --stats $URL $FILEPATH |grep "Number of regular files transferred" | cut -c 38-50`
 +
exitcode=$?
 +
if [ "$exitcode" = "0" ]; then
 +
    if [ "$filesUpdated" = "0" ]; then
 +
echo "NodeNameUpdate run with no updates"
 +
logger -i "NodeNameUpdate run with no updates"
 +
    elif [ "$filesUpdated" > "0" ]; then
 +
echo "NodeNameUpdate updated $filesUpdated nodenames"
 +
        logger -i "NodeNameUpdate updated $filesUpdated nodenames"
 +
    fi
 +
else
 +
    echo "NodeNameUpdate failed"
 +
    logger -i "NodeUpdate failed"
 +
    exit 1
 +
fi
 +
exit 0
 +
</syntaxhighlight>
 +
* Add entries to crontab
 +
<syntaxhighlight lang="text">
 +
0 0,8,16 * * * root /usr/local/bin/NodeNameUpdate.sh > /dev/null 2>&1
 +
*/5 * * * * root /usr/local/bin/NodeUpdate.sh > /dev/null 2>&1
 +
01 03 * * * cd /var/www/html/allmon2; ./astdb.php
 +
</syntaxhighlight>
 +
 
 +
== PTTLink Configuration Updates ==
 +
Run the following commands to add PTTLink server address.
 +
 
 +
<pre>
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/rc.updatenodelist
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/NodeNameUpdate.sh
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/NodeUpdate.sh
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/rpt.conf
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/iax.conf
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/extensions.conf
 +
 
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /var/www/html/allmon2/astdb.php
 +
sudo sed -i 's/Allstar /PTTLink / g' /var/www/html/allmon2/header.inc
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /var/www/html/allmon2/link.php
 +
 
 +
sudo service asterisk restart
 +
</pre>
 +
 
 +
Edit the following file with:
 +
 
 +
<pre>
 +
sudo nano /usr/local/sbin/astdb.php
 +
</pre>
 +
 
 +
Replace line:
   −
== Port forwarding ==
+
<pre>
 +
$url = "https://allstarlink.org/cgi-bin/allmondb.pl";
 +
</pre>
   −
You will need to forward port 4569 on your ISP modem. As there are many brands and modems, it is not possible to show a step to step guide.
+
with:
   −
== Allmon2 Setup. ==
+
<pre>
 +
$url = "http://allmondb.pttlink.org";
 +
</pre>
   −
*[[Allmon2 Install and Setup]] - Allmon2 setup.
+
Restart your system.
   −
== Allmon2 web control. ==
+
sudo reboot
   −
TBD
+
At this point your node should be up and running.
   −
== DTMF control. ==
+
== Allmon2 Setup. ==
   −
TBD
+
*[[Allmon2 Install]] - Allmon2 setup.

Navigation menu