Xerox Phaser 6115, DocuTech 6135, DocuTech 6155, Phaser 6100, Phaser 6180 Getting Started

Xerox Document Services Platform
DocuTech/DocuPrint 2000 Series printers

Getting

started

701P38849
October 2002
DocuSP version 3.6.xx

Prepared by:
Xerox Corporation
Global Knowledge and Language Services
800 Philips Road Bldg. 845-17S
Webster, New York 14580
USA

©2002 by Xerox Corporation. All rights reserved.

Copyright protection claimed includes all forms and matters of copyrightable material and information
now allowed by statutory judicial law or hereinafter granted, including without limitation, material generated
from the software programs which are displayed on the screen such as icons, screen displays, looks, etc.

Printed in the United States of America.

XEROX® and all Xerox product names mentioned in this publication are trademarks of XEROX CORPORATION.
Other company trademarks are also acknowledged.

Changes are periodically made to this document. Changes, technical inaccuracies, and
typographic errors will be corrected

in subsequent editions.

Table of contents

Table of contents ......................................................................................................................................................1

1. DocuSP 3.6.xx ............................................................................................................................... 1-1

New features.................................................................................................................................. 1-1

Minimum hardware requirements for DocuSP 3.6.x ................................... 1-5

Documentation............................................................................................................................... 1-6

2. DocuSP 3.6.x software release information ............................................................................... 2-1

Notes and caveats ......................................................................................................................... 2-1

DocuSP Controller ...................................................................................... 2-1

Security ....................................................................................................... 2-9

DocuJob Converter ..................................................................................... 2-9

VIPP Interpreter .......................................................................................... 2-9

DigiPath....................................................................................................... 2-9

Clients .........................................................................................................2-9

3. Resource Backup and Restore (RBR) utility.............................................................................. 3-1

Procedure for backing up and restoring resources ..................................... 3-2

Helpful hints for using RBR .........................................................................3-2

Sample resource backup and restore scripts ............................................. 3-3

4. Adobe Acrobat Reader ................................................................................................................. 4-1

For Windows and Macintosh....................................................................... 4-1

For Solaris................................................................................................... 4-1

New features

1. DocuSP 3.6.xx

Your Document Services Platform (DocuSP) product has just
been installed or upgraded. This document will familiarize you
with the new features and functions available with this system.

The following is a list of the features and functions now available
in the DocuSP Version 3.6.xx software. For customers
upgrading from an earlier version, this list details the
enhancements available to you in this version of the software.

The following new features are available for all DocuTech 2000
Series and DocuPrint 2000 Series printers including:

Þ DocuTech 6100, 6115, 6135, 6155, 6180

Þ DocuPrint 1xx EPS

Þ DocuTech 75, 90 and DocuPrint 75, 90

For detailed information on each of these new features, refer to
the DocuSP Help system or contact your Xerox customer trainer.

v The ability to forward a job from one DocuSP system to a

second DocuSP system. Job Forwarding allows the Trusted
User to select any job from the Job Manager and forward it
to another DocuSP 3.1 or 3.6 system.

v The ability to pause a job and reposition the page currently

printing to either an earlier or later page. For example, a job
with 2,000 unique pages may be paused at page 999 and
restarted printing at page 998 or 1001. Reposition output is
also known as Space Pages or Spacing.

v The ability to impose images in multiple combinations on a

single sheet of paper to support book printing. The Layout
feature is available on the Job and Queue Properties, and
provides a variety of image placement, rotation, and scaling
to support a variety of imposition models.

v Layout is only available for PostScript and PDF jobs.

v All page-level programming in the PostScript or PDF and

special pages programming is ignored during the
conversion.

XEROX DOCUMENT SERVICES PLATFORM SERIES 1-1

GETTING STARTED

v The Layout feature, also called imposition, requires a

license to be enabled and will be available later this year.
Contact your Xerox representative for more information.

DOCUSP 3.6.xx

v Support for Adobe Acrobat 5.0 and PDF version 1.4, which

primarily provides support for printing transparent image
data. Additional information may be obtained from the
Adobe PDF Reference Manual Version 3 by Adobe
Systems.

v Accounting enhancements:

v An option is now available to allow the automatic export

and purge of the accounting log when the log reaches
80% full.

v Additional options have been added to allow the

accounting log to be exported in an industry standard
delimited database file format. The format option saves
the accounting log in a fixed semi-colon format that is
standard for popular database software.

v The Account field name in the exported accounting log

has been changed to Department to support legacy LPS
systems.

v Additional accounting log file formats have been added

to support color versions of the DocuSP. These new
formats, 5.0 and 5.1, are not applicable to the DocuTech
and DocuPrint systems.

v Save facility:

v If the specified save path requested by the job being

saved does not exist, the Save Facility software now
automatically creates the path and saves the job in the
new location.

v Single or multiple TIFF page creation is now selectable.

v Stock Management:

v The Preferences tab for Stocks and Trays has been

expanded with additional options to allow the stock
management feature to be configured for each printer
type and market, and to allow customers to configure
the stock management for their workflow requirements.

v View Columns allows the customer to set which

paper tray options are displayed in the Printer
Manager.

v Allow Multiple Stocks per Paper Tray enables or

disables the ability to use the “Append” feature on a
tray.

v Display Preferred Trays allows a preferred tray

designation per a paper stock. This is especially
useful for paper stocks that require a particular type
of feed tray, for example using a vacuum feed tray
for a carbonless stock, or feed orientation.

1-2 XEROX DOCUMENT SERVICES PLATFORM SERIES

v Allow Tray Selection by Queue enables or disables

the ability for the customer to force a queue to feed

GETTING STARTED

DOCUSP 3.6.xx

the stock from a specific tray regardless of the paper
stock attributes of the stock in the tray.

v Enforce Unique Names forces the customer to

create new names for a new stock. Some printing
environments, especially the color printers, prefer to
be able to use duplicate stock names for stock
grouping and characterization.

v Allow Duplicate Names allows the user to create

multiple stocks with the same or similar name. In
the creation of the duplicate name, the customer
can select to automatically generate the name
extension, thus adding a !1, !2 to the duplicate stock
name, or manually generate the name extension
allowing the customer to determine the extension.

v Unspecified stock behavior has been more clearly

defined for each printer type.

v Queue Manager:

v The Queue Manager provides a new option to allow the

customer to feed stock from a specific tray as an
alternative to specifying the paper stock by stock
parameters. This option performs an override to the job
properties for paper stock for all job pages and
administration pages.

v The outQ size limit has been extended to scale with the size

of the internal hard drive of the DocuSP controller. This
allows for a very large outQ, which will allow processing of
very large jobs.

v The size of the banner page message field has been

expanded.

v The pages to print range has been expanded to 999,999.

v The maximum total number of exception pages, covers, and

inserts has been set at 1000 per job.

v SNMP enhancements:

v More complete SNMP support is now available,

including many of the printer engine level features can
now be communicated to the SNMP managers. The
exact list of available features is dependent upon the
match between the SNMP manager and the DocuSP
functions.

v The SNMP gateway now requires a license to be

enabled on the DocuSP controller.

v The SNMP gateway can be switched on or off by the

System Administrator or Trusted User in the Gateways,
SNMP setup tab. This switch allows the gateway to be
disabled as necessary for security reasons.

XEROX DOCUMENT SERVICES PLATFORM SERIES 1-3
GETTING STARTED

DOCUSP 3.6.xx

v The DocuSP user interface font size adjustment is now

available in the DocuSP user interface under the Setup pull­down menu. In DocuSP 3.1, the font size adjustment could
only be made through a UNIX command line tool.

v Configuration:

v The system information and configuration windows have

been enhanced with additional information. For
example, the General tab now includes specific details
about the processor speed of the DocuSP controller,
and hard disk sizes and types.

v An icon will now be displayed on the main menu that

indicates debug logging has been enabled or disabled for
troubleshooting purposes.

v The Job Status message has been updated to include a

percentage complete value. The percentage complete is
based on the total number of pages printed in relation to the
number of pages ripped and the quantity of prints. The
percentage displayed changes as the job is ripped and
printed, so very large jobs may display unexpected
percentages based on how much of the job has been ripped.

v Improvements have been made to the Job Status Message

area in Job Properties. The raw byte count is now reported
in Mbytes, and the field for pages printed now reads “Sheets
Delivered”.

v The ability to set the Socket Gateway to receive LCDS data

streams from VPS clients can now be set through the
DocuSP Gateways dialog. Prior to this release, the VPS
setup had to be accomplished via a UNIX command.

v The Reprint Manager module has been moved from the Job

Manager to a separate module, and the Reprint Manager
icon now displays on the module tool bar on the left side of
the user interface.

v Enhanced security for DocuSP and the UNIX environment.

For specific information, refer to the System Guide.

v Additional tape formats are now supported by the Tape

Client.

v ICL 2900

v Honeywell Bull

v Implementation of the LCDS workflow for the DocuTech and

DocuPrint 75/90 printers. The majority of the LCDS
workflow that has been available with the DocuPrint 1xx EPS
systems is now available on the 75/90 systems.

1-4 XEROX DOCUMENT SERVICES PLATFORM SERIES

v Addition of the On-line Gateway interface and Groupe

Set board.

v Addition of the LCDS decomposer to process LCDS

jobs.

GETTING STARTED

DOCUSP 3.6.xx

v Job, Queue, and Resource management features to

support LCDS jobs are the same as on the DocuPrint
1xx EPS systems.

v Off-line tape submission using the Tape Client interface.

v Certain limitations exist on the LCDS implementation

based on differences between the DocuPrint 1xx and
DocuTech/DocuPrint 75/90 printers. Refer to your
Xerox representative for more information.

v Support for 16 digit job numbers for LCDS jobs.

v The ability to set the DocuSP to automatically end a current

on-line job and start a new on-line job without operator
intervention.

v Refer to the Customer Letter for the Xerox Production Print

Services software version 3.6.xx for information on new
features and options available in the client drivers and Xerox
Document Submission tools.

Minimum hardware requirements for DocuSP 3.6.x

The DocuSP 3.6.x platform hardware requirements vary by
printer type and software options, such as LCDS, required by the
customer. Refer to the specific product documentation for the
platform requirements for each printer product.

XEROX DOCUMENT SERVICES PLATFORM SERIES 1-5
GETTING STARTED

DOCUSP 3.6.xx

Documentation

The documentation set to support the DocuTech 2000 Series
Models 61xx, 75, 90 and the DocuPrint 2000 Series Models 1xx
EPS, 75, and 90 is included on a CD ROM packaged with this
Getting Started document. The documentation is provided in
Adobe Acrobat pdf format for easy printing and for display on
your workstation.

The CD ROM is structured into collections of documentation:

· DocuSP 3_6: contains the system level documentation to
support the DocuSP controller.

· DP_EPS: contains the documentation that supports the
DocuPrint 1xx EPS products in addition to the system level
documentation.

· DT_61xx: contains the documentation that supported the
DocuTech 61xx products in addition to the system level
documentation.

· DTDP7590: contains the documentation that supported the
DocuTech/DocuPrint 75/90 products in addition to the
system level documentation.

· DC_6060: contains the documentation that supported the
DocuColor 6060 products in addition to the system level
documentation.

· Acroread: contains the executable files to load the Adobe
Acrobat Reader. Refer to the last section in this document
for instructions on loading the reader.

1-6 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED

Notes and caveats

DocuSP Controller

2. DocuSP 3.6.x software release
information

The following information supports the DocuSP 3.6.x software.
Please read the information thoroughly before using the system.

The following sections cover known notes and caveats for the
DocuSP 3.6.x software and supporting applications.

The following table details the notes and caveats for the DocuSP

3.6.x software and indicates which printer products, or all, to

which the caveat is applicable.

Caveat Applicable printer product

When using the Socket Gateway to submit
LCDS jobs, the jobs may contain missing
pages or data, extra pages or data, the job
may abort, or a C03-308 error may occur.
The Accounting Report for an LCDS On-line
job contains “Host Job Number = None” on
the middle reports for a multiple report job.

In the LCDS Resource Manager, when an
IMG file is sampled and the Positioning
window is open, the IMG file does not print
correctly if the units are millimeters, 600 dpi,
or 300 dpi. Ensure that the units are set to
inches.

If a custom paper size is programmed in the
Queue Manager to be Short Edge feed, LCDS
jobs raise a message “Edge marking values
are out of range”. If necessary, program the
custom paper size as a Long Edge Feed.

If an LCDS job is waiting with an OTEXT
WAIT command, the fault clearance window
to resume printing does not display. The
operator has to resume the job.

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

XEROX DOCUMENT SERVICES PLATFORM SERIES 2-1

GETTING STARTED

DOCUSP 3.6.xx

Caveat Applicable printer product

When a copy sensitive FORM command
causes a change to the back side, side 2, of a
page, the form does not print on side 2 but
prints on side 1 of the next page.

A DJDE syntax error is raised when a DJDE
command RTEXT=(TEST) is used, where
TEST is the name of a TST file.

If an LCDS job is submitted after a DocuSP
restart, a fault clearance message may
appear. Clear the fault and the system prints
correctly.

A large number (e.g. 100+) of jobs submitted
with the printer paused causes the printer to
cycle down intermittently after the printer
resumes printing. Single page printing
performance is very slow. Do not submit a
large number of single page jobs while the
printer is paused.

After changing the output order or output
delivery of a printing job, and then selecting
Apply Properties Now, the system hangs.
Restart the system, then delete and resend
the job.

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

DocuTech/DocuPrint 75/90
DocuPrint 1xx EPS

DocuTech/DocuPrint 90

DocuTech/DocuPrint 75/90

Do not attempt to program a paper tray that
contains ordered stock and is currently being
used by a printing job.

After a restart of the DocuSP software, the
Queue Manager, Printer Manager,
Administration, Job Manager, and Reprint
Manager windows may take up to 5 minutes to
come up. As a workaround, exit power saver
mode before restarting the system, or power
on power off the printer during the restart.
Any job with a paper size US Legal or US
Letter short edge feed and single portrait
stitching becomes ineligible with the message
“Job was received with a programming
conflict. Finishing is not available for jobs with
this media orientation.”

The system may display an unclearable Reset
message. The system prints normally.

When Offset stacking is enabled, stitched jobs
do not offset.

DocuTech/DocuPrint 75/90

DocuTech/DocuPrint 75/90

DocuTech/DocuPrint 75/90

DocuTech/DocuPrint 75/90

DocuTech 61xx

2-2 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED

DOCUSP 3.6.xx

Caveat Applicable printer product

During a Print Now or Proof, a message to
“Remove Sheets from the Top Tray” may be
displayed when there is no need to remove
sheets. Always clear the message before
performing any other operation.

When a job is printing to the top tray and is
interrupted by a print now or proof job, the
interrupted job stops (as it should) and an
error message reads "remove sheets from top
tray". Whether the sheets are removed or not,
the message stays until "reset" is selected in
the fault frame.

The listp command does not work on the 61xx
system.

If the system is in power saver mode and all of
the paper trays are empty, when the power
saver mode is reset, the printer may hang with
the printer initializing until paper is added to
the trays.

External finishing cannot be selected at the
client using the IPP or HTTP gateways.
Submit the job to the printer without any
finishing, and select the external finisher at the
DocuSP.

DocuTech 61xx

DocuTech 61xx

DocuTech 61xx

DocuTech 61xx

DocuPrint 1xx EPS
DocuTech 61xx

Do not apply late binding attributes (Apply
Properties Now) and Reposition Output
options on the same job.

Intervening DJDE packets cause the EPS and
LPS to process GRAPHIC DJDEs differently.
LPS prints the data on the same page. EPS
prints the data on two or more pages.

For multi-copy jobs, if an OTEXT command is
specified on a copy pass for a page that
doesn't print (no data on the page), then the
OTEXT message will not be displayed and the
WAIT parameter will be ignored.

The system is unable to resume printing when
late binding attributes and page spacing
options are used. As a work around, restart
the DocuSP or Select Sample Current job
from the Printer drop down menu to activate
the resume and sample button on the
repositioning output dialog box and the
Resume button on the DocuSP main window.

DocuPrint 1xx EPS

DocuPrint 1xx EPS

DocuPrint 1xx EPS

DocuPrint 1xx EPS

XEROX DOCUMENT SERVICES PLATFORM SERIES 2-3
GETTING STARTED

DOCUSP 3.6.xx

Caveat Applicable printer product

Fast scan registration is off by –1/8 inch
between a 300 dpi and a 600 dpi queue.

If the system crashes during the submission of
a streaming job, the job must be cancelled
from the client and resubmitted.

If the system is set to Retain the last 50 jobs,
the jobs are deleted when a software upgrade
is performed.
If an alignment of over 275mm is made and
Apply Properties Now selected, the job will be
aborted with a C16-350 error.

After a software installation, the PCL paper
sources window is unexpectedly blank the first
time you select Queue Manager, Paper
Sources. Close the windows and reopen and
the default values will appear.

Jobs with extreme Alignment shifts will fault.
For example:

- Dots with extreme positive values

- Scan lines with extreme positive or

negative values
As a work around, use a shift magnitude
slightly less (>0.01 inches) than the extreme
value.
NOTE: Dots with extreme negative values will
not fault.
When entering an image shift with values less
than 1 inch, enter a leading 0 (e.g. 0.5) before
the decimal point.

DocuPrint 1xx EPS

All

All

All

All

All

All

Do not send list files or other ASCII jobs to the
TIFF decomposer. The jobs will fault without
a message.
No job name is created for an ASCII
document when the job name is not specified
during job submission. This is also a problem
for a saved Job since the saved job name is
created from a job name that does not exist.

The job progress update is not consistent in
the Properties Tab and the DocuSP main
window.

If you save a job as Single-page TIFF and
then save the same job with the same name
as Multi-page TIFF, the job is successfully
saved over the Single-page TIFF job.

2-4 XEROX DOCUMENT SERVICES PLATFORM SERIES

All

All

All

All

GETTING STARTED

DOCUSP 3.6.xx

Caveat Applicable printer product

A job submitted through the lpr gateway with
image shifts on exception pages uses values
from the job level image shift instead.
Program the image shift values for the
exception pages in Job Properties.

Processing performance on a 600x600 dpi
queue is considerably less than performance
on a 300x300 dpi queue. Not selecting the “fit
to page” selection in the driver increases the
performance.
Type 1 fonts with an invalid “BlueValues” field
may not install correctly.

When a preinstalled stock sized 12x18 inches
is selected for a paper tray, a new name is
created in the stock list. The ! delimiter and a
number will be appended to the name.

The Output Delivery change (Face Up or Face
Down) does not take affect when the change
is made while a job is printing and the Apply
Properties Now is selected.

An internal error requiring a restart of the
DocuSP controller occurs when changing the
job ticket programming for exception pages,
covers, and inserts on a saved job in Reprint
Manager.

All

All

All

All

All

All

If multiple users are submitting requests to the
IPP Gateway, the requests are managed one
at time at the DocuSP controller. If a user is
sending a large job through XDS Plus then all
other users who try to connect, use, or submit
a job will not be able to do anything until that
job is submitted, and XDS Plus will appear to
hang.
Jobs printed with the –nofinishing option fault
at the controller requesting an external
finisher. Reprogram the job at the controller.

Jobs that contain multiple setpagedevice
commands for copycount, collate, and
finishing may not print correctly.

A reprint job requiring full cut tab stock
becomes ineligible requesting plain drilled
stock. Reprogram the job in Job Manager or
Reprint Manager for full cut tab stock.

The job status displayed in the Main status bar
may be different from the status displayed for
the job in Job Manager.

All

All

All

All

All

XEROX DOCUMENT SERVICES PLATFORM SERIES 2-5
GETTING STARTED

DOCUSP 3.6.xx

Caveat Applicable printer product

Total pages saved in the Job Properties for a
saved job does not reflect the total number of
saved pages.

If an active window is minimized or hidden
behind the DocuSP Print Services window, the
mouse is inoperable and an alert tone will
sound. Minimize the DocuSP Print Services
window to find the hidden active window.

Solaris 8 does not allow ftp, file transfer
process, to be used with root user access.
Any processes that use ftp that have typically
used root access need to be modified to use
another user. For example, DigiPath
NetAgent and Production Print features, VIPP
resources, or font transfer.

The Walk Up user can print any files on the
DocuSP controller using the Reprint Manager
tab in Job Manager, including any files set for
read only access by root or any sample jobs.

Do not use the Apply Properties Now button in
Queue Manager to change job attributes to
using ordered stock. The job will fault.

All

All

All

All

All

PCL fonts cannot be loaded from a directory
that contains multiple subdirectories. In order
to load PCL fonts from a directory, create a
Font directory and store the fonts in that
directory. Do NOT use the /font directory,
located in root on all DocuSP systems, to
store uninstalled fonts. Avoid using long
directory structures for font installation.

At this time, setting up the HTTP, and SNMP
gateways cannot be accomplished through the
graphical user interface. The gateways and
the common settings must be set using the
gwConfig utility through a UNIX Terminal
window. The instructions for performing the
gwConfig utility are included in the Document
Services Platform System Guide.

All

All

2-6 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED

DOCUSP 3.6.xx

Caveat Applicable printer product

The following are known problems with the
HTTP gateway and DocuSP Web Interface:

Þ Do not specify an ampersand (&) in the

sender name, file name (print ready), or

Queue name fields.

Þ Faulted jobs display as held in the queue

list.

Þ When the DocuSP W eb Interface is

accessed from a client workstation, the

web URLs displayed in the Support

section are placeholders.

For the IPP gateway using XDS Plus:

Þ Send jobs to a spooling queue only. Do

not send jobs to a streaming queue.

After a restart or reboot, ineligible jobs in a
held queue move to an active window and
change status to pending.

Negative image shift values do not display the
negative sign but the job prints correctly.

All

All

All

All

An insert programmed for a paper type
custom displays as the main paper stock type
of the job. The insert prints correctly on the
custom stock.

The following fonts are no longer part of the
resident PostScript font set of the DocuSP:

Barmeno-Regular
Barmeno-Medium
Barmeno-Bold
Barmeno-ExtraBold
Formata-Regular
Formata-Medium
Formata-Italic

Formata-MediumItalic
Jobs that use any of these fonts will fault at
the controller. Select a different font.
When a PostScript font is loaded, the font is
immediately available. However, a restart of
the DocuSP software is required before the
font is listed in the font window.

Imposition is available for PS and PDF only.
Imposition is not supported for PCL, LCDS,
VIPP, or ASCII jobs. If non supported jobs
are submitted and modified to be imposition
jobs, the jobs print as normal and not fault.

All

All

All

All, Imposition only

XEROX DOCUMENT SERVICES PLATFORM SERIES 2-7
GETTING STARTED

DOCUSP 3.6.xx

Caveat Applicable printer product

The Sides Imaged value for signature layouts
must be either the Queue default value or the
job must be programmed to be Head-to-Toe
regardless of the orientation.

If the original size of the job is changed during
the printing process, such as after a proof has
been run, the Original Size is set to the default
Letter size. Be sure to check and, if
necessary, change the Original Size before
printing the job.

The value shown in the Current Stock Size
field does not update to match the Size value
on the Stock tab.

All, Imposition only

All, Imposition only

All, Imposition only

2-8 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED

Security

DocuJob Converter

VIPP Interpreter

DOCUSP 3.6.xx

The following notes and caveats are specific to Security issues
on the DocuSP controller.

- The IPP Gateway loads an unsecured version of Java. If
security is an issue, do not use the IPP Gateway.

– The DocuJob Converter software must be at least version

2.1.04. This version corrects a timing problem that resulted
in jobs being lost at the controller.

– Version 2.2 of the DocuJob Converter software, which runs

under Solaris 2.6 on a Sun Ultra 60 platform, is available.

– VIPP 4.0 demo mode is included with a DocuSP 3.6.xx new

installation. In order to fully use VIPP 4.0, a production kit
and a license will need to be obtained from your Xerox
representative. Existing DocuSP customers with a VIPP
license should be able to upgrade to DocuSP 3.6.xx and
VIPP 4.0. In order to use VIPP 4.0, the DocuSP must be at
version 3.1 or higher.

DigiPath

Clients

– Please reference the VIPP documentation for additional

information pertaining to VIPP.

– Please reference the DigiPath 3.0 Customer Software

Release Supplement for additional information pertaining to
DigiPath.

– Please reference the Xerox Production Print Services

version 3.6.xx documentation for more information.

– Macintosh clients using the AppleTalk Gateway submit jobs

very slowly or hang during submission, requiring a reboot of
the DocuSP controller.

XEROX DOCUMENT SERVICES PLATFORM SERIES 2-9
GETTING STARTED

DOCUSP 3.6.xx

2-10 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED

3. Resource Backup and Restore
(RBR) utility

The Resource Backup and Restore (RBR) utility allows you to
back up and restore customer resources such as PostScript
fonts, LCDS resources (JSLs, JDLs, etc.), VIPP files, and
custom color profiles on color printing systems. The RBR utility
backs up files to either magnetic tape or the controller internal
hard drive. You can then use the backup disk file or tape to
restore the resources onto your controller or other DocuSP
controllers.

The following resource files may be backed up to either tape or
file:

· LCDS resources: All files in the lcds resource library, located
at:

/var/spool/XRXnps/resources/lcds

· PS fonts: All PostScript font files in the following directory:

/var/spool/XRXnps/resources/ps/fonts

· Color resources: User TRCs, user ICC profiles, and the
ccprof.tv file, which associates the ICC profiles with your
stock database

· VIPP resources: Customer VIPP files in the following
directory:

/var/spool/XRXnps/resources/XRXxgfc

· Stock Programming database: The media.tv file

CAUTION: Use the Media Restore option (Options 3 and 4
of the Restore Menu) only if you are restoring files to the
same release of software from which you backed them up.
Otherwise, the results are unpredictable and may require
scraping the machine.

XEROX DOCUMENT SERVICES PLATFORM SERIES 3-1

GETTING STARTED

DOCUSP 3.6.xx

Procedure for backing up and restoring resources

This procedure requires root access to the DocuSP controller so
that the necessary permissions are available to restore the
resources.

Note: For these instructions, it is assumed that you have some
working knowledge of the UNIX operating system.

The RBR script file is available in the /opt/XRXnps/bin directory
of your installed DocuSP 3.6 controller.

1. Open a Terminal window.

2. Enter su.

3. Enter the root password for your system.

4. Change to the directory containing the script.

cd /opt/XRXnps/bin

5. Ensure that the executable permission is assigned by
following this procedure:

Helpful hints for using RBR

a. Enter ls –l.

b. If x permission is not assigned, enter – chmod +x RBR.

6. Start the script by entering ./RBR.

7. Follow the instructions as they appear on screen to complete
the resource backup procedure.

· If you are backing up a large amount of resources, you can
monitor the progress of the backup by opening an additional
Terminal window and entering:

tail –f /var/spool/XRXnps/log/Resource_BandR.log

· If you are backing up the resources to tape, you need to
know the device ID of the tape drive. There are several
ways to verify the ID and operability of your tape drive.

- If you have only one tape drive, the ID is usually 0.

- If you have two tape drives, each drive is assigned an ID

starting with 0.

3-2 XEROX DOCUMENT SERVICES PLATFORM SERIES

- You should use the mt command to check the operation

of your tape before beginning. Following are some
examples of the mt command.

mt –f /dev/rmt/0 status
mt –f /dev/rmt/0 rewind
mt –f /dev/rmt/0 erase

GETTING STARTED

DOCUSP 3.6.xx

· When restoring files, the RBR script first makes a backup of
the resources that are currently installed on the system.
After the original files are backed up, the backup files are
restored, and then the original files are restored. This
ensures that newer files are not overwritten with older files
that are restored from the backup.

If this is not your intent, use the mv command to remove the
existing resources from their directory so that all the
resources from the backup are restored. For example:

mv /var/spool/XRXnps/resources/lcds
/export/home/xrxusr

· Unless you are backing up files and restoring them to the
same software release, do not use the RBR utility to restore
the Stock Database programming.

You can use the Restore Stock Database option to back up
files from DocuSP 2.1 or 3.1 and restore them to DocuSP

3.6 or above.

However, if you restore the stock database programming
from DocuSP 2.1 to DocuSP 3.1, the database manager
may not comprehend the older version of the stock database
file, and the Restore process would render the software
inoperable. A scrape would then be required to correct the
problem.

Use the Backup and Restore Bridge tool delivered with your
DocuSP software to perform the Stock Database Restore.

Sample resource backup and restore scripts

Following are examples of resource backup and restore scripts.
Responses by the user and user-specific information provided by
the RBR utility are shown in boldface type.

Sample backup script

# ./RBR

MAIN MENU

Please enter your selection:

1) Backup resources

2) Restore resources

3) EXIT

Select (1,2,or 3)? > 1
You have selected Backup resources.

Backing up 10895 LCDS resources to
/export/home/xrxusr/jbs/wiggum_25_Jul_09:54.tar.
This may take some time.
Check /var/spool/XRXnps/log/Resource_BandR.log file to view
progress.

XEROX DOCUMENT SERVICES PLATFORM SERIES 3-3
GETTING STARTED

DOCUSP 3.6.xx

Backing up 180 PS fonts to
/export/home/xrxusr/jbs/wiggum_25_Jul_09:54.tar.

This may take some time.
Check /var/spool/XRXnps/log/Resource_BandR.log file to view
progress.

No user trc's were found. No user trc's were backed up,
No ICC profiles were found. No ICC profiles were backed
up.

Backing up ccprof.tv file to
/export/home/xrxusr/jbs/wiggum_25_Jul_09:54.tar.
This may take some time.
Check /var/spool/XRXnps/log/Resource_BandR.log file to view
progress.

No customer VIPP files found.

Backing up media.tv file to
/export/home/xrxusr/jbs/wiggum_25_Jul_09:54.tar.
This may take some time.
Check /var/spool/XRXnps/log/Resource_BandR.log file to view
progress.
a /opt/XRXnps/configuration/media.tv.bak 44K
Done

Compressing
/export/home/xrxusr/jbs/wiggum_25_Jul_09:54.tar. Please
wait ...

Done.

Your files have been successfully backed up and compressed.
File name is
/export/home/xrxusr/jbs/wiggum_25_Jul_09:54.tar.Z
Do you want to copy file to QIC tape? (Y/N) > y
Please enter a device ID for the QIC tape drive [Generally 0
(digit zero)]:0
Please insert a QIC tape into QIC tape drive
Press RETURN/ENTER when ready. >

Copying file to QIC tape. A blinking light on the tape drive is an
indication that backup is progressing.
See /var/spool/XRXnps/log/Resource_BandR.log for list of files
that were backed up.
Press RETURN/ENTER to continue. >

3-4 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED

DOCUSP 3.6.xx

Sample resource restore script

MAIN MENU

Please enter your selection:

1) Backup resources

2) Restore resources

3) EXIT

Select (1,2,or 3)? 2

RESTORE MENU

Please enter your selection:

1) Restore Resources from Tape

2) Restore Resources from File

3) Restore stock programming from Tape

4) Restore stock programming from File

5) Back to Main Menu

Select (1,2,3,4 or 5)? > 1
You have selected Restore Resources from Tape.
Please enter a device ID for the QIC tape drive [Generally 0
(digit zero)]:0
Please insert a QIC tape into QIC tape drive
Press RETURN/ENTER when ready. >

Backing up current resources, so that newer files will not be
overwritten.
This may take some time.
Check /var/spool/XRXnps/log/Resource_BandR.log file to view
progress.

No user TRC's were found.
No ICC profiles were found.

Done.

We will now restore your resources from the QIC tape.
A blinking light on the tape drive is an indication

that backup is progressing.

About to uncompress
/export/home/xrxusr/jbs/wiggum_25_Jul_09:54.tar.Z
This may take some time. Please wait ...
Check /var/spool/XRXnps/log/Resource_BandR.log file to view
progress.

Uncompress and tar successful.

We will now restore the newer files.
This may take some time.

Check /var/spool/XRXnps/log/Resource_BandR.log file to view
progress.

XEROX DOCUMENT SERVICES PLATFORM SERIES 3-5
GETTING STARTED

Done.
Press RETURN/ENTER to continue. >

MAIN MENU

Please enter your selection:

1) Backup resources

2) Restore resources

DOCUSP 3.6.xx

3) EXIT
Select (1,2,or 3)? 3
You have selected EXIT.
Cleaning up.\:
Done.

3-6 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED

For Windows and Macintosh

4. Adobe Acrobat Reader

To install the Acrobat Reader, follow the instructions below. The
Reader software is available on the customer documentation
CDROM for Windows 95/98/NT, Macintosh, and Solaris.

1. Insert the documentation CDROM into the CDROM reader
on your workstation.

2. Open to folder labeled ACROREAD.

3. Open the folder that is specific to your workstation, either
Windows or Mac.

4. W indows: Double click on the ar405eng file. Follow the
instructions on the screen to install the reader.

5. Macintosh: Copy (select and drag) the ar405eng file to the
desktop. Double click on the file and follow the instructions
on the screen to install the reader.

For Solaris

1. Insert the documentation CDROM into the CDROM reader
on the DocuSP controller.

2. In the background, select and open a terminal window.

3. Logon as the root or superuser.

4. Change directory to the CDROM, Acroread directory:

cd /cdrom/65docs/acroread/solaris

5. Copy the ssolrs.tar file to the /tmp directory:

cp ssolrs.tar /tmp

6. Change to the /tmp directory:

cd /tmp

7. Untar the ssolrs.tar file:

tar –xf ssolrs.tar

8. Run the ssolrs install script:

SSOLRS.install/INSTALL

9. The license agreement is displayed. Use the [Enter] key to
scroll through the agreement, and type accept to accept the
agreement.

XEROX DOCUMENT SERVICES PLATFORM SERIES 4-1

GETTING STARTED

DOCUSP 3.6.xx

10. The screen asks for the installation directory for the reader.
Press the [Enter] key, and then type y to create the Acrobat4
directory.

11. W hen the installation is complete, you can start the Acrobat
Reader by typing:

/opt/Acrobat4/bin/acroread – iconic

12. The Adobe Acrobat Reader is started and placed as an icon
on the desktop. Open the Reader, and select [File], [Open].
Enter the path to the customer documentation CDROM
(/cdrom/65docs) to open one of the pdf files on the
documentation CDROM.

NOTE: Steps 11 and 12 will have to be performed every
time the system is shutdown and restarted unless a path is
set up to the Adobe Acrobat Reader executable.

NOTE: If an icon does not appear, refer to the next
procedure.

In order to launch the Adobe Acrobat Reader from the CDE
console, located in the bottom center of the screen, perform the
following steps:

1. Open the File Manager.

2. Change to the /opt/Acrobat/bin folder.

3. Open the folders pop up menu by selecting the up arrow
above the file drawer icon on the CDE console.

4. Use the left mouse button to select and drag the acroread
file from the File Manager window to the Install Icon on the
Folders pop up menu. This will install an icon that can be
selected to launch Acrobat Reader.

When the Acrobat Reader icon is selected, a window titled
Action:Run opens. Select [OK] and a run window opens, then
Acrobat Reader opens. Minimize the Run window if desired;
closing the Run window closes the Acrobat Reader.

4-2 XEROX DOCUMENT SERVICES PLATFORM SERIES

GETTING STARTED