Infoprint Manager Notifications README

Contents

Infoprint Manager Notifications README

  • Installing and using Infoprint Manager Notifications
  • Preparing to install Infoprint Manager Notifications on Windows
  • Installing the software on a Windows client
  • Installing the software on an AIX system
  • Starting and using Infoprint Manager Notifications on an Infoprint AIX system
  • Starting and using Infoprint Manager Notifications on a Windows client
  • Receiving messages
  • Multi-server environments
  • Uninstalling Infoprint Manager Notifications on Windows
  • Uninstalling Infoprint Manager Notifications on AIX

    • Infoprint Manager Notifications README

    Installing and using Infoprint Manager Notifications

    Infoprint Manager Notifications is an application that you can use to receive messages about Infoprint objects, such as print jobs that you submit to Infoprint Manager, or destinations, queues, and servers that you manage. For example, Infoprint Manager can send you a message when a job you submit is finished printing so you know that you can pick it up, or it can let you know that there is something wrong with the printer and no jobs can be printed until someone resolves the problem.

    Note:
    If you have installed Infoprint Select and use it to submit your print jobs to Infoprint Manager, messages about your jobs will continue to be sent to Select Notification, even if you install Infoprint Manager Notifications. You can still use Infoprint Manager Notifications to receive messages about other objects.

    The Infoprint Manager notifications server and notifications client software are both automatically installed on the system that your Infoprint Manager server software runs on. In addition, you can install the notifications client on any other Windows or AIX system that is network-connected. Follow the procedures in this chapter if you want to install and use the Infoprint Manager Notifications client to receive messages from your Infoprint Manager server or just follow the directions in Starting and using Infoprint Manager Notifications on an Infoprint AIX system to use the client on your Infoprint server.

    For Infoprint Manager Notifications to work, one and only one Infoprint Manager Notification server must be running in your Infoprint Manager cell. ( For information about handling the Notification server in multiple server Infoprint Manager environments, see Multi-server environments). Both Infoprint Manager for AIX and Infoprint Manager for Windows should automatically start a Notification server on port 8200, but you should verify it is running. Each Notification client defaults to receive notifications from server notification on port 8200.

    If you ask the site network administrator to add notification as an alias for the hostname of the Infoprint server running the notification server to the site's Domain Name System (DNS) nameserver, the default settings in all the Notification clients work. If you ever move the Notification server to another host, you only need to update the notification alias in the DNS server for the default settings in all the Notification clients to work.

    If you do not use a DNS server alias, you need to set up each Notification client to point to the hostname of the Infoprint server running the Notification server.

    For the Infoprint Manager Notification client to receive notification messages from the Infoprint Notifications server, the delivery address setting in the Notification client must match the delivery address in the notification profile of the Infoprint Manager destination, job, or other object. Refer to the chapter on using Notifications in the Infoprint Manager for Windows: Procedures or the Infoprint Manager for AIX: Procedures, as applicable, for information about setting up notification profiles.

    Preparing to install Infoprint Manager Notifications on Windows

    |Infoprint Manager Notifications requires the IBM Runtime Environment |for Windows, Java 2, Version 1.3.1, Build level |cn131-20020710. This is the only supported Runtime Environment |for running Infoprint Manager Notifications.

    To verify that you have the correct version of the Runtime Environment installed, follow these steps:

    1. Type java -fullversion at an MS-DOS command line.
    2. Verify that output from the command contains the following text: 
      |IBM Build cn131-20020710
    3. If the output from the command does not contain the text above, uninstall the currently installed Runtime Environment component:
      1. Click the Windows Start button and select Settings -> Control Panel, then double-click the Add/Remove Programs icon.
      2. Find the currently installed version of the |IBM Developer Kit for Windows, Java 2, Version |1.3.1 in the list of programs that can be removed and click Add/Remove. Follow the instructions on the screen to complete the process.

    If necessary, follow these steps to install the required Runtime Environment:

    1. Insert the Infoprint Manager Common Clients CD-ROM into the drive. The install program will start automatically.
    2. |Select the Install Products button, and then select the |IBM Runtime Environment for Windows, Java 2, Version 1.3.1 |button.
    3. Provide information as prompted by the installation program. When the installer asks if you want to install the Runtime Environment as the system Java Virtual Machine (JVM), answer Yes.

    When the installation is complete, verify that you have the correct version of the Runtime Environment installed:

    1. Type java -fullversion at an MS-DOS command line.
    2. Verify that the output from the command contains the following text: 
      |IBM Build cn131-20020710

    Installing the software on a Windows client

    Follow these steps to install the Infoprint Manager Notifications software on a remote system.

    1. Insert the Infoprint Manager Common Clients CD-ROM into the drive.
    2. The install program will start automatically.
    3. Select Install Products, and then select Infoprint Manager Notifications.
    4. Follow the instructions on the installation screens to install the program.

      There are two installation files to choose from:

    Installing the software on an AIX system

    The Infoprint Notification client is installed on all Infoprint AIX servers with the Infoprint Manager for AIX Base Server, LCD4-1916.

    |Infoprint Manager Notifications requires the IBM Runtime Environment |for AIX, Java 2, Version 1.3.1, Build level |cn131-20020710. This is the only supported Runtime Environment |for running Infoprint Manager Notifications.

    To install the Infoprint Notification client on an AIX system where you have not installed the Infoprint server, follow these steps:

    1. Log onto AIX as root.
    2. Insert the Infoprint Manager Common Clients CD-ROM, LCD4-1917, into the drive.
    3. If this is the first time you are installing software on this AIX system, create the /cdrom file system.
      1. Start the System Management Interface Tool (SMIT).
        • To start the AIXwindows version of SMIT, enter the following command: 
          smit cdrfs
        • To start the ASCII version of SMIT, enter the following command: 
          smitty cdrfs
        The CDROM File Systems panel is displayed.

        Figure 1. SMIT CDROM File Systems panel

        +--------------------------------------------------------------------------------+
|                               CDROM File Systems                               |
|                                                                                |
|Move cursor to desired item and press Enter.                                    |
|                                                                                |
|  Add a CDROM File System                                                       |
|  Change / Show Characteristics of a CDROM File System                          |
|  Remove a CDROM File System                                                    |
|                                                                                |
|1=Help               F2=Refresh             F3=Cancel                F8=Image   |
|F9=Shell             F10=Exit               Enter=Do                            |
+--------------------------------------------------------------------------------+
      2. Select Add a CDROM File System.

        Figure 2. SMIT Add a CDROM File System panel

        +--------------------------------------------------------------------------------+
|                            Add a CDROM File System                             |
|                                                                                |
|Type or select values in entry fields.                                          |
|Press Enter AFTER making all desired changes.                                   |
|                                                                                |
|                                                           ^Entry Fields|       |
|* DEVICE Name                                                               +   |
|* MOUNT Point                                           ^|                      |
|  Mount AUTOMATICALLY at system restart?                 no                 +   |
|                                                                                |
|1=Help               F2=Refresh             F3=Cancel                F4=List    |
|F5=Reset             F6=Command             F7=Edit                  F8=Image   |
|F9=Shell             F10=Exit               Enter=Do                            |
+--------------------------------------------------------------------------------+
      3. In the DEVICE name field, enter the identifier of your CD-ROM drive.
      4. In the MOUNT POINT field, enter /cdrom.
      5. Select OK (AIXwindows version) or press Enter (ASCII version).
      6. Select Cancel (AIXwindows version) or press F10 (ASCII version) to exit from SMIT.
    4. To mount the CD-ROM, enter: 
      mount /cdrom
    5. Enter the following command to install the notification client: 
      /cdrom/setup -y -n ServerName -l locale
      where:
      ServerName
      is the name of the host where the Infoprint server you want to communicate with (PDHOST) is running.
      locale
      is the locale of the notification client. The default is en_US (U. S. English). The -l locale flag is optional.

    Starting and using Infoprint Manager Notifications on an Infoprint AIX system

    To launch Infoprint Manager Notifications, type notificationClient on an AIX command line. The first time you start the program, it needs to connect to the notification server on the machine that your Infoprint Manager server runs on. If it does not succeed, Infoprint Manager displays the Notification Client Properties dialog. Check to see if the notification server hostname and port number match the ones the Notification server is using. If they do not, change them and click OK. If you need further assistance with the dialog, click Help to see the online help.

    Note:
    If the site network administrator adds a notification alias for the hostname of the Infoprint server running the notification server to the site's Domain Name System (DNS) nameserver, the default settings will not have to be changed on each notification client.

    Starting and using Infoprint Manager Notifications on a Windows client

    To launch Infoprint Manager Notifications, click Start-->Programs-->Infoprint Manager Notifications to run the software.

    The first time you start the program, it needs to connect to the notification server on the machine that your Infoprint Manager server runs on. If it does not succeed, the Notification Client Properties dialog will be displayed. Check to see if the notification server hostname and port number match the ones that your Notification server is using. If they do not, change them and click OK. If you need further assistance with the dialog, click Help to see the online help.

    Note:
    If the site network administrator adds a notification alias for the hostname of the Infoprint server running the notification server to the site's Domain Name System (DNS) nameserver, the default settings will not have to be changed on each notification client.

    Receiving messages

    In order to receive messages, you must have Infoprint Manager Notifications not only installed, but running on your workstation. On both Windows and AIX systems, you can minimize the notification window if you do not want it open on your desktop. You will have to restore it when you want to check the messages that have arrived.

    Tip:
    On Windows systems, you can put Infoprint Manager Notifications in your Startup folder, so it will automatically start whenever you log on.

    You will receive certain messages without having to do anything else; for example, messages about print jobs you have submitted (including messages about the printers you send your jobs to) will come to you by default. Most of the messages you receive about jobs provide reasons for a job not printing. If you receive one of them, you can either resend the job or attempt to resolve the problem.

    If you need to receive messages about other objects (for example, about printers that you manage), you can change the notification profile for those objects. The delivery address in your Infoprint Notifications Settings window must match the delivery address specified in one of the values of the notification profile of the object for which you want to receive messages. For more information about using Notifications, see "Using Infoprint Manager notifications" in Infoprint Manager for AIX: Procedures.

    Multi-server environments

    While the notification server defaults to starting automatically, you may have reason to stop and then start it on your own. For example, if you have installed multiple Infoprint servers, only one notification server (for each cell) should be enabled. To stop the server on an Infoprint Windows server, access the Management Console and select File -> Stop Server. To stop or disable the server on an Infoprint AIX server, access the SMIT interface and take the following path: Infoprint Printing System -> Infoprint Utilities -> Notification Daemon -> Stop. You can also stop and start the notification (notifyd) daemon from the command line on the AIX server by using the stopnotd and the startnotd utilities, respectively. For more information about these commands, see Infoprint Manager: Reference.

    Uninstalling Infoprint Manager Notifications on Windows

    To uninstall Infoprint Manager Notifications, follow these steps:

    1. From the Start menu, select Settings -> Control Panel.
    2. Double-click the Add/Remove Programs icon.
    3. Select Infoprint Manager Notifications.
    4. Click Add/Remove (Windows NT) or the Change/Remove (Windows 2000).
      Note:
      Click the button only once, then wait for at least 30 seconds before you do anything else. If you do not wait for the first panel of the uninstaller to appear, it may get lost behind other windows. If you don't see first panel of the uninstaller the after 30 seconds, press and hold the Alt key, then press the Tab key to bring the window to the front.
    5. Follow the instructions on the screen.

    Uninstalling Infoprint Manager Notifications on AIX

    To uninstall Infoprint Manager Notifications, do the following:

    From the AIX command line, specify the following: 

    setup -Y

    Infoprint Manager removes the Notification client from the AIX server.