NRMServerInventory.xml

Generates an inventory for each volume and combines each volume's inventory into a server inventory.

Syntax

   <Server_Inventory name=""/> 
   <Inventory_Status/>
   <Space_Available/>
   <Volume_Count/>
   <Space_Used/>
   <Directory_Count/>
   <File_Count/>
   <Space_Change_Last_Day/>
   <Space_Change_Last_Week/>
   <Space_Change_Last_Month/>
   <Estimated_Months_Left/>
   <File_Type_Count/>
   <File_Owner_Inventory>
      <Owner Global_DN="" Local_ID="">
         <Space_Used/>
         <File_Count/>
      </Owner>
   </File_Owner_Inventory>
   <File_Type_Inventory>
      <Extension name="">
         <Space_Used/>
         <File_Count/>
      </Extension>
   </File_Type_Inventory>
   <File_Modified_Inventory>
      <Group range="">
         <Space_Used/>
         <File_Count/>
      </Group>
   </File_Modified_Inventory>
   <File_Access_Inventory>
      <Group range="">
         <Space_Used/>
         <File_Count/>
      </Group>
   </File_Access_Inventory>
   <File_Create_Inventory>
      <Group range="">
         <Space_Used/>
         <File_Count/>
      </Group>
   </File_Create_Inventory>
   <File_Size_Inventory>
      <Group range="">
         <Space_Used/>
         <File_Count/>
      </Group>
   </File_Size_Inventory>    

Elements

Server_Inventory

Specifies the root element for NRM inventory requests.

Inventory_Status

Specifies the status of the inventory:

  • Done
  • Scanning
Space_Available

Specifies the amount of free space on the server.

Volume_Count

Specifies the number of volumes on the server (excluding the _ADMIN volume).

Space_Used

Specifies the byte space in use by all files on the server.

Directory_Count

Specifies the number of subdirectories on the server.

File_Count

Specifies the number of files on the server.

Space_Change_Last_Day

Specifies the change in terms of available space (MB) for the last day, as a signed integer.

Space_Change_Last_Week

Specifies the change in terms of available space (MB) for the last week, as a signed integer.

Space_Change_Last_Month

Specifies the change in terms of available space (MB) for the last month, as a signed integer.

Estimated_Months_Left

Specifies the number of months before the server will have a volume run out of available space (in consideration of last month's rate).

File_Type_Count

Specifies the number of file types that are being tracked in the inventory. If the Inventory_Status is Scanning, it specifies the number of files that have been scanned thus far.

File_Owner_Inventory

Specifies information about the users that own files on the server.

Owner_Global_DN

Specifies the full eDirectory Distinguished Name.

Space_Used

Specifies the amount of byte space in use.

File_Count

Specifies the number of files.

File_Type_Inventory

Specifies information about the different types of files that are stored on the server. This element tracks only the first 2000 file types.

Extension

Specifies the space used and file count for all extensions that were not counted in the first 2000 file types. NRM tracks files that have no extensions and reports them under the No Extension name.

File_Modified_Inventory

Specifies information about when the files were last modified.

Group

Specifies the data about the number of files and associated space that were fall within the specified range.

File_Access_Inventory

Specifies information about when the files were last accessed.

File_Create_Inventory

Specifies information about when the files were created.

File_Size_Inventory

Specifies information about the size of the files.

Attributes

name

Specifies the name of the server.

Local_ID

Specifies the object ID (valid on the local server only).

range

Specifies the range to return information about:

  • Within Last Day
  • 1 Day - 1 Week
  • 1 Week - 2 Weeks
  • 2 Weeks - 1 Month
  • 1 Month - 2 Months
  • 2 Months - 4 Months
  • 4 Months - 6 Months
  • 6 Months - 1 Year
  • 1 Year - 2 Years
  • More than 2 Years

OR

  • Less than 1KB
  • 1 KB - 4 KB
  • 4 KB - 16KB
  • 16 KB - 64 KB
  • 64 KB - 256 KB
  • 256 KB - 1 MB
  • 1 MB - 4 MB
  • 4 MB - 16 MB
  • 16 MB - 64 MB
  • 64 MB - 256 MB
  • More than 256 MB

Remarks

Reading the preceding file causes NRM to generate an inventory for each volume and then combine each volume's inventory into a server inventory. By generating a server inventory, you cause XML inventory files to be generated for each volume (see Volume_Inventory.xml and Volume_Trustees.xml). However, if an inventory was generated in the last hour, that inventory is used (rather than generating a new inventory). With this functionality, you can start an inventory and come back later to process that inventory's data.

When you first read the data, the Inventory_Status tags might indicate “Scanning,” which tells you that NRM is currently generating the inventory. Keep trying until you receive a “Done” status. By processing inventories in this manner, you can asynchronously inventory multiple servers without having to wait for each inventory to complete (and without blocking any threads).

Note that integer values are in base 10.