Line 1: |
Line 1: |
| + | [[Category: How to]] |
| PTTLink for beginners. | | PTTLink for beginners. |
| | | |
Line 4: |
Line 5: |
| | | |
| Go to https://pttlink.org/ and click on the '''<Login/Sign Up>''' link. | | Go to https://pttlink.org/ and click on the '''<Login/Sign Up>''' link. |
− | [[File:Ptt site menu login.png|none|thumb|545x545px]]Next click the '''<Sign Up>''' link.[[File:Ptt_site sign up.png|none|thumb|311x311px]] | + | |
| + | [[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 12: |
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 25: |
| | | |
| You will need to login to your account at [https://pttlink.org/ https://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|579x579px]] | + | [[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|308x308px]] | + | [[File:Ptt site login.png|none|thumb]] |
| | | |
| == Create a Server == | | == Create a Server == |
Line 45: |
Line 51: |
| Then click '''<Continue...>'''. | | Then click '''<Continue...>'''. |
| | | |
− | [[File:ptt site request node number 1.png|none|thumb|357x357px]] | + | [[File:ptt site request node number 1.png|none|thumb]] |
| | | |
| Then click '''<Request>'''. | | Then click '''<Request>'''. |
| | | |
− | [[File:ptt site request node number 2.png|none|thumb|532x532px]] | + | [[File:ptt site request node number 2.png|none|thumb|424x424px]] |
| | | |
| Select which server you would wish to have a node number assigned to. | | Select which server you would wish to have a node number assigned to. |
| | | |
| A comment of 'additional node on same server' would be appropriate if you are requesting a second node number. | | A comment of 'additional node on same server' would be appropriate if you are requesting a second node number. |
− | [[File:ptt site request node number 3.png|none|thumb|733x733px]] | + | [[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 73: |
Line 79: |
| 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 79: |
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 87: |
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. |
| | | |
− | sudo pttlink-menu
| + | repeater@repeater:~$ sudo asl-menu |
| | | |
| This will load the PTTLink configuration menu. | | This will load the PTTLink configuration menu. |
− | [[File:Ptt first time.png.png|none|thumb|640x640px]] | + | [[File:Asl menu main screen.png|none|thumb|640x640px]] |
| | | |
| == PTTLink software setup == | | == PTTLink software setup == |
| | | |
| Choose option '''<1>'''. | | Choose option '''<1>'''. |
− | [[File:Ptt first time.png|none|thumb|640x640px]] | + | [[File:002_first_time.png|none|thumb|640x640px]] |
| + | |
| + | 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]] |
| | | |
| Setup now will ask if you want to change "'''repeater'''" account password with you should already changed at first time login so answer '''<No>''', unless you want to change it again. Do not forget to write it down. | | Setup now will ask if you want to change "'''repeater'''" account password with you should already changed at first time login so answer '''<No>''', unless you want to change it again. Do not forget to write it down. |
− | [[File:Ptt repeater password prompt.png|none|thumb|640x640px]] | + | [[File:004_repeater_password.png|none|thumb|640x640px]] |
− | | |
− | Next, 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.
| |
− | [[File:Ptt root password prompt.png|none|thumb|640x640px]]
| |
− | | |
| | | |
− | Now let's set time zone '''<Ok>'''. | + | Now lets set time zone '''<Ok>'''. |
− | [[File:Ptt timezone setup.png|none|thumb|640x640px]] | + | [[File:005_timezone.png|none|thumb|640x640px]] |
| | | |
| Choose the node's continent. | | Choose the node's continent. |
− | [[File:Ptt geo area.png|none|thumb|640x640px]] | + | [[File:006_continent.png|none|thumb|640x640px]] |
| | | |
| Choose the node's city. | | Choose the node's city. |
− | [[File:Ptt time zone.png|none|thumb|640x640px]] | + | [[File:007_city.png|none|thumb|640x640px]] |
| | | |
| Next you can change the name of you host name, the default is '''repeater'''. | | Next you can change the name of you host name, the default is '''repeater'''. |
− | [[File:Ptt by default.png|none|thumb|640x640px]] | + | [[File:008_message.png|none|thumb|640x640px]] |
| + | |
| + | Answer '''<Yes>''' to be able to make changes. |
| + | [[File:009_edit_hostname.png|none|thumb|640x640px]] |
| | | |
| Type the new host name and hit '''<Enter>'''. | | Type the new host name and hit '''<Enter>'''. |
− | [[File:Ptt hostname prompt.png|none|thumb|640x640px]] | + | [[File:010_hostname.png|none|thumb|640x640px]] |
| | | |
| If you want to set up a domain, type it and hit '''<Enter>'''. | | If you want to set up a domain, type it and hit '''<Enter>'''. |
− | [[File:Ptt domain prompt.png|none|thumb|640x640px]] | + | [[File:011_domain_name.png|none|thumb|640x640px]] |
| | | |
| Say '''<Ok>''' to this message. | | Say '''<Ok>''' to this message. |
− | [[File:Ptt existing hostname.png|none|thumb|640x640px]] | + | [[File:012_message.png|none|thumb|640x640px]] |
| | | |
| Now you can make your network settings '''<Ok>'''. | | Now you can make your network settings '''<Ok>'''. |
− | [[File:Ptt setting for dhcp.png|none|thumb|640x640px]] | + | [[File:013_dhcp.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt you can network.png|none|thumb|640x640px]] | + | [[File:014_network.png|none|thumb|640x640px]] |
| | | |
| To choose between DHCP or Static IP say '''<Yes>'''. | | To choose between DHCP or Static IP say '''<Yes>'''. |
− | [[File:Ptt network setup.png|none|thumb|640x640px]] | + | [[File:015_dhcp_static.png|none|thumb|640x640px]] |
| | | |
| Use '''<D>''' for DHCP or '''<nowiki><S></nowiki>'''. for Static, if you choose Static, you will be asked to enter it next, for this example DHCP is in use. | | Use '''<D>''' for DHCP or '''<nowiki><S></nowiki>'''. for Static, if you choose Static, you will be asked to enter it next, for this example DHCP is in use. |
− | [[File:Ptt dhcp or static.png|none|thumb|640x640px]] | + | [[File:016_dhcp_static.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt commented out.png|none|thumb|640x640px]] | + | [[File:017_message.png|none|thumb|640x640px]] |
− | | |
− | As you already selected DHCP now select '''<Back>''' to continue.
| |
− | [[File:Ptt dhcp or static.png|none|thumb|640x640px]]
| |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt you will now move.png|none|thumb|640x640px]] | + | [[File:018_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt importing the.png|none|thumb|640x640px]] | + | [[File:019_message.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<A1>'''. | | Choose option '''<A1>'''. |
− | [[File:Ptt a menu a1.png|none|thumb|640x640px]] | + | [[File:020_a_menu_a1.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<N1>'''. | | Choose option '''<N1>'''. |
− | [[File:Ptt n menu n1.png|none|thumb|640x640px]] | + | [[File:021_n_menu_n1.png|none|thumb|640x640px]] |
| | | |
| Type the node number for your node. Yes the one you previously wrote down from PTTLink site. | | Type the node number for your node. Yes the one you previously wrote down from PTTLink site. |
− | [[File:Ptt node number prompt.png|none|thumb|640x640px]] | + | [[File:022_node_number.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<N2>'''. | | Choose option '''<N2>'''. |
− | [[File:Ptt 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 PTTLink site. | | Type the node password for your node. Yes the one you previously wrote down from PTTLink site. |
− | [[File:Ptt node password prompt.png|none|thumb|640x640px]] | + | [[File:024_node_password.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<N3>'''. | | Choose option '''<N3>'''. |
− | [[File:Ptt n menu n3.png|none|thumb|640x640px]] | + | [[File:025_n_menu_n3.png|none|thumb|640x640px]] |
| | | |
| Type the call sign for your node. Yes the one you previously wrote down from PTTLink site. | | Type the call sign for your node. Yes the one you previously wrote down from PTTLink site. |
− | [[File:Ptt call sign prompt.png|none|thumb|640x640px]] | + | [[File:026_callsign.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<N4>'''. | | Choose option '''<N4>'''. |
− | [[File:Ptt n menu n4.png|none|thumb|640x640px]] | + | [[File:027_n_menu_n4.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<I1>'''. | | Choose option '''<I1>'''. |
− | [[File:Ptt i menu i1.png|none|thumb|640x640px]] | + | [[File:028_i_menu_i1.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt enable simpleusb.png|none|thumb|640x640px]] | + | [[File:029_message.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<N5>'''. | | Choose option '''<N5>'''. |
− | [[File:Ptt n menu n5.png|none|thumb|640x640px]] | + | [[File:030_n_menu_n5.png|none|thumb|640x640px]] |
| | | |
| If your node will be a simplex node type '''<1>'''. | | If your node will be a simplex node type '''<1>'''. |
| If your node is a repeater controller type '''<2>'''. | | If your node is a repeater controller type '''<2>'''. |
− | [[File:Ptt duplex type.png|none|thumb|640x640px]] | + | [[File:031_rptr_mode.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<N6>'''. | | Choose option '''<N6>'''. |
− | [[File:Ptt n menu n6.png|none|thumb|640x640px]] | + | [[File:032_n_menu_n6.png|none|thumb|640x640px]] |
| | | |
| Type a new password, this will be used to have access from the nodes web site Allmon2, the default password is 'llcgi'. | | Type a new password, this will be used to have access from the nodes web site Allmon2, the default password is 'llcgi'. |
− | [[File:Ptt manager password prompt.png|none|thumb|640x640px]] | + | [[File:033_password.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt setting new.png|none|thumb|640x640px]] | + | [[File:034_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt creating basic.png|none|thumb|640x640px]] | + | [[File:036_message.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<N9>'''. | | Choose option '''<N9>'''. |
− | [[File:Ptt n menu n9.png|none|thumb|640x640px]] | + | [[File:037_n_menu_n9.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt setting repeaters.png|none|thumb|640x640px]] | + | [[File:038_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt enabling pttlink.png|none|thumb|640x640px]] | + | [[File:039_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt setting the node.png|none|thumb|640x640px]] | + | [[File:040_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt setting node.png|none|thumb|640x640px]] | + | [[File:041_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt enabling the.png|none|thumb|640x640px]] | + | [[File:042_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt setting duplex.png|none|thumb|640x640px]] | + | [[File:043_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt node number.png|none|thumb|640x640px]] | + | [[File:044_message.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<Back>'''. | | Choose option '''<Back>'''. |
− | [[File:Ptt n menu back.png|none|thumb|640x640px]] | + | [[File:045_n_menu_back.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<AZ>'''. | | Choose option '''<AZ>'''. |
− | [[File:Ptt 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:Ptt review.png|none|thumb|640x640px]] | + | [[File:047_review.png|none|thumb|640x640px]] |
| | | |
| Choose '''<Yes>''' to backup your configuration. | | Choose '''<Yes>''' to backup your configuration. |
− | [[File:Ptt backup and save.png|none|thumb|640x640px]] | + | [[File:048_backup.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt your original.png|none|thumb|640x640px]] | + | [[File:049_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt new configuration.png|none|thumb|640x640px]] | + | [[File:050_message.png|none|thumb|640x640px]] |
| | | |
| Just say '''<Ok>''' to this message. | | Just say '''<Ok>''' to this message. |
− | [[File:Ptt asterisk reload.png|none|thumb|640x640px]] | + | [[File:051_message.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<Exit>'''. | | Choose option '''<Exit>'''. |
− | [[File:Ptt a menu exit.png|none|thumb|640x640px]] | + | [[File:052_a-menu_exit.png|none|thumb|640x640px]] |
| | | |
| Answer '''<Yes>''', because we already saved our configuration. | | Answer '''<Yes>''', because we already saved our configuration. |
− | [[File:Ptt exit.png|none|thumb|640x640px]] | + | [[File:053_exit.png|none|thumb|640x640px]] |
| | | |
| If you want to automatically start your system with this menu answer '''<Yes>''', if not then '''<No>'''. | | If you want to automatically start your system with this menu answer '''<Yes>''', if not then '''<No>'''. |
− | [[File:Ptt select menu at login.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: |
| | | |
− | sudo pttlink-menu
| + | repeater@repeater:~$ sudo asl-menu |
| | | |
− | [[File:Ptt you may.png|none|thumb|640x640px]] | + | [[File:055_message.png|none|thumb|640x640px]] |
| | | |
| Now your node will reboot to apply all the changes we have done, so say '''<Ok>'''. | | Now your node will reboot to apply all the changes we have done, so say '''<Ok>'''. |
− | [[File:Ptt setup is complete.png|none|thumb|640x640px]] | + | [[File:056_reboot.png|none|thumb|640x640px]] |
| | | |
| == 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 ptlink-menu''' like the example bellow: | + | type '''sudo asl-menu''' like the example below: |
| | | |
− | sudo pttlink-menu
| + | repeater@repeater:~$ sudo asl-menu |
| | | |
| Choose option '''<4>'''. | | Choose option '''<4>'''. |
− | [[File:Ptt menu 4.png|none|thumb|640x640px]] | + | [[File:101_asl_menu_4.png|none|thumb|640x640px]] |
| | | |
| With option '''<F>''', will trigger PTT few times on your radio for testing, you should also listen a test tone. | | With option '''<F>''', will trigger PTT few times on your radio for testing, you should also listen a test tone. |
Line 286: |
Line 298: |
| To achieve that, you can type values between 0 and 999 and press '''<Enter>''' to apply the new value. The system will Tx a test tone for 5 seconds. If you do not set any value and hit '''<Enter>''', you will exit this function keeping the last typed value on RAM. | | To achieve that, you can type values between 0 and 999 and press '''<Enter>''' to apply the new value. The system will Tx a test tone for 5 seconds. If you do not set any value and hit '''<Enter>''', you will exit this function keeping the last typed value on RAM. |
| | | |
− | Do not forget to turn off the tone generator by pressing once again '''<T>'''. | + | Do not forget to turn of the tone generator by pressing once again '''<T>'''. |
| | | |
| Once you are happy with your settings, type '''<W>''' and '''<Enter>'''. | | Once you are happy with your settings, type '''<W>''' and '''<Enter>'''. |
| | | |
| To exit from this menu type '''<0>''' (zero) and hit '''<Enter>'''. | | To exit from this menu type '''<0>''' (zero) and hit '''<Enter>'''. |
− |
| |
| | | |
| == 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:Ptt menu 6.png|none|thumb|640x640px]] | + | [[File:103_asl_menu_6.png|none|thumb|640x640px]] |
| | | |
| Choose option '''<nowiki><I></nowiki>'''. | | Choose option '''<nowiki><I></nowiki>'''. |
− | [[File:Ptt configuration 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 beginning 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:Ptt invertptt.png|none|thumb|640x640px]] | + | [[File:Ptt_invertptt.png|none|thumb|640x640px]] |
| | | |
| COS/CTCSS invert: | | COS/CTCSS invert: |
| | | |
− | Search for the line beggining with '''carrierfrom =''' and change its value as follows. | + | Search for the line beginning with '''carrierfrom =''' and change its value as follows. |
| | | |
− | Search for the line beggining with '''ctcssfrom =''' and change its value as follows. | + | Search for the line beginning with '''ctcssfrom =''' and change its value as follows. |
| | | |
| '''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:Ptt invertcarrier.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>'''. |
| | | |
| Choose Option '''<9>'''. | | Choose Option '''<9>'''. |
− | [[File:Ptt menu 9.png|none|thumb|640x640px]] | + | [[File:107_asl_menu_9.png|none|thumb|640x640px]] |
| + | |
| + | 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]] |
| + | |
| + | == 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 |
| + | |
| + | |
| + | # 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 |
| | | |
− | Choose option '''<G>''' to restar PTTLink software and apply changes. Choose '''<Back>''', repeat your audio test if needed.
| + | sudo sed -i 's/allstarlink.org/pttlink.org/g' /var/www/html/allmon2/astdb.php |
− | [[File:Ptt system menu g.png|none|thumb|640x640px]]
| + | 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> |
| | | |
− | At this point your node should be up and running.
| + | Edit the following file with: |
| | | |
− | == Port forwarding ==
| + | <pre> |
| + | sudo nano /usr/local/sbin/astdb.php |
| + | </pre> |
| | | |
| + | Replace line: |
| | | |
− | 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.
| + | <pre> |
| + | $url = "https://allstarlink.org/cgi-bin/allmondb.pl"; |
| + | </pre> |
| | | |
| + | with: |
| | | |
− | == Allmon2 Setup. == | + | <pre> |
| + | $url = "http://allmondb.pttlink.org"; |
| + | </pre> |
| | | |
− | *[[PttLink Allmon2 Install]] - 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. |