Escolar Documentos
Profissional Documentos
Cultura Documentos
UQCW-4300-00
Columbus OM 4.3
Publication number
Trademark acknowledgements
Documentation set
Introduction
Technical Reference
Making comments
We welcome suggestions from all users regarding our
software products and their accompanying documentation.
Please contact your local Macro 4 representative, email us
at tech.authors@macro4.com, or write to:
Technical Documentation
Macro 4
The Orangery, Turners Hill Road,
Crawley, West Sussex RH10 4SS
United Kingdom
www.macro4.com
License information
Copyright 2004 Macro 4. All rights reserved.
This publication, as well as the software described in it, is
furnished under license and may be used or copied only in
accordance with the terms of such license. The information
in this publication is furnished for informational use only, is
subject to change without notice, and should not be
construed as a commitment by Macro 4. Macro 4 assumes
no responsibility or liability for any errors or inaccuracies
which may appear in this publication.
Except as permitted by such license, no part of this
publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means,
electronic, mechanical, recording or otherwise, without
prior written permission from Macro 4.
Contents
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
15
15
17
19
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Contents
Conventions
Conventions
The following typographic conventions are used:
boldface
Vertical bars separate alternative values from which you must make a selection.
...
directory.
CHAPTER 1
Chapter 1
Introduction to the
Columbus OM WebClient
WebClient features on page 9 explains what you can accomplish using the
interface.
CHAPTER 1
Architecture
Architecture
The WebClient uses a web server to communicate with Columbus OM instances to
find out their status and control their operation. It displays the information in a web
browser.
Columbus OM hosts
PCs
web
browser
print
instance
printers
Gateway
host
web
browser
web
browser
web
server
print
instance
print
instance
the Sun ONE (Open Net Environment) HTTP server (also known as iPlanet),
available from www.sun.com/software.
CHAPTER 1
WebClient features
WebClient features
The WebClient features are similar to those on Columbus OM Explorer; the style
of information presentation will be familiar to users of that interface.
Device control
To display the status of printers, click Printers in the navigation pane.
You can issue commands to control the devices, such as: Enable, Disable, Abort,
Cancel, Pause, Resume, Back up, Advance, Goto page, Split and Transfer. The
commands may be issued to a single device, selected devices, or all devices. You
can also display the properties of a device, and show the jobs which are scheduled
for it.
Job control
To display the status of jobs, click All Entries in the navigation pane.
The display shows the Pending and Completed sections of the queue. You can
issue commands to control the jobs: Remove, Release, Hold and Copy. The
commands may be issued to a single job, selected jobs, or all jobs. You can also
display the contents of a job, and add a new job to the queue.
10
CHAPTER 1
WebClient features
11
CHAPTER 2
Chapter 2
The gateway components need be installed on only one host, irrespective of the
number of Columbus OM instances in your network. No additional software is
needed on the hosts running the Columbus OM instances. The only software
needed on the end-user computers is a web browser: Columbus OM WebClient
works with Internet Explorer and Netscape Communicator at Version 4 or above.
12
CHAPTER 2
Preparing to install
Preparing to install
Before installing the software, there are some preparatory procedures which you
must follow:
The computer on which you install the web server and the HTTP gateway software
may be (but does not have to be) a Columbus OM host. However, it must be able
to communicate with the Columbus OM hosts which you want to monitor.
CHAPTER 2
Installing on Windows
Perform these steps:
1
Click Next.
If the uniqcs network service name is already defined in the services file, a
message box appears showing its allocated port number.
If the uniqcs network service name is not already defined in the services
file, or if you select to change its current value, the Select uniqcs port
number screen appears. Type a port number, and click Next. (For more
information, see Reviewing the services file on page 12).
The installation asks if you want it to configure web server to work with
Columbus OM WebClient. You can configure Apache either:
10 Click Next.
To add details for another instance, click Yes, and then repeat steps 9 to 10.
13
14
CHAPTER 2
instances Pending and Completed queues, by selecting them in the list. When
you have selected all the required columns, click Next.
13 Click Finish to complete the installation process.
14 Finally, complete the appropriate post-installation procedures. See Post-
Installing on UNIX
Perform these steps:
1
Log on as root.
Insert the CD-ROM into your drive. Locate and open the appropriate
Columbus OM product folder.
If you already have a supported HTTP web server installed on your computer,
you can skip this step. Otherwise, download and install one of the servers listed
in the previous chapter.
Copy the uniq directory and its files and sub-directories from the CD-ROM to
become a sub-directory of the:
where install_dir is the path to the directory where you have installed the
HTTP web server. The uniq directory contains HTML files, stylesheets,
graphics and scripts which the server uses to display information about
Columbus OM instances when requested by web browsers.
5
Copy from the CD-ROM the appropriate version for your operating system of:
CHAPTER 2
Post-installation setup
Post-installation setup
After you have installed the HTTP gateway components, there are a number of
additional manual steps to be completed.
See
Add one line for each Columbus OM instance which you want to monitor and
control:
ColumbusInstance host[:service] instance
host
service
instance
To control the language used by the WebClient user interface (the default is
English) add:
for Apache
ColumbusLanguage de|en|fr|it
"install_dir\htdocs\uniq\nls\file"
ColumbusLanguage de|en|fr|it
"install_dir\docs\uniq\nls\file"
where install_dir is the path to the folder where you installed the HTTP
web server, and file is uniqnls.de, uniqnls.en and so on.
4
Optionally, add any number of lines defining the attributes of queue entries
which are to be included when displaying an instances pending and completed
queues. If desired, you can specify the attributes display width:
15
16
CHAPTER 2
Post-installation setup
The display includes all of the specified attributes, in the order in which
they are defined in this file. Possible values (and default widths) are as follows;
attribute names which include spaces should be enclosed in quotes "...":
Banner
1
Browse Path
30
Chain After
7
Child
6
Command
10
Copy
1
Current Server Remark
20
Date Created
20
Document Coding
10
Document Date
20
Document Name
15
Document Path Name
30
Document Type
1
Entry
7
File Alias
30
File Name
15
File Path
30
File Path Error
30
File Temp
30
Finishing
7
First Attempt
20
Font
10
Format
10
From Page
5
Hopper
7
Host Name
10
Latest Attempt
20
Lines
7
Master
7
Medium Name
10
Next Attempt
20
Orientation
9
Original UID
7
Output Hopper
7
Owner
10
Page Len
3
Pages
5
Paper
7
Path Alias
30
Path Temp
30
Pitch
8
Presentation
10
Previous Server Remark
20
Previous Status
4
Printer
10
Printer Type
10
Priority
1
Program
10
CHAPTER 2
Remark
20
Remark Type
1
Retention (Days)
Server
10
Server Info
20
Server Type
1
Size
7
Source Host
10
Status
10
Success
10
To Page
5
Tries
3
Post-installation setup
Sample entries
A typical set of columbusconf.txt entries to support connection to four
Columbus OM print instances is:
ColumbusInstance
ColumbusInstance
ColumbusInstance
ColumbusInstance
samson print1
samson print2
delilah print
testbox:2700 print
Configuring Apache
Follow this procedure only if you decided to configure Apache manually on
Windows, or if you are installing on a UNIX host. install_dir is the path to the
directory where you installed the server.
columbus.conf
Specify the location of columbus.conf in an operating system environment
variable:
columbus_init=install_dir\conf\columbus.conf
export columbus_init
Include these commands in the Apache control script bin/apachectl. Make sure
that the columbus_init environment variable is in lowercase.
httpd.conf
Edit the install_dir\conf\httpd.conf file as follows:
17
18
CHAPTER 2
Post-installation setup
Add a line defining the handler for files with an extension of .uqp:
AddHandler uniq-handler uqp
Add a section defining the handler for virtual document views (note that here
\uniq refers to the sub-folder of Apaches htdocs folder where you copied the
Columbus OM WebClient files):
<Location \uniq\doc>
SetHandler uniq-handler
</Location>
Note
Default home
page
Changes that you make to httpd.conf take effect the next time that the web
server is restarted.
To display the Columbus OM status information, use hypertext links of the form:
http://your.gateway.host/uniq/index.html
If this web server will be used only for serving Columbus OM status information,
you can make this the default page. To do this, edit the configuration file
(httpd.conf):
1
Change the section defining the handler for virtual document views to remove
\uniq:
<Location \doc>
SetHandler uniq-handler
</Location>
You can then display the Columbus OM status information using hypertext links of
this form:
http://your.gateway.host/
CHAPTER 2
Post-installation setup
which you should define and initialize appropriately (for example, in the Sun ONE
start script).
magnus.conf
Edit the file install_dir\https-your.gateway.host\config\magnus.conf as follows:
Note
1
Changes that you make to magnus.conf take effect the next time that the
web server is restarted.
or on Windows:
Init fn="load-modules" funcs="uniq_init,uniq_handler"
shlib="install_dir\bin\https\lib\NSAPIModuleUniq.dll"
Init fn="uniq_init"
obj.conf
Add a section defining the handler for uniq virtual document views to the end
of the file:
<Object name=uniq>
Service fn=uniq_handler
</Object>
19
20
CHAPTER 2
Post-installation setup
If this web server will be used only for serving Columbus OM status information,
you can make this the default page. To do this, edit the configuration file obj.conf:
1
You can then display the Columbus OM status information using hypertext links of
the simpler form:
http://your.gateway.host/
CHAPTER 2
21
22
CHAPTER 2
23
Index
services file
WebClient use of 12
Sun ONE web server
configuring for WebClient 19
using with WebClient 8
Columbus OM WebClient
architecture 8
features 9
installing 11
introduction 7
columbus.conf file (WebClient
configuration) 15, 17, 19
uniqcs service
WebClient use of 12
H
HTTP server 8, 12
httpd.conf file (web server configuration)
15
I
installation
Columbus OM WebClient 11
iPlanet web server See Sun ONE web
server
M
magnus.conf file (web server
configuration) 19
O
obj.conf file 19
W
WebClient See Columbus OM WebClient
24
Index
I N T E L L I G E N T S Y S T E M S M A N A G E M E N T
www.macro4.com