Using UCM

This document describes technical implementation of CA UCM (Unicenter Configuration Management). File name: trNSM Using UCM.odt. Created by: THIERRY ...
Télécharger le PDF
685KB taille 18 téléchargements 281 vues
commentaire
Report
Using UCM

Domain

Infrastructure

Author

THIERRY ROCH

Title

Using UCM

Status

Final

Version 1

See last page: version follow up, validation follow up, diffusion

Summarize This document describes technical implementation of CA UCM (Unicenter Configuration Management).

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 1 of 16

Using UCM

Version 1

INDEX

1 Introduction..........................................................................................................................................3 2 How it works step by step....................................................................................................................3 2.1 Logon on UCM......................................................................................................................................................3 2.2 Configure UCM.....................................................................................................................................................3 2.3 Define a Base Profile............................................................................................................................................4 2.4 Define Differential Profile......................................................................................................................................5 2.5 Now Create a Group.............................................................................................................................................6 2.6 Create a configuration Bundle...............................................................................................................................7 2.7 Deliver the configuration.......................................................................................................................................8 2.8 Check / Update calendars.....................................................................................................................................9

3 UCM infrastructure.............................................................................................................................10 3.1 Datastructure......................................................................................................................................................10 3.1.1 Profiles and Configuration linking : 10 3.1.2 Hosts-Profiles associations : 10 3.1.3 Configset Details (Profiles) 11 3.2 User Interface.....................................................................................................................................................11 3.3 Log Files ............................................................................................................................................................11 3.4 Communication ..................................................................................................................................................11 3.5 Restarting UCM service......................................................................................................................................12

4 Technical tips......................................................................................................................................12 4.1 Instrumenting UCM using Command Lines.........................................................................................................12 4.2 Transferring Datas from one server to the other one..........................................................................................13 4.3 Querying database..............................................................................................................................................14

5 Troubleshooting.................................................................................................................................14 5.1 I CANNOT DELIVER A CONFIG, WHY ?...........................................................................................................14

6 Reference Documents........................................................................................................................16 7 Versions, Validation and Diffusion follow up...................................................................................16

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 2 of 16

Using UCM

Version 1

1 Introduction UCM appears with NSM r11 as a tool to deliver configuration to NSM r11 monitoring agents, NSM r11 AEC and to deliver files to managed agents.

2 How it works step by step 2.1 Logon on UCM

2.2 Configure UCM If this operation has not been performed, click on administration on the first page and fill in the info (login, database …)

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 3 of 16

Using UCM

Version 1

2.3 Define a Base Profile If you have a host where you have already configured an agent with basic monitoring thresholds, Go to Profiles / Create News, Enter the wish name of your profile , select the agent (there is one profile per agent), and click on Get Configuration from Host , fill-in the hosts info and create the profile. After that process, you’ll have a profile you can edit. This profile is coresping to a xml file stored on a server and it contains all the infos for an agent (infos that you can retrieve also using the mkconfig command but in another format than xml).

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 4 of 16

Using UCM

Version 1

2.4 Define Differential Profile If you have some specific configuration that do not apply on every agents,you may use Differential Profile. For example you can create a MSSQL Server 2008 Diff Profile that contains all what need to be monitored when running MSSQL Server 2008. To create this profile, click on New Profile , check on Differential and then update all the differents table you need to add.

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 5 of 16

Using UCM

Version 1

2.5 Now Create a Group Create a Group, and put into one host

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 6 of 16

Using UCM

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Version 1

Created by: THIERRY ROCH Page 7 of 16

Using UCM

Version 1

2.6 Create a configuration Bundle A bundle is the association host/agent/configuration/calendar, you have one bundle per agent and calendar.

Select the Base Profile you wish to apply .

And the differential if you wish.

2.7 Deliver the configuration

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 8 of 16

Using UCM

Version 1

Select the agent, an then click on Deliver Now to ask UCM to send your configuration to the agent.

The agent will not be restarted and new items will be added. Based on the calendar you have selected, it will also beeing delivered on the interval setup within calendar

2.8 Check / Update calendars Click on Delivery Schedule to update / create any calendar.

3 UCM infrastructure 3.1 Datastructure 3.1.1 Profiles and Configuration linking : Within the CA database (mdb) there are a few tables used by UCM. This tables are storing mainly links between Profiles and Configurations

3.1.2 Hosts-Profiles associations : This association is done within the 2DMAP under UCM Business Views or in the UCM interface under the Groups view. (Wich reflect same datas)

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 9 of 16

Using UCM

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Version 1

Created by: THIERRY ROCH Page 10 of 16

Using UCM

Version 1

3.1.3 Configset Details (Profiles) The Agent configuration are stored within xml files. This files are not stored in the database but on the UCM server under CA\SharedComponents\Tomcat.ccs\4.1.29\webapps\wiser\Documents

3.2 User Interface The web interface is the main interface to use UCM. It’s a set of jsp runned by tomcat server. (Installed with CA Distribution). Tomcat application’s name is wiser

3.3 Log Files Logs are located under : Program Files\CA\SharedComponents\Tomcat.ccs\4.1.29\webapps\wiser\log\wiser.log

3.4 Communication UCM to agent communication is performed using DIA.

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 11 of 16

Using UCM

Version 1

3.5 Restarting UCM service Restart “CA-Web Services” and “NSM Auxiliary Services” You may also logon on http://servername:9090, select Tomcat’s administration and stop start the wiser service.

4 Technical tips 4.1 Instrumenting UCM using Command Lines -UCMCatalogCmd File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 12 of 16

Using UCM

Version 1

Output Configuration Model Tree to Screen -UCMDeliverCmd Delivers all applied configuration bundles -UCMProfileCmd Migrates profiles to XML and Registers -UCMServiceCmd Update activity on the managed resource These batch commands is in the next directory X:\Program Files\CA\Tomcat.ccs\4.1.29\webapps\wiser These command are not documented, they are used in internal by our products, to get the "usage" you have just to run the command

UCMDeliverCmd - number of arguments is :0 UCMDeliverCmd UCMDeliverCmd nsmsrvr1:9090 MRM:Group1:nsmsrvr1 UCMDeliverCmd nsmsrvr1:9090 EMM:Group2:nsmsrvr2 UCMDeliverCmd nsmsrvr1:9090 MRM:eSupport:nsmsrvr1:caiLogA2 UCMDeliverCmd nsmsrvr1:9090 MRM:eSupport:n*:caiLogA2 UCMDeliverCmd nsmsrvr1:9090 "MRM:eSupport:*:caiLogA2:Noon Daily Default" UCMDeliverCmd nsmsrvr1:9090 "EMM:eSupport:nsmsrvr1:*:Noon Daily Default" Example: H:\Program Files\CA\SharedComponents\Tomcat.ccs\4.1.29\webapps\wiser> UCMDeliverCmd.bat pnsmw3:9090 "MRM:GCS_HOSTS_MAI_AIX:ma2serv:caiUxsA2:gcs_saturday_brbackup”

4.2 Transferring Datas from one server to the other one CA Technical Support Request 16773435 01 - TRANSFERING UCM DATAS

On 28 JAN 2008 06:28:21 EST, [email protected] said: > Hi Thierry, > > We can copy profiles from one server to another...but Groups cannot be > copy to anothser server because the information is stored in different > tables. Below is the procedure to Import UCM profiles to another > server... > > * Copy the Profile XML files to new server. > * Once it is done... > * Go into UCM and choose the Profiles Tab > * Choose New Profile > * Enter a Profile Name > * Select the Register Only option > Enter the Profile Location (Newly copied file from old UCM Server) > Select Next > File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 13 of 16

Using UCM

Version 1

> * Copied profile will now be listed as a new Profile under new name > entered. > > Note: There is a DAR has already open for Import/Export of UCM Data. If > you > would like to open DAR request, I will open for you. > > Please let me know if you have any questions. > > Thanks > Brahma > Unicenter NSM Support

4.3 Querying database Get all config items associated to a specific host. (not inherited) : select * from ca_link_named_config_item l,ca_named_configuration n where l.asset_uuid in (SELECT uuid FROM tng_managedobject WHERE name = 'drseosver' AND class_name = 'AIX' ) and n.named_config_uuid = l.named_config_uuid select * from ca_link_named_config_item l,ca_named_configuration n where l.asset_uuid in (SELECT uuid FROM tng_managedobject WHERE name = 'sdfsdeserv') and n.named_config_uuid = l.named_config_uuid select m.name, config_name,* from ca_link_named_config_item l,ca_named_configuration n , tng_managedobject m where l.asset_uuid in (SELECT uuid FROM tng_managedobject WHERE name = 'AIX CRM TTR') and n.named_config_uuid = l.named_config_uuid and m.uuid = l.asset_uuid

5 Troubleshooting 5.1 I CANNOT DELIVER A CONFIG, WHY ? It says deliver from the web site but the console log says : UCM_80_W: Configuration Object 'WINDOWS System Base' delivery failed for Managed Resource caiWinA3 on Host ILDAP0' Many reasons. See the log file for details. Most of the time it's ukb/dia troubles. It's better to register from the client as the ukb will take the good name. ReRegister in case of doubt (1st remove via diatool host from grid) In case you have multiple network ip : force in access.cfg , quick.cfg ....with the ip of the agent. Do not hesitate to re-activate dna on the host to be sure it’s connected to the correct UKB. (see Handbook)

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Created by: THIERRY ROCH Page 14 of 16

Using UCM

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Version 1

Created by: THIERRY ROCH Page 15 of 16

Version 1

Using UCM

6 Reference Documents Reference Documents

7 Versions, Validation and Diffusion follow up Version follow up Date 16/6/2008

Description of change Creation

Validation follow up Date

Who

Who Thierry Roch

Signature

Version V1.0

Comments / Remarks

Diffusion Name

File name: trNSM Using UCM.odt Printing Date: 2009-02-20

Project Role

Action

Information

Created by: THIERRY ROCH Page 16 of 16