Administration Guide : Conversions from other systems to Xinet products

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:
It is good practice to have a backup of all files before making any changes.
For Helios conversions, to stop the Helios daemons, use their script:
# /usr/local/es/stop-atalk now
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.
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
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.
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.
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
# /var/adm/appletalk/convert.ipt /filesystem/restoredfiles
This will convert the files in /filesystem/restored files and all subdirectories.