Share via

Creating a configuration file for OA 3.0

Before you can use the OA 3.0 tool, you must create a configuration file that specifies which way you will use the OA 3.0 tool to create the hardware association, to add your optional information, and to return the Computer Build Report. The configuration file is case-sensitive.

There are two ways that you can interact with the OA 3.0 Tool to create the injectable binary file (OA3.bin) and the OA3.xml file:

  • Server-based. Use the Key Provider service and its parameters as the basis to create the OA3.bin and OA3.xml files.
  • File-based. Create and use an XML file as the basis for the OA3.bin and OA3.xml files.

You must select the configuration file interaction that is compatible with your environment and requirements.

To create the server-based configuration file

  1. Create a new folder to store the output from the OA 3.0 Tool, the OA3.bin file, and the OA3.xml file.
  2. Open a text editor, such as Notepad, and then type the following, using your own parameter information:
<OA3>
   <ServerBased>
      <KeyProviderServerLocation>
         <IPAddress>10.1.1.1</IPAddress>
         <ProtocolSequence>ncacn_ip_tcp</ProtocolSequence>
         <EndPoint>90118765</EndPoint>
<Options></Options>
      </KeyProviderServerLocation>
      <Parameters>
         <Parameter name="OEMPartNumber" value="ABC-12345" />
      </Parameters>
   </ServerBased>
   <OutputData>

<AssembledBinaryFile>C:\temp\data\OA3.bin</AssembledBinaryFile>
      <ReportedXMLFile>C:\temp\data\OA3.xml</ReportedXMLFile>
   </OutputData>
</OA3>

The <Options> element must appear in your script, even if it is empty. Otherwise, the script will fail.

  1. Save the configuration file with the name OA3.cfg.

To create the file-based input XML file

  1. Open a text editor, such as Notepad, and then type the following, using your own product key, product key ID, and product key state information:
<?xml version="1.0"?>
  <Key>
    <ProductKey>W4YPB-2XN63-6D6CH-YQG3R-X2BDY</ProductKey>
    <ProductKeyID>1600000000545</ProductKeyID>  
    <ProductKeyState>2</ProductKeyState>
  </Key>
  1. Save the input file.

There are no naming restrictions for this file. However, you must use the identical name as the file-based OA3.cfg file. For example, for purposes using FileBasedInput.xml, the file-based input xml is only required for file-based mode. If you use MDOS and MSC system, you can export the DPKs to local storage driver with the xml format directly.

To create the file-based configuration file

  1. Open a text editor, such as Notepad, and then type the following, using your own file name and location information:
<OA3>
   <FileBased>
       <InputKeyXMLFile>C:\OA30\FileBasedInputFile.xml</InputKeyXMLFile>
   </FileBased>
   <OutputData>
<AssembledBinaryFile>C:\temp\data\OA3.bin</AssembledBinaryFile>
<ReportedXMLFile>C:\temp\data\OA3.xml</ReportedXMLFile>
   </OutputData>
</OA3>
  1. Save the configuration file using the file name OA3.cfg.

If you do not want to manually create the server-based or file-based configuration files, you can also use an automated process created by your organization.