Professional Documents
Culture Documents
1 Implementation
Student Exercises
S150-3036-00
September 2008
Copyright Notice
Copyright © 2008 IBM Corporation, including this documentation and all software. All rights
reserved. May only be used pursuant to a Tivoli Systems Software License Agreement, an IBM Soft-
ware License Agreement, or Addendum for Tivoli Products to IBM Customer or License Agreement.
No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system,
or translated into any computer language, in any form or by any means, electronic, mechanical,
magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corpora-
tion. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any
machine-readable documentation for your own use, provided that each such reproduction shall carry
the IBM Corporation copyright notice. No other rights under copyright are granted without prior writ-
ten permission of IBM Corporation. The document is not intended for production and is furnished “as
is” without warranty of any kind. All warranties on this document are hereby disclaimed, including the
warranties of merchantability and fitness for a particular purpose.
Note to U.S. Government Users—Documentation related to restricted rights—Use, duplication or
disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.
Trademarks
The following are trademarks of IBM Corporation or Tivoli Systems Inc.: IBM, Tivoli, AIX, Cross-Site,
NetView, OS/2, Planet Tivoli, RS/6000, Tivoli Certified, Tivoli Enterprise, Tivoli Ready, TME. In Den-
mark, Tivoli is a trademark licensed from Kjøbenhavns Sommer - Tivoli A/S.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in
the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
C-bus is a trademark of Corollary, Inc. in the United States, other countries, or both.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States,
other countries, or both.
Lotus is a registered trademark of Lotus Development Corporation.
PC Direct is a trademark of Ziff Communications Company in the United States, other countries, or
both and is used by IBM Corporation under license.
ActionMedia, LANDesk, MMX, Pentium, and ProShare are trademarks of Intel Corporation in the
United States, other countries, or both.
SET and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC. For fur-
ther information, see http://www.setco.org/aboutmark.html.
Other company, product, and service names may be trademarks or service marks of others.
Notices
References in this publication to Tivoli Systems or IBM products, programs, or services do not imply
that they will be available in all countries in which Tivoli Systems or IBM operates. Any reference to
these products, programs, or services is not intended to imply that only Tivoli Systems or IBM prod-
ucts, programs, or services can be used. Subject to valid intellectual property or other legally pro-
tectable right of Tivoli Systems or IBM, any functionally equivalent product, program, or service can
be used instead of the referenced product, program, or service. The evaluation and verification of
operation in conjunction with other products, except those expressly designated by Tivoli Systems or
IBM, are the responsibility of the user. Tivoli Systems or IBM may have patents or pending patent
applications covering subject matter in this document. The furnishing of this document does not give
you any license to these patents. You can send license inquiries, in writing, to the IBM Director of
Licensing, IBM Corporation, North Castle Drive, Armonk, New York 10504-1785, U.S.A.
Printed in Ireland.
Table of Contents
•
•
• I
•
•
Table of Contents
•
•
II • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 1
•
•
• 1-1
•
•
Student Exercises for Unit 1
•
•
1-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
___ 2. Copy the SMP folder in the same directory (c:\IBM) and rename it SMP2.
You will now update the maximo.properties file in the newly created Maximo
installation folder (SMP2) to reflect a second database (or Maximo instance) that
you will create in the next exercise.
c:\IBM\SMP2\applications\maximo\properties
mxe.db.url=jdbc:db2://localhost:50000/UDB02
mxe.db.url=jdbc:db2://localhost:50000/UDB02
•
•
2-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 2: Creating a Second Database Instance
___ 1. For the purposes of this exercise, create the directory c:\db2data2.
___ 2. Launch the DB2 Control Center by right-clicking the DB2 system tray icon and
selecting DB2 Control Center.
___ 3. From the All Systems folder, expand the plus (+) signs to go down the chain until
you see the Databases folder, which contains UDB01.
___ 4. Select the Databases folder. From the Tools menu of the Control Center, select
Command Editor.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 2: Creating a Second Database Instance
___ 5. Type or paste the following SQL code into the top pane of the Command Editor
tool to create a database named UDB02.
•
•
2-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 2: Creating a Second Database Instance
___ 6. Click the green triangle on the Commands tool bar to execute the query. This
process will take from 2 to 5 minutes to complete, depending on the performance
capabilities of your hardware.
___ 7. When the database creation process is completed, Exit the Command Editor.
___ 8. Refresh the Control Center view (View >> Refresh) and expand the All Systems
folder. Drill down to the Databases folder.
___ 9. Right-click the UDB02 database and select Stop to stop the database
(acknowledge the warning dialog box).
___ 12. From the Database Authorities dialog box, click Add User.
___ 14. Highlight the MAXIMO user and click Grant All.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-5
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 2: Creating a Second Database Instance
___ 1. Launch a Windows Command Prompt and enter the following commands:
cd \IBM\SQLLIB\BND
set DB2DBDFT=UDB02
db2cmd db2 connect to UDB02
___ 2. The DB2 command-line processor tool is launched. Enter the following
commands:
•
•
2-6 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 3: Run Maxinst Against DB2
3. Launch maxinst using the –t parameter (to specify tablespace) and the –s
parameter (to specify index storage area).
For example, at the command prompt, instead of typing maxinst, type maxinst -imaximo.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-7
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 4: Create a Second Application Server
This URL address uses the default port number (9060) and context (admin) for the
Administrative console.
___ 3. Enter any user name to log in, or just click Log in.
c:\IBM\WebSphere\AppServer\profiles\Custom01\bin
___ 6. At the prompt, type stopnode. Allow for the Node Agent to stop.
___ 7. Refresh the Servers page, by clicking the Application servers link and the icon
turns from an X to unavailable.
___ 9. Type MAM71Target in the Server name field and click Next.
___ 13. Before you save the new application, click Preferences from the Messages
window. The goal is to synchronize changes with nodes.
You synchronize changes with nodes when you have one Deployment Manager
and multiple application server custom profiles. For example, if you have
WebSphere spread over four machines, you would have one Deployment Manager
and four custom profiles. If you make a change and select Synchronize changes
with Nodes, the change will be replicated out to all of the profiles.
___ 14. Select Synchronize changes with Nodes, click Apply, and then click Save.
•
•
2-8 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 4: Create a Second Application Server
___ 16. Click the Servers >> Application Servers link on the left pane.
___ 18. Under Container settings, expand Web Container Settings, then click Web
container transport chains.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-9
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 4: Create a Second Application Server
___ 21. In Step 2, specify Port name as MAM71Target, Host as * (asterisk), and Port as
8888. Click Next.
___ 24. Allow for the synchronization to complete and click OK.
•
•
2-10 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 4: Create a Second Application Server
___ 25. Click the Application servers link in the left pane.
___ 27. Under the Server Infrastructure section, expand Java and Process
Management.
___ 29. Under the Additional Properties section, click Java Virtual Machine.
___ 30. Specify the following settings. Ensure to type these values, especially the Generic
Java argument. Do not copy/paste it into WebSphere.
There are no line breaks in the Generic Java argument settings. There is a space
after the 10000, followed by the dash (-) and so forth. Please type the entire
argument, do not copy/paste the string value.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-11
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 4: Create a Second Application Server
The value of this property represents the length of time (in milliseconds) that the
server-side RMI runtime will strongly refer to a remote object (or a reference to a
remote object). This elapsed time is returned from the current virtual machine as
part of the result of a remote method call. The time stops when it receives positive
acknowledgment from the client that the remote reference has been fully received
and processed. This time-out only applies to failure situations in which the client
fails to send the acknowledgment. Setting the value too low can increase the risk
of a remote object being prematurely garbage collected when the only known
reference to the remote object is the one in transit as part of the remote method
call result. The maximum value is Long.MAX_VALUE. The default value is 300
000 (5 minutes).
The second argument tells WebSphere to use the IPv4 stack as the default, rather
than both the IPv4 and the IPv6 stacks.
___ 33. In the left pane, expand Environment and then click Virtual Hosts.
___ 35. Type MAM71TargetSERVER as the virtual host name, and click OK.
___ 37. Click MAM71TargetSERVER from the main Virtual Hosts pane.
•
•
2-12 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 4: Create a Second Application Server
___ 40. Accept the default values (Host Name: * and Port: 80) and click OK.
___ 42. Change the port number to 8888 and then click OK.
Later in this paper, you will use port number 8888 in your browser to connect to
the Target environment.
___ 44. Click Save to save these changes and click OK.
The first alias is usually the port that the IBM HTTP Server is running on. The
second one is for the Web container port.
You have completed your middleware installation and configuration manually, without
using the scripts that are available to the middleware installer.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-13
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 5: Building the EAR Files
For the purposes of this exercise, you will build only the Maximo and the Maximo Help
EAR files.
___ 2. At the prompt, type buildmaximoear. After the maximo.ear file is built, type
buildhelpear.
Ignore the message that the tools.jar file was not found. It is of no consequence.
In the next section you will deploy these EAR files using the IBM WebSphere
Administrative Console.
•
•
2-14 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 6: Deploying the MAXIMO and MAXIMOHELP EAR Files
___ 1. From the WAS console, click Applications > Install New Application.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-15
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 6: Deploying the MAXIMO and MAXIMOHELP EAR Files
___ 4. From the Select Installation Options panel, change the Application name from
MAXIMO to MAXIMOTarget and click Next.
___ 5. From the Map modules to servers panel, complete the following sub-steps in the
exact order that they appear:
3
1
___ d. Scroll to the right and ensure that the Server column depicts:
•
•
2-16 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 6: Deploying the MAXIMO and MAXIMOHELP EAR Files
WebSphere:cell=vm100Cell01,node=vm100Node01,
server=MAM71Target
___ 6. From the Map virtual hosts for Web modules panel, select all three entries (just
one for the help EAR file).
___ 7. Select MAM71TargetSERVER from the Virtual host drop-down list for all
three Web modules and click Next.
___ 8. Click Finish in the Summary window to install the maximo.ear file.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-17
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 6: Deploying the MAXIMO and MAXIMOHELP EAR Files
___ 9. Wait for the successful deployment message and then click Save.
___ 12. From the Select Installation Options panel, change the Application name from
MAXIMO to MAXIMOHELPTarget and click Next.
___ 14. From the Map virtual hosts for Web modules panel, select enmaximohelp.war.
___ 15. Select MAM71TargetSERVER from the Virtual host drop-down list for all
three Web modules and click Next.
•
•
2-18 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 6: Deploying the MAXIMO and MAXIMOHELP EAR Files
___ 20. From the Servers section, open the Application servers link.
___ 21. Select the MAM71Target and MAM71Target application servers (check box)
and click Start. After 1 minute or so, the Status icon will change from an X to an
arrow.
___ 22. From the Applications section, open the Enterprise applications link. Note that
all four applications are displaying green arrows for their status icon.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 2-19
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 2
Exercise 7: Accessing the Second Start Center
___ 2. In the URL address bar, type http://vm100:8888/maximo and press Enter.
___ 2. In the URL address bar, type http://vm100:9999/maximo and press Enter.
The Maximo Workflow Designer requires a Java runtime environment™ (JRE™) 1.5.
You can obtain JRE 1.5 from the following Web site:
http://java.sun.com/javase/downloads/index_jdk5.jsp
In this exercise, you create a Service Request (SR) workflow process that automatically sets
the internal priority of a new SR. The process then places the SR into the Inbox of a Service
Desk manager. The manager reviews the SR and places it into the queue of a Service Desk
agent. The agent receives an automatic e-mail notification to take action based on the
queued SR.
You can launch the workflow process manually or automatically using Maximo workflow
infrastructure. When launched, the process examines the chosen SR record. If the record
has NEW status and its reported priority is 1 or 2, Maximo places the SR into the Service
Desk manager’s Inbox for review. After the manager has acted on the SR, the internal
priority of the SR is changed to 1. A notification is sent to the designated Service Desk
agent to work on the SR.
• Roles
• Actions
• Communication Templates
• Workflow
Later, in Unit 6, you will migrate this workflow from your Source environment to your
target environment that you created in Unit 2.
•
•
• 3-1
•
•
Student Exercises for Unit 3
Exercise 2: Creating Actions
– Value: :owner (You can use the lookup available for the Value field to select
the OWNER attribute of SR.)
•
•
3-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 3
Exercise 3: Creating Communication Templates
___ 2. Click the New Communication Template button to create a new communication
template.
– Template: MMNOTIF
– Applies To: SR
– Send From: maxadmin@us.ibm.com
– Subject: Service Request :ticketid is prioritized
– Message: Service Request :ticketid is set to internal priority
:internalpriority - please take action.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 3-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 3
Exercise 3: Creating Communication Templates
You must now activate the Recipients tab of the Communication Templates application
for the same template.
___ 5. Open the Roles section on the Recipients tab (the Expand icon is to the right).
___ 8. Select the check box to the left of the role record, and click OK to carry the value
to the Recipients tab.
___ 9. Select the To? field for the role record brought back to the Recipients tab.
___ 10. Click the Change Status button on the application tool bar.
___ 11. In the Change Status dialog box, change the status to ACTIVE.
•
•
3-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 3
Exercise 4: Creating a Workflow Process
___ 2. Click the New Process button to create a new workflow process definition.
___ 4. In the Process box, type MMWF. For Object, type SR.
___ 5. Click the canvas applet to activate it. The canvas already displays Start and Stop
nodes.
– Title: ISNEW
– Description: Is New Service Request?
– Expression: :status='NEW' (Type the colon before status and the single
quotation marks around NEW.)
___ 11. In the Condition Node properties, specify the following items:
– Title: ISHIPRT
– Description: Is High Priority Service Request?
– Expression: :reportedpriority <3 (Start with the colon.)
___ 14. In the Task Node properties dialog box, specify the following items:
– Title: 'QUESR'
– Description: Queue the Service Request
– Application: SR
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 3-5
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 3
Exercise 4: Creating a Workflow Process
Accept all other default values and then click OK to save the changes.
___ 15. Drag and drop positive connect lines (blue lines) between all the nodes on the
canvas. Similar to the image in the bottom of the next page.
___ 16. Drag and drop negative connect lines (red dashed lines) between the ISNEW
condition node, the ISHIPRT condition node, and the STOP node.
___ 17. Right-click the positive connect line between the QUESR task node and the
STOP node.
– Action: MMACT
Accept all other default values and click OK to save the changes.
•
•
3-6 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 3
Exercise 4: Creating a Workflow Process
You have now created a basic SR workflow process. The process checks SR records and
routes these records to a Service Desk manager for review and queueing to an agent’s SR
queue.
The workflow process can be launched manually or automatically using Maximo workflow
infrastructure. When launched, it examines the chosen SR record. If the record has the
NEW status and its reported priority is 1 or 2, the SR is placed into the Service Desk
manager’s Inbox for review. After the manager has acted on the SR, the internal priority of
the SR is changed to 1. A notification is sent to the designated Service Desk agent to work
on the SR.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 3-7
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 3
Exercise 4: Creating a Workflow Process
•
•
3-8 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
In this exercise, you will create a database object which will be used to create an
application. You will perform the following steps:
___ 1. Open the Domains application (Go To > System Configuration > Platform
Configuration > Domains).
___ 2. Click the Add New Domain button to display the following menu.
___ 3. Click to select Add New TABLE Domain. The TABLE Domain dialog box
opens.
Domain: CUASSET
•
•
• 4-1
•
•
Student Exercises for Unit 4
Exercise 1: Creating a Table Domain
Field Value
Object ASSET
Validation Where Clause assetnum=:assetnum
Organization EAGLENA
Site BEDFORD
___ 7. Click OK. The TABLE Domain dialog box closes, saving your values.
•
•
4-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 2: Creating an Object
___ 1. Open the Database Configuration application (Go To > System Configuration
> Platform Configuration > Database Configuration).
___ 2. Click the New Object button. A new object opens on the Object tab, ready for
editing.
Field Value
Object KNOWAPP
Description Knowledge Base for Work Orders
Note: You will not be able to change the Level to ORG or SITE until after the attributes are
created.
___ 5. Click the Attribute tab. The following attributes are automatically created.
KNOWAPPID INTEGER 12
DESCRIPTION ALN 50
DESCRIPTION_
LONGALN (CLOB) 32000
LONGDESCRIPTION
HASLD YORN 1
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 4-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 2: Creating an Object
___ 6. Use the New Row button to enter each of the following attributes.
ADDITEMS ALN 50
ASSETNUM UPPER 12
CREATEDATE DATETIME 10
KNOWNUM UPPER 12
OBSERVATIONS ALN 1024
ORGID UPPER 8
SITEID UPPER 8
USERCREATE ALN 50
Field Value
•
•
4-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 2: Creating an Object
Field Value
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 4-5
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 2: Creating an Object
Field
•
•
4-6 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 2: Creating an Object
___ 10. For the ORGID attribute, add the following values.
Field Value
___ 11. For the SITEID attribute, add the following values.
Field Value
___ 12. For the USERCREATE attribute, add the following values.
Field Value
___ 13. Save your record. Your display should look similar to the following example.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 4-7
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 3: Creating a New Index
___ 2. Click New Row in the Indexes section. A new row opens for editing.
___ 3. Enter the following values and then save your record.
Field Value
Index KNOWAPP_NDX1
Enforce Uniqueness? {Selected}
Field Value
Column KNOWAPPID
Sequence 1
Ascending? [Selected]
___ 5. Save your record. Your new index, KNOWAPP_NDX1 is ready to be configured.
•
•
4-8 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 4: Create New Relationships
For the index to take effect, you must reconfigure the database. You will do this
later.
Note: Indexes must contain at least one required field for best function.
You can drop an index by removing the data row the same way you remove any data row
throughout Maximo: by clicking the Trash button. The pending index to be dropped
receives a status of Delete, as shown in the following example.
The change will be identified and take effect pending configuration of the database.
• The DRILLDOWN relationship enables you to use the drilling down feature for
both assets and locations.
Field Value
Relationship KNOWASSET
Where Clause assetnum=:assetnum
Child Object ASSET
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 4-9
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 5: Configure the Database
Field Value
Relationship DRILLDOWN
Child Object DRILLDOWN
___ 5. Save your record. Your display should look similar to the following example.
___ 1. In the Database Configuration application, select Manage Admin Mode from
the Select Action menu (you need to be on the List tab). The Turn Admin Mode
ON dialog box is displayed. The default value is 5 for the Number of
Administrative Sessions Allowed and Number of Minutes for User Logout.
•
•
4-10 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 5: Configure the Database
___ 2. In the Number of Minutes for User Logout field, change the value from 5 to 1
minute.
___ 5. Click Turn Admin Mode ON. A System dialog box is displayed.
___ 6. In the Password field, enter maxadmin and in the Reason for Change field,
enter db change.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 4-11
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 5: Configure the Database
___ 9. To view the refresh status, after one minute, click Refresh Status. Your display
should look similar to the following example. A System dialog box is displayed.
___ 10. Click OK and close the dialog box. After you turn admin mode on, a message is
posted on the Bulletin Board of the product. The message informs users that they
should log out of the system.
___ 11. Click on the List tab. Select Apply Configuration Changes from the Select
Action menu. The Structural Database Configuration dialog box is displayed.
•
•
4-12 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 5: Configure the Database
___ 12. Select the Do you have a current backup? check box.
___ 14. In the Password field, enter: maxadmin and in the Reason for Change field,
enter: db change.
___ 17. Refresh your screen by clicking the List tab and pressing Enter in the Object
field. The Status column should not have a status indicated.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 4-13
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 4
Exercise 5: Configure the Database
___ 18. Select Manage Admin Mode from the Select Action menu.
___ 19. Click on Turn Admin Mode Off. A System message is displayed.
___ 20. In the Password field, enter: maxadmin and in the Reason for Change field,
enter: db change.
___ 23. Click Close. You are returned to the List tab.
•
•
4-14 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
In this exercise, you create a simple knowledge base application to capture asset
information. The new application uses the object created in the previous unit. You perform
the following tasks:
• Use the Security Groups application to allow users to access the new application.
___ 1. Open the Application Designer application (Go To > System Configuration >
Platform Configuration > Application Designer.)
___ 2. Click New Application Definition to insert a new application. The Create a New
Application dialog box opens.
Field Value
Application KNOWAPP
Description WO Asset KB
Key Attribute KNOWNUM
Main Object KNOWAPP
•
•
• 5-1
•
•
Student Exercises for Unit 5
Exercise 2: Signature Security Options
___ 4. Save the record. Your display should look similar to the following example:
.
A power application has at least two tabs: List and Main. The first tab is the
standard Maximo List tab. The Main tab automatically populates with text boxes
linked to the various attributes of the KNOWAPP object.
Note: The power application provides a generic application with a field for each attribute
in the associated database object. If you did not reconfigure the database after adding the
attributes, the attributes will not appear here.You can customize the layout of the
application by adding sections and controls. This exercise will not customize the layout.
___ 1. From the Select Action menu, select Add/Modify Signature Options.
•
•
5-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 3: Select Action Menu Items
___ 2. Click the View Details button for the various options, and verify the values.
Before adding a menu item to the Select Action menu, you create a signature security
option to associate it with the application as you did in the previous exercise. Select Action
menu items have a Position field property. The position property is a relative position and
not an absolute position.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 5-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 4: Toolbar Buttons
___ 1. From the Select Action menu, select Add/Modify Select Action Menu. The
Add/Modify Select Action Menu dialog box opens.
Before adding a toolbar button, you need to create a signature security option to associate
it with the application.
The Select Tool bar Button items have a Position field property. The position property is
a relative position and not an absolute position.
Complete the following steps to verify that toolbar menu items are part of your new
application.
___ 1. From the Select Action menu, select Add/Modify Tool bar Menu. The Add/
Modify Tool bar Menu dialog box opens.
___ 2. Verify the following information for the INSERT toolbar menu item.
Field Value
•
•
5-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 4: Toolbar Buttons
Field Value
___ 3. Verify the following information for the SAVE toolbar menu item.
Field Value
___ 4. Verify the following information for the CLEAR toolbar menu item.
Field Value
Field Value
Tabs MAIN
___ 5. Verify the following information for the AT2 toolbar separator.
Field Value
___ 6. Verify the following information for the PREVIOUS toolbar menu item.
Field Value
___ 7. Verify the following information for the NEXT toolbar menu item.
Field Value
•
•
5-6 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 5: Search Menu Items
Field Value
___ 8. Before you click OK, verify that your display looks similar to this screen capture.
___ 9. Click OK. The Add/Modify Toolbar Menu dialog box closes.
Before adding a menu item to the Search menu, you must create a Signature Security
option to associate it with the application. These have been created beforehand.
The Search menu has been created for you; so you will verify the settings.
Complete the following steps to verify the default Search menu items in your new WO
Asset Knowledge Base application.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 5-7
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 6: Modify the List Tab
___ 1. From the Select Action menu, select Add/Modify Search Menu.
The List tab holds Table Column controls. Table Column controls are always added to
the left of the current Table Column control.
___ 1. In the Application Designer workspace, click the List tab.The List tab opens in
the Workspace.
___ 2. Right-click the Table title, open the Properties dialog box, and enter the
following information.
Field Value
___ 3. Close the Table Properties dialog box and save the record.
•
•
5-8 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 6: Modify the List Tab
___ 5. To add a Table Column control, drag and drop a Table Column control onto the
Description control. The new table column will appear to the left.
___ 6. Open the Control Properties dialog box for the first Table Column control and
enter the following information.
Field Value
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 5-9
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 6: Modify the List Tab
Your Table Column control should look similar to the following example.
___ 8. Open the Control Properties dialog box for the second Table Column control
and enter the following information.
Field Value
•
•
5-10 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 7: Granting Access
Your Table Column control should look similar to the following example.
___ 9. Close the Table Column Properties dialog box. Your List tab should look similar
to the following example.
___ 1. Open the Security Groups application (Go To > Security > Security Groups).
___ 4. Using the Filter, find and select your Knowledge Base application. Your WO
Asset Knowledge Base application opens.
___ 5. Click the Grant Listed Options for This Application button. A dialog box
opens.
___ 7. Click the Grant Listed Applications button and select All Above.
Your display should look similar to the following example. (Notice that all the
check boxes are selected.)
___ 1. Sign out and sign back in for the security changes to take effect.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 5-13
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 5
Exercise 8: Verify Your Work
___ 2. From the Go To menu, select WO Asset KB from the Work Order module. Your
Knowledge Base application opens.
___ 3. Test the functions of your application by performing the following tasks, at a
minimum:
•
•
5-14 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Before going into the steps on how to define, create, and distribute a sample snapshot
package (all performed in the source environment), consider the following scenario.
You have created a Service Request (SR) workflow process that automatically sets the
internal priority of a new SR. The process then places the SR into the Inbox of a Service
Desk manager. The manager reviews the SR and places it into the queue of a Service Desk
agent. The agent receives an automatic e-mail notification to take action based on the
queued SR.
This workflow process definition with its constituent roles, actions, and communication
templates comprises the configuration changes that you want to migrate from source
environment to target environment.
This workflow scenario is not intended as a best practices approach. It serves as a simple
workflow example facilitating the exercises depicted for the Migration Manager
application in this lab.
• Workflow process
• Communication template
• Action
• Role
___ 2. From the Go To menu, select System Configuration > Migration > Migration
Groups.
___ 3. After the Migration Manager application opens, place the cursor in the List box
and press Enter. All of the available migration groups are displayed.
•
•
• 6-1
•
•
Student Exercises for Unit 6
Exercise 1: Organizing the Content
___ 4. Select and click the BPM (Business Process Management) entry. The Migration
Group tab opens, displaying the BPM object group.
The two sections are Migration Objects and Dependency. The first section, Migration
Objects for BPM, lists the migration objects (object structures) that are part of the BPM
group. These objects include:
• DMACTION
• DMACTIONGROUP
• DMROLE
• DMCOMMTEMPLATE
• DMESCALATION
• DMWFPROCESS
• DMINBOUNDCOMM
You chose the BPM group because the object structures of interest to you are already
members of the BPM group. In the current scenario, you have not built any escalation
(DMESCALATION), nor do you need to migrate any Email Listener configurations
(DMINBOUNDCOMM).
The second section, Dependency, lists other groups on which the BPM migration group is
dependent. This can be the case if you have put together a new custom application including
new BOs, domains, tabs, dialog boxes, and so on. However, this is not the case for this
scenario. All you need to migrate is a single workflow process and its constituent data.
Because no dependencies are required, you discard all the entries in the Dependency
section. You cannot change the migration groups shipped with the product (notice that they
are marked Internal), so you duplicate the BPM group.
•
•
6-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 1: Organizing the Content
___ 5. With the BPM group selected, click Select Action > Duplicate Migration Group
to duplicate the BPM group.
___ 7. In the Description field, type Workflow only. Accept the default order of 12
assigned to this new group.
___ 8. You can now remove the existing dependencies that were copied over from BPM.
Delete each dependency using the Delete icon to the right in the Dependency
section.
You are now left with just the object structures that are members of the MYBPM group.
You only need the DMACTION, DMROLE, DMCOMMTEMPLATE, and
DMWFPROCESS object structures. You do not need the DMACTIONGROUP,
DMESCALATION, or DMINBOUNDCOMMCFG object structures because you have no
changes in these areas.
You have created a migration group that you can use to migrate only workflow definitions
and related data without other data such as data dictionary or application.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 6-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 2: Defining the Migration Package
___ 1. From the Go To menu, select System Configuration > Migration > Migration
Manager.
___ 2. Click New Package Definition in the application toolbar to activate the Package
Definition tab.
___ 3. In the Package Definition Name field, type mmwf. Notice that the Source field
is automatically populated.
___ 4. Accept the default value of SNAPSHOT for the Type field and the default value
of 100 for the Batch Size field.
___ 6. Click the Detail Menu, and then click Select Value.
___ 7. From the Select Value dialog box, select MYBPM. After the value is returned to
the Migration Groups section, click the Save icon.
You now have included the newly created MYBPM group in a package definition. By
doing so, you are declaring that the content of the package contains workflow definitions
and related data.
The scenario calls for the migration of a workflow process and its related data. With the
current package definition, all workflow processes, roles, actions, and active
communication templates in the source environment will be brought into the physical
package during package creation. This is not the migration requirement. You need to filter
the package contents to just the specific MMWF workflow-related roles, actions, and so on
(see Appendix A). You can set up such a filter as part of the definition by completing the
following steps.
•
•
6-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 2: Defining the Migration Package
___ 8. Click the Set Where Clause icon to the right of the MYBPM entry in the
Migration Groups section. The resulting dialog box lists the migration objects
included in the MYBPM group.
In the next step, you attach a SQL Where condition to each migration object. This action
ensures that the physical package, when created, will contain only the MMWF workflow
process and related records.
___ 9. Select the DMACTION migration object. (The prefix DM means data
migration.) Click the SQL Expression Builder icon to the right of the row.
___ 10. From the SQL Expression Builder dialog box, select the Action attribute (click
the blue square).
___ 11. Type the ='MMACT' condition immediately following the Action attribute.
Include the equal sign and the single quotation marks surrounding MMACT. See
Appendix A regarding the user-defined MMACT condition.
By adding this WHERE condition, you have filtered action records to just the
MMACT action that is being used by workflow MMWF.
___ 13. Repeat steps 10 through 12 to set the remaining three attributes with specific
conditions that apply only to your MMWF process.
___ a. Click each main object from the Set Where Clause dialog box to display the
attributes that are specific to the main object.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 6-5
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 2: Defining the Migration Package
___ b. Select the attribute (for example, maxrole) from the SQL Expression
Builder dialog box.
___ c. Type the condition, with the quotation marks, exactly as shown in the
following table. The MMNOTIF, SDAGNT, SDMGR, and MMWF are
user-defined and are explained in Appendix A.
___ d. Click OK after assigning attributes and conditions to each migration object.
___ 14. Click the Change Status icon in the Migration Manager application toolbar.
___ 15. From the drop-down list of the Change Status dialog box, select Approved
Package Definition.
___ 17. From the Select Action menu in the toolbar, click Activate/Deactivate Package
Definition. You will notice that the Active check box to the right of the Package
Definition tab header area is now selected.
You have completed the tasks required to prepare for a physical package.
•
•
6-6 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 3: Creating the Migration Package
You can now visually verify the contents of the package definition using the Package
Definition Structure tab.
___ 18. In the Migration Manager application, click the Package Definition Structure
tab. A hierarchical view of your package definition is displayed.
___ 19. To verify the contents, drill down into the Migration Groups node of the
hierarchy. You will see that MYBPM is immediately under Migration Groups.
___ 20. Expand MYBPM and verify the individual migration objects within the group.
You can also open each migration object and verify each BO within the object.
This visual verification step helps you determine the total contents of any physical
package based on this definition.
For the purpose of this scenario, your target will be a folder on a file system. The file system
must be accessible to the application server where Maximo is executing. Later, you will
download this package to your client machine.
___ 1. In the Migration Manager application toolbar, click the Manage Targets icon.
___ 4. Enter or select Type as FILE, because you want to distribute the physical package
in the form of a file.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 6-7
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 3: Creating the Migration Package
___ 5. In the Database URL or File Path field enter c:\ (or other appropriate folder if
you have your own local Maximo build). The physical package file will be copied
to this folder upon distribution. This folder is accessible to the application server.
___ 6. Click OK to save this new target and close the Manage Targets dialog box.
You are now linking your approved package definition to the newly defined target. A
distribution is what links a package to a particular target.
___ 9. From the new row that is created, use the lookup on the Target Name field or type
Production.
___ 10. Click Save in the application toolbar to save this distribution record.
•
•
6-8 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 3: Creating the Migration Package
___ 11. In the Migration Manager application, click the Package tab.
Creating a package might take several minutes, depending on the volume of data
to be collected. Data collection (or export) is based entirely upon the package
definition. When you click the Create button, the Upload Compiled Sources
dialog box opens.
– To collect compiled sources that might be part of the package: You upload
compiled sources using this dialog box. Compiled sources are outside of the
database, and they might be class files or properties files that are included in
the EAR files.
– To enter read-me information regarding the particular physical package
that can be reviewed in a target environment before deployment: Because
you did not specify any compiled sources for your package, you can ignore
the Compiled Sources section.
___ 13. In the Read-Me Information field, enter text that describes the content of the
package. For example, enter Workflow artifacts for MMWF workflow
targeting Service Requests.
___ 15. Click OK when package creation is complete and the progress dialog box displays
the Done message.
When created, the Package tab refreshes to show the new package record. The Manifest
subtab below the Packages section shows the manifest for the package. Review the
manifest and look at the listing of various migration objects that now contain actual data for
the MMWF workflow process.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 6-9
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 4: Distributing the Migration Package
___ 1. In the Packages section of the Migration Manager application, click the
Distribute button to the right of the Create button.
___ 2. Indicate the target by selecting the box to the left of the Distribution row and
clicking OK.
Distribution is initiated. The progress dialog box opens, and messages are posted
to the dialog box as distribution progresses. When distribution is complete, the
dialog box displays a Done message.
You have now distributed the contents of the physical package to a file that currently is
located on the file system of the application server. You can, if necessary, download this
file to the client machine where you are working.
You also can download the package file to the client machine from where you are accessing
Maximo. Click the Download Package File icon to the right of the package record in the
Packages section of the Package tab.
Up to this point, you have completed all of the migration activities necessary in the source
environment. You started with the identification of changes to be migrated. You
determined the need to organize content and then defined a package that would serve as a
template for physical packages. You approved and activated the definition. After
associating a target with the definition, you created and distributed the package to the
chosen target.
___ 1. Open a new tab in your Mozilla or Internet Explorer 7 browser (or a new browser
window).
___ 4. From the Go To menu, select System Configuration > Migration > Migration
Manager.
___ 6. From the Upload Package box, click Browse and locate the package file that you
downloaded from the source environment.
___ 7. Select the package file. Click Open to bring back the folder and file information
into the Upload Package dialog box.
___ 8. Click OK in this dialog box to physically upload the package file into the test
environment.
___ 9. From the application toolbar, click the Deploy Package button. A pop-up dialog
box opens, displaying the newly uploaded package.
To begin deployment from the Deploy Package dialog box, you must first confirm that you
have a database backup in place. Remember that the Migration Manager cannot roll back
the package. If deployment fails, your only option to recover might be to restore your
database from a backup.
___ 10. Select the Do you have a current database backup? check box. Then click the
Deploy button.
___ 11. Enter the password for the currently logged-in user (wilson) and a memo into the
Reason for Change field. Click OK to proceed with deployment.
___ 12. Click OK after the deployment progress dialog box posts a Done message. When
you review the contents of the Package tab, you will see a row for the package
that you just deployed. It shows a status of DEPLOYED.
For this package, the deployment does not require you to log out or restart the application
server to see the changes take effect. Therefore, you can access the Workflow Designer
application and bring up the MMWF workflow process. You will see that the workflow is
laid out exactly as in the source environment. It is disabled and inactive. Now you can
validate this process, enable it, and activate it.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 6-11
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 6
Exercise 5: Deploying the Migration Package
•
•
6-12 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
The following list provides an overview an a brief explanation of the exercises in this unit:
This includes exercises 1 through 11. The main idea here is to create three
destination or queues for your transactions (messages in Java language). You
perform all this activities in the WebSphere application.
From the Assets Application, you make changes to an asset in the list.
You manually modify the outbound XML file, pretending that an external system
has made changes to the file (transactional changes, such as approved a PO) and
import that xml file into Maximo.
You have just been told your system will be configured with the Maximo Enterprise
Adapter interfacing with other products. You need to configure the Java Messaging System
(JMS) queues and rebuild the EAR file(s)
•
•
• 7-1
•
•
Student Exercises for Unit 7
Exercise 1: Create a WebSphere Messaging Resource (Bus)
http://vm100:9060/ibm/console
___ 2. Security is not enabled so you can enter any username or just click enter.
___ 4. Ensure that the Synchronize changes with Nodes option is selected, and then
click Apply.
___ 5. Click Service Integration > Buses to open the Buses dialog.
___ 6. A bus is a group of interconnected servers and clusters that have been added as
members of the bus. Click New to open the Buses >New dialog box where you
can add a new service integration bus.
___ 7. Enter intjmsbus as the name of the new bus in the Name field.
___ 10. Click Save. This step propagates the JMS bus setup to the cluster configuration.
Confirm that build completed screen displays the following:
___ 1. From the WebSphere® Administrative Console, click Service Integration >
Buses to open the Buses dialog box.
___ 2. Click intjmsbus to open the Buses > intjmsbus dialog box.
___ 4. In the Buses > intjmsbus > Bus members dialog box, click Add to open the Add
a new bus member dialog box.
___ 5. Click the Server drop-down arrow, and select the server name
vm100Node01:MAM71 to add to the bus, and then click Next.
___ 6. Ensure that the File store radio button is selected, and then click Next.
___ 7. From the Provide the message store properties panel, click Next.
___ 11. Click Service Integration > Buses to open the Buses dialog box
___ 13. Change the value of the High message threshold field to a minimum value of
500,000 messages, and then click Apply.
___ 14. If the number of messages awaiting processing exceeds the High Message
Threshold you set, the application server will take action to limit the addition of
new messages in the processing queues.
If you decide to change the High message threshold setting after the initial
configuration, open the Additional Properties menu in the Administrative Console
and change the threshold value for each child configuration.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 3: Create the Service Integration Bus Destination for the Continuous Inbound (CQINBD) Queue
___ 2. Click intjmsbus to open the Buses > intjmsbus dialog box.
___ 3. Click Destinations under Destination resources to open the Buses > intjmsbus >
Destinations dialog box.
___ 4. Click New to open the Create new destination dialog box.
___ 5. Leave Queue checked as the destination type, and click Next to open the Create
new queue dialog box.
___ 6. Type CQINBD in the Identifier field and Continuous Queue Inbound in the
Description field, then click Next to open the Create a new queue for point-to-
point messaging dialog box.
Note: Queue names are case sensitive. Use all upper-case to specify queue names.
___ 7. Select the Bus Member pull-down and choose a server, such as
Node=vm100Node01:Server=MAM71 as the bus member that will store and
process messages for the CQINBD bus destination queue.
___ 9. Review your selections, then click Finish to complete the creation of the
CQINBD bus destination queue.
___ 10. Navigate to Buses > intjmsbus > Destinations, then click CQINBD to open the
configuration dialog box where you must make the following changes:
•
•
7-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 4: Create the Service Integration Bus Destination for the Sequential Inbound (SQINBD) Queue
This is the maximum number of times you want the system to process a failed
messaging attempt before forwarding the message to the exception destination.
___ 2. Click intjmsbus to open the Buses > intjmsbus dialog box.
___ 3. Click Destinations under Destination resources to open the Buses > intjmsbus >
Destinations dialog box.
___ 4. Click New to open the Create new destination dialog box.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-5
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 4: Create the Service Integration Bus Destination for the Sequential Inbound (SQINBD) Queue
___ 5. Leave Queue checked as the destination type, and click Next to open the Create
new queue dialog box.
___ 6. Type SQINBD in the Identifier field and Sequential Queue Inbound in the
Description field, then click Next to open the Create a new queue for point-to-
point messaging dialog box.
Note: Queue names are case sensitive. Use all upper-case to specify queue names.
___ 7. Select the Bus Member pull-down and choose a server, such as
Node=vm100Node01:Server=MAM71 as the bus member that will store and
process messages for the SQINBD bus destination queue.
___ 9. Review your selections, then click Finish to complete the creation of the
SQINBD bus destination queue.
___ 10. Navigate to Buses > intjmsbus > Destinations, then click SQINBD to open the
configuration dialog box where you must make the following changes:
This is the maximum number of times you want the system to process a failed
messaging attempt before forwarding the message to the exception destination.
•
•
7-6 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 5: Create the Service Integration Bus Destination for the Sequential Outbound (SQOUTBD) Queue
___ 2. Click intjmsbus to open the Buses > intjmsbus dialog box.
___ 3. Click Destinations under Destination resources to open the Buses > intjmsbus >
Destinations dialog box.
___ 4. Click New to open the Create new destination dialog box.
___ 5. Leave Queue checked as the destination type, and click Next to open the Create
new queue dialog box.
___ 6. Type SQOUTBD in the Identifier field and Sequential Queue Outbound in the
Description field, then click Next to open the Create a new queue for point-to-
point messaging dialog box.
Note: Queue names are case sensitive. Use all upper-case to specify queue names.
___ 7. Select the Bus Member pull-down and choose a server, such as
Node=vm100Node01:Server=MAM71 as the bus member that will store and
process messages for the SQOUTBD bus destination queue.
___ 9. Review your selections, then click Finish to complete the creation of the
SQINBD bus destination queue.
___ 10. Navigate to Buses > intjmsbus > Destinations, then click SQOUTBD to open
the configuration dialog box where you must make the following changes:
This is the maximum number of times you want the system to process a failed
messaging attempt before forwarding the message to the exception destination.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-7
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 6: Create the JMS Connection Factory
___ 1. From the WebSphere® Administrative Console, click Resources > JMS >
Connection factories.
___ 4. Verify that the Default Messaging Provider is selected and click OK.
•
•
7-8 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 7: Create the Continuous Inbound (CQIN) JMS Queue
___ 1. From the WebSphere® Administrative Console, click Resources > JMS >
Queues.
___ 4. Verify that the Default Messaging Provider is selected and click OK.
– Name: CQIN
Note: Queue names are case sensitive. Use all upper-case to specify queue names.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-9
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 7: Create the Continuous Inbound (CQIN) JMS Queue
•
•
7-10 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 8: Create the Sequential Inbound (SQIN) JMS Queue
___ 1. From the WebSphere® Administrative Console, click Resources > JMS >
Queues.
___ 4. Verify that the Default Messaging Provider is selected and click OK.
– Name: SQIN
Note: Queue names are case sensitive. Use all upper-case to specify queue names.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-11
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 9: Create the Sequential Outbound (SQOUT) JMS Queue
___ 1. From the WebSphere® Administrative Console, click Resources > JMS >
Queues.
___ 4. Verify that the Default Messaging Provider is selected and click OK.
– Name: SQOUT
Note: Queue names are case sensitive. Use all upper-case to specify queue names.
•
•
7-12 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 9: Create the Sequential Outbound (SQOUT) JMS Queue
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-13
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 10: Create JMS Activation Specification for the Continuous Inbound Queue (CQIN)
___ 1. From the WebSphere® Administrative Console, click Resources > JMS >
Activation Specifications.
___ 3. Click New to complete the General Properties section for the new JMS activation
specification.
– Name: intjmsact
Note: Queue names are case sensitive. Use lower-case to specify queue names.
•
•
7-14 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 11: Stop and Start all WebSphere Application Server Services.
___ 1. Stop the MAM71 Application server from the WAS Console
C:\IBM\WebSphere\AppServer\profiles\Custom01\bin\stopNode
___ 4. Restart all three services in the reverse order: begin with the
vm100CellManager01, then the Node Agent, and finally the MAM71
application server.
___ 3. Type mxe.int in the Property Name field and press Enter.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-15
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 12: Setting System Properties
___ 7. From the Global Properties section, open the mxe.int.flatfiledelimiter property.
___ 8. For Global Value, enter the pipe sign on your key board (|). It is beneath your
Backspace button.
•
•
7-16 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 12: Setting System Properties
___ 10. Check the check boxes of both properties: mxe.int.globaldir and
mxe.int.flatfiledelimiter.
___ 11. From the Select Action menu, click Live Refresh.
___ 12. From the Global Properties section, open the mxe.int.webappurl property (you
may need to advance to the next page of Global Properties).
___ 13. Specify the correct URL on the Global Value field. In this case, change the port
number to 9999 (ensure the colon is included).
___ 15. Check the check box of the mxe.int.webappurl Global Property.
___ 16. From the Select Action menu, click Live Refresh.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-17
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 13: Configuring Cron Task
___ 1. Place your cursor in the Cron Task list box and press Enter.
___ 3. Open the SEQQIN instance name and change the schedule to 10 seconds.
___ 4. Open the SEQQOUT instance name and change that schedule to 10 seconds.
___ 5. Check the Active check boxes for both Cron Task Instance Names.
___ 2. In the Consumed by field to the right, type integration and press Enter.
•
•
7-18 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 14: Enable Integration Components
The source objects for MXASSET, define the content of MXASSET object
structure.
___ 4. From the Select Action menu, click Generate Schema/View XML.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-19
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 15: Publish Channels
___ 2. Place your cursor in the Publish Channel field and press Enter.
___ 4. From the Select Action menu, click Enable Event Listener.
•
•
7-20 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 17: External Systems
___ 7. Note that the End Point value in the top left (under System) is MXXMLFILE.
There is no need for further action in this application, merely a visual verification.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-21
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 19: Test an Inbound Transaction
___ 6. Using Windows Explorer, From the C:\temp folder, open the
EXTSYS1_MXASSETInterface_<12.....>.xml file with Note pad.
___ 1. Using your text editor make the following changes to the XML file:
___ b. Repeat the same change for the closing tag in the bottom of the file.
•
•
7-22 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 20: Importing Inbound Data
___ c. Change the content of the Description tag from Outbound to Inbound test.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 7-23
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 7
Exercise 20: Importing Inbound Data
___ 10. Uncheck the Use Continuous Queue check box in the bottom right corner.
___ 13. In the Data Import dialog box, use the Browser button to navigate to c:\temp and
import the XML file.
___ 16. Open Assets and note the new description: Inbound test.
•
•
7-24 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
• Configure BIRT
In this exercise, you will create a public query for use with a Start Center portlet.
___ 3. Open the More Search Fields dialog box (Advanced Search > More Search
Fields).
Field Value
•
•
• 8-1
•
•
Student Exercises for Unit 8
Exercise 1: Create a Result Set Query
___ 6. To modify the result set so that it is in order by priority, open the Where Clause
dialog box (Advanced Search > Where Clause).
•
•
8-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 1: Create a Result Set Query
___ 7. At the end of the Where clause statement, type order by priority.
___ 9. To save the current query, open the Save Current Query dialog box (Save Query
> Save Current Query) and enter the following information.
Field Value
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 2: Modify the Start Center
___ 5. For all KPI Graph rows, click the Delete Row icon.
•
•
8-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 2: Modify the Start Center
___ 7. To edit the Result Set portlet, click the Edit icon. In the Display Name field, type
RSDemo.
The Column Display tab shows the Query Column and Description columns.
.
– Status
– Priority
– Reported Date
– Description
___ 10. Click the Display Option tab. For the Condition Attribute field, use the Select
Value icon and select PRIORITY.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-5
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 3: Create a KPI
___ 11. Click Add Color Alert and enter the following alerts (click Add Color Alert,
each time that you want to add a new Expression).
Equal to 1 Red
Greater than or equal to 2 Purple
Greater than or equal to 5 Teal
The Start Center displays the RSDEMO result set by priority order and color.
In this exercise you will create a KPI using the KPI Manager application.
___ 1. Open the KPI Manager application (Go To > Administration > Reporting >
KPI Manager).
___ 2. Click the NewKPI icon and enter the following data.
Field Value
•
•
8-6 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 3: Create a KPI
Field Value
Caution At 550
Alert At 750
Is Public? [Selected]
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-7
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 4: Create a New Start Center Template
___ 5. Select Quick Insert from the Available Portlets dialog box and click OK.
– KPI List
– KPI Graph
– Bulletin Board
___ 8. Click Finished. The Start Center should look like the following example.
___ 9. Click the Edit Portlet icon to edit the Quick Insert portlet and select these
actions. You may need to type New Message in the description field and click OK
and do the same for New Person.
– New Message
– New Person
•
•
8-8 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 4: Create a New Start Center Template
___ 11. Click Finished. The Start Center should look like the following example.
___ 12. Edit the KPI List portlet. In the Display Name field, type My KPI.
___ 14. From the KPI list, select MYKPI (current # of logged-in users).
___ 15. Click OK and then click Finished. The Start Center should look like the
following example.
___ 16. Edit the KPI Graph portlet. In the Display Name field, type Work Order KPIs.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-9
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 4: Create a New Start Center Template
___ 20. In the tool bar of the New Template tab, click Save Template.
___ 21. Open the Security Groups application and retrieve the EVERYONE group.
___ 22. Using the Select Value icon, select My SC Template for your Start Center
Template.
___ 23. Save the record. The screen should look like the following example.
___ 24. Sign in to the system as user name stanley, password stanley.
•
•
8-10 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 5: Run a BIRT Report from Work Order Tracking
___ 25. Click the My SC Template tab. The Start Center should look like the following
example.
___ 2. Select the Work Order Details report. To do so, enter woprint.rptdesign in the
Report File Name text box and enter Work Order Details in the Description
field. Then click Enter.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-11
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 5: Run a BIRT Report from Work Order Tracking
___ 3. Click the link for woprint.rptdesign and change the following information.
Field Value
The Report tab detail screen will look similar to the following example.
•
•
8-12 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 5: Run a BIRT Report from Work Order Tracking
When the page is completed, you will see the following system message.
___ 7. Go to the Work Order Tracking application in the Work Orders module.
___ 8. Click into the Work Order text box and then press the Enter key (or click the
Filter Table icon [binoculars].
The system shows a list of work orders that are in the user’s default insert site.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-13
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 5: Run a BIRT Report from Work Order Tracking
Note: The default insert site is set by the administrator when a user record is
created. With permissions, the user can change this site using the Default
Information profile. The Site filter field can be cleared to see the sites that the user
has permission to access.
___ 9. Click the link for work order 1008 in the Work Order column. The selected
record opens on the Work Order tab.
Note: Most of the navigational links found on the Start Center (top of the screen)
are also available in applications.
•
•
8-14 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 5: Run a BIRT Report from Work Order Tracking
The dialog box opens a list of reports on the On Demand Reports tab.
___ 11. Click the Work Order Details link. The following screen is displayed.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-15
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 6: Generate All System Reports
___ 12. Click Submit. The Work Order Details report opens in a separate browser
window.
___ 1. Open the Report Administration application (Administration > Reporting >
Report Administration).
The system indicates that the request is being processed. The processing will take
a few minutes.
•
•
8-16 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 7: Set Application Security
___ 4. All reports available in the system are now ready for use. Click into the Report
File Name text box to view all available reports.
___ 3. Find and select the Job Plan List report (jobplan.rptdesign).
___ 4. On the Report tab, click Set Application Security from the Select Action menu.
___ 5. In the Report Application Security window, filter for the JOBPLAN application.
___ 8. In the Select Value window, click Planning, and then click OK.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-17
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 8: Install Eclipse and BIRT
___ 9. In the Details section of the Report Application Security window, Click BIRT
Reports, and then click OK.
___ 11. Click the Security tab, and verify that the Planning security group has been
granted access to reports for the Job Plan application.
___ 1. Using Windows Explorer, navigate to c:\Eclipse_dwnlds folder and ensure that
you have the following files:
– birt-report-framework-sdk-2.1.2.zip
– eclipse-SDK-3.2.2-win32.zip
– emf-sdo-SDK-2.2.2.zip
– GEF-SDK-3.2.2.zip
•
•
8-18 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 8: Install Eclipse and BIRT
New folder
Note: Extract the compressed files into c:\eclipse in the order that it is stated below.
Note: Use the right-click context menu and extract the compressed file to c:\eclipse. Files
will extract to c:\eclipse\eclipse. Your active directory will also be c:\eclipse\eclipse,
which is used throughout this course.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-19
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 8: Install Eclipse and BIRT
___ d. Extract the emf-sdo-SDK-2.2.2.zip file into c:\eclipse. (Click Yes to All if
the message appears.)
Tip: Except for the Eclipse SDK 3.2.2 compressed file, which must be extracted first, the
order in which the three remaining files are extracted does not matter.
If you do not have JDK 1.5 (5.0) installed, install an IBM-authorized version
(ibm-java2-sdk-50-win-i386.exe). This version is available to IBM employees
from JIM at http://w3.hursley.ibm.com/java/jim/jim/index.html.
Note: If you are using the IBM Tivoli Education developed image, the JDK is already
installed.
from:c:\ibm\smp\applications\maximo\maximouiweb\webmodule\
WEB-INF\birt\platform\plugins
to: c:\eclipse\eclipse\plugins
•
•
8-20 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 9: Configure the Environment for BIRT
c:\eclipse\\eclipse\plugins\org.eclipse.birt.report.viewer_2.1.2.v20070205-
1728\birt\WEB-INF\
from: c:\IBM\SMP\reports\birt\scriptlibrary\classes\com
to: The new classes folder you created in the previous step
from: c:\IBM\SMP\reports\birt\scriptlibrary\classes\
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-21
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 9: Configure the Environment for BIRT
to: c:\eclipse\eclipse\plugins\org.eclipse.birt.report.viewer_2.1.2.v20070205-
1728\birt\WEB-INF\classes\
___ 4. Open the newly copied mxdatasources.properties file and edit it for your local
configuration.
Notes: If you are using the IBM Tivoli Education developed image, use the values from
one of the following lists. Otherwise, you can find these values in the maximo.properties
file in c:\IBM\SMP\applications\maximo\properties.
• If you are using the IBM Tivoli Education image for MAM 7.1:
...//localhost:50000/UDB01
...username = maximo
...password = object00
• If you are using the IBM Tivoli Education image for CCMDB 7.1, connect to the
MAXDB71 database.
...//localhost:50005/MAXDB71
...username = maximo
...password = object00
• If you are using the IBM Tivoli Education image for SRM 7.1, connect to the
MAXDB71 database.
..//localhost:50005/MAXDB71
...username = maximo
...password = object00
• If you are using the IBM Tivoli Education image for TAMIT 7.1, connect to the
MAXDB71 database.
..//localhost:50005/MAXDB71
...username = maximo
...password = object00
•
•
8-22 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 9: Configure the Environment for BIRT
from: c:\IBM\SMP\applications\maximo\lib\
to: c:\eclipse\eclipse\plugins\org.eclipse.birt.report.viewer.2.1.1.v20070205-
1728\birt\WEB-INF\lib\
Note: If you are using the IBM Tivoli Education developed image, you will need the DB2
drivers: db2jcc.jar and db2jcc_license_cu.jar.
For example:
after c:\eclipse\eclipse\eclipse.exe
Do not copy and paste from this document; type the parameters.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-23
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 10: Configure BIRT
___ 4. Click the Use this as the default and do not ask again check box.
___ 6. After Eclipse opens, click File > New > Project.
___ 7. Expand the Business Intelligence and Reporting Tools section and click Report
Project. Click Next.
___ 9. If prompted, click Yes and open the Report Design perspective.
___ 11. In the Preferences window, expand Report Design and click Resource.
___ 17. Clear the Generate Comment check box and click Apply.
___ 20. Under Business Intelligence and Reporting Tools, click Report Project, and then
click Next.
___ 21. Enter a new project name and clear the Use Default Location field.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 8-25
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 8
Exercise 10: Configure BIRT
•
•
8-26 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 9
Follow these steps to create a separate appender that directs output to a log file specifically
for Reporting.
___ 1. From the Go to menu, select System Configuration >> Platform Configuration
>> Logging and open the Logging application.
___ 2. From the Select Action drop-down list, select Manage Appenders.
• Appender: Reporting
•
•
• 9-1
•
•
Student Exercises for Unit 9
Exercise 2: Modify a Logger to Use an Appender
Follow these steps to modify the appropriate logger to use this appender.
___ 1. From the Logging application, In the Root Loggers table window, find and select
the report root logger.
___ 2. In the Loggers table window, find and view details for the birt logger.
___ 5. Click the Manage Appenders button for the Appenders field.
___ 6. In the Manage Appenders dialog box, click to select the Reporting appender.
___ 7. Change the Log Level field to DEBUG (you select DEBUG instead of ERROR,
so that informational log statements are written into the log file).
___ 8. Click to select the Active? field. (Ensure that the reporting root logger is
reactivated.)
___ 1. In the logging application, from the Select Action menu, select Set Logging Root
Folder.
•
•
9-2 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 9
Exercise 4: Generate Request Page
___ 1. From the Go to menu, select Administration >> Reporting >> Report
Administration and open the Report Administration application.
___ 2. In the List tab, place your cursor in the Report File Name field and press Enter.
___ 5. Once the request page has been generated, click Close in the System Message
box.
•
•
©Copyright IBM Corp. 2008 IBM Tivoli Maximo Asset Management 7.1 Implementation • 9-3
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Student Exercises for Unit 9
Exercise 5: Run Reports
___ 2. In the List tab, place your cursor in the Assets field and press Enter.
___ 3. Select the first asset in the list, 7500 (Standard Laptop Computer).
___ 4. From the Select Action Menu, click Run Reports (you may have to scroll down).
c:\Reporting_logs\maximo\logs\
•
•
9-4 • IBM Tivoli Maximo Asset Management 7.1 Implementation ©Copyright IBM Corp. 2008
•
•
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.