Ioprint+ configuration tips using PSFilter.

Issue:
Ioprint+ configuration tips using PSFilter.

Solution:
A 1. Using install.sh failed when I tried to install IOPRINT+ in UNIX environment (C compiler and Socket library must be included in Host)?
STEP 1 : Check that you have installed IOPRINT + Hardware , assigned IP address of IOPRINT + and have checked LED's status.

STEP 2 : Install IOPRINT + by using install.sh

(2.1) modify install.sh At /full_path/install.sh, vi ./install.sh, change #!/bin/sh to #!/bin/ksh
(2.2) Issue ./install.sh printer_name PS_Name ...

STEP 3 : Install IOPRINT + to UNIX host by manual

(3.1) At /full_path/psfilter.c, cp pmfilter.c psfilter.c.119 (for safety), vi ./psfilter.c, change #define SVR4 0 to #define SVR4 1 (If UNIX type is SYSTEM V )
(3.2) cc -o PSfilter psfilter.c -lsocket -lnsl (compiler psfilter.c)
(3.3) At /full_path/Psfilter, Issue /full_path/PSfilter -DPrintServer_name -v < file_name & If this fails, check for an error log file, PSErrLogxxxxx, in the directory /tmp.
(3.4) Please see "For System V : " section in "Manual Installation of PSfilter to UNIX Host" on TCP/IP protocol User's Guide.

 

A 2. I want to install IOPRINT+ on HP_UX version 9.04, how do I do it?
On HP_UX version 9.04 you need to modify dumb_int.sh file, the following procedure is:

STEP 1: cd LPTI

STEP 2: vi dumb_int.sh

STEP 3: change the first line #!/bin/sh to #!/bin/ksh

STEP 4: do what user's guide tells you

 

A 3. How to install  PSfilter to HP Unix  
Step 1:
- Make sure the Hardware Installation is complete
- Login to the Unix host as root
- Your IOPRINT+ is on the same network segment that the host resides
- Tar all files from the Print Server Utility (TCP/IP protocol) diskette (tar formatted) to ./LPTI directory

Step 2: Assign an IP address to the IOPRINT+

(1) To create a new entry in /etc/hosts file --> add the following line :

IP_Address PS_NAME # comment

(2) To create a static map in the UNIX host --> type the following line :

arp -s PS_NAME 00:c0:02:xx:yy:zz

(00:c0:02:xx:yy:zz is node address of print server you can find the node address from the default print server name - SCxxyyzz - located on the bottom of the IOPRINT+ cover)

(3) Configure IOPRINT+
(a) tftp PS_NAME
(b) tftp> get CONFIG
(c) tftp> quit
(d) vi CONFIG
(e) Edit parameters which you want to change in the CONFIG file
(f) tftp PS_NAME
(g) tftp> put CONFIG
(h) tftp> get RESET
(i) Wait for a moment becuse it is doing RESET
(j) tftp> quit

Step 3: Setup for PSfilter

- Before you begin, you must make sure that you have C complier. If you do not have it, you can not use PSfilter. (Please see user's guide for LPD printing protocol -Installation & Configuration Guide )

- Three methods are provided to setup IOPRINT+ for PSfilter.
Method 1 : PSfilter Quick Installation to Unix Host
Method 2 : Interactive Installation
Method 3 : Manual Installation of PSfilter to Unix Host

Method 1 : Quick installation by using install.sh

Step A : Execute Install.sh

cd LPTI

./install.sh printer_name PS_NAME [pn=port_number] [im=interface_model] [d=delay_minutes] [text]

printer_name : It is the printer name.
PS_NAME : It is the host name of the IOPRINT+ unit.
pn=port_number :

It is optional. it is the print port number. 1 is parallel port 1, 2 is parallel port 2, 3 is the serial port. The default number is 1.

im=interface_model :

It is optional. It replaces the standard interface model. The default is dumb_int.sh shipped with IOPRINT+.

d=delay_minutes : It is to specify option, -d, of PSfilter program.

Text : Text mode on. It is to specify option, -T, of PSfilter program.

Line feed will be converted to Carriage Return + Line Feed
Finally, it adds the printer to the Unix system. User can then use the
printer after the install.sh has been executed completely.

Note:

(1) The interface model must be in the lp model directory

(2) For BSD UNIX, it will be ignored.

In Method 2 : Interactive Installation

Step A : Execute Install.sh

cd LPTI

./install.sh

The install.sh program will ask users to input the following information

1. The type of UNIX system

2. The printer name

3. The IOPRINT+ Name

4. the path of the directory containing the PSfilter program and the
directory containing dumb_int.sh script

5. The IOPRINT+ print port to which the printer is connected

6. The capability of switching print port if the selected printer
is busy

7. Whether to send string before/after print job

8. Whether send files before/after print job

9. Time to delay before the print job been aborted after printer fault

10. for System V, the model of interface program if dumb_int.sh is not
used.

install.sh will check the correctness of the information provided by user.

If all information provided by user is correct, install.sh will modify
the selected interface program of System V host so that the intreface
program will redirect its stdout to PSfilter's stdin and invoke the
PSfilter program with the parameters properly set.

Users can print the jobs to Printmate after the install.sh execution
is finished.

In Method 3 : Manual Installation of PSfilter to Unix Host

You can also install the PSfilter program and printers to a Unix host
without using the install.sh program. Before you begin, you should
compile psfilter.c

step A : Modify and compile pmfilter.c on the Unix host, then install the
compiled pmfilter program on the Unix host by running install.sh

Type the following command for compiling psfilter.c

cd /usr/local/LPTI

(assuming that mycc resides in /usr/local/LPTI)

./mycc

If mycc succeeds, its output will be an execution file:

/usr/local/LPTI/LPsource/PSfilter

Note: Your Unix host must include C Compiler

step B : Add a printer name by using one of the following methods

(1) Add a printer using the program sam. Specify everything as

if the printer were directly connected to the device /dev/null

or (2) To use Unix system provided interface script by typing :

/usr/lib/lpshut

/usr/lib/lpadmin -p -v /dev/null

-m

/usr/lib/lpsched

or (3) typing (if user wants to use dumb_int.sh as the interface program)

/usr/lib/lpshut

/usr/lib/lpadmin -p -v /dev/null

-i dumb_int.sh

/usr/lib/lpsched

step C: Modify the interface script

/usr/spool/lp/interface/printer_name

To modify the interface script,assuming that PSfilter is
located in the directory /usr/local/LPTI, modify the shell so
that all output is piped into the program PSfilter and exit
with the exit code of PSfilter program.

For example :

# !/bin/sh

(

shell script

) | /usr/local/LPTI/PSfilter -D PS_Name

exit $?

If the user uses the dumb_int.sh as the interface of the printer
find the first PSFILTER_CMD in the program and change the
PSFILTER_CMD to the full path of PSfilter program with the
parameters properly set, e.g.,

PSFILTER_CMD="/usr/local/LPTI/PSfilter -D PS_Name "

Note:

(1) printer_name is the name of the printer that you just added

(2) Put the command line in a pair of double quotes. Do not split
the command line. If the command line is too long to fit in one
line, continueously typing it till the end of the command line

step D: After modifying the command script, enable the printer and have
it accept the connections with the following commands :

/usr/bin/enable printer_name

/usr/bin/accept printer_name

step E : Repeat from step B to step D until each printer has been
configured

_

(b) tftp

 

A 4. How to install PSfilter SCO UNIX System V release 3
Step 1 :

- Make sure the Hardware Installation is complete
- Login to the Unix host as root
- Your IOPRINT+ is on the same network segment that the host resides
- Tar all files from the Print Server Utility (TCP/IP protocol) diskette
(tar formatted) to ./LPTI directory

Step 2 : Assign an IP address to the IOPRINT+

(1) To create a new entry in /etc/hosts file --> add the following line
IP_Address PS_NAME # comment

(2) To create a static map in the UNIX host --> type the following line
arp -s PS_NAME 00:c0:02:xx:yy:zz
(00:c0:02:xx:yy:zz is node address of print server you can find
the node address from the default print server name - SCxxyyzz -
located on the bottom of the IOPRINT+ cover)

(3) Configure IOPRINT+
(a) tftp PS_NAME
(b) tftp> get CONFIG
(c) tftp> quit
(d) vi CONFIG
(e) Edit parameters which you want to change in the CONFIG file
(f) tftp PS_NAME
(g) tftp> put CONFIG
(h) tftp> get RESET
(i) Wait for a moment because it is doing RESET
(j) tftp> quit

Step 3 : Setup for PSfilter

- Before you begin, you must make sure that you have C compiler.
If you do not have it, you can not use PSfilter.

(Please see user's guide for LPD printing protocol) Installation & Configuration Guide

Three methods are provided to setup IOPRINT+ for PSfilter.

Method 1 : PSfilter Quick Installation to UNIX Host
Method 2 : Interactive Installation
Method 3 : Manual Installation of PSfilter to UNIX Host

In Method 1 : Quick installation by using install.sh

Step A : Execute Install.sh

cd LPTI
./install.sh printer_name PS_NAME [pn=port_number] [im=interface_model]
[d=delay_minutes] [text]
printer_name : It is the printer name.
PS_NAME : It is the host name of the IOPRINT+ unit.
pn=port_number :
It is optional. it is the print port number. 1 is parallel port 1,
2 is parallel port 2, 3 is the serial port. The default number is 1.
im=interface_model :

It is optional. It replaces the standard interface model.
The default is dumb_int.sh shipped with IOPRINT+.
d=delay_minutes : It is to specify option, -d, of PSfilter program.
Text : Text mode on. It is to specify option, -T, of PSfilter program.
Line feed will be converted to Carriage Return + Line Feed

Finally, it adds the printer to the UNIX system. User can then use the
printer after the install.sh has been executed completely.
Note :
(1) The interface model must be in the lp model directory
(2) For BSD UNIX, it will be ignored.

In Method 2 : Interactive Installation

Step A : Execute Install.sh

cd LPTI
./install.sh

The install.sh program will ask users to input the following information
1. The type of UNIX system
2. The printer name
3. The IOPRINT+ Name
4. the path of the directory containing the PSfilter program and the
directory containing dumb_int.sh script
5. The IOPRINT+ print port to which the printer is connected
6. The capability of switching print port if the selected printer
is busy
7. Whether to send string before/after print job
8. Whether send files before/after print job
9. Time to delay before the print job been aborted after printer fault
10. for System V, the model of interface program if dumb_int.sh is not
used.
install.sh will check the correctness of the information provided by user.
If all information provided by user is correct, install.sh will modify
the selected interface program of System V host so that the interface
program will redirect its stdout to PSfilter's stdin and invoke the
PSfilter program with the parameters properly set.

Users can print the jobs to the IOPRINT+ after the install.sh execution
is finished.

In Method 3 : Manual Installation of PSfilter to UNIX Host

You can also install the PSfilter program and printers to a UNIX host
without using the install.sh program. Before you begin, you should
compile psfilter.c

step A : Modify and compile pmfilter.c on the Unix host, then install the
compiled pmfilter program on the Unix host by running install.sh
Type the following command for compiling psfilter.c
cd /usr/local/LPTI
(assuming that mycc resides in /usr/local/LPTI)
./mycc
If mycc succeeds, its output will be an execution file:
/usr/local/LPTI/LPsource/PSfilter
Note : Your UNIX host must include C Compiler
step B : Add a printer name by using one of the following methods
(1) Add a printer using the program sysadmsh. Specify everything as
if the printer were directly connected to the device /dev/null
or (2) To use Unix system provided interface script by typing :
/usr/lib/lpadmin -p -v /dev/null
-m
or (3) typing (if user wants to use dumb_int.sh as the interface program)
/usr/lib/lpadmin -p -v /dev/null
-i dumb_int.sh
step C: Modify the interface script
/usr/spool/lp/admins/lp/interfaces/printer_name
To modify the interface script,assuming that PSfilter is
located in the directory /usr/local/LPTI, modify the shell so
that all output is piped into the program PSfilter and exit
with the exit code of PSfilter program.
For example :

# !/bin/sh
(
shell script
) | /usr/local/LPTI/PSfilter -D PS_Name
exit $?

If the user uses the dumb_int.sh as the interface of the printer
find the first PSFILTER_CMD in the program and change the
PSFILTER_CMD to the full path of PSfilter program with the
parameters properly set, e.g.,
PSFILTER_CMD="/usr/local/LPTI/PSfilter -D PS_Name "

Note :
(1) printer_name is the name of the printer that you just added
(2) Put the command line in a pair of double quotes. Do not split
the command line. If the command line is too long to fit in one
line, continuously typing it till the end of the command line

step D: After modifying the command script, enable the printer and have
it accept the connections with the following commands :
/usr/bin/enable printer_name
/usr/bin/accept printer_name

step E : Repeat from step B to step D until each printer has been
configured

 

A 5. How to install PSfilter on Unixware 2.1.3
Manual Installation of PSfilter to Unixware

Before start, user must make sure this Unix host has C compiler

Step 1 :

- Make sure the Hardware Installation is complete
- Login to the Unix host as root
- Your IOPRINT+ is on the same network segment that the host resides
- Tar all files from the Print Server Utility (TCP/IP protocol) diskette
(tar formatted) to ./LPTI directory

Step 2 : Assign an IP address to the IOPRINT+

(1) To create a new entry in /etc/hosts file --> add the following line
IP_Address PS_NAME # comment
(2) To create a static map in the UNIX host --> type the following line
arp -s PS_NAME 00:c0:02:xx:yy:zz
(00:c0:02:xx:yy:zz is node address of print server you can find
the node address from the default print server name - SCxxyyzz -
located on the bottom of the IOPRINT+ cover)
(3) Configure IOPRINT+
(a) tftp PS_NAME
(b) tftp> get CONFIG
(c) tftp> quit
(d) vi CONFIG
(e) Edit parameters which you want to change in the CONFIG file
(f) tftp PS_NAME
(g) tftp> put CONFIG
(h) tftp> get RESET
(i) Wait for a moment becuse it is doing RESET
(j) tftp> quit

Step 3 : Modify and compile pmfilter.c on the Unix host, then install the
compiled pmfilter program on the Unix host by running install.sh
Type the following command for compiling psfilter.c
cd /usr/local/LPTI
(assuming that mycc resides in /usr/local/LPTI)
./mycc
If mycc succeeds, its output will be an execution file:
/usr/local/LPTI/LPsource/PSfilter
Note : Your Unix host must include C Compiler

Step 4 : Add a printer name by using one of the following methods
(1) To use Unix system provided interface script by typing :
/usr/lib/lpadmin -p -v /dev/null
-i
or (3) typing (if user wants to use dumb_int.sh as the interface
program)
/usr/lib/lpadmin -p -v /dev/null
-i dumb_int.sh

Step 5: Modify the interface script
/etc/lp/interfaces/printer_name
To modify the interface script,assuming that PSfilter is
located in the directory /usr/local/LPTI, modify the shell so
that all output is piped into the program PSfilter and exit
with the exit code of PSfilter program.
For example :
# !/bin/sh
(
shell script
) | /usr/local/LPTI/PSfilter -D PS_Name
exit $?
If the user uses the dumb_int.sh as the interface of the printer
find the first PMFILTER_CMD in the program and change the
PMFILTER_CMD to the full path of PSfilter program with the
parameters properly set, e.g.,
PMFILTER_CMD="/usr/local/LPTI/PSfilter -D PS_Name
"
Note :
(1) printer_name is the name of the printer that you just added
(2) Put the command line in a pair of double quotes. Do not split
the command line. If the command line is too long to fit in one
line, continueously typing it till the end of the command line

Step 6: After modifying the command script, enable the printer and
have it accept the connections with the following commands :
/usr/bin/enable printer_name
/usr/bin/accept printer_name

Step 7 : Repeat from step 4 to step 6 until each printer has been configured


Article ID:
173
Published:
2/3/2003 12:46:30 PM
Last Modified:
9/8/2003 9:23:59 AM
Issue Type:
Configuration