________________________________________________________

  How to install EchoLink Proxy Server on Raspberry Pi
________________________________________________________

# by WA8KIM / kim@kim125.com / EchoLink: WA8KIM-R / WiRES-X: Rm#21149 / Last updated 08/24/2015.
# http://www.wa8kim.com/rpi.html
# MANY thanks to W2YMM. Most information was gathered from his website: http://www.w2ymm.com/pi_proxy.html
# Best viewed in Notepad with Word Wrap OFF/UNCHECKED and in full screen

Download the latest version of this file at:
http://www.wa8kim.com/files/(RPi)%20Install%20-%20EchoLink%20Proxy%20Server.txt

1. Download the EchoLink Proxy Software onto this computer from:
http://echolink.org/download.htm

2. Now we need to copy the EchoLinkProxy.jar and ELProxy.conf files to the Raspberry Pi.
- The easiest way I know how to do this is to use WinSCP, which allows the trasfer of files from/to your RPi.
- Download, install, and run WinSCP on your main computer (the one you're viewing this file with)
		http://winscp.net/eng/download.php

	- File Protocol is SFTP
	- Hostname: (your RPi's IP address)
	- User name: pi
	- Password: raspberry (or whatever password you may have changed it to)

- Click [LOGIN]
	- On the left side of the screen, switch to the folder containing the downloaded Echolink Proxy files
	- The right side of the screen displays your RPi files in the /home/pi folder.
	- Highlight EchoLinkProxy.jar and ELProxy.conf and click [Upload] at the top

3. Configure EchoLink Proxy Server
- The easiest way to modify the config file is to use WinSCP. Double-click on the ELProxy.conf file on the RIGHT side of the screen.
- You can also modify the file directly on your RPi by typing 'sudo nano /home/pi/ELProxy.conf' on your pi.

In the config file, change the following parameters, if desired:
	- Password=password			# You MUST change this one
	- PublicAddress=your.dyndns.com		# Your RPi's WAN/Public IP address
	- RegistrationName=WA8KIM-PROXY01	# What your Proxy will be called in the proxy search list
	- RegistrationComment=Raspberry Pi	# Any comment you wish

4. Set your RPi to auto start the EchoLink Proxy Server. The file rc.local is RPi's version of autoexec.bat
Perform the following on from your Raspberry PI:

sudo nano /etc/rc.local

Add the following before the 'exit 0' line:
-----------------------------------------------------------------------------
echo Starting EchoLink Proxy Server . . .
cd /home/pi && java -jar EchoLinkProxy.jar

exit 0
-----------------------------------------------------------------------------

5. Create a shortcut to viewing the log file by simply typing 'el' from any folder.
	# The line '#!/bin/bash' at the beginning tells the RPi what program to run the script with. BASH is the program most often used.
	# The 'cat' command simply displays the content of the file
	# By placing the file in the '/usr/local/bin' folder, it can be run from any folder.
sudo nano /usr/local/bin/el
-----------------------------------------------------------------------------
#!/bin/bash
sudo cat /home/pi/ELProxy.log
-----------------------------------------------------------------------------
	
	# The 'chmod +x' command makes the file executable.
sudo chmod +x /usr/local/bin/el

6. Reboot your RPi
sudo reboot

7. Set your router up to port forward the following ports to your RPi's IP:
	- UDP ports 5198 & 5199, and TCP ports 5200 & 8100 (Needed for EchoLink)
	- TCP port 22 (To remotely connect to your Raspberry Pi)


7. Set up your EchoLink Client software.
Taken directly from EchoLink's site: 
	"On the remote PC (e.g., the laptop), download and install version 1.9 (or above) of the EchoLink software.  Start up EchoLink as usual, but go to Tools-->Setup, and click the Servers tab.  Check the box marked "Use proxy", and enter the hostname (or IP address) of the proxy PC, along with the chosen password and port number.  Note that the hostname (or IP address) must be the external address of the proxy PC, not the internal address.  Click OK and then re-start EchoLink for the changes to take effect."

For more help, go to EchoLink's Proxy Server website at:
http://echolink.org/proxy.htm#background

Miscellaneous Notes:
- To edit the config file on your raspberry Pi (instead of on your PC), type:
nano /home/pi/ELProxy.conf

REVISION HISTORY:
2015-08-24 Updated Download Link
2015-02-25 File Created