Skip to content

Installation Integration Route53

Jethro Carr edited this page Mar 20, 2015 · 1 revision

Configuring Route53 Integration

Integrating with Route53 is reasonably simple, the code for doing so is already in the main NamedManager application and just requires your AWS access key and secret to connect to your account.

How Route53 Integration Works

NamedManager Route53 integration is an asynchronous process. Changes made to domains and records via the web interface are made locally, then later synced and applied to Route53 via a background cronjob.

The cronjob runs on the NamedManager web interface server and by default is scheduled to run every 1 minute. The cronjob installation is done as part of the application install process.

Note that if a domain already exists in Route53, a new domain will be added alongside it - NamedManager won't replace an existing domain if it wasn't managed by NamedManager before.

Configure Route53 Account

To add a Route53 account, you just need to configure a name server with the type of Route53 in the same fashion as any other name server.

  1. Select "Name Servers"
  2. Select "Add new Name Server"
  3. Set the nameserver FQDN to a label for your account eg "Route53". This name is purely for your reference inside the application.
  4. Set the Server Type to "Route53".
  5. Enter your AWS Access Key and Secret Key.
  6. Save the changes.

Any domains that get assigned to the Route53 name server (or a group including it) will be automatically synced up to Route53 and the name server entries in NamedManager will show the NS servers delegated by Route53.

Reviewing Route53 Synchronisation Status

All creations/updates/deletes to domains in Route53 are logged in the NamedManager log interface as usual.

Troubleshooting

For issues with the background sync process, review the log file in /var/log/namedmanager/cron-route53

You can execute the process manually in a debug mode if required. First edit /etc/namedmanager/config.php and uncomment:

$_SESSION["user"]["debug"] = "on";

Secondly, execute the script with:

su -s /bin/sh apache -c 'cd /usr/share/namedmanager/htdocs/include/cron/; php -q route53.php'

(You may need to adjust paths are required for your installation - above assumes defaults only).