10.2 THE OVCUSTOMER UTILITYCV is configured with the ovcustomer utility. Cut/paste and drag/drop functionality is not supported with CV. In fact, if you try to use the cut and paste or drag and drop functions, you may encounter undesired results. The ovcustomer utility must be used to define the hierarchy.The utility is used in three ways: interactive command mode, not-interactively from the command line, or batch mode. The interactive method is helpful when you are first learning ovcustomer . The ovcustomer help menu list of supported commands and arguments that may be used with the utility. However, as you progress, you may want to create batch files to allow you to more quickly add customer configuration.To obtain a list of commands available in ovcustomer , type ovcustomer help .To obtain help on a specific command such as create_organization, use ovcustomer help create_organization . 10.2.1 Adding Customer DataThe following commands can be specified with the ovcustomer utility, both interactively and in a batch mode, to add customer data. To use ovcustomer interactively, simply type line ovcustomer at the command line.The create_organization command requires a customer type and a customer name. Specify the type of organization (customer or provider), the customer name (use double quotes if the name contains a space), and an optional external key. The external key may be used to provide a keyed field. If a customer name already exists with a different external key, the external key is modified.The add_associations_to_org command allows you to add the NNM selection name or IP addresses to the association. add_associations_to_org requires an organization name and selection name/IP address.The create_location command allows you to define site types. The type must be one of the four: general, NOC, POP, or peering_point. The general may be used when defining a city, state, or building. NOC is used for a Network Operations Center, POP for a Point of Presence, and peering_point for shared equipment between service providers.The set_location command is used to nest general locations and to add devices to locations. For example, set_location Boston Mass nests Boston inside the Mass container.The set_field command allows you to set object attributes isServer, isCPE , and isKeyDevice. set_field requires the selection name, attribute, and value. For example, set_field r208w100 isKeyDevice TRUE sets the isKeyDevice field for the device r208w100 to true.To use ovcustomer in batch mode, create a text file named custInfo.txt containing the commands listed in the next section and execute ovcustomer as shown. The actual name of the batch file can be whatever you choose. Use the following to execute ovcustomer using a file named custInfo.txt: ovcustomer < custInfo.txt .The sample batch file, custInfo.txt , is listed in the next section. This batch file creates three organizations, adds some systems to the organizations, creates four types of locations, creates the location hierarchy, and configures the fields isServer, isCPE , and isKeyDevice . Make sure to include valid hostnames and IP addresses within your enterprise. 10.2.1.1 Sample Batch File custInfo.txtSample batch files for adding and removing customer data are available for download from the server http://www.phptr.com/title/0130352098 for both UNIX and Windows systems. Obtain the Readme file for Chapter 10 for a description of the files available and install procedures.create_organization customer MomNPop C-154 create_organization customer "Tammy Inc" Z-999 create_organization provider bellsouth.net add_associations_to_org MomNPop r208w1 add_associations_to_org "Tammy Inc" r208w100 add_associations_to_org MomNPop 156.153.206.51 add_associations_to_org "Tammy Inc" 156.153.206.75 add_associations_to_org "Tammy Inc" 156.153.206.1 add_associations_to_org "Tammy Inc" 156.153.206.2 add_associations_to_org "Tammy Inc" 156.153.206.3 add_associations_to_org bellsouth.net 156.153.206.25 create_location general Mass create_location general Boston create_location general Peabody create_location NOC PeabodyNOC create_location POP PeabodyPOP create_location peering_point BostonPPT set_location Boston Mass set_location Peabody Mass set_location PeabodyNOC Peabody set_location PeabodyPOP Peabody set_location BostonPPT Boston set_location r207w100 PeabodyNOC set_location r208w100 PeabodyNOC set_location r208w1 PeabodyPOP set_location r207w1 PeabodyPOP set_location r207w2 BostonPPT set_location r207w3 BostonPPT set_field r208w1 isServer TRUE set_field r208w1 isCPE TRUE set_field r208w100 isKeyDevice TRUE 10.2.2 Listing Customer DataThe following commands may be used to list CV information. These commands may be used interactively or in a batch file.The print _organization command provides the organization type, organization name, and external key. If the organization name is provided, only objects within the specified organization are listed. If no organization is provided, all organizations are listed.The print_associated_organization command also provides the organization type, organization name and external key. It requires the IP address or selection name of the associated organization.The print_associated_interface command lists information about interfaces associated with objects. If an organization name is specified, interfaces associated with the specified organization are listed. If no organization name is specified, all interfaces associated with any organization are listed.The print_associated_node command lists information about nodes associated with objects. If an organization name is specified, only list nodes associated with the specified organization are listed. If no organization name is specified, all nodes associated with any organization are listed. 10.2.3 Deleting Customer DataThe following batch file removes organizations, unsets and deletes locations, and resets fields that were set by the custInfo.txt file. It might be a good idea to create a corresponding batch file to similar to this when creating a batch file for creating the customer data. This allows you to quickly remove customer data in case you want to modify or remove customer data. Create a text file named delCustInfo.txt and execute the command ovcustomer < delCustInfo.txt 10.2.2.1 Sample Batch Fiel delCustInfo.txtremove_associations_to_org MomNPop r208w1 remove_associations_to_org "Tammy Inc" r208w100 remove_associations_to_org MomNPop 156.153.206.51 remove_associations_to_org "Tammy Inc" 156.153.206.75 remove_associations_to_org "Tammy Inc" 156.153.206.1 remove_associations_to_org "Tammy Inc" 156.153.206.2 remove_associations_to_org "Tammy Inc" 156.153.206.3 remove_associations_to_org bellsouth.net 156.153.206.25 delete_organization MomNPop delete_organization "Tammy Inc" delete_organization bellsouth.net unset_location Boston unset_location Peabody unset_location PeabodyNOC unset_location PeabodyPOP unset_location BostonPPT unset_location r207w100 unset_location r208w100 unset_location r208w1 unset_location r207w1 unset_location r207w2 unset_location r207w3 delete_location Mass delete_location Boston delete_location Peabody delete_location PeabodyNOC delete_location PeabodyPOP delete_location BostonPPT unset_field r208w1 isServer unset_field r208w1 isCPE unset_field r208w100 isKeyDevice 10.2.4 Tips for ovcustomerThe ovcustomer utility accepts abbreviated commands based on the uniqueness of the command. For example, to obtain help on print commands, use the following commands:
|
لطفا منتظر باشید ...
