"WARNING: unable to obtain list of files using specified search criteria" when attempting to restore from a User Archive that ended in Status Code 4 when using a VERITAS NetBackup (tm) 5.0, 5.0 MP1, 5.0 MP2, 5.0 MP3, or 5.1, 5.1 MP1.

Article:TECH35387  |  Created: 2004-01-10  |  Updated: 2004-01-22  |  Article URL http://www.symantec.com/docs/TECH35387
Article Type
Technical Solution

Product(s)

Environment

Issue



"WARNING: unable to obtain list of files using specified search criteria" when attempting to restore from a User Archive that ended in Status Code 4 when using a VERITAS NetBackup (tm) 5.0, 5.0 MP1, 5.0 MP2, 5.0 MP3, or 5.1, 5.1 MP1.

Error



WARNING: unable to obtain list of files using specified search criteria.

Solution



Error Message: "WARNING: unable to obtain list of files using specified search criteria" when attempting to restore from a User Archive. (Figure 1).
Figure 1:

When this error message appears check for the following conditions:
1. The User Archive ended in a Status Code 4.
2. Master Server is running Unix.
3. The User Archive Policy is set to use Checkpoint restart.
4. If the Policy destination Storage Unit is using tape media and not disk.
Note: If the above conditions exist the error is generated because the image database is incomplete. The Header file for the User Archive image exists, but the (.f file) or Files File does not.
Note: Open the policy to view the attribute selections for Storage Unit and Checkpoint restart. (See Figure 2).
5. If the User Archive Policy is using a Disk Storage Unit (DSU) or a Disk Staging Storage Unit (DSSU), see Figure 3, please refer to TN 272853 in the related document section below.

Figure 2:


Figure 3:


Corrective Action:
1. If the Policy is using a tape storage unit the image must be imported immediately to restore files.
    The import process must be performed immediately as the tape is vulnerable to overwrite and the image could be lost.
    This import process is a bit different because the header file must be deleted before importing can occur.
      To check if the image database files are intact. Both the header and files file (.f file) must exist.
      To find the Image Header and (.f file) perform the following actions:
        a. Locate the Job ID that matches the User Archive for the Client that ended in a Status Code 4 in the Activity Monitor.
        b. Once the Job ID is known, go to Reports and All Log Entries.
        c. Sort by the Job ID and Client and search in the descriptions field for the Backup ID. Example in (Figure 4).
          In the following example, the Client is pr2, the Job ID is 124, and the Backup ID is pr2_1100193093. (The Backup ID is a combination of client_name and the CTIME of the backup).
          The Header and .f file will be located in the image database based upon the first 4 digits of the CTIME in the backup ID.
          In this example the Header and (.f) files file will be in a directory netbackup/db/pr2/1100000000.
Figure 4.


      d. On the Unix Master, from a command line change directory to usr/openv/netbackup/db/<client_name>/1100000000
        <client name> is the NetBackup client that ran the User Archive, and 1100000000 is the folder created based on the first 4 digits of the CTIME in the Backup ID.
        Example: usr/openv/netbackup/db/pr2/1100000000
      e. In this directory locate the image (Header and (.f) files file) for the Client User Archive.
        Example:  Header: ARC_1100191340_UARC and (.f) ARC_1100191340_UARC.f.
      f. If the Header file is present but the (.f) files file is not, delete the ARC_1100191340_UARC file.
        It is necessary to delete this file in order to import the image.
2. Once the Header file is deleted perform the following procedure to import the image.
This procedure is from the VERITAS NetBackup� 5.0 System Administrator's Guide, Volume I for UNIX.
If using 5.1 please refer to the procedure located in the 5.1 Administrator's Guide in the related document section below.

    Importing Images
    ? To initiate an import - Phase I
    The result of initiating Phase I of the import process is to create a list of expired images
    from which to choose to import in Phase II. No actual import occurs in Phase I.

    1. Add the media IDs that have the backups to Media Manager on the server where you are going to import the backups.
    2. In the NetBackup Administration Console, expand NetBackup Management Catalog.
    3. Select Actions > Initiate Import. A dialog appears titled Step 1: Read Catalog from Media.
       - The Master Server field indicates the master server to which you are importing the images.
       - In the Media Host field, specify the name of the host that contains the volume you are going to import.
       - In the Media ID (to import) field, type the Media ID of the volume that contains the backups you are importing.

    4. Click OK to start the process of reading the catalog information from the source volume.
    5. Click on the Catalog Results tab to see NetBackup look at each image on the tape and determine
        whether or not it has expired and can be imported. The job also displays in Activity Monitor as an
        Import type. Select the import job log just created to view the job results.

    Note Since it is necessary to mount and read the tape at this phase, reading the catalog and building the list can take some time to complete.

    ? To import backup images - Phase II
    1.
    In the NetBackup Administration Console, expand NetBackup Management Catalog.
    2. Set up the search criteria to find imported images by setting the search action to Import. Be sure to select a date range that includes the images you want to import.
    3. Select the image(s) you wish to import and Select Actions Import. The Confirm Import dialog appears.
    4. To view the log, click the Results tab, then select the import job log just created.
      Note When importing backups that have fragments on more than one tape, do not start the import until you have read the catalog for all the tapes containing fragments.
      Otherwise, the import will fail with a message similar to the following:
      Import of backupid failed, fragments are not consecutive.

Viewing Job Results
The results of verify, duplicate, or import jobs appear in the Results tab. The top portion of the dialog displays all existing log files.
To view a log file, select the name of the log from the list. The log file currently displayed appears in the bottom portion of the Results dialog.
If an operation is in progress, the log file display is refreshed as the operation proceeds.

    ? To view or delete a log file
    1.
    In the NetBackup Administration Console, expand NetBackup Management Catalog.
    2. Click the Results tab.
    3. Select a log file.
    4. Select View Full View to display the entire log file in a screen editor. Select Edit Delete to delete the log.
      You can also right-click the log file and select an action from the scroll-down menu.

FORMAL RESOLUTION:
The issue where the image database on the Master Server is incomplete will be resolved in NetBackup 5.0 MP4, now available at:  http://support.veritas.com/tabs/download_ddProduct_NBUESVR.htm
 and NetBackup 5.1 MP2, scheduled for release end of January 2005.


Supplemental Materials

SourceError Code
Value4
Descriptionarchive file removal failed


Legacy ID



272880


Article URL http://www.symantec.com/docs/TECH35387


Terms of use for this information are found in Legal Notices