1.0

Introduction

Inexpensive Macintosh computers make robust, easy-to-use, TCP/IP remote filing servers for Docutech production publishers. All that is required is a software package called MachTen, from Tenon Intersystems, on the WWW at http://www.tenon.com, or phone 1-(805)-963-6983.

TCP/IP remote filing service is only available if the Docutech's FTP feature is enabled. Contact your Xerox sales representative, systems analyst or service technician for any questions regarding the process of enabling this feature on your Docutech system.

1.1

MachTen Overview

MachTen is UNIX for the Macintosh. When you double-click on MachTen, you actually launch UNIX and run it just like any other Macintosh program. MachTen provides all of the networking capabilities of UNX, including FTP, which supports Docutech's Remote Filing. DocuJobs uploaded to MachTen are stored as files in a folder on the Macintosh and can easily be backed-up, off-loaded or deleted using the Macintosh.

MachTen is easy to install and easy to maintain. It runs on any Power Macintosh. 32MB of memory and 1GB of hard disk space are recommended for Docutech's remote filing service. Other Macintosh programs can be run at the same time as MachTen.

The following step-by-step instructions detail the process of installing and configuring MachTen and a Macintosh as an inexpensive Remote Filing Server for Docutech Production Publishers. Please review all of the documentation before actually installing the MachTen software and configuring the Docutech. If you have any questions regarding these instructions, contact Tenon Intersystems (1-805-963-6983) for assistance.

2.0

Suggested Hardware and Software Configuration

A custom Docutech Installer package (http://www.tenon.com/products/machten/docutech/) is needed to enable MachTen to act as a Docutech remote filing server. This installer is available for MachTen 4.1.1 (or later). Before proceeding with the rest of these instructions, you will need a suitable configured Power Macintosh, MachTen 4.1.1 and the Docutech Installer package.

MachTen 4.1.1 runs on any Power Macintosh. MacOS 8.0 (or later), 32MB of memory and 1GB of hard disk space are recommended for Docutech's remote filing service.

Before proceeding with the rest of these instructions, you will need a suitable configured Power Macintosh, MachTen 4.1.1 and the Docutech Installer package.

3.0

Configure the Macintosh as a Network Server

To provide TCP/IP based remote filing service to a Docutech, your Macintosh must be properly configured as a Network Server. Follow the steps in this section to setup your Macintosh as a server using TCP/IP networking.

3.1

The Energy Saver Control Panel

Network servers should be available at all times. Configure your "Energy Saver" options to not allow the Macintosh to go to sleep.

3.2

The AppleTalk Control Panel

Verify that the Macintosh is properly connected to the network. Open the AppleTalk Control Panel and select "Connect via: Ethernet".

If this control panel does not accept the Ethernet selection, the Macintosh is not properly connected to the network or there is something wrong with the network itself. Check all of your network connections.

In this example, the name of the Current zone is "DOCUTECH". This comes from the Novel Network Server. This name may be different on your network, depending on whether or not you have a Novel server and how it is configured.

3.3

The TCP/IP Control Panel

The TCP/IP Control Panel must be set appropriately for your network. These settings specify the TCP/IP addressing information used by the Macintosh. This example assumes the Docutech has been assigned an IP address on the 192.9.200 network (e.g., 192.9.200.50), and that the Macintosh's IP address is 192.9.200.12.

The TCP/IP Control Panel may initially look different than shown above. First set "Connect via:" to "Ethernet", then set "Configure:" to "Manually". Now the remaining fields should be exposed as shown above.

You can use any numbers you wish as long as you match them up during the other portions of the

installation. The numbers shown here are known to work if the Macintosh is on the private side of the Docutech network (as recommended). If you are installing the Macintosh on the public side with Internet access, you should contact your network administrator for assistance. Also, refer to your Appendix B worksheet that contains the IP addresses of the Docutech system as installed by your Xerox service technician.

4.0

Install MachTen

Insert the MachTen CD-ROM and double click on "MachTen 4.1.1 Installer". Follow the online instructions to install MachTen on your hard disk. When the installation completes, it automatically reboots the Macintosh. Don't launch MachTen until the Docutech package is installed and the following MachTen Control Panel settings have been specified.

5.0

Install the Docutech Package

Double-click on "Docutech Installer". Follow the online instructions to install this package into the (previously installed) MachTen folder. Don't launch MachTen until the following MachTen Control Panel settings have been specified.

6.0

Set Up MachTen as a Network Server

MachTen requires some site-specific configuration settings to set it up as a Network Server using TCP/IP networking. This example assumes the Docutech has been assigned an IP address on the 192.9.200 network (e.g., 192.9.200.50), and that the Macintosh's IP address is 192.9.200.12. You can use any numbers you wish as long as you match them up during the other portions of the installation. The numbers shown here are known to work if the Macintosh is on the private side of the Docutech network (as recommended). If you are installing the Macintosh on the public side with Internet access, you should contact you network administrator for assistance. Also, refer to your Appendix B worksheet that contains the IP addresses of the Docutech system as installed by your Xerox service technician.

6.1

The MachTen Control Panel

Launch the MachTen Control panel and enter the settings as follows.

6.1.1

General Configuration

Click on the "General" button to expose the General Settings.

Enter a Host Name for your Macintosh. The generic name "Macintosh" is OK. This choice provides an intuitive name when subsequently configuring the Docutech to talk to this system. Select your time zone from the pull-down list. Click "Save".

6.1.2

Memory Configuration

There is no need to change the Memory configuration from the default settings.

6.1.3

Networking Configuration

Click on the "Networking" button to expose the Networking Settings.

Enter the TCP/IP addressing information into the corresponding fields. Verify that the "Enable Incoming Connections" checkbox is checked. Click "Save".

Again, these numbers are known to work if the Macintosh is on the private side of the Docutech network (as recommended). If you are installing the Macintosh on the public side with Internet access, you should contact you network administrator for assistance. Also, refer to your Appendix B worksheet that contains the IP addresses of the Docutech system as installed by your Xerox service technician.

7.0

Launch MachTen

Once you have entered the above information, you can close the MachTen Control Panel and launch MachTen. MachTen will initialize itself (including completion of the installation of the Docutech package), and present a message about requiring a license number.

7.1

Temporary License Dialog Box

Click "OK".

7.2

MachTen Login Screen

Next, MachTen presents its login screen.

To enter the MachTen license number, you are required to enter a valid login account name and a password. Enter the account name "root" after the "login:" prompt. Be careful to use the correct case. Unlike the Macintosh, MachTen is case sensitive. If you make a mistake, use the <delete> key. Type <return> at the end of the account name. Enter the password "MachTen" after the "password:" prompt. Again, be careful to use the correct case. Characters entered as part of the password are not displayed on the screen, so type carefully. Type <return> at the end of the password.

7.3

The MachTen Command Window

When the user name and password are correctly entered, MachTen presents a terminal window with a "shell" prompt.

Type the command "chnglicense", and hit <return>.

7.4

The License Number Dialog Box

After you enter the "chnglicense" command, MachTen will display its license number dialog box.

Delete the temporary license number and enter your permanent license number. The license number can be found on the registration card that is included with the MachTen package. Click "OK".

MachTen is now configured and ready to run as a network server. The next time MachTen is launched (perhaps after the next time the Macintosh is restarted), it is not necessary to log into MachTen. MachTen will function as a network server even without anyone logged in on the login screen.

8.0

Configure MachTen to Launch Automatically

Network servers should be available all of the time. To make the Macintosh automatically launch MachTen every time the Macintosh is rebooted, make an alias to the MachTen application and place this alias in the "Startup Items" folder in the "System Folder".

9.0

Make an Alias to the "Jobs" Folder

The Docutech Installer creates a folder for DocuJobs uploaded to the Macintosh server. This folder is called "jobs" and resides inside the "docutech" folder in the "home" folder inside the "MachTen_HFS" folder. It is very convienent to find this folder once, and then create an alias to it. Move the alias to the desktop of the Macintosh system. (Don't move the original folder itself; folders within the MachTen hierarcy are very position dependent!)

The "jobs" folder corresponds to the "jobs" drawer that is created in a later stage of configuring the Docutech system to use the Macintosh server.

10.0

Creating Custom Drawers

Additional drawers with custom names can be created. The Docutech Installer package also created a "Custom Drawer Template" folder. To create a custom drawer for the Docutech, duplicate the "Custom Drawer Template" folder and rename the new folder with your custom name. This custom name will have to be entered into the Docutech system in a later stage of configuring it for Remote Filing to the Macintosh server.

11.0

FTP Account Information

The Docutech Installer package automatically creates a special FTP account for the Docutech. This account has the name "DOCUTECH" and the password "DOCUTECH". This name and password are entered into the Docutech in a later stage of configuring it for Remote Filing to the Macintosh server.

12.0

Docutech Setup and Configuration

After configuring MachTen, you will be ready to configure the Docutech 135 II Production Publisher. This

process must be followed closely in order to avoid any problems. The first step required is to have your Xerox service technician enable the FTP feature on the Docutech. If you have any questions regarding this process, contact your systems analyst, sales representative, or service technician.

Your next task is to assign the Docutech an IP address. To do this, you will need access to the "Security Folder" under the "Systems Administrator" switch. After the FTP services have been enabled on your Docutech, you will see an icon in the "Security Folder" labeled "Remote File" menu. Select the "Options" icon in the upper right-hand corner of the "Remote File" menu. In the "Options" menu, select "Docutech Identification". In the "Name" field of the "Docutech Identification" dialog box, type "DOCUTECH" in all caps. In the "Address" field of the dialog box, enter the IP address you assigned to the Docutech in the System (e.g., 192.9.200.50). Ignore the button labeled "Internetwork Properties". Close the "Docutech Identification" dialog box.

Select the "Options" icon in the "Remote File" menu again and select "Server List". A new menu will appear to the right of the "Remote File" menu. Select the "Create Server" icon at the top of the new menu. In the "Name" field of the "Create Server" dialog box, enter the host name of your UNIX server in upper- case. This is the same name you assigned to your UNIX server in the "General" options screen of the MachTen Control Panel (e.g., "MACINTOSH"). In the "Address" field of the dialog box, enter the IP address you assigned the Ethernet interface (in the "Networking" options screen of the MachTen Control Panel; e.g., 192.9.200.12). In the "Docutech Password" field of the dialog box, type "DOCUTECH" in all caps, followed by a <return>. You will be prompted to re-enter the password for confirmation. Enter the password again and hit <return>. Select the icon at the bottom of the dialog box labeled "Type 1 Server". Close the "Create Server" dialog box.

In the "Remote File" menu, select the icon labeled "Create Drawer" (the name you specify must match the corresponding folder created earlier (e.g., /hfs/home/docutech/jobs). In the "Drawers Alias" field, enter a name that describes the nature of the jobs that will be stored in that drawer. For instance, use the names of your customers and store all jobs into that directory. In the "Server Reference" field, enter the host name of your UNIX server in upper-case. This was determined in the MachTen Control Panel, under General Configuration (e.g., "MACINTOSH"). Select the "Path" icon. You will be presented with a "Path" dialog box. In this box you will want to enter the value that corresponds to the path of the directory you wish to reference on the MachTen server. The syntax for this is /hfs/home/docutech/jobs (the Docutech will automatically place the "/" in the directory name; just enter the directory name individually in each field), where <job_directory_name> corresponds to the directory you created on the MachTen server to hold your jobs. Note: You can create multiple drawers that reference different directories. Refer to section "10.0 Creating Custom Drawers" for information on setting up the Macintosh server for multiple drawers.

After you have set your path, you should select the "Access Controls" icon (Docutech user must have access for Remote Filing!) and set the access to all users. This will complete the Docutech configuration.

13.0

Troubleshooting

At this point, you should be able to transfer files from the Docutech Production Publisher to the MachTen UNIX server. Please refer to the Xerox TCP/IP Transport Administrator's Manual for information on using the FTP feature. If you are unable to transfer files, your problem could be either a network communications error or a configuration problem.

To check if there is a network communications problem, go to your MachTen server. Log in as "root" (the password is "MachTen"), and type "ping <Docutech_IP_Address>" at the shell prompt. Wait thirty seconds and simultaneously hit the <control> key and the letter "c"
(<Ctrl-c>). You should see a message detailing the amount of packets sent and received by the Docutech 135 Production Publisher. If no packets were received (100% packet loss), the Macintosh and the Docutech 135 are not seeing each other and are not communicating properly. For more details on the "ping" command, type "man ping" at the shell prompt.

You can also "ping" the Macintosh from the Docutech Production Publisher. This option is available in the "Diagnostic Program" section under the diagnostic switch labeled "Ethernet Test". Refer to the Docutech 135 manual for operating instructions.

If both machines can see each other and are able to communicate via "ping", you most likely have made an error in the configuration of either the Docutech or the MachTen software. Go back and check all of your configuration settings using this guide, or contact your Xerox systems analyst for assistance.

You should also test the MachTen FTP server "daemon" to see that it is working properly. While logged

in as "root", type "ftp <hostname>", where "<hostname>" is the name of your local host (e.g., "MACINTOSH"). You should be presented with another login prompt. Type "DOCUTECH". You will be informed that a password is needed and will be presented with a "password:" prompt. Type "DOCUTECH". You will be logged into the /home/docutech directory via the FTP daemon. You should be informed that the system type is "UNIX" and the file type is "binary". You will also be presented with an "FTP>" prompt. Type "bye" to exit FTP. If any step of this process does not occur, or if you are given any error messages, contact Tenon Intersystems (1-805-963-6983) for assistance.