Conversions from other systems to Xinet products

Macintosh files have special characteristics that differentiate them from Unix files. All Macintosh files have two “forks,” a data fork, and a resource fork. In addition, Macintosh files have desktop information associated with them such as the type of the file and its creator. When Macintosh files are stored on a Unix system, this information can be encoded in several different ways. Xinet uses a proprietary format, as do other file-sharing software vendors.

You may need to convert files on the server to the Xinet format, if you have previously used other file-sharing server products. Xinet provides scripts to convert Helios, IPT and CAP files for you. Celix files will convert automatically upon installation of Xinet software.

Converting Helios and IPT systems to Xinet systems

Xinet has developed a conversion script to change the format of Macintosh files on Unix servers from Helios and IPT formats to Xinet’s format.

For Helios conversions: This script has been tested with Helios EtherShare version 2.2.0, 2.5, and 2.6 files originating on Macintosh (not PC). (It is possible that different versions of Helios software have different formats.)

An average conversion will take a few hours, but if you have a lot of data, the conversion may take longer. To convert a system:

1.	Backup your file systems.

It is good practice to have a backup of all files before making any changes.

2.	Stop the older file sharing mechanism.

For Helios conversions, to stop the Helios daemons, use their script:

# /usr/local/es/stop-atalk now

3.	Install Xinet software.

Upon installation the Xinet software launches the Xinet GUI. Do not attempt to export any volumes using Xinet software until the files created with Helios or IPT have been converted into Xinet format using our conversion script.

4.	Convert the files.

Run the conversion script convert.helios or convert.ipt found in /var/adm/appletalk. You must be user “root” when running this script. This script does several things.

• Converts the exported volume list from Helios or IPT format to Xinet format

• Converts all Macintosh files in each volume into Xinet format

• Removes the Helios- and IPT-specific information from each volume

• On Helios conversions, removes the Helios .lay layout files if EtherShare OPI is on the machine

• Removes Helios and IPT from the automatic system startup scripts

5.	Set up a Xinet volume.

Inside the Xinet GUI, you should see the same volume list exported in the configuration window as was exported with either Helios or IPT. You should enable FPO support on the volumes you want to support OPI, and check that the FPO Options for these volumes are set as desired. Refer to "Creating a new System Volume” on page 244 for details.

6.	Check your network, for example., mount a Xinet volume on a Macintosh.

Specific to Helios conversions: Verify that everything appears to be working properly, particularly routing. Helios EtherShare does not publish routes that it is handling, nor does it appear to properly listen to routing packets. The “NetInfo” configuration aid with EtherShare is used to set up routing with EtherShare. It is possible to have EtherShare appear to work normally on networks with misconfigured routing. Routing with Xinet software can be configured with the Xinet Administration GUI.

7.	Remove Helios and IPT software.

Remove the Helios software from the machine by removing everything in /usr/local/es and /usr/local/opi. Remove IPT software by removing everything in /ushare.

Restoring from Helios backups and archives

After you are running Xinet products, if you restore jobs from backup or archive that were created when you were running Helios or IPT, you will need to convert those files. To do this, call the conversion script specifying the directory where you restored. For example:

# /var/adm/appletalk/convert.helios /filesystem/restoredfiles

or

# /var/adm/appletalk/convert.ipt /filesystem/restoredfiles

This will convert the files in /filesystem/restored files and all subdirectories.