• Loading...
This documentation refers to a previously released version of BMC Atrium Discovery (other versions).

Migrating scheduled discovery tasks

Skip to end of metadata
Go to start of metadata
Space Search

Searching ADDM 8.2

Table of Contents

As introduced in the Fundamental differences in discovering configuration data section, BMC Atrium Discovery 8.2 contains several fundamental differences from version 7.5 in the way it schedules scans. This, in turn, affects how you must approach and accomplish the migration of the data so that scheduled scans are available in the current version.

Considerations for migrating scheduling data

The primary factors that impact how version 7.5 schedule data is migrated include:

  • BMC Atrium Discovery 8.2 does not contain named collections of IP Addresses, IP Ranges and IP Subnets such as version 7.5. These need to be migrated as lists of IP addresses, ranges, or subnets.
  • The different scheduling periods for each version must be mapped to the nearest equivalent schedule period. For example, BMC Atrium Discovery 8.2 has no direct equivalent to 'Every x (>=60) minutes + Start Date/Time', and has no equivalent to 'Once + Start Date/Time'.
    Note
    The supported migration path for BMC Atrium Discovery is from version 7.5.01.03 to version 8.2. If you plan to migrate data from earlier versions of BMC Atrium Discovery (or BMC Topology Discovery and BMC Foundation Discovery), you must first upgrade to version 7.5.01.03. For users migrating their mainframe data using BMC Discovery for zOS version 1.5, you must first upgrade to version 1.6.

Process for migrating scheduled discovery tasks to a scheduled scan

The following steps provide an overview of how you migrate scheduled data from version 7.5.01.03 into BMC Atrium Discovery 8.2 to create a scheduled scan.

  1. Install and run the M-Tools utility to store the discovery task settings as .xml files
  2. Determine which tasks must be migrated
  3. Examine each discovery task. The items that need to be copied across are:

Migrating scheduled discovery tasks to a scheduled scan

The following sections detail the steps in the process overview.

Determine which tasks must be migrated

In the BMC Atrium Discovery version 7.5 Discovery Tasks panel, all tasks which have scheduling information attached have a clock face icon next to their name. For example, in the following illustration, the Discovery_Asset_UNIX task is a scheduled task.

For each discovery task with scheduling information attached, migrate the the task according to the steps below.

Open the Add a New Run dialog

To open the Add a New Run dialog and begin creating a scheduled scan:

  1. From the Discovery Status page, click the Add New Run ... link. The Add a New Run dialog is displayed.
    On a consolidation appliance the link name is Add New Local Run ...
  2. The Add a New Run dialog is displayed.
  3. Select the Scheduled radio button. The dialog is refreshed to show Frequency, Start Time, and Duration drop-down lists.
  4. Enter the name of the discovery task into the Label field.

Enter IP information

To enter the IP information from the discovery task:

  1. Fully expand the Discovery Domains section of the discovery task in the 7.5 UI. Each range or IP address must be entered into the 8.2 UI as part of a comma separated list.
    1. For Addresses, simple copy the IP addresses as a comma separated list into the Range field of the Add a New Run dialog.
    2. For Ranges, the format must be converted from one that 7.5 understands to the format understood by 8.2. 7.5 uses the format a.b.c.d-e.f.g.h, which represents all IP addresses between a.b.c.d and e.f.g.h inclusive as though these were treated as 32 bit numbers. 8.2 supports ranges only on individual octets, for example a.b.c.d-e. Converting the 7.5 form into the 8.2 form is relatively straightforward if the range is small: for example 1.1.1.1-1.1.1.254 becomes 1.1.1.1-254. For larger ranges, you will need to include more IP addresses on 8.2 than you did on 7.5, or enter multiple ranges, each covering a different portion of the 7.5 task range. Multiple ranges can be entered by separating them by commas.

It is recommended that, rather than just doing a mechanical translation, you think about what each task is trying to achieve and recast it in 8.2 terms.

The following images show an example of the conversion of 7.5 discovery domains to range information in 8.2:


Enter scheduling information

There are a number of choices for entering scheduling information. The options depend on the schedule that you selected in the BMC Atrium Discovery 7.5 discovery task. The following illustration shows the scheduling options available in the Discovery task wizard.

Each option is described in the following table:

Field Name Details
No schedule. No equivalent in 8.2. You cannot migrate this option to 8.2, because there is no way of representing a named set of IP addresses that are scheduled only at a later date. Use a snapshot scan in BMC Atrium Discovery version 8.2.
Once. No equivalent in 8.2. Can be reproduced in the monthly scan entry by selecting a single day, start time, and duration. This can only be in the next month; there is no way to schedule a single scan more than one month in the future. The scheduled scan must be manually removed after the scan has occurred.
Every <number of minutes>. No equivalent in 8.2. BMC Software recommends that you replace this option with a daily scan.
Every <number of hours>. No equivalent in 8.2. BMC Software recommends that you replace this option with a daily scan.
Every <number of days>. Can be reproduced in the weekly or monthly scan entry by selecting multiple days. For example, for a discovery task scheduled every 2 days in version 7.5, configure scheduled weekly scan starting on a Monday, a Wednesday, and a Friday. This is not an exact reproduction, so you must decide the best days to run the scan.
Weekly on <day>. Can be reproduced exactly in the weekly scan entry, although the start time can only be specified to the nearest hour.
Monthly on <day>. Can be reproduced exactly in the monthly scan entry, although the start time can only be specified to the nearest hour.

The Add a New Run dialog

The Add a New Run dialog is described in the following table.

Field Name Details
Range Enter either a single IP address or a range in one of the following formats:
• IP addresses, as a single address or a range, or a comma separated list (for example, 172.17.1.1 or 172.17.1.1-5 or 172.17.1.1, 172.17.1.2, 172.17.1.3)
• A subnet (for example 172.17.2.0/24)
• A * wildcard (for example 172.17.1.*)
These may be combined (for example, 172.17.1.*, 172.17.2.0/24, 172.17.3.100-105, 172.17.4.1, 172.17.4.2, 172.17.4.3)
Level Select one of the following levels for the discovery run:
• Sweep Scan - This will do a sweep scan, trying to determine what is at each endpoint in the scan range. It will attempt to login to a device to determine the device type.
• Host Identification - Identifies enough information to build a host and its interfaces. Usually this will involve getting the host information and the interfaces for the endpoint.
• Host Information - Retrieves all the default information for hosts, but does not perform any inference.
• Full Discovery - Retrieves all the default information for hosts, and completes full inference.
Label Enter a label for the discovery run. Where the discovery run is referred to in the UI, it is this label that is shown.
Frequency Select a frequency for the discovery run to be performed. For example, this can be Daily, Weekly, or Monthly.
For a weekly discovery run, you are provided with buttons for each day. Select the day or days that you want the run to take place.
For a monthly discovery run, you are provided with buttons for each day in the month. Select the day or days that you want the run to take place. Alternatively, select the Scan on the radio button and choose one of the following options:
• First
• Second
• Third
• Fourth
• Last
Additionally, select the day that you want the scan to take place. In this way you can select the Second Tuesday of the month and so forth.
Start Time Select a time for the scan to start. Discovery must be running at the time specified.
Duration Select a duration in hours. This is the length of the scan window and can be from 1 to 23 hours.

Editing an existing scheduled run

You can edit an existing scheduled run. If the run is currently in progress, it is automatically canceled when you edit it. To edit the run, perform the following steps from the Scheduled Runs tab of the Discovery Status page:

  1. Click the Scheduled Run that you want to edit.
  2. The Edit an Existing Run dialog is displayed:

  3. All of the fields described in the table above are editable. Make the required changes, click OK to apply the changes, and dismiss the dialog.
Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.