Copyright protection claimed includes all forms and matters of copyrightable
material and information now allowed by statutory or judicial law or hereinafter
granted, including without limitations, material generated from the software
programs which are displayed on the screen such as styles, templates, icons,
screen displays looks, and so on.
XEROX®, The Document Company®, the digital X®, Xerox Canada Ltd.®, Xerox
Europe®, and all identifying numbers used in connection with the Xerox products
mentioned in this publication are trademarks of XEROX CORPORATION.
All non-Xerox brands and product names are trademarks or registered
trademarks of their respective companies.
While every care has been taken in the preparation of this material, no liability
will be accepted by Xerox Corporation arising out of any inaccuracies or
omissions.
Changes are periodically made to this document. Changes, technical
inaccuracies, and typographical errors will be corrected in subsequent editions.
This product includes software developed by the Apache Software Foundation
(http://www.apache.org/).
This chapter describes Documents Xpress — Xerox Web Document
Submission Software Version 2.0 and how to use this manual.
Documents Xpress — Xerox Web Document Submission Software
Documents Xpress allows end users to submit print jobs electronically
using industry standard browsers. Once submitted, production personnel
efficiently update job status as documents move through the production
cycle, providing users with information about their jobs. Web-based
printing generates cost savings and improvements in quality, productivity,
and turnaround time.
The system uses several services that can be loaded on one or more
servers, depending on the print shop configuration.
Intended Audience
This manual is intended for use by Xerox personnel who are responsible
for the installation of this system.
NSTALLATION AND CONFIGURATION GUIDE
I
1-1
NTRODUCTION
I
Assumptions
Conventions
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
The person installing Documents Xpress software should have
experience in the following areas:
• Windows NT server and / or Windows 2000 server administration
• Applicable workstation operating systems experience
• Hypertext Markup Language (HTML)
• Extensible Markup Language (XML)
• JavaServer Pages (JSP)
• Structured Query Language (SQL)
This guide uses the following conventions:
• Menu items and buttons appear in bold text.
• Screen, text box, and drop-down list titles, are spelled and punctuated
exactly as they appear on the screen.
• Document titles appear in italics.
• Content representative of text that is displayed on a computer monitor
is displayed in Courier New font and enclosed in a shaded table as
shown in Table 1-1.
Table 1-1. Example of text displayed on a computer monitor
INSERT INTO Field {field_name,custom_name}
1-2I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
Related Documentation
The following manuals provide further information on the
Documents Xpress system:
• Documents Xpress — Xerox Web Document Submission Software
Installation Planning Guide – 701P37977
• Documents Xpress — Xerox Web Document Submission Software
System Administration Guide – 701P37979
• Documents Xpress — Xerox Web Document Submission Software
Product Overview Guide – 701P37980
• Documents Xpress — Xerox Web Document Submission Software
Product Overview Training – 701P37981
Note: Operator / Administrator and User instructions are available as
online help while using the Documents Xpress system.
2.0I
NTRODUCTION
NSTALLATION AND CONFIGURATION GUIDE
I
1-3
Responsibilities
System Administrator
2. Product Overview
Documents Xpress is a web-based application used to submit and track
jobs.
System users access the software via three web interfaces:
• A User interface for submitting print jobs
• An Operator interface for printing jobs
• A Printer Administrator interface for setting up printers and templates,
customizing the user interface, and establishing pricing
The System Administrator manages user, operator, and print shop
administrative permissions for a print shop installation. Specific tasks
include:
• Managing Documents Xpress software
• Customizing the Documents Xpress user interface
• Managing user / operator permissions for a single print shop
The System Administrator will have a detailed understanding how the
Documents Xpress software works.
NSTALLATION AND CONFIGURATION GUIDE
I
2-1
RODUCT OVERVIEW
P
OCUMENTS XPRESS
D
Print Shop Administrator
The Printer Administrator is a user who manages a print shop. Specific
tasks include:
• Establishing specific print shop policies
• Configuring printers
• Generating reports using Documents Xpress tools
• Load pricing data into Documents Xpress
• Creating templates
The Print Shop Administrator must understand how to configure a printer
and how printer communications work.
Print Shop Operator
The Print Shop Operator is a user who manages the printing workflow in
a print shop. Specific tasks include:
• Printing jobs sent by end users
• Modifying the job status as jobs move through the workflow
• Distributing printed materials
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
The Print Shop Operator must have detailed knowledge of scheduling
and prioritizing print jobs as well as a solid understanding of the
capabilities and capacities of the print shop.
2-2I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
User
The User submits documents and jobs to Documents Xpress over the
Internet using a web browser, the Xpress Print Driver (XPD), or in some
installations through DocuShare. Specific tasks include:
• Using Documents Xpress as the interface to the print shop and local
printers
• Uploading documents into Documents Xpress
• Requesting printing and resubmission services using Documents
Xpress
The User must be knowledgeable about basic web browser use, general
Internet use (downloading, uploading, and navigation), and printer driver
installation.
2.0P
RODUCT OVERVIEW
NSTALLATION AND CONFIGURATION GUIDE
I
2-3
3. Installation Requirements
Documents Xpress requires a specific combination of hardware, software,
and information to ensure a successful installation. These requirements
are documented in the Documents Xpress — Xerox Web DocumentSubmission Software Installation Planning Guide.
These installation instructions assume that the Documents Xpress server
has had the proper operating system installed and has a working
connection to the Internet.
Hardware Requirements
Server Requirements
• One Windows NT 4.0 or Windows 2000 server
• 9-GB hard disk
• 512-MB random access memory (RAM)
• One 10/100 MBPS network interface card (NIC)
• One available drop on a 100-MBPS network
• Simple Mail Transfer Protocol (SMTP) server supporting Anonymous
SMTP connections for outgoing mail
• An uninterruptible power supply (UPS) for the server
Client Requirements
• Workstation capable of using a supported operating system and a
supported browser
NSTALLATION AND CONFIGURATION GUIDE
I
3-1
NSTALLATION REQUIREMENTS
I
D
Software Requirements
Server Requirements
• Microsoft Windows NT Server 4.0 or Microsoft Windows 2000 Server
• Microsoft TCP / IP Printing service (LPR service) installed (Windows
NT Server 4.0 only)
• Microsoft Office XP
• Adobe Acrobat Reader
• Documents Xpress software
• Internet Explorer 5.5 (or later) or Netscape Navigator 4.75 (or later)
• WinZip
Client Requirements
• Any one of the following operating systems:
• Windows NT Workstation 4.0
• Windows 2000 Professional
• Windows 95 / 98 / ME
• Adobe Acrobat Reader
• Internet Explorer 5.5 (or later) or Netscape Navigator 4.75 (or later)
• WinZip
OCUMENTS XPRESS
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
Information Requirements
See the Documents Xpress — Xerox Web Document Submission
Software Version 2.0 – Installation Planning Guide for a complete list of
the information requirements.
3-2I
NSTALLATION AND CONFIGURATION GUIDE
4. Installing the Software
Obtain the Documents Xpress — Xerox Web Document Submission
Software Version 2.0 – Installation Planning Guide before installing the
software. The following figure, Figure 4-1 gives an overall look at the
workflow for the complete installation process.
Figure 4-1. Documents Xpress installation process
Installation
process
Gather customer
installation information
Schedule installation
Install, configure and test
software
Customize and test
software as required
Software training as
required
NSTALLATION AND CONFIGURATION GUIDE
I
4-1
NSTALLING THE SOFTWARE
I
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
When performing an installation, the following, including third-party
software and printer driver, must be present and properly configured on
the server before installing Documents Xpress software:
• Adobe Acrobat Reader
• XDX PDFwriter print driver
• Microsoft Office XP
It is recommended that the server be assigned a name and physically
labeled with the applicable name and machine IP address. An example is
shown in Figure 4-2.
Figure 4-2. Example server label
Example label
Documents Xpress
Server
IP: xxx.xxx.xxx.xxx
Third-party Software and Printer Driver Installation
2.0
Installing Adobe Acrobat Reader
The system uses Adobe Acrobat Reader to convert documents to PDF
format. If Adobe Acrobat Reader is not already installed on the
Documents Xpress server, it must be downloaded from Adobe and then
installed.
Perform the following to install Adobe Acrobat Reader:
1. Go to http://www.adobe.com and download a copy of Acrobat Reader.
Choose either the base version, or the version that can search PDF
files. Either free version will work with Documents Xpress.
2. Follow the instructions from Adobe to install Adobe Acrobat Reader.
4-2I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
Note: Restarting the server is not necessary at this time. The server will
be restarted as part of the final installation procedure.
Adding the Print Driver
The Xpress Print Driver (XPD) is used to convert documents to PostScript
before they are sent to the printer.
Perform the following to add the XPD:
Windows NT 4.0 Server
1. Create a folder named XPD on the C: drive of the server.
2. Unzip xpd-1.1.3.zip into the newly created XPD folder. This file is in a
Java archive (jar) file on the installation CD at
<CD ROM drive>/ installer.jar. Use WinZip to open installer.jar.
When the file listing appears in WinZip, locate and double-click
webAppServer_dist.zip. Inside this zip file is xpd-1.1.3.zip. Unzip
this file without closing any previous WinZip windows.
2.0I
NSTALLING THE SOFTWARE
3. Click Start > Settings > Printers.
4. Double-click Add Printer.
5. Ensure My Computer is selected and click Next.
6. For the port, select File. Click Next.
7. The list of manufacturers of printers appears. Click Have Disk.
8. The Install from Disk dialog box appears. Browse to C:/XPD.
9. When in the XPD folder click webxpd.inf. Click Open.
10. The Install From Disk dialog box appears. Click OK.
NSTALLATION AND CONFIGURATION GUIDE
I
4-3
NSTALLING THE SOFTWARE
I
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
11. Select Documents Xpress PS Color Plugin. Click Next.
Note: Only the color driver needs to be selected for the server since it
will handle both color and black and white jobs.
12. Type XDX PDFwriter in the Printer name text box. Click Next.
Note: This is case and space sensitive. There is a space between the
letter X and the letter P.
13. Click Not shared. Click Next.
14. Click No to bypass printing a test page. Click Finish.
Windows 2000 Server
1. Create a folder named XPD on the C: drive of the server.
2. Unzip Xpdy2k.zip into the newly created XPD folder. This file is in a
Java archive (jar) file on the installation CD at
<CD ROM drive>/ installer.jar. Use WinZip to open installer.jar.
When the file listing appears in WinZip, locate and double-click
webAppServer_dist.zip. Inside this zip file is Xpdy2k.zip. Unzip this
file without closing any previous WinZip windows.
2.0
3. Click Start > Settings > Printers.
4. Double-click Add Printer.
5. The Add Printer Wizard appears. Click Next.
6. The Local or Network Printer window appears. Click Local Printer.
Clear Automatically detect and install my Plug and Play Printer.
Click Next.
7. For the port select File. Click Next.
8. The list of manufacturers of printers appears. Click Have Disk.
4-4I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0I
NSTALLING THE SOFTWARE
9. The Install from Disk dialog box appears. Click Browse and browse
to C:/XPD.
10. When in the XPD folder click webxpd.inf. Click Open.
11. The Install From Disk dialog box reappears. Click OK.
12. Select Documents Xpress PS Color Plugin. Click Next.
Note: Only the color driver needs to be selected since it will handle both
color and black and white jobs.
13. Type XDX PDFwriter in the Printer name text box. Click Next.
Note: The print name is case and space sensitive. There is a space
between the letter X and the letter P.
14. Click Do not share this printer. Click Next.
15. To ensure that a test page is not printed click No Click Next.
16. The Completing the Add Printer Wizard window appears. Click
Finish.
17. A warning that the Digital Signature not found appears. Click Yes.
18. Close all open windows. The XDX printer driver has been installed.
Installing Microsoft Office XP
Microsoft Office XP must be installed in order for print drivers to process
Office documents.
Perform the following to install Microsoft Office:
1. Insert the Microsoft Office CD in the CD-ROM drive.
NSTALLATION AND CONFIGURATION GUIDE
I
4-5
NSTALLING THE SOFTWARE
I
Post Installation Tasks
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
Note: If the Microsoft Office installation does not begin after inserting the
CD, follow the instructions distributed with Microsoft Office on
manually starting an installation.
2. Start the installation process and choose Typical installation.
3. Accept all defaults ensuring that Word, Excel, and PowerPoint are
installed.
4. Remove the CD from the CD-ROM drive.
5. Restart Windows when prompted.
In order for the Documents Xpress system to operate, Adobe Acrobat
Reader, and Microsoft Office must be started to accept license
agreements. Failure to do so will keep the system from operating.
Start both Adobe Acrobat and Microsoft Office. Accept their licensing
agreements and then close Acrobat and Office before installing
Documents Xpress.
Documents Xpress License Generation
The Documents Xpress installation program requires a license diskette.
Generate a license using the XDX License Generation Tool 1.0 before
installing Documents Xpress.
The computer where the XDX License Generation Tool 1.0 is run must
have Java 2 Runtime Standard Edition v1.3.1 installed in order to use the
tool.
4-6I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0I
NSTALLING THE SOFTWARE
CAUTION: Do not install Java 2 Runtime on the Documents Xpress
server. Documents Xpress will not run properly if Java 2
Runtime is installed on the server. Instead, install Java 2
Runtime on a laptop or client workstation to use the license
tool.
Note: This procedure requires a blank floppy disk.
Perform the following to generate a license:
1. Double-click license_gen.jar.
2. The XDX License Generation Tool 1.00 window appears. Type the
following information into the appropriate fields:
• Company Name – Type the full company name
• Expiration Date – Type the date that is one year from the installation
date
• Serial Number – Type the nine digit serial number
• Web App Server IP – Type the IP address of the Documents Xpress
server
•Database Server IP – Type the IP address of the Documents Xpress
server
•License File Location – Type the name of the license file in the
following format:
<floppy drive letter>:\<license file name>.lic
When all the fields are complete, ensure there is a floppy disk in drive A
and click Generate License File.
NSTALLATION AND CONFIGURATION GUIDE
I
4-7
NSTALLING THE SOFTWARE
I
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
3. The License Generator window appears. Click OK. Remove and
label the floppy disk for use in the installation process.
2.0
Note: If the program indicates an error with the expiration date, exit the
program and start the licensing process again. The expiration date
cannot be edited once set.
4-8I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EB DOCUMENT SUBMISSION SOFTWARE VERSION
— W
Installing Documents Xpress
This section gives procedures on installing the core Documents Xpress
software. Once operational, the chapters that follow give procedures on
testing the installed configuration of the software at a customer site.
CAUTION: Ensure that the Display Properties for the server monitor is
set to a minimum of 256 colors. The installation program will
not appear on the screen if a lower number of colors is
selected.
The Documents Xpress server contains the application server software,
the database server, the web server software and the repository. Figure
4-3 illustrates the workflow for installing the core product.
Perform the following to install Documents Xpress software on the
server:
1. Insert the Documents Xpress installation CD into the CD-ROM drive
of the server.
2. Double-click My Computer.
3. Double-click the CD-ROM drive where the Documents Xpress
software appears.
4. Double-click runInstaller.bat.
5. A command window appears followed the WebXpress Installation
window. Click Full Installation.
2.0
Note: The WebXpress Installation window may appear behind the
Command window when installing on a Windows 2000 server.
Minimize the Command window to see the Installation window.
4-10I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0I
NSTALLING THE SOFTWARE
6. The License File window appears. Insert the license floppy disk in
drive A. Click Browse.
7. Ensure that the license file is in the File Name window. Click Select
License File.
NSTALLATION AND CONFIGURATION GUIDE
I
4-11
NSTALLING THE SOFTWARE
I
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
8. The License File window reappears. Click Next.
9. The Installation Location window appears. The default installation
directory is C:/xdx. Ensure the Server address is the IP address of
the server where Documents Xpress is being installed. Click Install.
2.0
4-12I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
10. After several minutes, the Installation Complete window appears.
Click Done.
Exit the Installation Program
2.0I
NSTALLING THE SOFTWARE
Perform the following to exit the installation program:
1. The WebXpress Installation window reappears. To exit the
installation program, click X.
2. Remove the installation CD.
3. Restart the server.
If there were problems and the installation did not complete properly,
consult Chapter 6 – Troubleshooting.
NSTALLATION AND CONFIGURATION GUIDE
I
4-13
NSTALLING THE SOFTWARE
I
Configuring the Documents Xpress Core Installation
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
The addresses for the e-mail server and administrator must be configured
for the Documents Xpress system to operate properly.
CAUTION: Without these addresses configured, the Documents Xpress
system will not validate any new users.
Perform the following to set e-mail server and administrator
addresses for the system:
1. On the server, double-click My Computer. Go to C:\xdx\scripts and
double-click ControlCenter.
Note: To simplify startup of Documents Xpress, create a shortcut to
Control Center on the desktop.
2. Once the Control Center has started, the database must be started.
Click 1 : Database Server. The MySQL tab appears.
3. On the XDX Control Center click Tools > Configuration Manager.
4. The configuration_control_panel window opens. Click the + next to
the xdxConf folder.
5. Click the + next to properties.
6. Click the + next to the Email folder.
Note: This next set of configuration items deals with e-mail properties.
Consult the Documents Xpress Installation Planning Guide for the
required information for this section.
7. Click Email Subject. Type the subject line of the e-mail messages
sent to warn users that their documents will be deleted in place of the
default property value.
8. Click Admin Email Address. Type the Documents Xpress
administrator e-mail address in place of the default property value.
4-14I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0I
NSTALLING THE SOFTWARE
9. Click Email Footer. Type the text to be appended to the end of every
outgoing e-mail message in place of the default property value.
10. Click Printshop Name. Type the name of the print shop, used in
e-mails to users in place of the default property value.
11. Click Email Server. Type the IP address of the designated e-mail
server in place of the default property value.
12. Click File > Save to save all changes.
13. If required, enter the Username Admin and the Password 22222.
Click OK.
14. Click X to close the configuration_control_panel window.
15. Click File > Reload XML. When asked Are you sure you want to
stop all processes… click Yes.
16. All processes stop. The core system is now installed.
Configure Apache Administrator E-mail Address
The Apache web server software can e-mail the system administrator if
there are internal problems with the web server. Follow these instructions
to set the e-mail address:
Perform the following to configure the Apache Administrator e-mail
address:
1. On the server double-click My Computer.
Go to C:\xdx\etc\Apache\conf.
2. Open httpd.conf in a text editor.
NSTALLATION AND CONFIGURATION GUIDE
I
4-15
NSTALLING THE SOFTWARE
I
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
3. Search for the line ServerAdmin @admin_email@ and replace
@admin_email@ with the System Administrator e-mail address.
4. Save the file, overwriting the existing httpd.conf.
5. Close all open windows.
2.0
4-16I
NSTALLATION AND CONFIGURATION GUIDE
5. Starting Up and Shutting Down
The XDX Control Center application is used to start and stop the various
Documents Xpress components. When starting Documents
Xpress it is necessary to go the Documents Xpress server and run the
XDX Control Center.
A tab appears in the Control Center for each component as it is
accessed. Tab names are red if the component is loading, black if the
component is waiting to be loaded, and blue if the component has loaded
properly. An example of the Control Center appears in Figure 5-1.
CAUTION: After using the Control Center to start Documents Xpress
services, minimize the Control Center but DO NOT close it.
Closing the Control Center shuts down Documents
Xpress.
NSTALLATION AND CONFIGURATION GUIDE
I
5-1
TARTING UP AND SHUTTING DOWN
S
OCUMENTS XPRESS
D
Figure 5-1. XDX Control Center as it appears on the Documents Xpress
server with all components loaded and operational
Starting Documents Xpress
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
Starting Documents Xpress requires using the XDX Control Center
application on the Documents Xpress server.
Starting Documents Xpress For the First Time
Perform the following to start Documents Xpress for the first time:
1. On the server, double-click My Computer. Go to C:\xdx\scripts and
double-click ControlCenter.
2. Once the Control Center has started, click
1 : Database Server > 2 : Web Application Server > 3 : Services.
3. Double-click My Computer. Go to C:\xdx\scripts and double-click
Admin-LoadPricing.
5-2I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0S
TARTING UP AND SHUTTING DOWN
CAUTION: Only load the Pricing Tables this one time. It initializes the
MySQL tables for use by Document Xpress Print Shop
Administrators. Loading the Pricing Tables again will erase
any changes made since the tables were initialized the first
time.
Note: After starting the processes, wait approximately one minute before
starting access from any client machines.
The following figure, Figure 5-2, describes the components started with
the Control Center.
NSTALLATION AND CONFIGURATION GUIDE
I
5-3
TARTING UP AND SHUTTING DOWN
S
Figure 5-2. Description of components started with the Control
Center
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
ComponentDescription
2.0
RMID (Remote Method
Invocation Daemon)
MySQL (Database Server)The database management system that tracks
Tomcat (used by Web
Server)
Apache (Web Server)The web server for the Documents Xpress system
Testing Documents Xpress
Once Documents Xpress has been installed, test the software to ensure
that it is operating correctly. The following steps are only a basic test to
see if the software is functioning. To test system operations completely,
consult the Install Verification Procedure chapter in Appendix A.
Testing Documents Xpress
Perform the following to test the Documents Xpress user log on:
A utility that XDX services use for activation
users and jobs in the system
Tomcat is a servlet container with a Java Server
Pages (JSP) environment. A servlet container is a
runtime shell that manages and invokes servlets
on behalf of users.
1. Open a browser window on a workstation connected to the network or
one of Documents Xpress servers.
2. In the address line, type the IP address that will point to the
Documents Xpress Web Application Server. In most cases, it is the IP
address of the Documents Xpress server, which hosts the web server
software.
5-4I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0S
TARTING UP AND SHUTTING DOWN
http:// <Documents Xpress server IP address>/xdx
3. The initial log on screen appears after several moments. Log on with
the User Name admin and the password 22222. Attempt to submit a
job.
Perform the following to test the Documents Xpress administrator
log on:
1. Open a browser window on a workstation connected to the network or
one of Documents Xpress servers.
2. In the address line, type the IP address that will point to the
Documents Xpress Web Application Server. In most cases, it is the IP
address of the Documents Xpress server, which hosts the web server
software.
http:// <Documents Xpress server IP address>/xdx/admin
3. The initial log on screen appears after several moments. Log on with
the User Name admin and the password 22222. Attempt to view the
job submitted
NSTALLATION AND CONFIGURATION GUIDE
I
5-5
TARTING UP AND SHUTTING DOWN
S
OCUMENTS XPRESS
D
Shutting Down Documents Xpress
To shut down the system, first close the Documents Xpress components
from the Control Center and then close the Control Center.
Shutting Down Documents Xpress
Perform the following to shut down Documents Xpress using the
Control Center:
1. On Server 1, click in the following order:
1 : Database Server > 2 : Web Application Server> 3 : Services.
2. Close the Control Center by clicking X.
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
5-6I
NSTALLATION AND CONFIGURATION GUIDE
6. Troubleshooting
This section describes two methods for helping to diagnose problems that
may occur. For further assistance with troubleshooting problems, consult
Chapter 7 – Contacts and Escalation Process.
Installation Problems
The simplest way to ensure there are no installation problems is to have a
clean server. If there are old versions of Documents Xpress, they must be
removed. Any existing versions of MySQL and any Java must also
removed.
If an installation is not working, often it is easier to delete the C:\xdx
folder and begin the installation again. Shut down Documents Xpress and
reboot the server. After the server has restarted, remove the C:\xdx
folder. Complete instructions are given in the Documents Xpress Web
Document Submission Software Version 2.0 System Administration
Guide.
Debugging Apache and Tomcat
The Apache server logs (access.log and error.log) are located in
C:\xdx\etc\Apache\logs and the Tomcat servlet engine logs (jasper.log,
servlet.log, and tomcat.log) are located in C:\xdx\etc\Apache\tomcat\logs.
These logs provide valuable troubleshooting information if the software is
not operating properly.
NSTALLATION AND CONFIGURATION GUIDE
I
6-1
ROUBLESHOOTING
T
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
In addition, at c:\xdx are two additional log files – RMID.log and
Tomcat.log.
Note: Each time Apache is started, the previous error log is reopened
and new information is appended to the end of the file. If there is an
error in the system, the logs will contain debugging information.
Debugging Documents Xpress Services
Debugging output is saved to file and displayed by each Documents
Xpress service. If there is an error with the system, examine the XDX
Control Panel window of the appropriate service to determine where the
error has occurred. Generally, if there is a problem, a Java exception will
be displayed in the window. This message can be used to determine
exactly what errors have occurred in the system.
The log file messages that appear for Tomcat can modified by starting the
Configuration Control Panel from the XDX Control Center. These steps
assume the XDX Control Center is operational and the Documents
System is running.
2.0
Perform the following to modify the logging messages for Tomcat:
1. On the XDX Control Center click Tools > Configuration Manager.
2. The configuration_control_panel window opens. Click the + next to
the xdxConf folder.
3. Click the + next to properties.
4. Click the + next to the Logging folder.
5. Change the Property Value from info to debug. This will increase the
level of information returned from the system.
6-2I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0T
6. Click File > Save to save all changes.
7. If required, enter the Username Admin and the Password 22222.
Click OK.
8. Click X to close the configuration_control_panel window.
The log for any tab in the Control Panel window can be cleared by
right-clicking the tab and selecting Clear output.
ROUBLESHOOTING
NSTALLATION AND CONFIGURATION GUIDE
I
6-3
7. Contacts and Escalation Process
This chapter describes the support process and support contacts
available for Documents Xpress.
Documents Xpress Support Process
At the time of installation, a Customer Solution Administrator (CSA) will
be identified. The CSA is available to manage all software-related issues.
The CSA, who has the skills of a system administrator, handles the dayto-day service and support operations at the customer site. The CSA is
the main interface to the Documents Xpress Support Center.
Note: If a problem relates to a Xerox output device and not the software
please contact the appropriate Xerox Support Center for that
product. If a problem relates to the computer server hardware,
contact the manufacturer of the server.
Here is the process for initiating support:
1. When the end user or operator encounters an error with the software,
they should contact the CSA.
2. The CSA performs system level isolation and problem resolution for
Documents Xpress.
3. If the CSA is not able to resolve the problem, the problem is escalated
to Documents Xpress Support Center for support.
Note: Only the CSA can call the hotline for support.
NSTALLATION AND CONFIGURATION GUIDE
I
7-1
ONTACTS AND ESCALATION PROCESS
C
Support Contacts
Documents Xpress has an e-Support website available at
http://www.xerox.com/webdocumentsubmission/support. The e-Support
website provides a searchable knowledgebase, Frequently Asked
Questions (FAQ’s), and the ability to submit a support request via e-mail.
Contact the designated CSA for support. The CSA will contact the
Documents Xpress Support Center if they require additional assistance.
The Support Center can be reached at
1-888-508-5244, 8:00 a.m. to 5:00 p.m., Monday through Friday, local
time.
OCUMENTS XPRESS
D
EB DOCUMENT SUBMISSION SOFTWARE VERSION
— W
2.0
7-2I
NSTALLATION AND CONFIGURATION GUIDE
A. Install Verification Procedure
Use this chapter to verify a successful installation of Documents Xpress.
Record all test results pertinent to a specific install in the worksheets
provided in this chapter.
Functional Areas Being Verified
This section provides an overview of the functional areas verified after
software installation.
Administrative Functions
Administrative functions that will be tested are listed in Table A-1.
Table A-1. Administrative functions and procedures
FunctionTest Procedure
Log on as Administrator1.1
Add Printer (Default and others in print shop)1.2
Edit User Interface Using Admin Tools1.3
NSTALLATION AND CONFIGURATION GUIDE
I
A-1
NSTALL VERIFICATION PROCEDURE
I
Client Functions
Client functions that will be tested are listed in Table A-2.
Table A-2. Client functions and procedures
FunctionTest Procedure
Register Your Account2.1
Log on as End User2.2
Edit User Profile2.3
Submit Print Job Request – MS Word Document2.4
Submit a Print Job Request – MS Excel Document2.5
Submit a Print Job Request – Hard copy Document2.6
Edit Personal Address Book2.7
Edit Document Repository2.8
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
A-2I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
FunctionTest Procedure
Log on as Operator3.1
Edit a Client Job Request – MS Word Document3.2
Fulfill a Client Job Request – MS Word Document3.3
Fulfill a Client Job Request – MS Excel Document3.4
Fulfill a Client Job Request – Hard copy Document3.5
Send a Print Job to Each Installed Printer3.6
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
Operator Functions
Operator functions that will be tested are listed in Table A-3.
Table A-3. Operator functions and procedures
2.0I
NSTALL VERIFICATION PROCEDURE
NSTALLATION AND CONFIGURATION GUIDE
I
A-3
NSTALL VERIFICATION PROCEDURE
I
OCUMENTS XPRESS
D
Install Verification Procedures
These install verification procedures test the basic system functionality of
Documents Xpress. Run the Administrator and Operator verification
procedures from any workstation on the system network except where
noted. Test Client verification procedures from a corporate client
workstation.
Record all Pass / Fail results and provide a summary in the InstallVerification Record at the end of this chapter.
1. Administrator Verification Procedures
The Administrator verification procedures test the major functions of a
System Administrator using Documents Xpress.
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
1.1 Logging on as Administrator
Perform the following to log on as Administrator:
1. Open a browser window on a workstation connected to the network,
or one of the Documents Xpress servers.
2. In the address line, type the IP address for the Documents Xpress
server:
http:// <Documents Xpress server IP address>/xdx/admin
3. Type admin in the User Name text box.
4. Type the admin password 22222 in the Password text box and click
Log On.
A-4I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0I
NSTALL VERIFICATION PROCEDURE
Verify that the log on was successful. If unsuccessful, please note the
observed system response.
Use the following section to record results of the installation verification
procedures. Comments concerning failure observations are recorded at
the bottom of each procedure the previous section.
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
Results
Record results using the following tables. Please describe what is
observed if a procedure fails.
A-18I
NSTALLATION AND CONFIGURATION GUIDE
OCUMENTS XPRESS
D
EROX WEB JOB PRINTING SOFTWARE VERSION
— X
2.0I
NSTALL VERIFICATION PROCEDURE
Administrative Functions
Test results for Administrative functions are recorded in Table A-4
Table A-4. Administrative functions and test procedures
FunctionTest
Log on as Administrator2.1.1
Add Printers (Default and others in print shop)2.1.2
Edit User Interface Using Admin Tools2.1.3
Client Functions
Test results for Client functions are recorded in Table A-5.
Table A-5. Client functions and test procedures
FunctionTest
Register Your Account2.2.1
Log on as End User2.2.2
Edit User Profile2.2.3
Submit Print Job Request – MS Word
Document
Procedure
Procedure
2.2.4
Results
P – Pass or F – Fail
Results
P – Pass or F – Fail
Submit a Print Job Request – MS Excel
Document
Submit a Print Job Request – Hardcopy
Document
Submit a File Conversion Job Request – PDF2.2.7
NSTALLATION AND CONFIGURATION GUIDE
I
2.2.5
2.2.6
A-19
NSTALL VERIFICATION PROCEDURE
I
Table A-5. Client functions and test procedures (continued)
OCUMENTS XPRESS
D
EROX WEB DOCUMENT SUBMISSION SOFTWARE VERSION
— X
2.0
FunctionTest
Procedure
Submit a File Conversion Job Request –
2.2.8
PostScript
Edit Personal Address Book2.2.9
Edit Document Repository2.2.10
Operator Functions
Test results for Operator functions are recorded in Table A-6.
Table A-6. Operator functions and test procedures
FunctionTest
Procedure
Log on as Operator2.3.1
Edit a Client Job Request – MS Word
Document
Fulfill a Client Job Request – MS Word
Document
2.3.2
2.3.3
Results
P – Pass or F – Fail
Results
P – Pass or F – Fail
Fulfill a Client Job Request – MS Excel
2.3.4
Document
Fulfill a Client Job Request – Hard copy
2.3.5
Document
Send a Job to Each Installed Printer2.3.6
A-20I
NSTALLATION AND CONFIGURATION GUIDE
Index
A
Acrobat Reader
installation, 4-2
Apache web server
debugging, 6-1
e-mail address setup, 4-15
D
display properties. See installation – display
properties
Documents Xpress
overview, 2-1
related documentation, 1-3
support contacts, 7-2
support process, 7-1