################################ Introduction #################################
#
# This file should be used to add Oracle Universal Installer inventories to
# Host Configuration collection performed by EMD. Note that usage of this file
# is optional and is for advanced users only. It's not needed for hosts that 
# do normal installations, but rather for users who have cloned software 
# installations and the corresponding inventory, or those who manually 
# manipulate the OUI internal files (oraInst.loc) to segregate inventories.
#
# In this file, you can specify both
#
# (a) inventories in addition to the "default" inventory (i.e. the one 
# pointed to by /var/opt/oracle/oraInst.loc file or its analog; or in other 
# words, inventory displayed when you bring up Oracle Universal Installer).
# Inventories are specified using an absolute/full path to the oraInst.loc-like
# file.
#
# (b) home location mapping between home locations as recorded in the
# inventories, and "real" home locations on the host. This mapping is required 
# to correctly match information discovered by Host Configuration with home
# location information as reported by the targets. For example, if you have an
# inventory with 9i database home location /gold/oracle/ora9i which in reality
# corresponds to home /customer123/production/ora9i, the database target will
# show its home as "/customer123/production/ora9i" and, without mapping,
# Host Configuration will only know about "/gold/oracle/ora9i" home which may
# not even exist on your host.
#
##############################################################################

################################ File format #################################
#
# White space is ignored at the beginning and end of any line.
#
# After white space is removed:
# (1) Empty lines are ignored.
# (2) Lines starting with hash (#) are considered comments and ignored as well.
# (3) Other lines have to start with one of the following:
#     (a) "inventory:",
#     (b) "original home:", or
#     (c) "real home:"
#     without double quotes.
#
#     Lines of type (a) above are used to specify an additional inventory. All
#     homes in this inventory will be added to Host Configuration collection.
#     (Duplicate inventories are ignored which might be convenient if you want
#     to list default inventory in this file as well in case default inventory
#     keeps changing among other inventories in the file.)
#
#     Lines of type (b) are used to specify home location as recorded in the
#     inventory (modulo ending slash which is ignored). These lines HAVE to be
#     followed by the corresponding lines of type (c) to complete home mapping.
#
#     Lines of type (c) are used to specify real home location that original
#     home should be mapped to. (Ending slash is NOT removed in this
#     case so that if target specifies its home with a slash, you can do it
#     here as well.) 
#
#     Order of lines in the file is important: lines of types (b) and (c) have
#     to specify homes in either the last read inventory, or if
#     there is none (i.e. no line of type (a) has been read yet), in the
#     default inventory.
#
#     If an inventory contains only one oracle home or only one appltop,
#     original home path does not have to be specified; only real home needs
#     be specified if the mapping is needed.
#
#     After the prefix specified in (a), (b), or (c) above is read in, white
#     space is ignored, and the path to inventory file in case of (a), or home
#     directory location in cases (b) and (c) are read in. (White space at the
#     end of the line is also ignored as mentioned earlier.)
#
##############################################################################

################################ Example #####################################
#
#     # default inventory home mapping (no "inventory:" lines occurred yet)
#     original home: /gold/oracle/ora817
#         real home: /customer123/oracle/ora817
#
#     # Note that IF default inventory contains only one oracle home, the
#     # "original home:" line above could be removed
#
#
#     # add another inventory
#     inventory: /var/opt/oracle/oraInst.loc.ora9i
#
#     # out of all homes that are read from the above inventory,
#     # map the following ones:
#
#     # home location as specified in the inventory
#     original home: /gold/oracle/ora902
#     # real home location on the host itself
#         real home: /customer234/oracle/ora902
#
#     original home: /gold/oracle/ias92
#         real home: /customer234/oracle/ias92
#
#     # add an inventory that does not need any mapping
#     inventory: /private/test_databases/testInventory.loc
#
#     # add yet another inventory.. in this case, with one oracle home that
#     # needs to be mapped.
#     inventory: /var/opt/oracle/oraInst.loc.old
#     real home: /private/oracle/ora816
#
##############################################################################