startippgw utility: start an IPP gateway on InfoPrint Manager for AIX or InfoPrint Manager for Linux

Syntax

startippgw [-p ListenPort] [-t Number of Threads]
 [-h Pdhost] [-s Pdsocket]

Description

Use the startippgw utility to start an IPP gateway daemon.

If you start an IPP gateway daemon on a different port than the default port, make sure that the IPP client you are using allows the port to be configured. This is necessary because most IPP clients use Port 631 by default. In other words, you must use an IPP client that lets you configure the port if you plan to start an IPP gateway daemon on a different port than 631. When using a different port than 631, you must update /etc/services with the unique port number.

Arguments

The startippgw utility uses these arguments:

-p ListenPort
Specifies the port where the IPP gateway listens. The default is port 631.
If you start an IPP gateway on a port other than 631, InfoPrint Manager does not update /etc/services. Therefore, you need to update /etc/services manually when you start an IPP gateway on a port other than 631.
-t Number of Threads
Specifies the number of threads in the connection thread pool. The default is 20. There is no limit on the number of threads.
-h Pdhost
Identifies the host of the InfoPrint Manager server to send the jobs to. When not specified, the InfoPrint Manager server follows the Configuration logic to define the host and socket.
-s Pdsocket
Identifies the port of the InfoPrint Manager server to send the jobs to. When not specified, the InfoPrint Manager server follows the Configuration logic to define the host and socket.

Configuration logic

InfoPrint Manager determines which server host and server port to use based on these sequence:

  1. Server host and server port specified with the startippgw utility or the SMIT interface.
  2. Server host and server port specified with the PDHOST and PD_SOCKET envirnonment variables.
  3. Uses the defaults for PDHOST=localhost and PD_SOCKET=6874.

Note: This configuration logic enables multiple IPP gateways to run on a single machine communicating with one or more InfoPrint Manager servers.

Examples

To start the startippgw daemon with a default port of 631 and a default of 20 threads in the connection thread pool, enter:

startippgw

To start the startippgw daemon with a default port of 631 and 35 threads in the connection thread pool, enter:

startippgw -t 35

To start the startippgw daemon with a listen port of 815 and a default of 20 threads in the connection thread pool, enter:

startippgw -p 815

To start the startippgw daemon with a server host of myhost and a port or socket of 7963, enter:

startippgw -h myhost -s 7963

Note: Only a person with root user authority or the InfoPrint Manager user can run this command.