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/J8.0
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
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/J8.0 or /usr/lpp/java/J7.1 if J8.0 does not exist.
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
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: 
/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 or Java 8.0. 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/J8.0 or /usr/lpp/java/J7.1 if J8.0 does not exist.
Example: JAVA_HOME=/usr/lpp/java/J8.0
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