Linux manual installation steps
This page describe a possible way to install manually IpUpdater as a cronjob on Linux so that it is executed on regular basis.
At this time, a proper installer is not available yet and hence the IpUpdater must be download and configured following manual steps.
The installation will consist of
- Create a installation directory
- Download the latest package for Linux/Mac platform
- Unzip it
- Configure aws.properties file
- Make run.sh executable
- Add run.sh to crontab
The following commands refers to the release (release 2.1.0). It is suggested to double check to make sure to download always the latest release from https://github.com/renatodelgaudio/renatodelgaudio.github.io/tree/master/IpUpdaterReleases
The following commands are executed as root but this is not a requirement.
Create a directory (e.g. /opt/awsupdate), download and unzip the linux package
sudo su
mkdir /opt/awsupdate
wget https://github.com/renatodelgaudio/renatodelgaudio.github.io/blob/master/IpUpdaterReleases/2.1.0/IpUpdater-2.1.0-linux-mac-package.tar.gz?raw=true
tar xvfz IpUpdater-2.1.0-linux-mac-package.tar.gz\?raw\=true
Configure aws.properties
vi aws.properties
#Insert your AWS Credentials from http://aws.amazon.com/security-credentials
secretKey=
accessKey=
# This is the AWS zoneId containing the record that should be updated
#Insert the zone id from https://console.aws.amazon.com/route53/home?region=us-east-1#hosted-zones
zone.id=
# This is the AWS record name (Type A) within the given zoneId that should be updated
# If the record name won't be found in AWS it will be created otherwise it will be updated
# e.g. if record.name=www.example.com a related AWS record (type A) will be created or updated with the public IP
record.name=
# This is the Time To Live (TTL) expressed in seconds as defined in AWS
record.ttl=86400
#Email notification are sent only if enable=true
mailsender.enable=true
mailsender.host=
mailsender.protocol=smtp
mailsender.port=
mailsender.username=
mailsender.password=
mailsender.from=
#Comma separated e-mails. The following people will receive notifications that most matters (e.g. IP change, Errors)
mailsender.to=email1@example.com,admin2@example.com
# Advanced email configuration settings.
#Comma separated emails. The following people will receive notifications on what matters as well as DEBUG info
mailsender.debug.to=admin3@example.com
# All properties with the prefix mail will be set AS IS to the underlying javax.mail.Session
mail.smtps.auth=true
mail.smtp.starttls.enable=true
Make run.sh executable
chmod +x run.sh
Add run.sh in crontab Edit your crontab to add a job similar to the following
crontab -e
20 0 * * * /opt/awsupdate/run.sh >/dev/null 2>&1
After you save and exit you should find it listing all the cronjob with the following command
crontab -l
20 0 * * * /opt/awsupdate/run.sh >/dev/null 2>&1
##Log File Everytime the IpUpdater runs, it writes to the log file awsupdater.log located in the main installation directory
e.g. /opt/awsupdate/awsupdater.log
An example of the log file is shown below
root@bastian:/opt/awsupdate# tail -f awsupdater.log
31.01.2015 00:20:03 INFO com.renatodelgaudio.awsupdate.RouteMain - Running com.renatodelgaudio.awsupdate.SimpleUpdater ....
31.01.2015 00:20:05 INFO com.renatodelgaudio.awsupdate.IcanHazip - Public IP: XXX.XXX.XXX.XXX
31.01.2015 00:20:06 INFO com.renatodelgaudio.awsupdate.SimpleUpdater - AWS DNS (xxx) is already configured with the public IP XXX.XXX.XXX.XXX No actions were performed at this time
31.01.2015 00:20:06 INFO com.renatodelgaudio.awsupdate.RouteMain - c com.renatodelgaudio.awsupdate.SimpleUpdater completed in 0 sec.