EZ-TZO X

OS X updater for TZO.COM Dynamic DNS

Release: v2.0, 3/10/2002, updated 6/20/07

Author: Edward F. O'Rourke

Features:

This DNS Updater client for TZO was provided free, compliments of Xgadgets / Jupiter Multimedia llc.

The author can not provide any guarantee or implied guarantee what-so ever. You use it at your own discretion.

TESTING Notes by TZO.COM

This client is tested "OK" by TZO.COM's software QA. The client itself does not meet current TZO design standards,

meaning that new software developers should not use this as a reference when designing a new client.

The above statement does not interfere with end-user use, providing these known issues are understood:

i) 'Refresh' (under UPDATE SETTINGS) must be set to a value NOT LOWER THAN 10 minutes.

For technical reasons, this TZO client can not update TZO any more frequently

(or the account may be suspended for client abuse, due to an error in the client.).

ii) When EZ-TZO is issued a Quit command under 10.4/Intel OS X, this application will crash.

The crash does not harm anything, and so can be ignored. This client is a 'PowerPC (PPC)' binary,

and there may be a slight incompatibility with the OS' PowerPC runtime layer.

iii) If for some reason your TZO account settings become corrupted, and you want to blank

all the EZ-TZO settings (as it was before your first use), open a Terminal and in the shell

you can type:

rm ./Library/Preferences/com.xgadgets.TZO

After deleting the above file, re-running EZ-TZO will cause the application to behave as if

it was the first time you ran it, and you can enter your new Account Information.

Features:

new status display

clearer indication of success or failure Status

displays time of last refresh

You can view account information such as the ip address and expiration date

Check box to enable or disable update on application launch

setting to set the refresh rate (every x minutes)

ability to use an alternate address

Instructions:

1) Drag the EZ-TZO Icon to Install

You can not run TZO from the downloaded disk image - this must be copied to the hard drive.

The suggested location to install TZO (and possibly the README) into, is the

Applications folder.

2) Obtain Your TZO Key

If you have already purchased a TZO account, use that key.

If you do not have a TZO account, please visit http://signup.tzo.com/

The signup form will email you your TZO activation key.

If you do not get this within 10 minutes of signing up, check your email

'Spam' folder, or try again using an alternate email address.

NOTE: If your network router (such as Linksys, etc) contains a dynamic DNS

client for TZO.COM, you should consider using the router's TZO client instead.

If you use the router client, you should remove this client from your computer.

Please do not configure your TZO account in more than one client, or install

TZO at more than one modem or site as this will cause a conflict.

3) Start EZ-TZO X and input your account

EZ-TZO X will prompt for your TZO account information. Carefully enter

your TZO account information.*

* Common errors: When using Copy and Paste from an email, be certain

you did not accidentally select leading or trailing spaces along with the TZO Key.

Use the same 'email address' that TZO sent your TZO key to.

Most configurations should use UPDATE ON LAUNCH, with Refresh set

to either 10 or 15 minutes.

Avoid the USE ALTERNATE IP ADDRESS checkbox as it has limited

usefulness, in most configurations.

Click SAVE, and you are done setting up TZO! If you test your domain using

'ping' or another network test, you should at the least see that DNS is resolving

to the correct IP address. (If unsure, you can verify what your correct IP is

by viewing your router's STATUS page, or opening Safari to http://www.mywanip.com/).

For a quick view of the IP address being used you can... type cmd + I or

click the status window or just hold the mouse over the status display

for a few seconds.

4) Make TZO a startup Item

After TZO successfully updates, you should configure TZO to run every time you log in.

In OS X, you can tell OS X to start applications (such as TZO) when the desktop loads.

On recent versions of OS X (10.4 and up) you configure applications to do this by

using Option (Command) click on the running TZO icon (or if you have a 2-button mouse,

right clicking on the running TZO icon, down in the icon bar). For older versions of OS X,

see Apple documentation on configuring Startup Items.

This step concludes TZO configuration. The remainder of tasks (for a new server install)

will pertain to your network specifics and the server applications you choose.

5) Server software, routers and firewalls...

OS X ships with a number of useful servers, including Apache webserver

and Remote Desktop. TZO is compatible with all of these servers, if you know how

to manage these servers.

Please note TZO can not provide Technical Support for third-party software. TZO Support

is limited to confirming the TZO/DNS configuration is correct. (If you get stuck, we may

be able to point you in the right direction however).

You should be familiar with the Apple.com website for any questions about the OS X

servers or firewall, or your network router's documentationfor any questions about port forwarding.

If unsure, you may need a local technician to work out firewalls, router port forwarding, etc.

Credits

* Software design by Edward F. O'Rourke of Jupiter Multimedia. A big thanks from TZO!

* TZO Labs testing/repackaging occurred March 2002 and June 2007.

History

June 20 2007 - Readme revised by Scott Prive of TZO, after additional testing against

OS X 10.4.9 (Intel). Application repackaged as a Disk Image (DMG) compatible with

OS X 10.2-10.4. The actual executable program remains unchanged from 3/10/2002.

March 10 2002 - Initial release by Edward F. O'Rourke

Developer Information

Developers should review the TZO Developer Documentation at http://www.tzo.com/Developer/

TZO software can be embedded into any Internet-aware application or hardware device.