Changing file resource information with Fork Translator

For Windows servers, run the Fork Translator utility to change resource information for specific files or folders.

Prerequisites

• All Prinergy server and client computers must be updated to the latest version of Prinergy Workflow.
• Plan for downtime ranging from one to several hours, depending on the size of your volumes. For example, after you quit the required software, converting a volume that contains 10,000 files takes two to three minutes.

Use Fork Translator to convert file resources in the following situations:

• For Windows volumes that contain files you want to convert. You do not have to convert volumes that do not contain jobs. For example, you do not need to convert a volume that is used only for temporary storage or a volume that contains hot folders or smart hot folders that accept input files and move them to other locations.
• Fonts in the AraxiPreps share on the Primary server.
• Files were not converted—for example, files that are open or have special characters.
• You want to restore files that were archived using NT Backup with a different Mac client computer protocol.

Note: Do not use Fork Translator on UNIX or Xserve volumes because Fork Translator cannot convert them. If you select UNIX or Xserve volumes, you create unnecessary and useless hidden files on the target volume.

This utility does not convert the following files:

• Files that are open during the conversion
• Files with names that contain certain special characters, such as * | \ / ? < >
• Files that are located on system volumes, in the Recycle Bin, or in Oracle data directories

1. Close the files that you want to convert.
2. On the Prinergy primary server or another Windows computer, open a command-prompt window.
3. Enter the following command:

   forktranslator {-a|-s|-h} [-I] [-n|-o] [-e] [-p] [-v] pathname...
   where

   -a	Creates resource fork information when converting from SMB with Named Forks (alternate data streams) or AFP (Apple Filing Protocol) to SMB with AppleDouble files For example, forktranslator -a -I -o \\<ServerName>\<FolderName>
   -s	Creates resource fork information when converting from SMB with AppleDouble to SMB with Named Forks or AFP For example, forktranslator -s -I -o \\<ServerName>\<FolderName>
   -h	Prints this usage information
   -I	Ignores errors and continues to process other files
   -n	Does not execute; only lists file names
   -e	Excludes the specified folders (separated by semicolons)
   -o	Overwrites existing fork information in SMB with AppleDouble files or SMB with Named Forks, if present
   -p	Prints progress on-screen
   -v	Writes to standard output (stdout) files. Implied by -n.
   pathname...	Operates on the specified files and/or folders (separated by spaces). Folders are treated recursively.

4. Close the command-prompt window.
5. If an error occurs, a message appears, telling you to view the log file:
   1. Click OK to close the message.
   2. In the %AraxiHome%\CreoAraxi\System folder, open the forktranslator.log file in Notepad.
   3. If the log identifies job files that were not converted, locate the original job file from a backup or other source, and copy the file to the volume.
      Resources are created automatically when you copy the file.