Creating the computer.yml file

Available from 9.2.5. The computer.yml file contains information about the scanned IBM i system, and is used to catalog scan results and correctly display them in the user interface. Each package with scan results must contain this file, but you can reuse the file as long as it is unique for each IBM i system.

Note: This task is optional, because it can be completed by an automated script. Use it only for advanced scenarios.


  1. Go to /cit, or /cit/config, and edit the computer.yml.sample file. The file contains the following values:
    endpointID: 6552CFF:5
    Agent Version: IBM_doc_v.1.0
    Catalog Version: 1250110.0
    Operating System: IBM i V7R1M0 PowerPC 64
    DNS Name: NC198511
    Computer Name: NC198511
    IP Address:
  2. Take the values from the results of the capacity scan that are in the /cit/output/hw_scan_all/last.xml file. The table provides some details on how to retrieve them.
    Attribute Description Value
    endpointID Mandatory.

    Unique ID of the computer. It must contain the hardware serial number and LPAR ID in the <HWSerial>:<LparID> format, for example 6552CFF:5.

    In capacity results:
    Agent Version Optional.

    You can use this attribute to provide information that lets you differentiate between scan results. For example, if you used the manual procedure to gather them, you can call it IBM_doc_v.1.0, or choose other names for automated processes.

    Catalog Version Optional.

    Versions of the software catalog and its custom content, separated with a dot (.), for example 1250110.0.

    To view these versions, in BigFix InventoryLicense Metric Tool go to Management > Catalog Upload.
    Operating System Mandatory.

    Operating system of the computer. It must start with IBM i, but you can add more information, and have it displayed in the user interface.

    In capacity results:
    <OSName>IBM i</OSName>
    Computer Name Mandatory.

    Name of the computer, used for identification. It can be an IP address, or any name or ID that lets you recognize the computer.

    In capacity results:
    DNS Name Optional.

    Domain name, used for identification. It can be the same as Computer Name.

    IP Address Optional.

    IP address of the computer, used for identification. For multiple IPs, place each address on a new line that starts with a space.

    In capacity results:
    <Address IsKey="1"></Address>

    Syntax for multiple IPs:

    IP Address:
  3. Save the file as computer.yml in the same directory.