!VoyUpdate v1.06 (30th Apr 2007)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Purpose:
~~~~~~~~
Upgrade !Voyager to Orpheus compatibility.


Instructions:
~~~~~~~~~~~~~
Configuring Voyager to connect to Orpheus:
Voyager was originally supplied by Argonet and was customized
specially for connecting to Argonet's own dialup service. This
means that you cannot connect to Orpheus using the standard
Argonet edition of !Voyager.
You HAVE to upgrade it to the Orpheus compatible version.
This is because things like your username and password are
embedded within the application and cannot be changed by the
user.
Also, once you've run the upgrader you CANNOT go back to
connecting to Argonet - unless you restore from a backup copy
of !Voyager.

Disclaimer:
We accept no responsibility for any loss of data or corruption
of your !Voyager software whilst performing the following update.
Whilst every care has been taken to ensure that the upgrade goes
as smoothly as possibly, errors can occur because it's impossible
to predict every possible individual configuration scenario. We
advise making a backup of any important files, including your
original !Voyager before you continue.
By continuing with this upgrade the user accepts responsibility
for any loss or corruption of data or program files.

Read these instructions carefully before you start the update.
It will be harder for us to provide technical assistance if you've
not followed the instructions correctly!

Running the Upgrader
You're now ready to start the upgrade process.
Double-click on !VoyUpdate in order to load the upgrader.
The upgrader will automatically detect whether !Voyager has been
'seen' by the filer or is already loaded. If !Voyager is already
loaded, it will give you the option of quitting !Voyager before
continuing. If !Voyager hasn't been 'seen' yet, simply open the
directory containing !Voyager and click 'Continue' in the !VoyUpdate
instruction window.
If !VoyUpdate is ok with the state of your !Voyager, it will now ask
you to enter your Orpheus Dialup password. This will have been
provided with your account details when you first opened your
Orpheus account. Enter it carefully, making note of any capital
letters or numbers. It's case-sensitive. Click 'OK' or press
'Return' when you've entered it.
N.B. If you're using broadband, then the dialup password is ignored
within Voyager - so you can just enter your POP password in order to
progress to the next question.

All passwords should generally be 8 characters long. If you enter the
wrong number of digits, !VoyUpdate will report an error and ask you to
re-enter the password. If you genuinely have a different length
password, click MENU over any !VoyUpdate window and toggle the 'Strict'
menu option. This will temporarily remove error checking and allow you
to enter your password.

If the password is accepted, !VoyUpdate will now ask you to enter
your POP3 email password. This should also be on the letter sent
when you opened your account. Again, it's case-sensitive and should
be 8 characters (although you can turn off 'Strict' again if needs be).
Click 'OK' to continue.

!VoyUpdate will now ask you to enter your Orpheus email address.
This is the primary email address associated with your new Orpheus
account and is generally in the form username@orpheusmail.co.uk
DO NOT enter your account ID, such as ab15@orpheusmail.co.uk because this
address will become your 'From' address that will be used for sending out
emails - so you want your actual email address.
If you've asked for an alternative domain (instead of orpheusmail.co.uk)
then enter that instead, such as pvigay@ormail.co.uk etc.
Click 'OK' to continue.

Doing the Update:
!VoyUpdate now has enough information to perform the upgrade of your
!Voyager suite. It will ask you for confirmation, so if you want to
actually go ahead and update your copy of !Voyager, click the 'Continue'
button now. If you click 'Back' you can go back and make any changes to
previous steps, such as passwords and/or email address.
When you click 'Continue', !VoyUpdate will update your copy of !Voyager.
Please wait a few moments whilst the relevant files are copied and
updated.
When the update is complete, !VoyUpdate will tell you so and the final
option is 'Quit'. You can now run your updated copy of !Voyager and,
if the update has run smoothly, you can now connect to Orpheus.

Don't worry about your username still being displayed as argab15 or
somesuch in the user preferences. The 'arg' bit is ignored, and we've
configured the same user ID conventions on Orpheus as you used to have
on Argonet, so that's nothing to worry about.
Also, note that news.orpheusnet.co.uk is the correct news server address,
but this is currently not operational yet.
Keep an eye on the Orpheus status page for announcements as to when it's
available.


Problems?
~~~~~~~~~
If you encounter any problems whilst carrying out the update of your copy
of !Voyager, please make a note of the EXACT error message reported, and
at which step in these instructions things went wrong. We will require
these if we are to offer support.

If the upgrader reports that there is not enough space to perform a backup
of your original Voyager, you may have to check a) how much space your
existing copy is occupying and b) how much space is left on your hard
drive. You may find that if you have 100's of emails in your existing
Voyager, they occupy a large amount of space. If you don't want to backup
Voyager, or have backed it up manually, you can turn off the backup
facility by toggling the 'Backup Voyager' menu option to off.

If VoyUpdate still thinks there is not enough space left on your hard
disc, even though there is, it could be that RISC OS is misreading the
freespace map of your hard drive. You can over-rule this check in
VoyUpdate by turning off the 'Strict' option on the main menu.

Calypso:
Calypso is currently not supported by Orpheus. The upgrader assumes you
are using the standard POP3Fetch transport for mail fetching. If you're
using Calypso/CalPOP, you need to manually run !POP3Fetch in order to
download your emails. You can find this inside !Voyager.Apps.Transports
and you may find it worth adding to your pinboard for ease of running
it in the future.

Voyager is a very complex piece of software and you may find that it's
left in an unusable or partially updated state if something does go
wrong. We will endeavour to help you out in the event of problems, but
we cannot emphasise strongly enough the need to make a backup of your
previous copy of !Voyager before you start - and ensure there is enough
free space on your hard disc.


What it does:
~~~~~~~~~~~~~
- Alter the phone number to dial Orpheus (0845-123-1621)

- Update your 'options' file to include your new dialup and POP
  usernames and passwords.

- Update the !Fresco HotList, correcting a few URLs

- Update the Voyager homepage, giving Orpheus contact details instead
  of ArgoNet details.

- Update Posty to version 1.38 which includes support for Orpheus
  email addresses instead of ArgoNet email addresses.

- Update 'signature' to an Orpheus-friendly one.

- Update the 'fetchers' to connect to Orpheus mail servers.


Contact:
~~~~~~~~
If you have technical difficulties, please contact Orpheus Internet
technical support at support@orpheusinternet.co.uk or telephone
0845 120 5559 during office hours (9am - 5pm, Monday-Friday)


History:
~~~~~~~~
v1.06 (30th Apr 2007)
	- Fixed bug where 'large' hard discs were incorrectly read,
	  resulting in a 'not enough space' error.
	  
v1.05 (17th Apr 2006)
	- Fixed bug in Voyager detection routine to stop lockups if
	  Voyager has not been seen at all.
	  
v1.04 (28th Jun 2005)
        - Corrected orpheusnet.co.uk email addresses to the same domain
          as the primary email user.
        - Disabled auto-upgrader due to closure of ftp.argonet.co.uk
        - Updated name servers in Ant resolver detection.
        
v1.03 (5th Jun 2005)
        - Corrected bug where backup was still performed, even if you
          turned off the 'Backup Voyager' option.
        - Amended wording for dialup password prompt, to cater for
          broadband users.
        - Added more detailed instructions into this !Help file.
          
v1.02 (1st Jun 2005)
        - Added option to disable making a backup of !Voyager, just
          in case people want to take the risk and save disc space.
        - Improved checking of disc space.
        
v1.01 (30th May 2005)
        - Fixed silly bug which resulted in a fatal 'file not found'
          error when trying to start the updater.
          
v1.00 (30th May 2005)
        - First version!


Credits:
~~~~~~~~
Voyager updater - 2005 Jason Tribbeck
Wimp front-end - 2005 Paul Vigay
The best RISC OS friendly ISP in the world - Orpheus Internet! :-)
