e-STUDIO Plug-in

for HP OpenView Network Node Manager

(Windows)

Operation Guide Rev2.0

Copyright 2007-2011 TOSHIBA TEC CORPORATION All rights reserved

Disclaimer Notice

The following notice sets out the exclusions and limitations of liability of TOSHIBA TEC
CORPORATION (including its employees, agents and sub-contractors) to any purchaser or
user (‘User’) of the e-STUDIO520/600/720/850, e-STUDIO523/603/723/853,
e-SUTDIO281c/351c/451c,e-STUDIO352/452,e-STUDIO353/453, e-STUDIO202L/232/282,
e-STUDIO203L/233/283, e-STUDIO2500c/3500c/3510c,
e-STUDIO5520C/6520C/6530C,
e-STUDIO2020C/2330C/2820C/2830C/3520C/3530C/4520C,
e-STUDIO205L/255/305/355/455, e-STUDIO555/655/755/855,
e-STUDIO5540C/6540C/6550C and e-STUDIO2040C/2540C/3040C/3540C/4540C,
including its accessories, options and bundled software (‘Product’).

1. The exclusion and limitations of liability referred to in this notice shall be effective to the
fullest extent permissible at law. For the avoidance of doubt, nothing in this notice shall
be taken to exclude or limit TOSHIBA TEC CORPORATION’s liability for death or
personal injury caused by TOSHIBA TEC CORPORATION’s negligence or TOSHIBA
TEC CORPORATION’s fraudulent misrepresentation.

2. All warranties, conditions and other terms implied by law are, to the fullest extent
permitted by law, excluded and no such implied warranties are given or apply in relation
to the Products.

3. TOSHIBA TEC CORPORATION shall not be liable for any loss, cost, expense, claim or
damage whatsoever caused by any of the following:
(A) use or handling of the Product otherwise than in accordance with the manuals,
including but not limited to Operator’s Manual, User’s Guide, and/or incorrect or
careless handling or use of the Product;
(B) any cause which prevents the Product from operating or functioning correctly which
arises from or is attributable to either acts, omissions, events or accidents beyond
the reasonable control of TOSHIBA TEC CORPORATION including without
limitation acts of God, war, riot, civil commotion, malicious or deliberate damage,
fire, flood, or storm, natural calamity, earthquakes, abnormal voltage or other
disasters;
(C) additions, modifications, disassembly, transportation, or repairs by any person other
than service technicians authorized by TOSHIBA TEC CORPORATION; or

2
 (D) use of paper, supplies or parts other than those recommended by TOSHIBA TEC
CORPORATION.

4. Subject to paragraph 1, TOSHIBA TEC CORPORATION shall not be liable to Customer

for:
(a) loss of profits; loss of sales or turnover; loss of or damage to reputation; loss of
production; loss of anticipated savings; loss of goodwill or business opportunities;
loss of customers; loss of, or loss of use of, any software or data; loss under or in
relation to any contract;
or
(b) any special, incidental, consequential or indirect loss or damage, costs, expenses,
financial loss or claims for consequential compensation;

whatsoever and howsoever caused which arise out of or in connection with the Product
or the use or handling of the Product even if TOSHIBA TEC CORPORATION is advised
of the possibility of such damages.

TOSHIBA TEC CORPORATION shall not be liable for any loss, cost, expense, claim or
damage caused by any inability to use (including, but not limited to failure, malfunction,
hang-up, virus infection or other problems) which arises from use of the Product with
hardware, goods or software which TOSHIBA TEC CORPORATION has not directly or
indirectly supplied

Trademarks
- The official name of Windows XP is Microsoft Windows XP Operating System.
- The official name of Windows Server 2003 is Microsoft Windows Server 2003 Operating
System.
- Microsoft, Windows, Windows NT, and the brand names and product names of other
Microsoft products are trademarks of Microsoft Corporation in the US and other
countries.
- IBM, AT,AIX and Tivoli are trademarks of International Business Machines Corporation.
- HP OpenView Network Node Manager are trademarks of Hewlett-Packard
Development Company.
- TopAccess is a trademark of Toshiba Tec Corporation.
- Other company names and product names in this manual are the trademarks of their
respective companies.

3
Copyright

Copyright 2007-2011 TOSHIBA TEC CORPORATION All rights reserved

This manual is protected by copyright laws. No part of this manual shall be duplicated or
reproduced without the permission of TOSHIBA TEC CORPORATION. TOSHIBA TEC
CORPORATION shall not be liable in terms of granting patents for any use of information
contained in this manual by third parties.

END USER SOFTWARE LICENSE AGREEMENT

INSTALLING OR OTHERWISE USING THIS SOFTWARE PRODUCT CONSTITUTES

YOUR ACCEPTANCE OF THE FOLLOWING TERMS AND CONDITIONS (UNLESS A
SEPARATE LICENSE IS PROVIDED BY THE SUPPLIER OF APPLICABLE SOFTWARE
IN WHICH CASE SUCH SEPARATE LICENSE SHALL APPLY). IF YOU DO NOT
ACCEPT THESE TERMS, YOU MAY NOT INSTALL OR USE THIS SOFTWARE, AND
YOU MUST PROMPTLY RETURN THE SOFTWARE TO THE LOCATION WHERE YOU
OBTAINED IT.

GRANT OF LICENSE:

This is a legal agreement between you, the end-user ("You"), and TOSHIBA TEC
Corporation ("TTEC") and its suppliers. This software, fonts (including their typefaces) and
related documentation ("Software") is licensed for use with the system CPU on which it
was installed ("System") in accordance with the terms contained in this Agreement. This
Software is proprietary to TTEC and/or its suppliers. TTEC and its suppliers disclaim
responsibility for the installation and/or use of this Software, and for the results obtained by
using this Software. You may use one copy of the Software as installed on a single System,
and may not copy the Software for any reason except as necessary to use the Software on a
single System. Any copies of the Software shall be subject to the conditions of this
Agreement. You may not, nor cause or permit any third party to, modify, adapt, merge,
translate, reverse compile, reverse assemble, or reverse engineer the Software. You may
not use the Software, except in accordance with this license. No title to the intellectual
property in the Software is transferred to you and full ownership is retained by TTEC or its
suppliers. Source code of the Software is not licensed to you. You will be held legally
responsible for any copyright infringement, unauthorized transfer, reproduction or use of the
Software or its documentation.

4
TERM:

This license is effective until terminated by TTEC or upon your failure to comply with any
term of this Agreement. Upon termination, you agree to destroy all copies of the Software
and its documentation. You may terminate this license at any time by destroying the
Software and its documentation and all copies.

DISCLAIMER OF WARRANTY:

This Software is provided "AS IS" without warranty of any kind, either express or implied,
including, but not limited to, the implied warranties of merchantability, fitness for a particular
purpose, title, and non-infringement. TTEC and its suppliers disclaim any warranty relating
to the quality and performance of the Software. If the Software proves defective, You (and
not TTEC or its suppliers) shall be responsible for the entire cost of all necessary servicing,
repair or correction. TTEC and its suppliers do not warrant that the functions contained in
the Software will meet your requirements or that the operation of the Software will be
uninterrupted or error free.

LIMITATION OF LIABILITY:

IN NO EVENT WILL TTEC OR ITS SUPPLIERS BE LIABLE TO YOU FOR ANY

DAMAGES, WHETHER IN CONTRACT, TORT, OR OTHERWISE (except personal injury or
death resulting from negligence on the part of TTEC or its SUPPLIERS), INCLUDING
WITHOUT LIMITATION ANY LOST PROFITS, LOST DATA, LOST SAVINGS OR OTHER
INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE
OR INABILITY TO USE THE SOFTWARE, EVEN IF TTEC OR ITS SUPPLIERS HAVE
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, NOR FOR THIRD PARTY
CLAIMS.

U.S. GOVERNMENT RESTRICTED RIGHTS:

The Software is provided with RESTRICTED RIGHTS. Use, duplication or disclosure by

the U.S. Government is subject to restrictions set forth in subdivision (b)(3)(ii) or (c)(i)(ii)of
the Rights in Technical Data and Computer Software Clause set forth in 252.227-7013, or
52.227-19 (c)(2) of the DOD FAR, as appropriate. Contractor/Manufacturer is TOSHIBA
TEC Corporation, 2-17-2, Higashigotanda, Shinagawa-ku, Tokyo, 141-8664, Japan

5
GENERAL:

You may not sublicense, lease, rent, assign or transfer this license or the Software. Any
attempt to sublicense, lease, rent, assign or transfer any of the rights, duties or obligations
hereunder is void. You agree that you do not intend to, and will not ship, transmit (directly or
indirectly) the Soft, including any copies of the Software, or any technical data contained in
the Software or its media, or any direct product thereof, to any country or destination
prohibited by the United States Government. This license shall be governed by the laws of
Japan or, at the election of a Supplier of TTEC concerned with a dispute arising from or
relating to this Agreement, the laws of the Country designated from time to time by the
relevant Supplier of TTEC. If any provision or portion of this Agreement shall be found to be
illegal, invalid or unenforceable, the remaining provisions or portions shall remain in full
force and effect. YOU ACKNOWLEDGE THAT YOU HAVE READ THIS LICENSE
AGREEMENT AND THAT YOU UNDERSTAND ITS PROVISIONS. YOU AGREE TO BE
BOUND BY ITS TERMS AND CONDITIONS. YOU FURTHER AGREE THAT THIS
LICENSE AGREEMENT CONTAINS THE COMPLETE AND EXCLUSIVE AGREEMENT
BETWEEN YOU AND TTEC AND ITS SUPPLIERS AND SUPERSEDES ANY PROPOSAL
OR PRIOR AGREEMENT, ORAL OR WRITTEN, OR ANY OTHER COMMUNICATION
RELATING TO THE SUBJECT MATTER OF THIS LICENSE AGREEMENT. TOSHIBA TEC
Corporation, 2-17-2, Higashigotanda, Shinagawa-ku, Tokyo, 141-8664, Japan

6
Introduction

This document describes the installation procedure, uninstallation procedure and the
features of the e-STUDIO Plug-in for OpenView Network Node Manager (OpenView NNM
hereafter) module. This module extends the ability of OpenView NNM to manage
e-STUDIO devices.

The plug-in extends OpenView NNM in the following five areas:

z Automatic Discovery
Automatically discovers e-STUDIO devices on your network and displays a TOSHIBA
icon on the IPMap.
z IPMap icon alert
The TOSHIBA icon displayed on the IPMap will change colors when the device is
having problems. Detailed device information is acquired using the TOSHIBA private
MIB and carefully weighted to warn the administrator only when the device is in real
trouble.
z Sub icons
The IPMap icons can be double clicked to display the category of the problem.
The administrator can see if it is a service call problem, consumable problem or a job
queue problem, without leaving OpenView NNM. The status will be periodically
updated.
z Jump to TopAccess
With a single click, OpenView NNM will launch the web browser and open the
TopAccess page, where the administrator can see more detailed information.
z Actual event message
Event messages are displayed in actual event names in the Event Browser.

These features will allow the administrator to quickly find a problem, run the initial diagnosis
from his/her desktop and understand the problem before he/she goes to the device. Which
will result in shorter down time.

This document assumes that you have a working knowledge and familiarity with OpenView
NNM. This document will only describe items related to the plug-in. Please see your
OpenView NNM manual for general information of OpenView NNM.

This module only supports OpenView NNM for Windows V7.51.

7
System Requirements

The OS platform must be Windows.

The PC or workstation to install this module must have OpenView NNM V7.51 installed and
running.
For hardware and platform requirements, comply with OpenView NNM requirements.

Package Structure

The distribution file is EsOV_win.zip.

The following files are included in the distribution file.
EsOV_win\
ReadMe.txt Readme file
OperationGuide_NNM.pdf This file
Setup.bat setup file
Plug-in\ folder containing the plug-in module

8
Installation Procedure

This section describes the procedure to install the plug-in:

1. Unzip the distribution file (EsOV_win.zip) on the PC to install the module.
2. Execute the following commands within OpenView NNM.
(1) Launch OpenView NNM.
(2) Select [Map] -> Properties.
(3) Select [IP Map] and execute [Configure For This Map].
(4) When prompted with the following message
“On-Demand: To What level should submaps be persistent?”
Select “All Levels”.
(5) Press the “OK” button.
3. Stop the OpenView NNM service.
To stop the OpenView NNM service, open the command prompt window and run the
following command from the command.
Change directory to OpenView NNM binary directory.
< OpenView NNM Installed Path>\bin> ovstop
Note: This can take several minutes.
4. Double click on the setup.bat file located in the EsOV_win folder you have unzipped.
A window will appear. Hit the Enter key to start setup.
5. Setup will copy the necessary files into appropriate locations.
6. Setup will display “done” and installation is complete.
Press any key to finish setup and close the window.
7. Restart the OpenView NNM service.
To restart the OpenView NNM service, run the following command from the command
prompt.
< OpenView NNM Installed Path>\bin> ovstart

Troubleshooting:

Error: Please Stop OpenView NNM Service!! Please press enter key to exit
If you run the setup.bat file while the OpenView NNM service is still running,
the above error message will be shown any the setup will stop.
Press the enter key to exit from setup. Stop the OpenView NNM service using the
ovstop command, before running the setup.bat file again.

9
e-STUDIO Setup

If you wish to view the e-STUDIO events in the OpenView NNM Event Browser, you need to
set each e-STUDIO to send the SNMP trap events to OpenView NNM.
This setup is required only if want to view each events. The IPMap and the sub icons
can be used without this setup.

The following procedure describes how to send SNMP trap events to your OpenView NNM
server.
1. Login to TopAccess as “Admin”
2. Go to “Network” setup.

3. Go to “SNMP” section.
4. Click on “SNMP” button to edit.

10
5. Enable Alerts trap and enter IP Address of the OpenView NNM host server.

Press “OK” and save the settings.

You must apply the above settings to all of the e-STUDIOs you wish to collect the events in
OpenView NNM.

11
Plug-in Features

This section describes the features added by the plug-in module.

Automatic Discovery

When an e-STUDIO device is found on the network, OpenView NNM will automatically
recognize the device as e-STUDIO and use the TOSHIBA icon to represent the device on
the IPMap.

Note: Immediately after the Plug-In is installed, OpenView NNM may fail to
update the icon and display e-STUDIO using a non Toshiba icon.
The icon will be corrected within a few minutes, but you can refresh the
icon immediately by the following operation:
(1)Select the icon on IPMap.
(2)Select from Menu [Fault] -[Connectivity]-[Poll Device].
(3)Demand Poll windows opens and poll begins.
(4)Close Demand Poll window with the Close button.

IPMap icon alert

The icon color on the IPMap represents the status of the device.
Green Device functioning.
Yellow Administrator attention required.
Red Device down or network unreachable.

Toshiba Private MIB information is used to obtain the device status and judge, when the icon
should change to yellow to ask for administrator attention.
Below are examples of when the device icon changes to yellow.

12
 Service call *1
Toner out (Pirate Toner Detected)
More than 15 jobs in queue
Paper related errors (Paper Jam, Paper out, Output bin full) do not change the icon color
because usually the end users can fix the problem and no administrator attention is
required.

*1 By changing the OpenView NNM settings, you can change the icon color to RED when a
service call occurs. However, this will change the entire OpenView NNM settings.

Sub icons

When the Toshiba icon is double clicked on the IPMap, the following window appears and
displays the status of four categories.

Network card: indicates the status of the network card.

Green: Device reachable.
Red: Device down or network unreachable.

Service Call: Changes color when Service Call is required.

Consumable: Changes color when consumables, such as toner

and staples needs to be supplied.

Queue: Changes color when more than 15 jobs are in queue.

The color-coding of the icons are as follows:

13
 Green: Functioning. No problems detected.
Yellow: Possible failure. Administrator attention required.
Red: Device not functioning.

Removing e-STUDIO icon from IPMap

The following procedure describes how to remove the e-STUDIO icon from the IPMap.
(1) Select the e-STUDIO icon to remove.
(2) From the menu, select [ESTools]-[Unmanage].
(3) From the menu, select [Edit]-[Delete Object]-[From All Submaps].
The icon will be removed.

14
Jump to TopAccess

When an e-STUDIO device is selected on the IPMap, “TopAccess” menu will be available
under the “Tools” menu. This will launch the web browser and open the TopAccess page
of the selected device.

Note:
When the TopAccess port number is changed by the administrator,
the “TopAccess” menu can open TopAccess using the correct port number.

15
Actual event message

When the SNMP trap messages are sent to OpenView NNM, the messages can be viewed
using OpenView NNM’s Event Browser. (e-STUIDO setup required. See, P5 for details)

Actual
The event message will have the following format:
MFP Trap: <AlertDescription>

Example event message output:

MFP Trap: Front Cover Open
MFP Trap: Staple Empty
MFP Trap: Black Toner is Empty
MFP Trap: Finisher Tray1 Stack Over
MFP Trap: Pirated Toner Bottle

The background color of the events indicates the severity of the event.
White: Information.
Yellow: Administrator attention required event.
Red: Device failure. Service Call required.

16
Uninstallation Procedure

This section explains the procedure to uninstall the plug-in.:

The procedure is shown as follows.
Please execute the DOS prompt screen by starting when you execute the command in
the procedure.

1. Backup execution of OpenView NNM.

OpenView NNM is backed up by using the backup command of the OpenView NNM
standard.
ovbacup.ovpl
* The file operation was mistaken according to the following procedures, the start and
operation became abnormal, and a wrong file was not able to be returned correctly. For
this case, it is possible to return it to the state of the point backed up by executing
Restoration command of the OpenView NNM standard to the file backed up.

2. The event setting is edited.

[Options]-[Event Configuration] Please execute the following operations from the
screen.
(1)"MFP" is selected from “Enterprise Name”.
(2)"MFPtrap2" is selected from “Event Name”.
[Edit]-[Event]-[Delete] Please press the button and delete it.
(3)[Edit]-[Enterprises]-[Delete] Please press the button, and delete "MFP" from
Enterprise Name.
(4)"ENTERPRISES" is selected from “Enterprise Name”.
(5)"MFPtrap4" is selected from “Event Name”.
[Edit]-[Delete]-[Event] Please press the button and delete it.
(6)"OpenView" is selected from “Enterprise Name”.
(7)"OV_MFPtrap_normal" is selected from “Event Name”.
[Edit]-[Event]-[Delete] Please press the button and delete it.
Similarly, please delete "OV_MFPtrap_minor" and "OV_MFPtrap_critical".
(8)Please execute [File]-[Save].

17
3. The polling watch service is stopped.
Please execute the following OpenView NNM standard commands, and stop the netmon
service.
ovstop netmon

4. All e-STUDIO icons for the watch are deleted.

Please delete all e-STUDIO icons for the watch from the map.

(1)The icon of the object is selected with the mouse, and [ESToos]-[Unmanage]is
executed.
(2)[Edit]-[Delete]-[From All submaps]is executed and the icon is deleted.

* It is necessary to delete information allocated by plug-in for exclusive use when

returning it to the watch only of OpenView NNM. Therefore, it is necessary to register
the e-STUDIO icon again.
Besides, OpenView NNM is uninstalled, and there is a method of the repeated
installation, too. However, please note that a necessary setting and registration should
be done again because everything returns to the initial state in this case.

5. The OpenView NNM service is stopped.

ovstop

6. The file operation is executed. * Refer to following "File operation procedure".

7. The OpenView NNM service is started.

ovstart

8. Start confirmation of OpenView NNM service.

If OpenView NNM starts normally, the file backed up according to procedure 1 is
unnecessary. It deletes and it doesn't care.

18
9. Change in environment variable of system.

(1)Select [MyComputer]-[properties].
(2)Select [Advanced].
(3)Select [Environment Variables].
(4)Select system variables:Path and execute [Edit].
(5)“<OpenViewNNM Installed Path>\bin\TMFP” is deleted.

10. It reboots a system.

19
File operation procedure:

It becomes a file operation under the control of < OpenView NNM installation directory >

1. Deletion of e-STUDIO icon image.

Please delete the following directories.
\bitmaps\C\vendor\toshiba-eS

2. Deletion of e-STUDIO icon type setting.

(1)Please edit the following files.

\conf\oid_to_type
:
<The following lines are deleted.>
#Setting e-STUDIO SysObjectId as TEC MFP
1.3.6.1.4.1.1129.2.3.17.2:Toshiba:MFP Agent:W # Toshiba MFP
1.3.6.1.4.1.1129.2.3.22.1:Toshiba:MFP Agent:W # Toshiba MFP
1.3.6.1.4.1.1129.2.3.22.2:Toshiba:MFP Agent:W # Toshiba MFP
:
1.3.6.1.4.1.1129.2.3.16.3:Toshiba:MFP Agent:W # Toshiba MFP
1.3.6.1.4.1.1129.2.3.16.1:Toshiba:MFP Agent:W #ToshibaMFP
<It ends here.>

(2)Please delete the following directories.

\conf\oid_to_sym_reg\001_ToshibaTec

3. Deletion of e-STUDIO symbol setting.

Please delete the following files.
\symbols\C\Device\Device_mfp
\symbols\C\Software\Software_mfp

4. Deletion of e-STUDIO device watch.

(1)Please execute the following commands.
ovdelobj < OpenView NNM installation directory >\lrf\mfppolling.lrf
(2)Please delete the following files.
\lrf\mfppolling.lrf

20
5. Deletion of e-STUDIO field setting.
(1)Please delete the following files.
\fields\C\tecmfp_field
(2)Please execute the following commands.
ovstart -c ovwdb
ovw -fields
ovstop

6. Deletion of e-STUDIO menu setting.

Please delete the following files.
\registration\c\topaccess
\registration\c\mfpManager
\registration\Japanese_Japan.932\topaccess
\registration\Japanese_Japan.932\mfpManager

7. Deletion of file related to e-STUDIO watch(module and installation file, etc.)

Please delete the following directories and files.
\conf\TMFP
\conf\trustedCmds.conf\TMFP
\bin\TMFP

R080720G2300-TTEC

Copyright 2007-2011 TOSHIBA TEC CORPORATION All rights reserved

21