/* 
 * CrossIP Copyright 2004 Algenta Technologies All rights reserved.
 * Use is subject to license terms.
 * 
 * $Id: README.txt,v 1.3 2004/02/11 23:34:28 dan Exp $
 */

Quick Start:
To run the CrossIP setup wizard,
java -jar CrossIP.jar

To update your hostname with a generated config file
java -jar CrossIP.jar thatip.config


Cross Platform ThatIP update client in java
CrossIP is in it's Beta Stage and is currently not supported by the ThatIP
technical support team. Please report your experiences with CrossIP so we can
create a user experience for Mac and Unix users that is as pleasant as with our
award winning WinIP client. When the beta testing is complete, CrossIP will
become a fully supported client for ThatIP.com.

The Cross Platform update client is for Mac, Unix, and Windows. The java client
for ThatIP was designed to be run in both an interactive mode for setup and from
a crontab or scheduler to perform updates as needed. Future versions will run
as a daemon or service, contacting the server only when needed. Please check
back and update to the new version.

WinIP provides a richer user experience for Windows users. If you are running a
Windows OS, please consider using WinIP until CrossIP is out of beta. 

CrossIP is given with full source code, and is distributed under the GPL
license.

Usage
To enter interactive mode, run the client with no parameters. This will prompt
you with a wizard that helps you establish your account information and store
update information. The client generates two configuration files, one which
tracks your user account information and hostnames, and one that maintains a
list of your hostnames and the actions to perform on then during an update.

To enter the interactive wizard type: java -jar CrossIP.jar

To run the client from a crontab, use the configuration file you generated as a
parameter. It will load the stored preferences and perform an update if
neccessary.

To update your hostname run: java -jar CrossIP.jar thatip.config

To use the java client with multiple ThatIP accounts, generate a seperate
configuration for each client. You can then add additional entries into your
crontab to execute crossip with each configuration.

Current Development Status
Feb. 9, 2004 : A new CrossIP beta was released today using ThatIP-J 1.3. This
release updates CrosSIP to ThatIP Protocol v1.1 and removed jdk 1.4
dependancies. CrossIP now runs on JRE versions 1.2 and 1.3. There are several
tasks left to finish before CrossIP becomes a supported client.

* Implement the ThatIP ip change detection algorithm for NAT and firewalls in
CrossIP
* GUI user interface for X-Windows and Mac OSX users 
* installer for Mac OSX 

This software is OSI Certified Open Source Software.
OSI Certified is a certification mark of the Open Source Initiative.

CrossIP uses a license that does not "require" an advertising
notice, however we would still appreciate recognition if possible:

"This product includes software developed by
Algenta Technologies: www.algenta.com, and its contributors."

CrossIP uses ThatIP-J and currently implements protocol v1.1

More information is located at:
http://www.thatip.com
http://crossip.sourceforge.net
http://thatip-j.sourceforge.net


