621 mx install bea814 win [rexonavn.com]

Upload: nitish-narayan

Post on 05-Apr-2018

232 views

Category:

Documents


0 download

TRANSCRIPT

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    1/110

    Release 6.2.1

    Installation Guide

    Microsoft Windows | BEA Weblogic

    IBM Maximo

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    2/110

    S e c o n d E d i t i on ( J a n u a r y , 20 08 )This edition ap plies to version 6, release 2, modification 1 of IBM Maximo and t o all subsequ ent relea ses an d

    modifications until otherwise indicated in new editions. This edition replaces any previous edition of this

    document.

    C o p y r i g h t I n t e r n a t i o n a l B u s i n e s s M a c h i n e s C o r p o r a t i o n 2 0 08 . Al l r i gh t s r e s e r v e d .

    US Government Users Restr icted Rights - Use, duplication or disclosure restr icted by GSA ADP Schedule

    Contr act with IBM Corp.

    N o t e Before usin g this inform at ion an d th e product it support s, read th e inform at ion in Notices on page Notices-1.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    3/110

    Copyright IBM Corp. 2008 ii i

    Abo u t Th is Gu id e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v

    Audien ce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

    Rela ted Docum entat ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

    IBM S up port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

    Ch a p t er 1: In t r od u cin g I BM M a xim o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

    Over view of Inst alla t ion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

    In terne t Conn ectivit y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

    Over view of Concept s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

    How Does Ma ximo Ru n in an Applicat ion Ser ver ?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

    Single Ma ximo Applicat ion Deployed in a Single Application S erver . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 -4

    Maximo Comp onen ts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

    Applicat ion Se rver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

    Actu at e Ser ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 -5

    Da ta base Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

    Typical Ma ximo Configurat ion Dia gra m . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-6

    Ha rd war e an d Softwar e Consider at ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

    Th ird -Pa r ty P roduct Upda te s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8

    J ava Virt ua l Machin e (J VM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8

    Ch a p t er 2: In st a llin g B E A Web Lo gic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

    In st allin g BE A WebLogic 8.1.4.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

    Configurin g th e Ma ximo Applica tion Ser ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

    In st alling t he L icense Upd at e P rogra m . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14

    Post I ns ta llat ion t as ks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17Ed it t he commE nv F ile (Oracle Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-17

    In creas ing t he J ava Hea p P ar am eter s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18

    Verify Settin gs by Run nin g sta rt WebLogic.cmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-19

    Sta rt ing the Ser ver Without Being Pr ompt ed for Usern am e and P assword . . . . . . . . . . . . . . . . . .2-20

    Ch a p t er 3: Ins ta llin g T h e Act u a t e Ap p lica ti on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

    Pre -Inst alla t ion P rocedu res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 -1

    Oracle Connectivit y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

    MS SQL Se rver Conn ectivit y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

    In st allin g Actu at e8 iSer ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

    Ch a p t e r 4: In st a lli n g M a xi m o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1St ar tin g th e Maxim o Inst alla tion P rogra m . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2

    Post In st alla t ion Ta sks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

    How to In clude t he or acleth in.jar File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

    How t o ena ble t he Applicat ion Des igne r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

    How to Modify Lan guage-specific J DBC Settin gs in Maximo for SQL Server Data base . . . . . . 4-6

    In st alling t he L an gua ge Ut ilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8

    In st alling t he Pr oduct E na blers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9

    Ch a p te r 5: Cr ea ti n g t h e Ma xim o S ch em a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

    Pr epa rin g Microsoft SQL Ser ver I ns ta nce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

    Set tin g up a S QL Ser ver Da ta base for Ma ximo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

    Prepa r ing Oracle Ins tan ce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

    Contents

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    4/110

    iv IBM Maximo: Installation Guide

    Data base Ch ar act er Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

    Verifying t he Ora cle In st an ce Requirem ent s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-6

    Ora cle In itia lization Pa ra met ers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7

    Crea t ing Ma ximo Ta blesp ace(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

    Crea tin g the Maxim o User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

    Crea te t he Maxim o Data base Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10

    Ch a p t er 6: Dep loy in g t h e E AR F ile s. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

    Ch ap te r 7: In st all in g Th e Actu at e E n cyclop ed ia for Max im o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

    Removing Corr up t Ch ar acter s from t he a cserverconfig.xml F ile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

    St ar tin g th e Actu at e iSer ver for Ma ximo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

    In st alling t he Actu at e In tegr at ion for Maxim o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

    Post In st alla t ion Ta sks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

    Im por tin g th e E ncyclopedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7

    Ch a p t er 8: Log gin g In t o Ma xim o St a r t Ce n t er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

    Maximo E nt erpr ise Adapt er User s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-2

    App en d ix A: Syst em Se r ve r Adm in ist r a t ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

    Crea tin g a Windows Ser vice for th e MAXIMOSE RVER Ser ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

    St ar tin g an d St opping th e MAXIMOSE RVER Ser ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

    St ar tin g an d St opping th e MAXIMOSE RVER Ser vice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

    Rem oving the App licat ion Ser ver as a S ervice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4

    St ar tin g th e Application Ser ver F rom a Comma nd P romp t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4

    St oppin g the MAXIMOS ERVER Ser ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

    App en d ix B : Con figu r in g J MS Op ti on s for ME A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

    Configur e J MS Opt ions for ME A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

    App en d ix C: En ab lin g J MS Con n ect ion Fa cto r y for MEA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

    E na ble J MS Connection F act ory for ME A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

    App en d ix D: Add in g Add it ion a l P r od u ct En a ble r s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .D-1Add Addit iona l Pr oduct En abler s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1

    App en d ix E : En a b lin g R ep or t s t o R u n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E -1

    E na ble Report s t o Run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E -1

    Not ices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . No t ic e s-1

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    5/110

    Copyright IBM Corp. 2008 v

    About This Guide

    This section explains h ow th is guide can help you t o use IBM

    Maximo

    . I talso provides informat ion a bout oth er IBM Corporation resour ces available to

    you, such as additional documentation and support.

    Audience

    This guide is intended for implementation analysts, support personnel, and

    system administrators who are installing Maximo for the first time.

    Related Documentation

    For more inform at ion about Max im o, refer to the following documentation:.

    Document Description

    IBM Maxim o Fi nan ce Man agers

    Guide

    Describes how IBM Maximo

    completes finan cial tr an sactions

    an d how to set u p general ledger

    accounts.

    IBM Maxim o Mult is it eAdm in is tra tors Gu id e

    Describes h ow to configur e IBMMaximo for a Multisite

    implementation.

    IBM Ma xim o On lin e H elp P rovides st ep-by-st ep pr ocedu res for

    Maximo a pplicat ions.

    IBM Max im o Reconcil ia tion Module

    Im pl em enta tion Gu id e

    Describes how to use t he IBM

    Maximo Reconciliation module to

    reconcile th e two types of

    informa tion t hat IBM Maximo

    maint ains a bout information

    technology (IT) assets: IT a sset da ta

    and deployed asset data .

    IBM M axim o Repor t Adm in is tra tion

    and Developm ent Gu ideDescribes how to use Actu at e to

    design an d adm inister IBM Maximo

    reports.

    IBM Maxim o S ys tem

    Adm in is tra tors Gu id e

    Describes dat abas e configura tion,

    security, and other administra tive

    level applicat ions an d ta sks.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    6/110

    IBM Support

    vi IBM Maximo: Installation Guide

    IBM Support

    IBM Software Su pport pr ovides assista nce with product defects.

    Before contacting IBM Softwa re Su pport, your compa ny mu st h ave an active

    IBM software maint enance contr act, and you mu st be a uth orized to submit

    problems to IBM. For informat ion about t he types of ma inten an ce cont ra cts

    available, see "En ha nced Support," in th e S oftware Su pport Han dbooka t

    techsupport.services.ibm.com/guides/services.html .

    Complete t he following steps t o cont act IBM Softwar e Support with a

    problem:

    1 Define the problem, gather background information, and determine theseverity of th e problem. For h elp, see "Cont acting IBM" in th e SoftwareSupport Handbooka t techsupport.services.ibm.com/guides/

    beforecontacting.html.

    2 Gather diagnostic information.

    3 Subm it your problem to IBM Softwar e Sup port in one of the followingways:

    a Online: Click t he R e p o r t p r o b le m s ta b on th e IBM Softwa re Supp ortsite: www.ibm.com/softwa re/support/probsub.htm l.

    b By telephone: For t he t elephone n um ber to call in your coun tr y, go toth e Cont acts page of the Software Support Handbook:

    techsupport .services.ibm.com/guides/cont acts.ht ml.

    If the pr oblem you su bmit is for a softwa re defect or for missing or inaccurat e

    docum ent at ion, IBM Support creat es an Auth orized Program Analysis Report

    (APAR). The APAR describes the problem in detail. Whenever possible, IBM

    Support provides a workaround tha t you can implement unt il the APAR is

    resolved a nd a fix is delivered. IBM pu blishes resolved APARs on th e IBM

    Support web site daily, so th at oth er user s who experience the sam e problem

    can benefit from th e same r esolution.

    IBM Maxim o Users Gu id e Pr ovides an overview of the Ma ximo

    end user a pplicat ions. It also

    describes how th e IBM Maximo

    applications int era ct with ea ch

    other.

    IBM Maxim o Work flowIm pl em enta tion Gu id e

    Pr ovides informat ion a bout h ow touse IBM Maximo to plan, design,

    build, test, implement, an d ma nage

    Work flow p rocesses.

    IBM Max im o E nterprise Adap ter

    (MEA) System Adm inistrator's

    Guide

    Describes h ow to configure a nd use

    th e IBM MEA.

    Document Description

    http://techsupport.services.ibm.com/guides/services.htmlhttp://techsupport.services.ibm.com/guides/beforecontacting.htmlhttp://techsupport.services.ibm.com/guides/beforecontacting.htmlhttp://www.ibm.com/software/support/probsub.htmlhttp://techsupport.services.ibm.com/guides/contacts.htmlhttp://techsupport.services.ibm.com/guides/contacts.htmlhttp://www.ibm.com/software/support/probsub.htmlhttp://techsupport.services.ibm.com/guides/beforecontacting.htmlhttp://techsupport.services.ibm.com/guides/beforecontacting.htmlhttp://techsupport.services.ibm.com/guides/services.html
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    7/110

    Copyright IBM Corp. 2008 1-1

    Maximo is a compr ehensive suit e of products a ll built on a single, common

    platform. It combines enhanced Enterprise Asset Management functionality

    with new service ma nagement capabilities tha t together improve th e

    effectiveness of asset m an agement str at egies.

    Maximo includes advanced IT a sset ma nagement, service man agement, an d a

    full-featu red service desk, all based on t he IT Infra str uctur e Librar y (ITIL)

    guidelines. Each product can be implemented separately as a stand-alone

    solut ion or r eadily deployed togeth er. The solution enh an ces asset

    ma na gement a nd en sur es service perform an ce of production, facility,

    tra nsportation and IT assets.

    Maximo consists of mu ltiple software ser vers th at you can eit her in sta ll on

    separ at e servers or th e same ph ysical server. Pr efera bly, use th e following

    dedicat ed servers: Applicat ion Ser ver, Actu at e Report Server a nd Dat abase

    Server.

    Overview of Installation

    Use t his guide t o inst all Maximo. Dur ing th is process you will complete th e

    following tasks in t he order th at they appear :

    1 Install BEA WebLogic application ser ver.

    2 Install the Actuate application server.

    3 Insta ll the Maximo system.

    4 Insta ll the language utilities program.

    5 Insta ll the Pr oduct Enabler program .

    6 Create t he Maximo schema.

    7 Deploy the Enterprise Application Archive (EAR) files.

    8 Inst all th e Actu at e En cyclopedia for Maximo.

    9 Log in to the Maximo Start Center.

    The following diagram illust ra tes th e software component s an d th e order in

    which you m ust insta ll these component s to obtain a su ccessful Maximo

    system inst allation:

    Introducing IBM Maximo

    1

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    8/110

    Internet Connectivi ty

    1-2 IBM Maximo: Installation Guide

    Installation Flow

    Internet Connectivity

    The inst allat ion of Maximo and its var ious component s requir e a valid and

    active connection t o the In ter net . Open port 8000 to ena ble the download of

    th e latest Maximo files.

    Overview of Concepts

    Maxim o appl ica ti on refers t o an inst an ce of Maximo. En ter prise Application

    Archive (EAR) files define what constitutes a Maximo application. You can

    ha ve mult iple Maximo applicat ions, in oth er words, mu ltiple deployed EAR

    files on one application server.

    An E AR file represent s a J ava 2 Ent erprise Edition (J2EE ) application

    th at you deploy in an application server. EAR files ar e stan dar d J ava ar chive

    files and ha ve the file extension . ear .

    An E AR file can cons ist of:

    Web Application Archive (WAR) files th at cont ain for exa mp le, JS P or

    HTML pages

    J ava E nt erpr ise Applicat ion (JAR) files tha t cont ain class files and oth er

    program ming code modules

    En ter prise J ava Bean (EJ B) files that cont ain class files

    IBM Corpora tion uses the ter m appli cation serverto refer to a J 2EE conta iner

    tha t pr ovides the infrastr ucture t o run business applications such as Maximo.

    BEA WebLogic is a commercial application server supported by Maximo.

    When you inst all Maximo, you creat e a new application server (in th e

    contain er sen se) for th e Maximo applicat ion itera tion with in BE A WebLogic.

    Install BEA WebLogic

    Configure the Maximo Application ServerInsta ll the Actuate 8

    iServer application

    Insta ll Maximo and

    Create the Maximo

    En cyclopedia for

    Maximo

    Log into Maximo

    Star t Center

    Chapter 2 Chapter 3 Chapter 4

    Chapter 5Chapter 6Chapter 7Chapter 8

    Perform post-installation task srelated software

    Schema

    Install the ActuateDeploy th e EAR

    files

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    9/110

    How Does Maximo Run in an Application Server?

    Introducing IBM Maximo 1-3

    Contextis th e na me t hr ough which you access a specific web applicat ion, su ch

    as Maximo deployed on an Applicat ion Server. Ma ximo has th e following

    contexts:

    /maximo Maxim o u se r in ter face

    /mbo Maximo busin es s objects

    /maximohelp Maximo h elp

    /a cweb Act uate

    /mea web ME A

    You access Maximo from t he br owser using t he /ma ximo context.

    For example, htt p://:/maximo. The char acter

    string ma ximo that appears a fter the port nu mber, is the Maximo context.

    How Does Maximo Run in an Application Server?

    The following points su mm ar ize how Maximo is set up t o ru n in a n a pplicat ion

    server:

    The E AR files are creat ed from th e cont ents placed on your local dr ive as

    par t of th e insta llation process

    The Ma ximo applicat ion consist s of th e following E AR files:

    ma ximo.ear for the Maximo application

    ma ximohelp.ear for th e Maximo Help applicat ion

    acweb.ear for th e IBM Actu at e Active Port al Integra tion applicat ion

    In order to ru n Maximo, you must deploy the Maximo applicat ion E AR

    files in th e application server.

    When Maximo applicat ion EAR files ar e deployed in th e Application

    Server, th e server m aint ains a copy of the EAR files int ern ally.

    The Maximo insta llation builds the E AR files based on the informa tion

    you pr ovided dur ing th e insta llation. Any configur at ion chan ges require

    you to rebu ild and redeploy the E AR files.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    10/110

    Single Maximo Appli cation Deployed in a Single Application Server

    1-4 IBM Maximo: Installation Guide

    Single Maximo Application Deployed in a SingleApplication Server

    You use your a pplicat ion ser ver softwa re t o deploy the E AR files that the

    Maximo installat ion p rogram builds. All thr ee EAR filesma ximo.ear,

    ma ximohelp.ear, a cweb.ear , compr ise a single Maximo applicat ion

    (MAXIMOSERVER).

    After you deploy the E AR files, a copy of each E AR file is saved in th e

    applicat ion server software folder str uctur e. The applicat ion server u ses this

    copy when ru nn ing an d does not access th e EAR files from th e Maximo root

    folder.

    The following diagra m depicts th e Applicat ion Server MAXIMOSERVER

    ru nn ing Maximo in BEA WebLogic on a single physical ser ver.

    Appl ication Server MAXIMOSERVER running Maximo in BEA WebLogic on a single physical server

    JSP Technology Maximo applications use JS P technology. An a pplicat ion ser ver, such as th eBEA WebLogic server, is used for accepting HTTP requests from client

    program s (web browsers) an d for r esponding in HTML cont ent .

    When a client requests a J SP page, the application server processes the J SP

    page, and the web server sends the r esult of the J SP pa ge in H TML content

    back to th e client. Refer t o the

    ht tp://java.sun.com/products/jsp/ index.html link for m ore inform at ion about

    J SP Techn ology.

    XML Technology Maximo applicat ions u ses XML files to render th e layout an d creat ion of theuser interface.

    EJB Technology EJ B technology ena bles rapid an d simplified developmen t of distr ibuted,tr an sactiona l, secur e and port able applicat ions based on J ava t echn ology.

    Additional Information If you have an a ctive Ann ua l Customer Ser vice Plan (ACSP) agreemen t withIBM Corpora tion, you can access th e IBM Tivoli Software Supp ort Online

    (eSupport ) website:

    http://www-306.ibm.com/software/sysmgmt/products/support/

    eSupport in cludes inform at ion on product releases, softwar e pat ches, an d

    docum enta tion upda tes. To crea te/access your support online a ccount , you will

    need your IBM Customer Nu mber (ICN).

    WAR files

    JAR files

    EJB Files

    WAR files

    WAR files

    J AR files

    maximohelp.ear

    acweb.ear

    maximo.ear

    The Maximo installation programbuilds the necessary EAR files

    MAXIMOSERVER

    The deployed EAR files are now

    accessed by BE A WebLogicDatabase

    Actua te iServer

    http://java.sun.com/products/jsp/%20index.htmlhttp://java.sun.com/products/jsp/%20index.htmlhttp://java.sun.com/products/jsp/%20index.htmlhttp://java.sun.com/products/jsp/%20index.htmlhttp://java.sun.com/products/jsp/%20index.htmlhttp://java.sun.com/products/jsp/%20index.html
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    11/110

    Maximo Components

    Introducing IBM Maximo 1-5

    Maximo Components

    The following section describes t he ser ver component s in a typical Maximo

    environment.

    Application Server

    Maximo is built u sing J 2EE (Ja va 2 En terp rise Edit ion) technology, which

    requir es us ing a comm ercial applicat ion ser ver. Maximo uses BEA WebLogic

    8.1.4 as it s application server.

    The Applicat ion Server consists of Maximo Applicat ions using J avaSer ver

    Pa ges (JSP ), XML, an d Ma ximo applicat ion specific business component s.

    The Maximo Application also insta lls th e Active Port al, which ena bles you to

    use t he Web to access report s in your En cyclopedia volume a nd t he

    Mana gement Console. This web-based capability fur th er ena bles you to

    deploy an d t est r eports on a n En cyclopedia volum e. You access report s by

    using a Web browser (Int ern et E xplorer ) to access th e En cyclopedia volum e

    th rough Active Porta l.

    Actuate Server

    As pa rt of Maximo, Actuat e is offered as t he em bedded report ing tool.

    Actu at es Informa tion Delivery Solut ion en ables you t o crea te, ma na ge, and

    deliver in ter active, actionable cont ent .

    However, it is your option wh eth er or not t o use Actu at e as your Maximo

    Report ing tool. As you perform th e Maximo insta llation (Cha pter 4), if you do

    not choose to use Actu at e, you simply skip th e Actu at e references and

    continu e completing the Maximo insta llation program.

    If you do choose to u se Actu at e, preferably, inst all th e Actu at e iServer on a

    separat e server on th e network. It generat es and m ana ges report document s

    an d provides:

    A server-based system to gener at e, ma na ge, an d deliver intera ctive,

    actionable electr onic report s

    Informat ion in m ultiple form at s including DHTML, PDF , XLS

    Open securit y folder int egrat ion t o leverage existing e-business plat formsecur ity service

    Database Server

    Maximo for BE A WebLogic su pport s:

    Ora cle 9.2.0.6 (9i), or 10.1.0.3 (Stan dar d or E nt erpr ise Edit ion)

    Microsoft SQL Server 2000 SP3

    Microsoft SQL Server 2005

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    12/110

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    13/110

    Hardware and Software Considerations

    Introducing IBM Maximo 1-7

    Table 1 lists h ardwar e an d software recommenda tions (server and workst ation)

    For addit iona l tun ing and configur at ion inform at ion, refer to th e IB M Max im o

    S ystem Adm inistrators Guide.

    D e d ica t e d Se r ve r s H a r d w a r e Soft w a r e

    Appl ica t ion

    S e r v e r : where you

    install BE AWebLogic Server

    24 dedicat ed, Intel Pentium

    processors

    2GB RAM per p rocessor

    1.5GB of disk spa ce

    Microsoft Windows 2000 Ser ver

    Microsoft Server 2003

    BE A WebLogic 8.1.4

    D a t a b a s e S e r v e r : Refer to vendor sp ecifications 9.2.0.6, or 10.2.0.2 server softwa re

    (either Ora cle Standar d or Ent erprise)

    MS SQL Server 2000 SP3

    MS SQL Server 2005

    Ac t u a t e i S e r v e r :

    the server you plan to

    use for generating

    reports

    12 dedicated, Intel Pentium

    processor

    1GB RAM per p rocessor

    610MB of disk sp ace

    Microsoft Windows 2000 Ser ver

    Microsoft Server 2003

    Actu at e 8 iServer

    Database client software:

    Ora cle Client Softwa re (Oracle J DBC

    drivers, SQL*Plus, Ora cle

    Networking)

    MS SQL S erver 2000/2005 Client

    (ODBC)

    A d m i n i s t r a t i v e

    W o r k s t a t i o n where you install

    Maximo

    Used for application

    buildin g, work flow

    designer, Application

    designer, and other

    high-level functions

    Intel Pentium processor

    512 MB RAM

    SVGA 1024 x 768 resolut ion; if

    used for Application Designer

    1280 x 1024 resolut ion

    Microsoft Windows 2000/XP

    Professional

    Inter net E xplorer 6.0

    Maximo

    C li e n t Wo r k s t a t i o n Intel P entium processors

    512 MB RAM

    SVGA 1024 x 768 r esolution

    Microsoft Windows 2000/XP Pr ofessiona l

    Inter net E xplorer 6.0

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    14/110

    Hardware and Software Considerations

    1-8 IBM Maximo: Installation Guide

    Third-Party Product Updates

    IBM Corporation supports Maximo with later pr oduct updat es as t hey are

    released by thir d-part y vendors. Our policy is to validate products with t he

    latest t hird-par ty product upda tes at t ime of release cert ificat ion. IBM

    Corpora tion has certified the following third-par ty product upda tes:

    Windows 2000 Ser ver/Advanced Server Service P ack 4

    Windows XP Professional Service Pack 2

    Windows 2000 Professional Service Pack 4

    Int ern et E xplorer 6.0: Service Pa ck 1

    BE A WebLogic 8.1.4

    Ora cle 10.2.0.2 (Oracle Stan dar d or En ter prise)

    Ora cle 9.2.0.6 (Oracle Stan dar d or E nt erpr ise)

    Microsoft SQL Server 2000: SP3

    Microsoft SQL Server 2005

    Java Virtual Machine (JVM)

    The Maximo aut omat ic updat e program used in t he product installation

    requires a J a v a V ir t u a l Ma c h i n e (JVM) be inst alled and presen t on the

    Maximo server. If no JVM is present, th e install appears t o start and the load

    scroll bar climbs to 100% but t he inst all does not lau nch. You can download a

    tested JVM from the following location:

    http://java.sun.com/products/archive/j2se/1.4.2_07/index.html

    http://java.sun.com/products/archive/j2se/1.4.2_07/index.htmlhttp://java.sun.com/products/archive/j2se/1.4.2_07/index.html
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    15/110

    Copyright IBM Corp. 2008 2-1

    This chapt er explains h ow to perform th e following task s:

    In st all BE A WebLogic 8.1.4.0

    Configure t he Maximo Applicat ion Server

    Inst all th e BEA WebLogic License Upd at e program

    Post Installation ta sks

    Installing BEA WebLogic 8.1.4.0

    Complete t he following steps t o ins ta ll BEA WebLogic 8.1.4.0. For bes t

    perform an ce, insta ll BEA WebLogic Server on a dedicat ed app licat ion ser ver.

    1 Inser t th e BEA WebLogic Applicat ion CD-ROM in your CD drive an d fromth e root CD dir ectory, double clickserver814_win32.exe .

    2 The Pr epar ing t he insta ller dialog box opens, followed by th e Welcomedia log box. ClickNext .

    Installing BEA WebLogic

    2

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    16/110

    Installing BEA WebLogic 8.1.4.0

    2-2 IBM Maximo: Installation Guide

    3 Select Ye s an d clickNext .

    4 Select C r e a t e a n e w B E A H o m e option a nd a ccept t he default BEA

    Home Dir ectory (c:\ bea). ClickNext

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    17/110

    Installing BEA WebLogic 8.1.4.0

    Installing BEA WebLogic 2-3

    5 Select C u s t o m , as th e Inst all Type and clickNext .

    6Select only WebL ogic Se r ve r (includes Server an d Server examples) and

    deselect WebLogic Work shop. ClickNext .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    18/110

    Installing BEA WebLogic 8.1.4.0

    2-4 IBM Maximo: Installation Guide

    7 Accept th e default (c:\ bea\ weblogic81) inst allat ion locat ion an d clickNext .

    8 Select No to insta ll the Node Mana ger as a Service an d clickNext .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    19/110

    Installing BEA WebLogic 8.1.4.0

    Installing BEA WebLogic 2-5

    Allow th e insta llation progress bar to complete.

    9 Check the R u n Q u i c k s t a r t check-box. ClickD o n e .

    In a few seconds the Qu ickSt ar t window opens. Cont inue with th e next section

    to configur e t he Maximo Applicat ion Server.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    20/110

    Configuring the Maximo Application Server

    2-6 IBM Maximo: Installation Guide

    Configuring the Maximo Application Server

    You can also invoke the Configura tion Wizar d from t he Windows Sta rt men u:

    Sta rt > All Pr ogra ms > BE A WebLogic Plat form 8.1 > Configur at ion Wizar d.

    Complete the following steps.

    1 Click t he C r e a t e a n e w d o m a i n c o n f ig u r a t i o n link.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    21/110

    Configuring the Maximo Application Server

    Installing BEA WebLogic 2-7

    2 Select C r e a t e a n e w W e b L o gi c c on f i g u r a t i o n an d clickNext .

    3 Fr om th e Configurat ion Tem plate wind ow, select only Basic WebL ogicS e r v e r D o m a i n an d clickNext .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    22/110

    Configuring the Maximo Application Server

    2-8 IBM Maximo: Installation Guide

    4 Select C u s t o m an d clickNext .

    5 Type MAXIMOSERVER in th e Nam e field an d accept all other defaultvalues a nd clickNext .

    By defau lt, th e Listen P ort n um ber is 7001. You can specify a different

    port num ber or accept t he default value.

    Record this port n um ber on page 4-1. You will need it d ur ing Maximo

    installation.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    23/110

    Configuring the Maximo Application Server

    Installing BEA WebLogic 2-9

    6 Select No in t he Man aged Server s dialog box an d clickNext .

    Refer to th e IB M Max im o S ys tem Adm in is tra tors Gu id e if you wan t t o

    distr ibute your WebLogic configur at ion a cross ma na ged servers.

    7 Select No in t he Da ta base (JDBC) Options dialog box and clickNext .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    24/110

    Configuring the Maximo Application Server

    2-10 IBM Maximo: Installation Guide

    8 Consider th e following options before continu ing with th is step:

    If you h ave received the MEA Product Ena bler and plan t o implement t he

    MEA, you need to define th e requir ed J ava Message Service (J MS)

    Options at t his tim e. Select Yes , clickNext , and cont inue with

    Configur ing J MS Opt ions for ME A, on p age B-1. Details on th e MEA can

    be found within t he IBM Max im o E nterprise Adapt er S ys tem

    Adm in is tra tor' s Gu id e.

    However, If you have not r eceived th e MEA Product En abler or ar e not

    plann ing to implemen t t he MEA, select No an d clickNext to continu e

    with the next step.

    If you a re using t he MEA option,

    select Yes and continue with

    Appendix B.

    If you are n ot planning on u sing

    the MEA option, select N O

    and continue with the next step.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    25/110

    Configuring the Maximo Application Server

    Installing BEA WebLogic 2-11

    9 Specify a userna me an d a password. The userna me an d password m ust be8 char acters long. ClickNext .

    10 Select Ye s to create a St art Menu, and No to install th e server(MAXIMOSERVER) as a Windows Ser vice. ClickNext .

    See Appendix A about crea ting a nd r un ning MAXIMOSERVER as a

    Windows Ser vice.

    12345678

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    26/110

    Configuring the Maximo Application Server

    2-12 IBM Maximo: Installation Guide

    11 Accept the default values that appear in t he Build Star t Menu E ntr ies andclickNext .

    12 Select P r o d u c t i on M o d e and the Su n SDK 1.4.2_05 an d clickNext .

    Start Server

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    27/110

    Configuring the Maximo Application Server

    Installing BEA WebLogic 2-13

    13 Select MAXIMOSERVER as your t emplat e and clickC r e a t e .

    You can specify a d ifferen t configur at ion n am e inst ead of the defau lt

    mydomain . However, th is nam e cannotbe the sa me as t he Application

    Server na me (MAXIMOSERVER).

    14 Once the program has completed configuring MAXIMOSERVER, clickD o n e . Do notcheck th e Star t Admin Server check-box at t his tim e.

    15 Close the Qu ickSt ar t window.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    28/110

    Installing the License Update Program

    2-14 IBM Maximo: Installation Guide

    Congra tu lations, you ha ve insta lled and configur ed your Maximo Applicat ion

    Server. Continu e with t he n ext section t o inst all th e BEA WebLogic License

    Update program .

    Installing the License Update Program

    This pr ogra m creat es a valid license file so you can ru n Ma ximo with BE A

    WebLogic 8.1.4.0. To do so, comp lete th e following st eps:

    1 Fr om t he BEA WebLogic 8.1.4.0 CD r oot director y, double clickBEA814LicUpd56.exe.

    2 ClickNext in th e Int roduction dia log box.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    29/110

    Installing the License Update Program

    Installing BEA WebLogic 2-15

    3 Accept th e default WebLogic inst alla tion folder (c:\ bea) an d clickNext .

    4 ClickI n s t a l l in the Pre-Installation summary dialog box.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    30/110

    Installing the License Update Program

    2-16 IBM Maximo: Installation Guide

    5 ClickD o n e in t he In sta ll Complete dia log box.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    31/110

    Post Installation tasks

    Installing BEA WebLogic 2-17

    Post Installation tasks

    Complete th e following ta sks:

    Edit th e comm En v.cmd file (Ora cle Only)

    Increase the J ava heap param eters .

    Verify settings by r un ning st ar tWeblogic.cmd.

    Include user nam e and password t o start the MAXIMOSERVER

    automatically.

    Edit the commEnv File (Oracle Only)

    You must use th e Oracle th in drivers from the Maximo installat ion t o conn ect

    to Oracle 9i and 10g dat abases. In th is section, you edit t he comm En v.cmd file

    in the /bea folder, where you installed BEA WebLogic. later, in Post

    Inst allation Ta sks, on p age 4-5., after installing Maximo, you will copy the

    o r a c l e t h i n . j a r file from th e \ lib folder in Ma ximo to th e \ lib folder in BE A.

    Complete the following steps:

    1 Using Windows Explorer na vigat e to:

    :\ \ weblogic81\ comm on\ bin

    For example: C:\ bea\ weblogic81\ common\ bin

    2 Right -click a nd edit (do not d ouble-click) th e c o m m E n v . c m d file a sfollows:

    3 Using your t ext editor, search for c la s spa th=%java_home%

    4 Type th e following after th e equa l (=) sign:

    %WL_HOME%\server \lib\oraclethin.j ar;

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    32/110

    Post Installation tasks

    2-18 IBM Maximo: Installation Guide

    commEnv.cmd File

    This comm an d is case-sensitive

    5 Save a nd close the file.

    Increasing the Java Heap Parameters

    Complete th e following steps to set th e Ja va Heap pa ra meter s to impr ove

    performance.

    1 Using Windows Explorer na vigat e to:

    \bea\user_proj ects\domains\mydomain

    2 Open and edit the s t a r t w e b l o g i c . c m d file as follows:

    a Place your cursor at th e end of th e file

    b Search up for s e t se r v e r _n a m e

    c Ent er t he following paramet er exactly as st ated below un der t heSERVER_NAME para meter:

    set MEM_ARGS=-Xms512m -Xmx1024m -XX:MaxPermSize=256m

    These par am eters a re case sensitive. Include the m inus () sign before

    each param eter and the m after each value.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    33/110

    Post Installation tasks

    Installing BEA WebLogic 2-19

    startWeblogic.cmd File

    3 Save a nd close the file.

    Verify Settings by Running startWebLogic.cmd

    To ensur e tha t t he edits th at you m ade t o the above ment ioned WebLogic files

    were a ccurat e, complete th e following st eps:

    1 Fr om a comma nd pr ompt, change directory path to:

    \bea\user_proj ects\domains\mydomain

    2 Type s ta r tWebL ogic . cmd and press Enter.

    3 When prompted, type the u ser na me a nd pa ssword tha t you specified inStep 9 on page 2-11.

    Once the ph rase:""

    displays, the WebLogic Server is r un ning.

    Type this param eter exactly256m as it appears

    http://-/?-http://-/?-
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    34/110

    Post Installation tasks

    2-20 IBM Maximo: Installation Guide

    Starting the Server Without Being Prompted for Username andPassword

    If you are working in Pr oduction mode and do not want to be prompted for t he

    WebLogic user na me an d password, crea te a b o o t . p r o p e r t i e s file. Th is will

    store the usern ame a nd password in a n encrypted forma t.

    Pla ce the following t wo lines in a text file:

    username=

    password=

    The userna me an d password values must mat ch a n existing user account in

    th e Aut hent icat ion provider for th e defau lt secur ity realm, an d must belong to

    a role tha t ha s permission to start and st op a server.

    These ar e the sa me values th at you specified in Step 9 on page 2-11.

    If you sa ve th e file as b o o t . p r o p e r t i e s and locate it in th e mydomain folder(for example: c:\ bea\ user_projects\ domains\ mydomain), the server

    au tomat ically uses this file dur ing its subsequent s ta rt up cycles.

    The first time you use t his file to star t a ser ver, the server rea ds th e file an d

    then overwrites it with an encrypted version of the userna me an d password.

    For m ore informat ion, refer to BEA's docum ent web site at:

    http://e-docs.bea.com/wls/docs81/ConsoleHelp/

    startstop.html#BootIdentityFiles

    http://-/?-http://e-docs.bea.com/wls/docs81/ConsoleHelp/startstop.html#BootIdentityFileshttp://e-docs.bea.com/wls/docs81/ConsoleHelp/startstop.html#BootIdentityFileshttp://-/?-http://e-docs.bea.com/wls/docs81/ConsoleHelp/startstop.html#BootIdentityFiles
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    35/110

    Copyright IBM Corp. 2008 3-1

    If you ar e using Actu at e for r eport ing in Maximo, th is cha pter explains how toinsta ll the Actu at e 8 iServer applicat ion. If you ar e not going to use Actu at e,skip to Chapt er 4.

    Pre-Installation Procedures

    The following sections describe t he pre-insta llation pr ocedur es.

    Oracle Connectivity

    You mu st in sta ll the following Ora cle Client Softwa re on your Actu at e Server

    before inst alling Actu at e:

    Ora cle JDBC Drivers

    SQL*Plus

    Ora cle Net workin g (in Ora cle 9i or 10g)

    You must setu p an d test Or acle Networking conn ectivity to the Maximo

    database.

    You mus t a lso create a TNS na me for your Ma ximo conn ect st ring a s you will

    need th is informat ion in Step 10 on pa ge 4-2.

    Please review Oracle insta llation document at ion for fur th er deta ils. Ora cle

    docum ent at ion is available online a t ht tp://otn.ora cle.com/docum ent at ion/

    content.html.

    MS SQL Server Connectivity

    If your Actu at e application conn ects to Microsoft SQL Ser ver, you mu st insta ll

    Microsoft SQL S erver client software before inst alling Actu at e.

    You mu st a lso crea te a DSN n am e for your Ma ximo connect str ing as you will

    need th is informat ion in Step 10 on pa ge 4-2.

    Inst all th e following products:

    Microsoft SQL Server ODBC Drivers

    SQL Server Client N etwork Ut ility.

    Installing The ActuateApplication 3

    http://otn.oracle.com/documentation/content.htmlhttp://otn.oracle.com/documentation/content.htmlhttp://otn.oracle.com/documentation/content.htmlhttp://otn.oracle.com/documentation/content.html
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    36/110

    Installing Actuate8 iServer

    3-2 IBM Maximo: Installation Guide

    Installing Actuate8 iServer

    This section describes how to install Actu at e 8 iServer. For best perform an ce,

    insta ll Actuat e iServer on a dedicated ser ver.

    1 Log in to Windows as a us er with Administ ra tive rights.

    2 Inser t t he Actu at e 8 iServer for Windows CD-ROM int o the CD drive.Fr om t he \ iserver folder on your CD double-click t he s e t u p . e x e .

    3 ClickNext in t he Welcome dialog box.

    4 Accept th e ter ms of the License Agreement an d clickN e x t .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    37/110

    Installing Actuate8 iServer

    Installing The Actuate Application 3-3

    5 Select C u s t o m an d r ead th e following war ning before clicking Next .

    WARNING Defau lt value for t he Destina tion Folder is\ P r ogr a mF i le s \ Ac t u a t e 8 \ i se r v e r ; however, you m ust ensure t hat the Destinat ion

    Folder pat h does not h ave any spaces in the path nam e. For example

    c :\ Ac t u a t e 8 \ i se r v e r . ClickB r o w s e to select t he new pat h.

    6 Select all component s exceptSam ple Volume an d clickNext .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    38/110

    Installing Actuate8 iServer

    3-4 IBM Maximo: Installation Guide

    7 Select S t a n d - a l o n e an d clickNext .

    8 Click t he br owse but ton an d na vigat e to the locat ion of the xml file, in thisexample: Actuate_key_18802.xml. This file resides under t he r oot CD

    folder on your Actu at e R elea se 8 iS erver f or Win dows CD-ROM. Click

    Next .

    d:\Actuate_key_18802.xml

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    39/110

    Installing Actuate8 iServer

    Installing The Actuate Application 3-5

    9 Accept t he default valu es tha t a ppear in your Locale Informat ion dialogbox and clickNext .

    10 Enter a user that isin the Adm in is tra tor Grou p and ensure that bothcheck-boxes in t he Services P rofile fra me ar e checked. ClickNext .

    11 En ter th e following values in t he Ser ver Configura tion dialog box.

    P M D Co n f ig u r a t i o n . The Process Mana gement Da emon enables you to

    perform Administ ra tive tasks with in iServer, but does not conn ect to the

    Maxim o Encyclopedia Volum e.

    a The host nam e or t he IP address of the m achine where you ar einstalling Actuate iServer.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    40/110

    Installing Actuate8 iServer

    3-6 IBM Maximo: Installation Guide

    b Accept t he default port n um ber 8100.

    c i S e r v e r C o n f ig u r a t i o n . The iServer Configurat ion ena bles you t oconnect to the Maximo Encyclopedia Volume.

    d The host nam e or t he IP address of the m achine where you ar einsta lling Actu at e iServer (same as a bove).

    e Accept t he default port n um ber 8000.

    f ClickNext .

    12 Specify a pa ssword for your Actuat e adm inistr at or an d clickNext .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    41/110

    Installing Actuate8 iServer

    Installing The Actuate Application 3-7

    13 Select U s e t h e d e f a u l t v o lu m e and t ype the comput er na me or IPaddr ess. ClickNext .

    14 Select U s e t h e A ct u a t e E n c y cl op e d i a v o l u m e an d clickNext .

    Actuate

    host name host name

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    42/110

    Installing Actuate8 iServer

    3-8 IBM Maximo: Installation Guide

    15 En ter t he comput er na me where requested and accept th e default portnu mbers. ClickNext .

    16 Accept t he default HTTP port n um ber (8900), or specify an other p ortnu mber a nd clickNext .

    You open t he Actu at e Administr at ive console via a browser, using t his

    port number. For example: http://:8900/acadmin .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    43/110

    Installing Actuate8 iServer

    Installing The Actuate Application 3-9

    17 Accept th e default cont ext pa th (/acadmin ) or specify an other cont extna me an d clickNext . You open th e Actu at e Administr at ive Console via a

    browser, using th is context.

    For example: ht tp://:8900/a c a d m i n

    Record the port n um ber an d th e context pat h th at you crea ted. You will

    need t hese t o access th e Web-based Actu at e Administr at ive Console

    Step 12 on pa ge 7-8.

    The above two steps enable system a dmin istra tors to access, genera te, and

    ma na ge report s u sing Actu at es web-based console.

    18 Accept th e default values for th e program folder a nd clickNext .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    44/110

    Installing Actuate8 iServer

    3-10 IBM Maximo: Installation Guide

    19 ClickNext in th e Summ ar y dialog box.

    20 Allow for th e inst allation pr ogra m to copy all t he files.

    21 Close th e setu p.txt file.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    45/110

    Installing Actuate8 iServer

    Installing The Actuate Application 3-11

    22 Un check th e ReadMe check-box an d clickF i n i s h .

    23 Restart t he comput er.

    You ar e now ready t o inst all Maximo.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    46/110

    Installing Actuate8 iServer

    3-12 IBM Maximo: Installation Guide

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    47/110

    Copyright IBM Corp. 2008 4-1

    This cha pter explains h ow to inst all the Maximo applicat ion, the La ngua ge

    Utilities, and th e Product Ena blers pr ogram.

    Complete t he following worksh eet by recording cert ain n am es and va lues th at

    will help you during insta llation. The page and step nu mbers in t he r ight

    colum n of th e work sheet indicate wher e you n eed the r equested informa tion.

    Installing Maximo

    4

    Record the information here... Use the information here...

    Maximo-related

    Serial number Step 7 on pa ge 4-2

    Maximo install folder Step 8 on pa ge 4-2

    SMTP host nam e Step 11 on page 4-3

    Work flow administrator email Step 12 on pa ge 4-3

    Maximo administra tor email Step 12 on page 4-3

    Applicat ion server n am e Step 13 on pa ge 4-3

    Listen Port n umber Step 13 on page 4-3

    Database-related

    Database server nam e Step 10 on pa ge 4-2

    Database port n umber Step 10 on page 4-2

    Database Name Step 10 on pa ge 4-2

    Database/Schema owner Step 10 on page 4-2

    Database owner nam e and

    password

    Step 10 on page 4-2

    Actuate-related

    Actua te iServer nam e Step 16 on pa ge 4-3

    iServer port n umber Step 16 on page 4-3

    TNS (Or acle) or DSN (MS SQL

    Server) on t he Actu at e iServer

    Step 16 on page 4-3

    http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    48/110

    Starting the Maximo Installation Program

    4-2 IBM Maximo: Installation Guide

    Starting the Maximo Installation Program

    You insta ll Maximo ont o a Windows work sta tion designated a s th e Maximo

    Admin istra tion Work sta tion. This is where t he E nt erpr ise Archive (EAR) files

    ar e built and su bsequent ly deployed to th e applicat ion server.

    You use the Administr at ion Works ta tion to inst all progra m pat ches, product

    upgrades, or just ru nning Configure Database a nd similar u tilities in which

    case you mu st stop the ap plicat ion server from run ning.

    To install the Maximo Application, complete the following steps:

    1 Log in to Windows as Administrat or or a s a user with adm inistrativerights.

    2 Inser t t he Maximo inst allat ion CD-ROM int o th e CD drive.

    3 Fr om th e root CD drive, double-clickmaximo62 .exe .

    4 Select t he desired lan guage from th e drop-down list. Selecting a langua geonly changes th e insta llation screens int o th at la ngua ge but does not affect

    the underlying files tha t get installed.

    If your langua ge is not ava ilable from t he list, select E ngl i sh , an d click

    OK .

    If it is J apa nese or Chinese you m ust ha ve those fonts inst alled on your

    system.

    For an y selected langu age othertha n En glish, that you are installing

    on a S Q L S e r v e r dat aba se, you mu st perform certa in post-insta llation

    ta sks as described in Cha pter 9. This procedur e does not ap ply if you

    are u sing Oracle database.

    5 ClickNext in t he Welcome dialog box.

    6 Select t he a ppropriat e application server, in th is case, BEA WebLogic.

    7 Ent er th e serial num ber included in your Maximo license agreement a ndclickNext .

    8 Ent er th e nam e of the folder wh ere the installation pr ogram will insta llMaximo. The default value is C:\ Maximo. ClickNext .

    9 Select the appropriate database and clickNext .

    10 Depending on your dat abase t ype, ent er th e following data base-relatedinform at ion, a nd clickNext .

    O r a c le SQ L Se r ve r

    Database server name Enter the Oracle host name Enter the SQL Server host name

    Port number 1521 (Default) 1433 (default)

    Database name Enter the Oracle system identifier Enter the SQL Server database name

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    49/110

    Starting the Maximo Installation Program

    Installing Maximo 4-3

    11 En ter t he host nam e of the machine runn ing the SMTP server. ClickNext .

    You m ust enter t his in order to run reports. Conta ct your Network

    Administra tor if you dont kn ow th e host nam e of th e machine ru nn ing the

    SMTP server.

    12 En ter th e following e-mail notificat ion inform at ion.

    a If you a re u sing Work flow, enter th e e-mail addr ess of th e Work flowAdministra tor, oth erwise, leave it blank .

    b Ent er th e e-mail address of the Maximo administrat or.

    c ClickNext .

    13 En ter th e host nam e or IP addr ess and the port n umber of the ma chinewhere your BEA WebLogic Server is installed. ClickNext .

    Use th e port n um ber th at you specified in Step 5 on pa ge 2-8 (default

    7001).

    14 If you h ave purchased th e MEA Product E nabler, then check t he En ableMaximo Ent erpr ise Adapt er check-box, otherwise accept default

    (unche cked) and clickNext .

    15 Accept th e default Maximo Server n am e (MXServer) an d clickNext .

    16 If you a re u sing Actu at e as your Report ing tool in Maximo, specify th efollowing inform at ion; other wise, click Next th rough th e following t hr ee

    steps an d complete installing the pr oduct.

    a iServer Nam e: enter t he Actua te iServer IP address or server n ame.

    b iServer Port Number: accept default, 8000.

    c Enter th e database name.

    d ClickNext .

    17 En ter t he host na me of th e Actu at e iServer. ClickNext .

    18 Accept t he default valu e tha t a ppear s in th e Actuat e Encyclopedia rootna me t ext box (rpt) an d clickNext .

    19 ClickI n s t a l l in th e Pr e-Insta llation Sum mar y dialog box.

    Database owner Maximo (default) Maximo (default)

    Database ownerspassword

    Maximo (default) Maximo (default)

    O r a c le SQ L Se r ve r

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    50/110

    Starting the Maximo Installation Program

    4-4 IBM Maximo: Installation Guide

    20 Once th e inst allat ion is complete, clickNext in th e Insta ll Complete dialogbox.

    21 Ensu re th at a J VM is present on t he Maximo server. If a J VM is notpresen t, download a nd ins ta ll it n ow, as described in J ava Virt ual

    Machin e (J VM), on pa ge 1-8

    22 En sur e th at port 8000 is open to su pport t he following process of checking

    for a nd downloading a ny available Maximo updat es.

    23 In the U p d a t e M a x i m o E n t e r p r i s e S u i t e R e l e a s e 6.2 .1 dialog box,verify that the C h e c k fo r U p d a t e s t o Ma x i m o E n t e r p r i s e S u i t e

    Release 6.2.1 check box is selected (wh ich it sh ould be, by defau lt), and

    clickNext .

    24 If a Maximo upda te is ava ilable (as in dicat ed by the dia log box message),clickNext in th e Updat e Available dialog box and continu e to Step 25 on

    pa ge 4-4.

    Or

    If your softwar e is alrea dy up t o date, (as indicated by th e dialog box

    mes sage) clickE xi t an d proceed to Step 28 on page 4-4.

    25 ClickNext in th e Upda ter Retr ieved dialog box to download th e latest filesfrom t he Power Update server.

    26 Choose t he Maximo insta llation locat ion (defau lt c:\ MAXIMO) and clickI n s t a l l .

    27 ClickD o n e .

    28 ClickC r e a t e a S u p p o r t O n l in e Ac c o u n t to de-select it, and then clickD o n e . IBM no longer r equires th at you create a Support Online account in

    th is step becau se you ha ve already established an I BM Online ID.

    29 Remove the CD-ROM from its drive.

    http://../621_mx_install_bea814_unixv2/61_mx_install_bea814_unix_ch1.pdfhttp://../621_mx_install_bea814_unixv2/61_mx_install_bea814_unix_ch1.pdfhttp://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://../621_mx_install_bea814_unixv2/61_mx_install_bea814_unix_ch1.pdfhttp://../621_mx_install_bea814_unixv2/61_mx_install_bea814_unix_ch1.pdf
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    51/110

    Starting the Maximo Installation Program

    Installing Maximo 4-5

    Post Installation Tasks

    In t his section you perform t he following general t ask s:

    Copy th e oraclethin.jar file from th e Maximo folder t o the BEA folder.

    En able the Application Designer a nd t he new Help files.

    Modify langu age-specific J DBC sett ings in Ma ximo for SQL Ser ver

    database users.

    How to Include the oraclethin.jar File

    Ea rlier in Chapt er 2, you edited th e comm En v file in WebLogic. Now tha t you

    ha ve insta lled Maximo, you must copy th e o r a c l e t h i n . j a r file to th e /lib folder

    in BEA. Complete the following steps:

    1 Navigate to::\ \ applications\ maximo\ li

    b

    for example: c:\ maximo\ applications\ maximo\ lib

    2 Copy th e o r a c l e t h i n . j a r file to::\ bea_installation_location>\ weblogic81\ server\ lib

    for example: c:\ bea\ weblogic81\ server\ lib

    How to enable the Application Designer

    You must n ow ma nu ally ena ble the Applicat ion Designer an d the n ew Help

    files to ta ke advan ta ge of the new upda tes th at you downloaded. Complete th e

    following ste ps.

    1 Enable the Application Designer by running pkg ins ta l l . ba t from th e\ tools\ maximo directory.

    2 To updat e your online h elp files, download th e en.z ip file from thefollowing location to the Maximo application server.

    ftp://ftp.software.ibm.com/software/tivoli/maximo/support/Maximo6/621/

    en.zip

    a Unzip t he en .zip file.

    b Copy the en folder t o the following locat ion:

    \ a p p l i ca t i o n s \ m a x i m o h e l p \ h e l p w e b \ w e b m o d u le

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    52/110

    Starting the Maximo Installation Program

    4-6 IBM Maximo: Installation Guide

    How to Modify Language-specific JDBC Settings in Maximo for SQL Server Database

    NOTE Per form t he ta sks outlined in th is section only if you a re inst alling a non-En glish lan guage, and you ar e using SQL Server da ta base; otherwise, ignore

    this section a nd the post-insta llation ta sks outlined in Chapter 9.

    You mus t m odify the J DBC settings in order for Maximo and Actu at e

    Reporting t o work properly with tra nslated dat abases th at conta in special

    cha ra cter s. For example: French, Swedish, or double-byte langua ges such asChinese, Ja panese and Korean.

    There a re a t ota l of four files tha t you must edit. In th is section you edit t he

    ma ximo.properties file. If are u sing Actu at e as your Report ing tool, then you

    must edit the remaining t hree Actua te-related files as described at the end of

    Chapter 9.

    Complete the following steps to modify the maximo.properties file.

    1 Using Windows Explorer , navigate t o\ applications\ maximo\ properties

    2 Using a text editor, open th e m a x i m o . p r o p e r t i e s file.

    NOTE If you h ave m ult iple inst an ces of Maxim o, you mu st m odify all Maximo (or

    Actu at e) properties files.

    3 Sear ch for th e following str ing: mxe .db .u r l= jdbc : ine tdae7a

    Example of the mxe.db.url setting before making any changes.

    4 Remove t he last a from i n e t d a e 7 a , leaving i n e t d a e 7 .

    Remove the a

    Add & c h a r s e t = af ter t rue

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    53/110

    Starting the Maximo Installation Program

    Installing Maximo 4-7

    5 Add & c h a r s e t = immediately after th en o w a r n i n g s = t r u e .

    is the chara cter set code and depends on th e language

    tha t you ar e using.

    Use th e following cha ra cter set codes in th e JDBC sett ing for the pr imar y

    languages supported in Maximo:

    Chin ese (Simplified) : GBK

    Dut ch : 8859_1

    Fr ench : 8859_1

    Germa n : 8859_1

    Ita lian : 8859_1

    J apan ese : Shift_JIS

    Korean : euc-kr

    Port uguese : 8859_1

    Span ish : 8859_1

    Swedish : 8859_1

    For example if you h ave a J apan ese database, type Shi f t_J IS for t hechar acter set.

    6 Save a nd close the file.

    Example of the mxe.db.url setting after making the changes.

    Generally, modifying the maximo.properites file (or any *.properties files)

    requir es th at you r ebuild and r e-deploy the E AR files.

    In t his case, you do not n eed to rebuild an d r edeploy the m aximo.ear file. ThePr oduct E na blers program bu ilds all th e necessar y EAR files for you a nd so

    th e cha nges tha t you made to the ma ximo.properties page in this section is

    incorporat ed in the r esulting EAR files. Lat er in t his guide, you ar e instr ucted

    on how to deploy th e EAR files.

    However, you must ma nu ally rebuild and re-deploy the a cweb.ear file becau se

    you m odify this file after ha ving built an d Deployed it. Therefore, any chan ges

    tha t you ma ke to th e actuat e-related pr operties file in Post In sta llation

    Tas ks, on pa ge 7-4 requir es you to man ua lly rebuild an d re-deploy the

    acweb.ear file.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    54/110

    Installing the Language Utilities

    4-8 IBM Maximo: Installation Guide

    Installing the Language Utilities

    This pr ogra m in sta lls langua ge-specific Help files and dat abase scripts. You

    insta ll th e Langua ge Utilities after inst alling Maximo applicat ion.

    1 Inser t t he Maximo Langua ge Utilities CD-ROM int o th e CD drive.

    2 Fr om th e root CD drive, double-clickm a x l a n g e n . e x e (or maxlang.exe).

    3 Select t he desired lan guage from th e drop-down list. Selecting a langua geonly changes th e insta llation screens int o th at la ngua ge but does not affect

    the underlying files tha t get installed.

    If your langua ge is not ava ilable from t he list, select E ngl i sh , an d click

    OK .

    If it is J apa nese or Chinese you m ust ha ve those fonts inst alled on your

    system.

    For an y selected langu age othertha n En glish, that you are installing

    on a S Q L S e r v e r dat aba se, you mu st perform certa in post-insta llation

    ta sks as described in Cha pter 9. This procedur e does not ap ply if you

    are u sing Oracle database.

    4 ClickNext in th e Int roduction dia log box.

    5 Verify th at t he default value (c:\ Maximo) is the M a x i m o Home Directoryan d clickNext .

    6 ClickI n s t a l l in th e Pr e-Insta llation Sum mar y dialog box.

    Allow th e insta llation progress bar to complete.

    7 If you are performing t he steps in this Cha pter because you ar e addingaddit iona l langua ges to an existin g Maximo insta llation, check the Build

    m axim ohelp.ear file check-box and click Next, otherwise accept default

    (unche cked) and clickNext .

    8 ClickD o n e .

    You are now ready to install the P roduct Ena blers pr ogram .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    55/110

    Installing the Product Enablers

    Installing Maximo 4-9

    Installing the Product Enablers

    Pr oduct E na blers allow you t o access to applicat ions t ha t you are ent itled to

    use deter mined by your Maximo license pu rchase.

    The E AR files ar e built a t t his t ime. Complete t he following steps:

    1 Insert the Product Ena blers CD-ROM into th e CD drive.

    2 Fr om th e root CD drive, double-clickse tup .exe .

    3 Select t he desired lan guage from th e drop-down list. Selecting a langua geonly changes th e insta llation screens int o th at la ngua ge but does not affect

    the underlying files tha t get installed.

    If your langua ge is not ava ilable from t he list, select E ngl i sh , an d click

    OK .

    If it is J apa nese or Chinese you m ust ha ve those fonts inst alled on your

    system.

    For an y selected langu age othertha n En glish, that you are installing

    on a S Q L S e r v e r dat aba se, you mu st perform certa in post-insta llation

    ta sks as described in Cha pter 9. This procedur e does not ap ply if you

    are u sing Oracle database.

    4 ClickNext in t he Welcome dialog box.

    5 Verify th at t he default value (c:\ Maximo) is the M a x i m o Home Directoryan d clickNext .

    6 ClickI n s t a l l in th e Pr e-Configur at ion Message box.

    Allow th e insta llation progress bar to complete.

    7 If you a re inst alling additional pa ckages, you must at t his time select Ye s an d th e program will exit allowing you to add th e oth er Pr oduct E na blers.

    See Adding Additional Product Enablers, on page D-1

    Once all packages ar e insta lled select No an d clickD o n e .

    Thr ee message boxes appear in dicat ing tha t th e EAR files are being built.

    ClickD o n e .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    56/110

    Installing the Product Enablers

    4-10 IBM Maximo: Installation Guide

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    57/110

    Copyright IBM Corp. 2008 5-1

    In t his chapt er, you pr epar e an Or acle insta nce or a Microsoft SQL Server

    insta nce on t he ser ver to hold your da ta . The following comman ds ar e

    guidelines for configur at ion cha nges. For more det ails on th ese comman ds,

    refer to your Ora cle or SQL Server docum ent at ion. The par am eter s are only

    suggestions; you might need to adjust t hem d epending on server disk space

    and site requirement s.

    Preparing Microsoft SQL Server Instance

    Full-text Search is a sett ings that you m ust install during th e installation of

    Microsoft SQL Ser ver 2000. To determine if Full-text S ear ch is insta lled on

    your existing MS SQL Server da ta base, perform th e following steps:

    1 Open SQL Quer y Ana lyzer from th e Tools menu .

    2 Type the following command:

    select FULLTEXTSERVICEPROPERTY ( 'IsFulltext Instal led' )

    Creating the MaximoSchema 5

    0 = Full-text is not installed (in this example)1 = Full-text is installed

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    58/110

    Preparing Microsoft SQL Server Instance

    5-2 IBM Maximo: Installation Guide

    In t he event th at you did not insta ll Full-text Sear ch (the r esulting value is

    zero), you mu st do so at t his t ime. The following steps p rovide a general

    guideline describing how you can chan ge this an d oth er sett ings after ha ving

    installed SQL Server.

    1 Inser t t he Microsoft S QL Server 2000 CD-ROM onto the ser ver wher e youha d it insta lled originally.

    2 Navigate t hr ough the inst allat ion dialog boxes and from the Setu p Typedialog box, select C u s t o m .

    3 Check t he Fu l l-T ex t Sea r ch option.

    4 Step thr ough th e remainder of the steps and F inish the installationprocess by selecting t o rest ar t t he server.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    59/110

    Preparing Microsoft SQL Server Instance

    Creating the Maximo Schema 5-3

    Setting up a SQL Server Database for Maximo

    Complete t he following steps to create a SQL Server Da ta base.

    1 Open SQL Server En ter prise Man ager (from P rogram Files >> MicrosoftSQL Server).

    2 Right Click t he D a t a b a s e s folder from t he t ree view, and select NewDatabase.

    3 In t he Dat abase P roperties dialog box, in th e Genera l tab, specify a uniqu edat abase n am e (for exam ple max602db).

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    60/110

    Preparing Microsoft SQL Server Instance

    5-4 IBM Maximo: Installation Guide

    4 Fr om the Dat a Files tab, cha nge the Spa ce allocated size to 50 0 (MB) an dcheck th e Aut oma t ica l ly gr ow f i le check box.

    5 If you pr efer, from t he Tr an saction Log tab m odify th e settin gs toaccommodate your production environm ent.

    6 ClickOK .

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    61/110

    Preparing Microsoft SQL Server Instance

    Creating the Maximo Schema 5-5

    7 Fr om th e Tools menu , select SQL Server Ana lyzer

    8 Select th e correct data base na me from th e drop-down men u. This is th evalue you ent ered in Step 3 on pa ge 5-3.

    9 Run th e following scripts:

    a To create the MAXIMO user , run th e following script:

    sp_addlogin MAXIMO,MAXIMOgo

    If th e maximo account is alrea dy present in t he SQL Server

    insta llation, then you will get a n er ror m essage login MAXIMO

    alrea dy exists. You can ignore th is error messa ge.

    b Change m a x i m o to be the dat abas e owner by ru nn ing the followingscript:

    sp_changedbowner MAXIMOgo

    c If you int end to use th e Users app t o add nat ive data base logins an duser s, then r un th e following script :

    sp_addsrvrol emember MAXIMO, securityadmingo

    10 You can n ow run the m axinst script from the\ tools\ Maximo folder from th e machine where you

    insta lled Maximo.

    See Creat e t he Ma ximo Data base Objects, on pa ge 5-10.

    Maximo01

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    62/110

    Preparing Oracle Instance

    5-6 IBM Maximo: Installation Guide

    Preparing Oracle Instance

    In th is section, you p erform th e following ta sks:

    Verify the Oracle instance requirements.

    Creat e Maximo Ta blespace(s).

    Create t he Maximo user.

    Creat e the Maximo data base objects.

    Database Character Set

    Maximo support s mult iple langu ages within a single schem a. The Oracle

    instance must be created with th e char acter set tha t will support all the

    langua ges which you will be using. For example, English, Fr ench, Germa n,

    Spanish, Dutch, Portu guese, and Italian a ll use the Oracle char acter set

    WE8ISO8859P1.

    If you plan to use a mix of langu ages tha t cann ot all use a single cha ra cter set,

    such as E nglish, Chinese, and Polish, then you m ust create t he dat abase with

    th e Unicode chara cter set AL32UTF8. The AL32UTF8 chara cter set is the

    only Unicode chara cter set t ha t can be u sed with MAXIMO.

    If you create t he dat abase with AL32UTF8 or an y multi-byte cha ra cter set

    you must also set the initialization parameter nls_length_semantics=CHAR.

    Verifying the Oracle Instance Requirements

    The Ora cle instan ce for Maximo mu st h ave Ora cle Text insta lled. Maximo

    uses Ora cle Text for indexes on description fields. You can verify th at Ora cle

    Text is inst alled by checking for th e CTXSYS u serid.

    Fr om SQL Plus, run th e following comman d:

    select username from dba_users where username = CTXSYS;

    If Ora cle Text is insta lled, th is comman d will retu rn th e nam e CTXSYS.

    NOTE The inst an ce for Maximo will need at least 100MB of tem porar y tablespace

    an d 100MB of un do tablespace.

    If Oracle Text is not in sta lled, refer to Ora cle insta llation docum ent at ion for

    more detail.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    63/110

    Preparing Oracle Instance

    Creating the Maximo Schema 5-7

    Oracle Init ialization Parameters

    IBM Corpora tion does not pr ovide deta iled per form an ce settings for MAXIMO

    becau se ther e are a n infinite nu mber of combina tions of data sizes, user

    counts , module usages, add-on m odule usages, system configur at ions, an d

    cust omizat ions possible in an Maximo system. Tak e advan ta ge of all the

    feat ur es of Ora cle 9.2 and 10g tu ning, such as:

    Use locally ma na ged ta blespaces for MAXIMO ta bles an d indexes.

    Use the n ew method of PGA man agement by setting

    WORKAREA_SIZE_POLICY=AUTO a nd

    PGA_AGGREGATE_TARGET=memory value.

    Use the new method of SGA man agement by setting

    SGA_TARGET = memory value.

    Control I/O cache via DB_CACHE_SIZE instead of

    DB_BLOCK_BUFFERS.

    Reduce libra ry lat ch content ion by sett ing CURSOR_SHARING=

    SIMILAR or F ORCE.

    Make sur e OPTIMIZER_FE ATURES_ENABLE is set to your curr ent

    Ora cle version a nd n ot an older one.

    OPE N_CURSORS = 1000 estimat ed; you may n eed more.

    DBMS_J OBS_PROCESSE S = 2 required for job tha t u pdat es Oracle Text

    indexes.

    Beyond th e above, sizing for SGA, PGA, and so forth , is best det ermin ed by

    using Oracle Ent erprise Manager or a Third-party dat abase monitoring andadministra tion tool to ana lyze the dat abase under load and mak e tun ing

    recommendations.

    CAUTION If you ha ve crea ted th e data base with AL32UTF8 or an y multi-byte char acterset, you must also set the initialization para meter

    nls_length_semantics=CHAR.

    Creating Maximo Tablespace(s)

    Complete th e following steps to creat e th e Maximo ta blespaces. Maximo offers

    a m ulti-schem a option. This featur e enables th e applicat ion t ables to be ownedby a user other tha n Maximo, permitting m ultiple Maximo schemas to reside

    in a sin gle Ora cle instan ce.

    Maximo tablespaces should be locally man aged an d not dictiona ry ma na ged.

    These inst ru ctions will crea te a locally man aged ta blespace by defau lt.

    If you do not include a schema owner, t he default is Maximo. The expected

    size of your da ta base det erm ines th e size of a Maximo tablespace.

    If you plan to insta ll the MAXDEMO schema, creat e a Ma ximo ta blespace

    of size 600MB.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    64/110

    Preparing Oracle Instance

    5-8 IBM Maximo: Installation Guide

    If you plan to crea te an empt y Maximo schema , use the est imat ed size of

    th e dat abase. Refer t o Table 7-1: Dat abase Size Guidelines.

    To permit growth, you can a dd another data file later or use t he

    AUTOEXTEND option of th e CREATE TABLESPACE comm an d.

    Use relat ed nam es for Maximo schem as a nd t ablespaces. For example, to set

    up a MAXDEMO dat abase, a pr oduction dat aba se, and a t est copy of th e

    production database, you might choose MAXDEMO, MAXPROD, andMAXTES T a s schem a owners an d MAXDEMO_DATA, MAXPROD_DATA,

    MAXPROD_INDE X, MAXTES T_DATA, an d MAXTE ST_INDE X as

    ta blespace na mes (MAXDEMO ha s only one tablespace nam e as splitt ing a

    sma ll demo data base ha s no real advan ta ge). Use the following guidelines to

    estima te initial ta blespace size:

    To creat e a ta blespace, use t he following comm an d:

    CREATE TABLESPACE DATAFILE SIZE

    AUTOEXTEND ON MAXSIZE ;

    where:

    is th e Maximo tablespaces na me.

    is t he d at a files n am e.

    is the d at afiles init ial size from ta ble.

    MAXSIZE is the ma ximum size allott ed to th e data

    file from th e above table.

    You can express both filesize and m aximum as a n um ber of megabytes when

    you follow it with th e letter M (for exam ple, 1000M). You can cus tomize t he

    storage parameter s for th e particular data base.

    The file na me is t he full pat h of the ser ver. It includes t he local dr ive of the

    server a nd pa th location t o the dat a file, and sh ould be placed inside singlequotes. For example: C:\ oracle\ orada ta\ maximo\ MAXIMO01.DBF

    Creating the Maximo User

    This section des cribes how to modify c r e a t e M a x i m o E S . s q l file. The m ulti-

    schem a featu re ena bles the application t ables to be owned by a user oth er

    th an MAXIMO, th us per mitt ing multiple schema s to reside in a single Oracle

    instance.

    Size of Database Tablespace Estimate (MB)

    Initial Maximum

    Small (12 users) 500 2000

    Medium (20100 users) 1000 5000

    Large (100+ users) 5000+ 20000+

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    65/110

    Preparing Oracle Instance

    Creating the Maximo Schema 5-9

    To use different schema or ta blespace na mes, you m ust edit th e following

    para meters in creat eMaximoES.sql.

    schema the schema (user id) to own th e tables (same value th at you

    specified in Step 10 on page 4-2)

    dat a_ts th e nam e of th e table space to hold the Maximo tables (an d

    indexes if th e optiona l index table spa ce is not us ed)

    index_ts the n am e of the ta ble space to hold the Maximo tables

    An example ofc r e a t e M a x i m o E S . s q l is sh own below:

    NOTE Ensure tha t the a l t e r u s e r s c h e m a t e m p o r a r y t a b le s p a c e t em p linereflects your temporary tablespace name.

    Add t he following line if you use a separ at e index t ablespace:

    alter user quota unlimited on ;

    To crea te t he Ma ximo user, complete th e following steps:

    1 Open SQL Plus.

    2 Login a s system adm inistrator.

    3 At the pr ompt, t ype:

    @:\\tools\Maximo\e

    n\createMaximoES.sql;

    4 Press E n t e r .

    5Exit SQL Plus.

    create user maximo identified by ma ximo;

    alter u ser m aximo default tablespace ma ximo quota unlimited on ma ximo;

    alter user maximo temporary tablespace temp;

    grant create trigger t o maximo;

    grant create session to maximo;

    grant create sequence to maximo;

    grant create synonym t o maximo;

    grant create table to maximo;

    grant create view to maximo;

    grant create procedure t o maximo;

    grant alter session to maximo;

    gran t execute on ctxsys.ctx_ddl to maximo;

    --To allow Maximo to give Data base Access to Maximo User s in Sig. Security, r un these:

    --gran t creat e user to MAXIMO;

    --gran t dr op user t o MAXIMO;

    --gran t crea te session t o MAXIMO with ADMIN OP TION;

    --gran t a lter u ser to MAXIMO;

    schema namepassword

    data _ts tablespace

    replace with your tem porar y

    tablespace nam e

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    66/110

    Create the Maximo Database Objects

    5-10 IBM Maximo: Installation Guide

    Create the Maximo Database Objects

    You crea te t he Maximo data base after creat ing the Maximo user. Complete

    the following steps:

    1 Open a comma nd prompt.

    2 Change directory path to: \ maximo\ tools\ maximo

    3 At t he prompt, type m a x i n s t

    By defau lt, Maxinst will look in th e ma ximo.properties file (In th is example,

    c:\ Maximo\ applications\ maximo\ properties) for connectivity inform ation to

    th e data base. It will conn ect u sing JDBC conn ection and st ar t t he pr ocess of

    creating a Ma xdemo dat abase. If you would like to creat e an em pty dat aba se,

    use the - imax imo flag.

    For example, at the comm an d prompt, instea d of just ma xinst, type: m a x i n s t

    - imax imo

    The following depicts t he var ious flags tha t you can use with ma xinst.

    F la g De scr ip t io n

    -a d at aba se a lia s Da ta ba se a lia s. If n ot sp ecified, u ses mxe.db.u rl pr op er ty.

    -c la ngu age cod e Dir ect or y n am e of in pu t file (for exa mp le en for En glish ).

    -d log file directory If using the -l param eter, i t will output logfile to the Maximo directory.Typically: tools > maximo > log.

    -e none Causes Sql to be execu ted. Required. Alrea dy present in maxinst .ba t .

    -f file n a m e F ile na m e for p rop er t ie s file . I f n ot s pe cifie d, u se s m a xim o.p rop er t ie s.

    -i file n a me F ilen a me of in pu t file (wit h ou t p at h or ext en sion ). Th e d efa u lt filen a meis Unlcvt if the -i para m is not provided.

    -k pr op. filedirectory

    Directory for propert ies file.

    -l none Outpu ts a deta iled log file. St rongly recommended. Already inmaxinst.bat.

    -o file n am e If u sin g t he -l pa ra met er , t he filen am e for t he logfile.

    If not specified, logfile is "Maxinst" + timestamp + ".log".

    -p p as swor d P a ss wor d for d at a ba se con n ect ion . If n ot s pecified , u sesmxe.db.pass word pr operty, or "MAXIMO".

    -s index stora gearea

    Oracle: tablespace for index storage (defaults to default tablespace forschema owner)

    SQL Ser ver: filegroup for in dex st orage (defaults to PRIMARY).

    -t table storage area Oracle: tablespace for table storage (defaults to default tablespace forschema owner)

    SQL Ser ver: filegroup for t able st orage (defaults to PRIMARY).

    -u u se r n a m e U se r n a m e for d a ta ba se con n ect ion . I f n ot s pe cifie d, u se s m xe .d b.u s erproperty, or "MAXIMO".

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    67/110

    Create the Maximo Database Objects

    Creating the Maximo Schema 5-11

    CAUTION -S and -T PARAMETE RS: Maxinst does n ot provide a default value fortablespace.

    The -S and th e -T PARAMETERS a re r equired. You must always specify the

    data and index tablespace names. There is no default value.

    CAUTION If MAXINST fails for an y reas on, you m ust drop an d r e-crea te t he MAXIMO

    schema before re-run ning MAXINST.

    NOTE Ea ch flag must be followed by th e par am eters with out a spa ce,for exam ple: -uMAXIMO.

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    68/110

    Create the Maximo Database Objects

    5-12 IBM Maximo: Installation Guide

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    69/110

    Copyright IBM Corp. 2008 6-1

    You ar e now r ead y to deploy the E AR files via th e BEA WebLogic Console.

    Deploying th e EAR files star ts th e Maximo Applicat ion Server. If

    MAXIMOSERVER is not ru nn ing, sta rt it from a comm an d prompt .

    You also need to inst all a J ava Virtu al Machine (JVM) in order t o view the

    BEA WebLogic Console. Newer versions of Windows ma y not sh ip with J VM.

    1 Fr om a comma nd pr ompt, change directory path to:

    :\\user_projects\domai

    ns\mydomain

    2 Type s ta r tWebL ogic . cmd and press Enter.

    3 When prompted, type the u ser na me a nd pa ssword tha t you specified inStep 9 on page 2-11.

    Once the ph rase:""

    displays, the WebLogic Server is r un ning.

    4 Sta rt th e MAXIMOSERVER Admin Console by typing th e following URL

    in your browsers addr ess bar: http:/ /:7001/console

    Deploying the EAR Files 6

  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    70/110

    6-2 IBM Maximo: Installation Guide

    5 Replace th e defau lt U s e r n a m e and P a s s w o r d with t he values youspecified in Step 9 on page 2-11. ClickS i gn I n .

    MEA Only If you a re a Maximo Ent erprise Adapter customer, and you have set up theJ MS queu es dur ing th e WebLogic configur at ion (Appendix B), you mu st

    now enable the JMS connection factory before deploying the EAR files.

    Please refer to En ablin g J MS Conn ection F actory for MEA, on pa ge C-1

    at th is t ime and return to Step 1 on pa ge 6-1 after completin g the steps

    outlined in Appendix C.

    6 ClickD e p l o y m e n t s from t he tr ee view in the left pa ne, and t hen clickAppl ica t ions .

    max01

    system

    http://-/?-http://-/?-
  • 7/31/2019 621 Mx Install Bea814 Win [RexonaVn.com]

    71/110

    Deploying the EAR Files 6-3

    7 Fr om th e ma in window, clickDeploy a new Appl ica t ion