AppleShare IP 6: Troubleshooting Installation Problems

If you have any issues during the installation process of AppleShare IP 6 (ASIP), here are some suggestions:

• Verify that your computer meets the minimum system requirements for ASIP. (details below)
  • CPU type
  • Version of Mac OS
  • Version of Open Transport
  • Version of OpenDoc
  • Amount of memory
• Verify that your startup disk has sufficient free space for the ASIP files.
• Run Disk First Aid on your startup disk and all server volumes before the installation.

If the disk utility finds problems it cannot repair, do the following:

1. Backup all data

2. Reformat the drive using your favorite disk driver utility (Now would be a good time to put the drive in HFS+ format, for more efficient file storage.)

3. Do a clean system install.

4. Configure your control panels as needed (Date & Time, File Sharing, AppleTalk, TCP/IP)

5. Try reinstalling ASIP again.

6. Restore other data to the disk, as needed.

• Turn off non-Mac OS extensions during the install.
• If a previous version of ASIP is installed, remove those files (or move them to a new location). The installer may have issues replacing files that are unusable.
• You may be able to use the Installer's "Custom Remove" option. Leave the Users & Groups data file and the PDS files in place in order to retain privileges and user information.

If none of the above works, you may have some unusable system files that are preventing the installation. Try the following:

1. Perform a clean system install

2. Reconfigure your control panels (Date & Time, File Sharing, AppleTalk, TCP/IP).

3. Try the install again.

Can't find ASIP Serial Number

If you purchased an ASIP upgrade kit, no serial number is included. Use the serial number from your previous version of AppleShare or ASIP.

If you cannot find the serial number card from the previous version of AppleShare, you should be able to find the serial number in the AppleShare Admin Server Settings or in the Web & File Admin program, if the server is still up and running.

If the server is not currently up and running, remember that the serial number information is stored in the Users & Groups data file. If you backed up your server's Users & Groups data file, you can restore that file to the new server, and the serial number will be restored at the same time. See the section on moving Users & Groups data file to a new server for details on how to do this.

If you purchased a full version of ASIP, the serial number will be on the CD jacket, on an adhesive sticker, which can be placed in your manual, if you wish. Be sure to keep the serial number in a safe place, but do not stick it to the CD itself (it might come off while inside the CD-ROM drive).

Moving User & Group information to another server

It's often useful to be able to carry users & groups from one server to another, for example, if you wanted to move mail services to another computer. Instead of creating all users a second time on the new mail server, you can move the data from one server to another. There are different approaches to doing this:

Move the Users & Groups data file.

All the data on users & groups are stored in the Users & Groups data file, located in the System Folder:Preferences. Moving this file from one computer to another will move ALL users & groups, and will replace any user data that is currently set up on the second computer. To move this file from Server A to Server B, follow these steps:

1. Configure Server B with Mac OS and install ASIP.

2. Verify that the "Network identity" fields in the File Sharing control panel contain the name of the server (Server names for A and B do not need to be the same).

3. Drag Server B's existing Users & Groups data file to the desktop.

4. Drag a copy of Server A's Users & groups data file to Server B's System Folder:Preferences.

5. Restart the server

6. Open Web & File Admin program to verify that Users & Groups have successfully been carried over.

Note: the Users & Groups data file also contains the serial number. If Web & File services are going to offered on both machines, be sure to change the serial number on one of them (Mail Services and Print Services don't look for the serial number). See "Duplicate Serial Numbers" for more info.

Export/Import Users & Group data

AppleShare IP allows you to export Users & Group data to a tab-delimited text file, then imported into another ASIP server.

To export data:

1. Select the Users you want to export. Shift-click to select multiple Users. Command-A will select all (but you will get a warning that 'Guest' and groups cannot be exported).

2. Select "Export Users & Groups" from the File menu of the Web & File Server Admin program. You can elect to export Internet Alias, Comments, and Email attributes. If you select Email attributes, you should also select Internet alias. The email attributes will be either "nomail", "hasmail", "forwardInternet" followed by the address. For example, user Mary Smith's exported file looks like this:
Mary Smith smith.m HasMail NoRequireAPOP BothPOPIMAPShare NoNotification

Passwords are not exported for security reasons, but they can be imported. You can open the text file with a spreadsheet or word processing program, enter default passwords for the users in the appropriate field, and then import the passwords along with the other user information.

To import data, select "Import Users & Groups" from the File menu of the Web & File Server Admin program. In addition to the name, you have the option of importing Internet Alias, Password, Comment, and Email Attributes.

If importing users with passwords, be sure to add the passwords in the appropriate field. For example, if you wanted to import internet aliases and e-mail attributes (skipping "Comments"), the password would be entered between these two fields. Using Mary Smith as an example again, her record for importing with a password "secret1", would be as follows (note that tabs would separate the fields in the text file you were importing from. Here, the tabs are indicated with a "->". Each record would be indicated with a hard return or carriage return, here indicated with a <CR>.)

Mary Smith ->smith.m -> secret1 -> HasMail->NoRequireAPOP-> BothPOPIMAP->Share->NoNotification <CR>

For AppleShare IP 6 system requirements, please see article 88015: "AppleShare IP 6: Server and Client Requirements"