Customizing the environment variables file for the IBM HTTP Server - Powered by Apache (bin/envvars)

When you install the IBM® HTTP Server - Powered by Apache, the environment variables file, bin/envvars, is created. To use the IBM HTTP Server - Powered by Apache with Infoprint Central, you must customize the bin/envvars file by adding environment variables at the end of the file. For example, you might add these variables:

export AOPCENTRAL=/usr/lpp/Printsrv/InfoprintCentral
export AOPCONF=/etc/Printsrv/aopd.conf # Location of aopd.conf
export CLASSPATH=/usr/lpp/Printsrv/classes/penguin.jar:\
/usr/lpp/Printsrv/classes/ipa.jar:/usr/lpp/Printsrv/classes/snmp.jar:\
/usr/lpp/Printsrv/classes/modelplugin.jar
export JAVA_HOME=/usr/lpp/java/J7.1
export LANG=C 
export LC_ALL=En_US.IBM-1047
export LIBPATH=$LIBPATH:/usr/lpp/Printsrv/lib:/usr/lpp/ixm/IBM/xml4c-5_7/lib:\
/usr/lpp/ixm/IBM/xslt4c-1_11/lib
export NLSPATH=/usr/lpp/Printsrv/%L/%N:/usr/lib/nls/msg/%L/%N:\
/usr/lpp/internet/%L/%N:/usr/lpp/ldap/lib/nls/msg/%L/%N

Follow these guidelines when you customize the bin/envvars file:

1. If you use the AOPCONF, LC_ALL, and LC_CTYPE environment variables in the HTTP server environment variables file, they must match the variables that are specified in the environment for the start command or the JCL startup procedure.
2. Start each environment variable on a separate line.
3. Use a backslash, \, to continue an environment variable on another line.
4. Do not include any blanks after the last character on a line.
5. After you update the HTTP server environment variables file, do these steps:
   1. Restart the HTTP server with this command so that your changes take effect:

      bin/apachectl restart

   2. Verify that you can open the main Infoprint Central web page. For example, enter:

      http://bldserv.bldev.infoprint.com:8081/Infoprint/En_US/IPS.html

   3. If you have problems opening the web page, see the logs/error_log file. You can use the LogLevel directive in conf/httpd.conf to adjust the number of the messages that are recorded in the Apache error logs. You can also set GUI_DEBUG=1, AOPTRACEON=1, or both in the bin/envvars file to get more information.
   

Table 1 summarizes the variables that you might need to set in the file. You must always set the required variables. You must set the optional variables only if the default values are not suitable for your installation.

Table 1. Environment variables in bin/envvars

Environment variable	Condition	Default
AOP_READ_COMMUNITY	Optional	public
AOP_WRITE_COMMUNITY	Optional	public
AOPCENTRAL	Optional	/usr/lpp/Printsrv/InfoprintCentral
AOPCENTRAL_CODEPAGE	Optional	IBM-1047
AOPCONF	Optional	/etc/Printsrv/aopd.conf
AOPLIMIT	Optional	250
AOPLIMIT_DOCS	Optional	250
AOPLIMIT_JOBS	Optional	250
CLASSPATH	Optional	/usr/lpp/Printsrv/classes/ipa.jar: /usr/lpp/Printsrv/classes/modelplugin.jar: /usr/lpp/Printsrv/classes/penguin.jar: /usr/lpp/Printsrv/classes/snmp.jar
JAVA_HOME	Optional	/usr/lpp/java/J7.1.
LANG	Optional	C
LC_ALL	Optional	C
LIBPATH	Required	None
NLSPATH	Required	None

AOP_READ_COMMUNITY

The SNMP community name that allows read access to TCP/IP-attached printers in your installation. The SNMP read community name is required for Infoprint Central to display information from the printer (such as status, paper level, and model) and to display the turn online, turn offline, and reset printer actions. This environment variable is optional.

Tips:

1. For information about how to assign an SNMP read community name to a printer, see the documentation for the printer or contact the printer manufacturer.
2. You need to assign the same SNMP read community name to all printers and specify it in this environment variable. If a printer's SNMP read community name is different from the one specified in this environment variable, Infoprint Central does not display information from the printer and does not display the turn online, turn offline, and reset printer actions.
3. To see information from the printer and printer actions, Infoprint Central users must have READ access to the RACF® profiles in the PRINTSRV and OPERCMDS classes that protect the printer.
4. Infoprint Central does not reveal this community name to Infoprint Central users.

Default: public

Example: AOP_READ_COMMUNITY=mypass

AOP_WRITE_COMMUNITY

The SNMP write community name that allows write access to TCP/IP-attached printers in your installation. The SNMP write community name is required to turn printers online, offline, and reset them. This environment variable is optional.

Tips:

1. For information about how to assign an SNMP write community name to printers, see the documentation for the printer or contact the printer manufacturer.
2. If you assign different SNMP write community names to your printers, specify the most common community name in this environment variable. If this community name is not correct for a particular printer, Infoprint Central asks the user to enter the SNMP write community name for that printer.
3. To do printer actions, Infoprint Central users must have CONTROL access to the RACF profile in the PRINTSRV class that protects the printer.
4. Infoprint Central does not reveal this community name to Infoprint Central users.

Default: public

Example: AOP_WRITE_COMMUNITY=mypass

AOPCENTRAL

The directory that contains Infoprint Central files. This environment variable is optional. If you installed Infoprint Server files in the default directory, you do not need to set this environment variable.

Default: /usr/lpp/Printsrv/InfoprintCentral

Example: AOPCENTRAL=/usr/lpp/mylib/InfoprintCentral

AOPCENTRAL_CODEPAGE

The EBCDIC code page that Infoprint Central uses when it searches for and displays attributes in the Printer Inventory. Specify the same code page for the locale that is specified in the LC_ALL or LC_CTYPE environment variable in the aopstart EXEC, envar file, or JCL startup procedure. This environment variable is optional.

Specify this environment variable only in the IBM HTTP Server - Powered by Apache environment variables file (bin/envvars).

Default: IBM-1047

Example: AOPCENTRAL_CODEPAGE=IBM-297

AOPCONF

The full path name of the Infoprint Server configuration file. This environment variable is optional. If you created the configuration file in the default location, you do not need to set this environment variable. The values in the IBM HTTP Server - Powered by Apache environment variables file (bin/envvars) and in the aopstart EXEC or envar file must match.

Default: /etc/Printsrv/aopd.conf

AOPLIMIT

The maximum number of objects that Infoprint Central displays after a search. This limit prevents the IBM HTTP Server - Powered by Apache from timing out before Infoprint Central can display all objects that meet the users' search criteria. This environment variable is optional. You can specify a number 1 - 9999. If you specify an incorrect value, the default value is used.

If you set a limit for print jobs in the AOPLIMIT_JOBS environment variable, the limit in AOPLIMIT does not apply to print jobs.

If you set a limit for documents in the AOPLIMIT_DOCS environment variable, the limit in AOPLIMIT does not apply to documents.

Tips:

1. If Infoprint Central users ask to see more than 250 objects, try increasing the limit. If the higher limit causes the HTTP server to time out, try increasing the HTTP server's timeout value.
2. If the HTTP server times out occasionally with the default limit, ask users to narrow their searches.
3. If the HTTP server times out repeatedly with the default limit, lower the limit or try increasing the HTTP server's timeout value.
4. When the HTTP server times out, users might not see any search results, or might see partial search results or a "Page not found" error.

Default: 250

Example: AOPLIMIT=100

AOPLIMIT_DOCS

The maximum number of documents that Infoprint Central displays after a search. This limit prevents the HTTP server from timing out before Infoprint Central can display all objects that meet the users' search criteria. This environment variable is optional. You can specify a number 1 - 9999. If you specify an incorrect value, the default value is used.

For more information, see the AOPLIMIT environment variable.

Default: The limit that is specified in the AOPLIMIT environment variable is used. If that environment variable is not specified, the limit is 250.

Example: AOPLIMIT_DOCS=100

AOPLIMIT_JOBS

The maximum number of print jobs that Infoprint Central displays after a search. This limit prevents the HTTP server from timing out before Infoprint Central can display all objects that meet the users' search criteria. This environment variable is optional. You can specify a number 1 - 9999. If you specify an incorrect value, the default value is used.

For more information, see the AOPLIMIT environment variable.

Default: The limit that is specified in the AOPLIMIT environment variable is used. If that environment variable is not specified, the limit is 250.

Example: AOPLIMIT_JOBS=100

CLASSPATH

The full path names of Infoprint Central Java™ Archive (JAR) files. This environment variable is optional. However, you must set it if you did not install Infoprint Server in the default directory (/usr/lpp/Printsrv), or if you specify the CLASSPATH environment variable in the HTTP server environment variables file.

If you did not install Infoprint Server in the default directory, add these directories to any existing values:

• /directory/classes/ipa.jar
• /directory/classes/modelplugin.jar
• /directory/classes/penguin.jar
• /directory/classes/snmp.jar

directory is the name of the directory where you installed Infoprint Server.

Rule: Separate directories with a colon, do not include any blanks in the value, and specify the entire value on one line.

Default:

CLASSPATH=/usr/lpp/Printsrv/classes/ipa.jar:
          /usr/lpp/Printsrv/classes/modelplugin.jar: 
          /usr/lpp/Printsrv/classes/penguin.jar:
          /usr/lpp/Printsrv/classes/snmp.jar

JAVA_HOME

The path that is used to locate Java files. Infoprint Central requires Java 7.1. This environment variable is optional. However, you must set it if you did not install the Java files in the default Java directory.

Default: /usr/lpp/java/J7.1.

Example: JAVA_HOME=/usr/lpp/java/J7.1

LANG

The language that is used for messages. Infoprint Server provides messages in English and Japanese. Specify En_US for English messages, or Ja_JP for Japanese messages.

Default: C (equivalent to En_US)

LC_ALL

The locale that is used to format time and date information in messages. This locale overrides the locale in the LC_TIME variable.

Rule: In the IBM HTTP Server - Powered by Apache environment variables file (bin/envvars), do not specify a value that is associated with a code page other than IBM-1047.

Examples:

1. aopstart EXEC: LC_ALL=Fr_FR.IBM-297
2. bin/envvars file: LC_ALL=Fr_FR.IBM-1047

Default: C (also called POSIX)

LIBPATH

The path that is used to locate dynamic link libraries (DLLs). This environment variable is required. Add these IBM XML Toolkit V1.10 and Infoprint Server libraries before any existing values in LIBPATH:

/usr/lpp/ixm/IBM/xml4c-5_7/lib
/usr/lpp/ixm/IBM/xslt4c-1_11/lib
/usr/lpp/Printsrv/lib

Rules:

1. Separate directories with a colon, do not include any blanks in the value, and specify the entire value on one line.
2. Add the XML Toolkit V1.10 libraries before the libraries for any other XML Toolkit versions.

Default: None

Example:

LIBPATH=/usr/lpp/ixm/IBM/xml4c-5_7/lib:/usr/lpp/ixm/IBM/xslt4c-1_11/lib:/usr/lpp/Printsrv/lib:other values 

NLSPATH

The path of directories that contain message catalogs. This environment variable is required. Add these directories for Infoprint Server messages to any existing values in NLSPATH:

/usr/lpp/Printsrv/%L/%N
/usr/lpp/Printsrv/En_US/%N

Rule: Separate directories with a colon, do not include any blanks in the value, and specify the entire value on one line.

Default: None

Example:

NLSPATH=existing values:/usr/lpp/Printsrv/%L/%N:/usr/lpp/Printsrv/En_US/%N