
                     UNIX Host Software              
                        Installation
                        ============


This readme file describes how to install the UNIX Host
Software from the Software Utilities CD-ROM.

You can also download UNIX Host Software via the World 
Wide Web at http:/www.minolta-qms.com.


Installation
------------

1 Insert the CD-ROM in your CD-ROM drive.

   >> Note: Some drives require that the disk be placed in
      a caddy before being inserted in the drive. Check your
      CD-ROM drive documentation for information.  Also, it
      takes a few seconds for the automounter to detect the
      CD.

 2 Logon the UNIX system as root.

 3 Type the following command to go to the root directory:

      cd / 

 4 If you are using a Solaris system, skip to step 6.

   If you are using a SunOS system and already have a 
   directory on the system named cdrom, skip to step 5.

   If you are using a SunOS system and don't have a 
   directory on the system named cdrom, type the following 
   command to make one:

      mkdir /cdrom

 5 On SunOS systems mount the CD-ROM file system:

      mount -r -t hsfs device_filename /cdrom

   For device_filename substitute the complete pathname of
   the device associated with the CD-ROM drive. 

 6 Verify that the CD-ROM file system has been mounted by
   listing the contents of the directory:

      Solaris systems      Type   ls /cdrom/qms
      SunOS systems        Type   ls /cdrom

   The directory contains several subdirectories, including
   unix.
 
 7 Change to the directory in which you want the UNIX Host 
   Software to be installed.

 8 Extract the files from the CD-ROM: 

      tar xvf /cdrom/platform/unix/host_sw/hs_tar 

   The utilities are installed in a directory named QMSoft 
   in the current directory.

 9 Unmount the CD-ROM file system: 

      umount device_filename

   For device_filename, substitute the complete pathname of 
   the device file associated with the CD-ROM drive.

10 Change to the newly created QMSoft directory: 

      cd QMSoft

11 Run the Qinstall installation utility:

      ./Qinstall

12 Follow the instructions on the screen. When the 
   installation is complete, the following message displays:

      QMS UNIX Host Software installation complete 

13 Copy the addprt and qpr utilities and their associated 
   manual pages to standard directories. For example, 

      cp addprt /usr/bin
      cp qpr /usr/bin
      cp man/addprt.1 /usr/man/man1
      cp man/qpr.1 /usr/man/man1

14 If you're using SNMP to manage your network using SunNet 
   Manager, copy the appropriate files to the SunNet Manager
   agents directory. 

   See your SunNet Manager documentation for more 
   information. 

  

  Using addprt to Install MINOLTA-QMS Printers on UNIX Systems
 =================================================            



Introduction
------------

      This remainder of this file tells you how to install a printer into 
	a BSD, SGI, SYSV, HP-UX, and IBM-based AIX spooling 
	system with the addprt printer installation program. 
	This is generally done right after 
	installing the host software but may also be done when 
	additional printers are added at a later date.

	>> Note: You must be logged in as root to run addprt.



Printer Internet Address
----------------------------------
	
      Refer to Configuring a TCP/IP Interface Configuration in 
	the CrownNet Setup Guide for information on setting the 
	printer internet address.


The addprt Man Page
------------------------------

	The addprt man page explains the addprt command and its 
	parameters. Since you can easily call up the man page for 
	reference, it is not reproduced in this manual.

	To display the man page, type

		man addprt <Enter> 
	


Conventions
-----------------
 
	The following conventions are followed by addprt:

	1. When a choice is presented to you:

		a. The list of possible values is displayed in 
		   parentheses ( ).

		b. The default value is displayed in brackets [ ].

	2. You may type in one of the following:

		a. <Enter> Press Enter to select the default value. 
               This action is represented in this file by <Enter>.

		b. One of the values listed in parentheses. The 
		   default value can also be specifically typed in.

		c. ? to list context-sensitive help.

	   For additional help with logical queues, refer to 
	   the CrownBook.



Context-Sensitive Help
--------------------------------

	The installation programs have context-sensitive help for 
	each user prompt. To display the help message for any prompt,
	type ? and press Enter. The help message that appears 
	explains the prompt and lists options. The help message is 
	followed by another prompt for your entry. The following 
	example illustrates the prompt for printer name, the ? 
	request for help, the help message, and the prompt again:

		Configuring printer
		Printer name []:
		?<Enter> 

		Enter the name by which the printer will be referenced 
		by the spooler.

		The printer name is arbitrary, but it must be unique. 
		There can't be any other printers with the same name.

		Printer name []:


Getting Started
----------------------

	Before running addprt, do one of the following:

	1. For a TCP/IP printer, the /etc/hosts file must first be 
	   updated with the printer internet name and address.

	2. For a parallel printer, you must know the physical device
	   name.

	3. For a serial printer, you must know the physical device 
	   name and the baud rate. You must also configure the 
	   serial port and set the baud rate prior to running  
	   addprt.

	Read through all of the installation steps and answer all 
	of the questions before beginning the installation.



Installing a Printer 
--------------------------
   
	To run addprt, type 
 
            addprt<Enter>  

	When the program loads, the following banner displays:

	    QMS Host Software Version x.xx
          QMS Printer Configuration Utility 

	1. Enter the printer's name. For example,

              Configuring printer
	        Printer name []:
                foo<Enter> 

	 2. On BSD and SGI systems, you may also enter an alternate (optional) 	name. For example,

		Printer alternate name []:
		lp<Enter>

	3. Enter the communications protocol used with the printer.

		Printer Communications Protocol
		(tcp/ip | parallel | serial)[tcp/ip]:

	At this point the installation differs for each of the three 
	communications protocols. Refer to the following "TCP/IP," 
	"Parallel," and "Serial" sections, as appropriate.


	

TCP/IP Communications Protocol
-------------------------------------------------
 
	1. If you are using TCP/IP, type tcp/ip for the printer 
	   communications protocol.

		Printer Communications Protocol 
		(tcp/ip|parallel|serial)[tcp/ip]:
		tcp/ip <Enter> 

	2. Enter the printer's hostname as it was entered in 
	   /etc/hosts. The default value is the name you previously
	   entered for the printer name. For example,

	  	Printer Hostname (in /etc/hosts)[foo]:
		foo <Enter>
 
	3. You are now asked for the port number to be used with 
	   STATUS1/TRANSPORT1 communications:
		
		Enter the port number to be used when sending jobs to
		the printer. This value must match the value set for 
		Port Assignment through the printer's keypad. [35]:

	4. You are asked whether you want to enable the capturing of
	   backchannel messages sent from the port.

		Would you like to receive backchannel information 
		(yes/no)? [no]:

      5. If you indicated you want to collect backchannel messages,
	   you are now asked for the job file. This file contains 
	   backchannel information for the last job printed.

		Enter a value for the backchannel job file (do not 
		specify a path), or press  <Enter> for no backchannel 
		job file. The file you specify will be placed in 
		/usr/spool. [none]:

	6. You are now prompted for the backchannel log file. This 
	   file contains backchannel information for all jobs since
	   the log file was created.

		Enter a name for the backchannel log file (do not 
		specify a path), or press  <Enter> for no backchannel 
		log file. The file you specify will be placed in 
		/usr/spool. [none]:

	7. You are now asked if you want to enable accounting.

	   >> Note: TCP/IP accounting/reverse channel is available 
	      only on some printers. The daughterboard determines if 
	      the motherboard supports this feature. (See the CrownBook
	      for more information.)

		Would you like to enable accounting (yes/no)? [no]

	   Enabling accounting allows the system administrator to 
	   keep up with information like page count, owner, and 
	   title of jobs that are printed over the TCP/IP interface.
	   If you answer no to this question, then only printer 
	   error messages will be returned. Consult your printer 
	   user's guide to determine whether your printer supports 
	   TCP/IP accounting.

	If you answer yes, the following prompt appears:

		Would you like to use the alternative status message 
		format (yes/no)? [no]
		? <Enter> 

		The alternative format provides a more generic form 
		of status message. Users who plan to use a separate 
		utility to automatically scan the accounting log file 
		and assemble the information may find it easier to 
		work with than the standard message format.

		Compare the following example of the standard message 
		format:

		%%[status:interpreting; pagecount:1; interface:
		Ethernet:q33; user:Username; title:file.ps; 
		time:Mon Feb 15 09:13:50 1996]%%

		with the alternative format:

		0215091350%%[status:busy; source:Ethernet:q33; 
		pagecount:1; user:Username; title:file.ps]%%

		The time information will be in a more standardized, 
		compact form, and printer status messages will have a 
		more standardized format. In addition, common error 
		messages, such as paper jam, paper out, no paper tray,
		etc., will be presented as a more standard phrase, in 
		all lower case, and with a time stamp.

		For example, the standard format of
		%%[PrinterError:ADJUST INPUTBIN]%%

		would be given as

		0402095454%%[PrinterError:no paper tray]%%

	   >> Note: The option to display status messages with your
	      system clock's time (i.e. in "real time") will 
	      automatically be enabled if you choose the alternative 
	      format.


	8. You are now asked to name the job status file. If you 
	   enter a filename, all the status messages for a single 
	   job will be saved. Press <Enter> for no job log file. 
	   For example,

		Enter a name for the job status file (do not specify 
		a path), or press Enter for no job status file. The 
		file you specify will be placed in one of the following directories.
		
		On AIX, SYSV, and HP-UX systems: 
		QDIR [NONE]:
		jobstat <Enter> 
		
		On BSD AND SGI systems: 
		/usr/spool [NONE]:
   	   	jobstat<Enter>

	9. You are asked to name the log status file. For example,

		Enter a name for the log status file (do not specify a 
		path), or press enter for no log status file. The file
		you specify will be placed under one of the following directories. 

		On AIX, SYSV, and HP-UX systems: 
		QDIR [NONE]:
		jobstat <Enter> 
		
		On BSD AND SGI systems: 
		/usr/spool [NONE]:
   	   	jobstat<Enter>
 

	10.You are now asked to specify the frequency (in seconds) 
	   of status requests made to the printer. For example,

		Enter the number of seconds between each status 
		request. This value MUST be less than the value set 
		for Connect Timeout through the printer's keypad. [5]:
		? <Enter> 

		By changing this number you can increase or decrease 
		the frequency of status requests made to the printer.

		Enter the number of seconds between each status 
		request. This value MUST be less than the value set 
		for 

		Connect Timeout through the printer's keypad [5]:
		<Enter>

		
   	11.You are now asked if you want to use verbose mode. For 
	   example,
		
		Would you like to set verbose mode (yes/no)? [no]
		? <Enter>
 
		If verbose mode is not used, only the final status 
		entry for each job is placed in the job and log 
		files. If verbose mode is used, each different 
		status messagewill be stored in the job and log 
		files. It should be noted that the log file can grow
		huge if verbose mode is used and many or large files
               	are printed.

		Would you like to set verbose mode (yes/no)? [no]
		y <Enter>
 
	12.Enter the path of the printcap file. For example,

		Path of printcap[/etc/printcap]:
		<Enter> 

	13.Enter the spooler path. For example,

		Spooler path [/usr/spool]: 
		<Enter>

	14.You are asked to verify that the information you have 
	   entered is correct. Type y if it is correct or n if it is
	   not correct. If you type n, you are returned to the 
	   beginning of the installation procedure with your 
	   previous answers used as the default values. For example,

   	   	You have entered the following configuration 
		information:

   	   	Printer Name:                     foo
   	   	Printer Alternate Name:           lp (On BSD and SGI systems)
   	   	Printer physical device name:	/dev/pio1 (On AIX systems)
		Printer hostname:                 /foo
   	   	Log file name:                    logstat
   	   	Job file name:                    jobstat
   	   	Interval between requests:        5
   	   	Alternative status mode:          yes
   	   	Display Real Time:                yes
   	   	Verbose mode:                     yes
   	   	Printcap path:                    /etc/printcap
   	   	Spooler path:                     /usr/spool

   	   	Is this information correct (y|n)? [y]
   	   	y <Enter>

	15.You are now asked if you want to send your print jobs 
	   through a filter before they go to the printer. An 
	   example of a filter is prtpost, which is included in the 
	   host software. For example,

		Would you like to filter your output (yes/no)? [no]

		For example, prtpost -L -2 produces two-column, 
		landscape listings of all files sent to the queue.
		y <Enter>
 
	    If you answer yes, the following prompt appears:

		Please key in the exact command line syntax to invoke 
		the filter (including all necessary flags and the 
		absolute path).  
    	   	<Enter>


	16.If your printer supports Document Option Commands, 
	   you are now asked a series of questions in order to 
	   create a set-up file containing Document Option Commands.
	   
	   This file will be sent before every print job sent to the
	   queue being configured. Thus, you can create logical 
	   queues for the same printer that will automatically format
	   the output according to the DOC file for the specified 
	   queue. See the "Document Option Command Prompts" section in this file
	   for additional details.

	

Parallel Communications Protocol
-------------------------------------------------

	1. If you are using parallel, enter parallel for the printer
	   communications protocol. For example,

		Printer Communications Protocol 
		(tcp/ip|parallel|serial)[tcp/ip]:

		parallel <Enter> 

	2. Enter the physical device to which the printer is 
	   connected. For example,

		Printer Physical Device Name []:
		lp0 <Enter>  (on AIX systems)
		/dev/pio <Enter> (on BSD, SGI, SYSV, or HP-UX systems)

	3. You are now asked if your printer supports DOC. Check 
	   your user's guide to determine if the printer supports 
	   Document Option Commands.

		Does your printer support DOC (yes/no)? [no]:

	4. Verify that the information is correct by typing y if it 
	   is correct, or n if it is not correct. If you enter n, 
	   you are returned to the beginning of the installation 
	   procedure with your previous answers used as the default 
	   values. For example,

		You have entered the following configuration 
		information:

		Printer Name:			foo
		Printer Physical Device Name:	lp0 (on AIX systems)
	Printer Physical Device Name:	/dev/pio (on BSD, SGI, SYSV, or HP-UX systems) 

		Is this information correct (y|n)? [y]:
		y <Enter> 

		Printer foo configured

	5. You are now asked if you want to send your print jobs 
	   through a filter before they go to the printer. An 
	   example of a filter is prtpost which is included in the 
	   host software.

		Would you like to filter your output (yes/no)? [no]

		For example, prtpost -L -2 produces two-column, 
		landscape listings of all files sent to the queue.

	    If you answer yes, the following prompt appears:

		Please key in the exact command line syntax to invoke 
		the filter (including all necessary flags and the 
		absolute path).

	6. If your printer supports Document Option Commands, 
	   you are now asked a series of questions in order to 
	   create a set-up file containing Document Option Commands.
	   
	   This file will be sent before every print job sent to the
	   queue being configured. Thus, you can create logical 
	   queues for the same printer that will automatically format
	   the output according to the DOC file for the specified 
	   queue. See the "Document Option Command Prompts" section in this file
	   for additional details.





Serial Communications Protocol
-----------------------------------------------

	1. If you are using Serial RS-232, enter serial for the 
	   print communications protocol.

		Printer Communications Protocol 
		(tcp/ip|parallel|serial)[tcp/ip]:
		serial <Enter> 

	2. Enter the physical device to which the printer is 
	   connected. For example,

		Printer Physical Device Name []: 
		lp1 <Enter> (on AIX systems)
 		/dev/ttyb <Enter> (on BSD, SGI, SYSV, or HP-UX systems)

	3. Enter the baud rate for which the printer is configured.
	   For example,

	   	Printer Baud Rate (9600 | 19200) [9600]:
	   	19200 <Enter> 

	4. You are now asked if your printer supports DOC. Check 
	   your user's documentation to determine if the printer supports 
	   Document Option Commands.

		Does your printer support DOC (yes/no)? [no]:

	5. Verify that the information is correct by entering y if 
	   it is correct, or n if it is not correct. If you enter n,
	   you are returned to the beginning of the installation 
	   procedure with your previous answers used as the default 
	   values. For example,

		You have entered the following configuration 
		information:

		Printer Name:			foo
		Printer Physical Device Name:	lp1 (AIX systems)
		Printer Physical Device Name:	/dev/ttyb (BSD and SGI systems)
	   	Printer Baud Rate			19200 (BSD and SGI systems)
		Printer Alternate Name:		lp  (BSD and SGI systems)
	   	
		Is this information correct (y|n)? [y]:y 

		Printer foo configured
 
		The following messages display:

		Installing colon files

		Creating filter shell script

	6. You are now asked if you want to send your print jobs 
	   through a filter before they go to the printer. An 
	   example of a filter is prtpost which is included in the 
	   host software.

		Would you like to filter your output (yes/no)? [no]

		For example, prtpost -L -2 produces two-column, 
		landscape listings of all files sent to the queue.

	    If you answer yes, the following prompt appears:

		Please key in the exact command line syntax to invoke
		the filter (including all necessary flags and the 
		absolute path).

	7. If your printer supports Document Option Commands, 
	   you are now asked a series of questions in order to 
	   create a set-up file containing Document Option Commands.
	   
	   This file will be sent before every print job sent to the
	   queue being configured. Thus, you can create logical 
	   queues for the same printer that will automatically format
	   the output according to the DOC file for the specified 
	   queue. See the "Document Option Command Prompts" section in this file
	   for additional details.


	  >> Note: addprt creates a QDIR directory, and in QDIR a
	       directory whose name is the name of the printer.  This 
	       directory contains the log file, the prologue file for
	       the logical queue, and the filter (qfilter) which 
	       indirectly communicates with the printer.



Document Option Command Prompts
------------------------------------------------------
		Would you like to customize a logical queue? (yes/no)?
	  	[no]

	    If you answer yes, the following prompts appear:

		Do you want to add multiple copies (yes/no)? [no]

	    If you answer yes, the following prompt appears:

		How many copies?

		Do you want to add duplex (yes/no)? [no]

		Do you want to add tumble (yes/no)? [no]

		Do you want to force a language (yes/no)? [no]

	    If you answer yes, the following languages are listed:

		postscript			pcl4 
		hpgl				ln03+
		ccitt				lineprinter
		pcl5 

		Enter the language name exactly as shown (all 
		lowercase).

		Depending on the language you selected, a series of 
		language-specific questions are asked (but not listed
		here).

		Do you wish to collate the output (yes/no)? [no]

		Do you want the output to go to a certain bin 
		(yes/no)? [no]

	    If you answer yes, the following prompts appear:

		Which bin do you prefer?
		1, 2, 3, *,
		<Logical Name>

		Do you want Portrait mode enabled (yes/no)? [no]

		Do you want Landscape mode enabled (yes/no)? [no]

	    If you wish to change the logical page size mapped to 
	    the physical, then enter (with capitals as shown here),
	    Letter, Ledger, Legal, or Executive. Otherwise, press
	    Enter.

		Would you like to select the physical size of the 
		input paper (yes/no)? [no]

	    If you answer yes, you are prompted for the paper size:

		Choose between the following sizes or press <Enter>
		to accept the default size:

		Letter				Ledger
		Legal				Executive 
		A5				A4
		A3				B5
		B4

	   >> Note: Enter an * after your paper size selection to 
	      force tray chaining and pull the desired paper from any 
	      input tray.

	      For example, enter Letter * to force tray chaining for
	      letter size paper.

		Do you want to select the input bin (yes/no)? [no]

	    If you answer yes, the following prompt appears:

		Please enter the desired input bin or press Enter for 
		printer default.
		Possible choices are:
		1, 2, 3, 4,
		manualfeed
		<Logical Name>

		Would you like the header on or off (on/off/default)? 
		[default]

	    If you answer on, the following prompt appears:

		Would you like to specify an input source for the 
		header (yes/no)? [no]

	    If you answer yes, the choices are: 

		Letter				Ledger
		Legal				Executive 
		A5				A4
		A3				B5
		B4

		Would you like the trailer on or off (on/off/default)?
		[default]

	    If you answer on, the following prompt appears:
	
		Would you like to specify an input source for the 
		trailer?

	    If you answer yes, the choices are:

		Letter				Ledger
		Legal				Executive
		A5				A4
		A3				B5
		B4

		Would you like to map multiple pages of the document 
		on one physical page (yes/no)? [no]

	    If you answer yes, the following prompts appear:

		Enter the number of columns of pages per sheet (1-10) 

		Enter the number of rows of pages per sheet (1-10)

		Enter the distance between two consecutive columns 
		(1/7200 in.)

		Enter the distance between two consecutive rows 
		(1/7200 in.)

		Enter the order in which the pages are mapped to the 
		physical page. The choices are:

		rightdown			leftdown
		rightup				leftup 
		downright			downleft
		upright				upleft

		Would you like to specify margins for the physical 
		sheet of paper (yes/no)? [no]

	    If you answer yes, the following prompts appear:

		Enter the value of the left margin in centipoints 
		(1/7200 in.)

		Enter the value of the right margin in centipoints 
		(1/7200 in.)

		Enter the value of the top margin in centipoints 
		(1/7200 in.)

		Enter the value of the bottom margin in centipoints 
		(1/7200 in.)

		Would you like to alternate the margins on every other
		sheet (yes/no)? [no]

	    If you answer yes, the following prompts appear:

		Do you want to exchange left and right margins 
		(yes/no)? [no]

		Would you like to specify a page offset (yes/no)? [no]

	    If you answer yes, answer the following prompts:

		Enter the left offset in centipoints (1/7200 in.)

		Enter the top offset in centipoints (1/7200 in.)

		Do you want to include a border around your logical 
		page (yes/no)? [no]

	    If you answer yes, the following prompts appear:

		Enter the width of the border in centipoints 
		(1/7200 in.)

		Would you like to turn page scaling on or off (on/off)?
		[default]

		Would you like to enter a printer resolution (yes/no)?
		[no]

	    If you answer yes, the following prompts appear:

		Enter the desired resolution

		Would you like your output in a booklet format (yes/no)
		? [no]

	    If you answer yes, the following prompts appear:

		Enter the number of pieces of paper you want to use 
		for the booklet.

		Do you want the fold to be horizontal (yes/no)? [no]

		Enter the value for the inner margin in centipoints 
		(1/7200 in.)

		Enter the thickness of the paper being used 
		(1/10,000 in.)

		Would you like to include your own Document Option 
		Command (yes/no)? [no] 

		Printer foo configured


Removing a Printer from the System
----------------------------------------------------

	To remove a printer from an AIX spooling system, type 

		rmvirprt <Enter> 

	To remove a printer from a BSD or SGI spooling system:

	1. Remove its spool directory (specified in the sd field 
	   of the printer's entry in /etc/printcap).

	2. Remove the printer's entry from /etc/printcap.


	To remove a printer from a SYSV or HP-UX spooling system, 
	type 
		
		lpadmin -x printername <Enter>






Trademarks
----------------
QMS is a registered trademark of MINOLTA-QMS, Inc.

All other trademarks and registered trademarks are the property 
of their respective owners: HP-UX/Hewlett-Packard; AIX/IBM; 
SGI, IRIX/Silicon Graphics; Solaris, SPARC, Sun, SunNet, 
SunOS/Sun; UNIX/UNIX Systems Laboratories.

Copyright (c) 2000 by MINOLTA-QMS, Inc. All Rights Reserved.
1810029-001G  rev. A

