What is the 'Content Utility'and how do I set it up ?

Document ID : KB000023045
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction:    

The Content Utility tool lets you share software definitions between independent CA ITCM installations.

The new and updated software definitions provided by CA are first downloaded to an online Domain (or Enterprise) manager that has access to the Internet, and then can be imported into all the offline domain (or enterprise) managers.

The exported definitions are saved as text files that can be shared by installations that are either not part of the same network or run in an offline environment.  You can export the software definitions to files on a shared network location or a portable media, such as a USB device, and then import them into the offline installations.

The utility works with both CA provided and custom-created software definitions and is available as a command line utility.

 

Question:

What is the 'Content Utility and how do I set it up?

 

Environment:                                   

CA Client Automation - All Versions

 

Answer:

1. Run the Content Utility: 

The Content Utility is a program that performs the actions described in the configuration file, content_utility.xml.

To run the Content Utility, Double-Click on contentutility.exe in the CA\DSM\BIN folder

This will create a content_utility.xml file.

  

2. Configure the Content Utility

When the Content Utility runs for the first time, it generates a configuration file named content_utility.xml in the

\CA\DSM\bin folder. You must configure this file to set the following parameters:

 

? Specify whether you want to export or import or both. If you choose both, the import starts only after the export is complete.

? Specify whether you want to process the CA Provided or Custom Created definitions or both.

? Specify the export and import server names.

 

 The content_utility.xml looks like this after the first run:

  <contentutility_configuration>

 
     <general>
               <datadirectory></datadirectory>
     </general>
     <export> 
 
           <manager>
                     <hostname>SOURCE</hostname>
                     <enabled>yes</enabled>
                     <ca_provided>no</ca_provided>
                     <custom_created>no</custom_created>
                     <ca_intellisig>no</ca_intellisig>
                     <custom_intellisig>no</custom_intellisig>
                     <intellisig_detail>no</intellisig_detail>
          </manager>
     </export>
     <import>
 
          <manager>
                    <hostname>TARGET</hostname>
                    <enabled>yes</enabled>
                    <ca_provided>yes</ca_provided>
                    <custom_created>no</custom_created>
                    <ca_intellisig>no</ca_intellisig>
                    <custom_intellisig>no</custom_intellisig>
                    <intellisig_detail>no</intellisig_detail>
            </manager>
      </import>
 </contentutility_configuration>
 

 General Section

 This section has the following tag:

DataDirectory

Defines the location of the export and import files.

The default path is C:\Documents and Settings\All Users\Application Data\CA\software_definitions.

  

You can leave the Data Directory Blank, this is only used if you are doing the contentutility process in 2 steps:

Step 1.    Export from one machine and put in above directory

Step 2.    Import on second machine from above directory

  

We are going to do the process in one step Export and Import without using any intermediate directory

 

Export Section

In this section, you can specify the following parameters for exporting the files:

Hostname             -        Defines the name of the DSM manager where you want to export the files.

Enabled                -        Specifies whether files are to be exported.

CA_Provided          -       Defines whether the CA Provided definitions must be exported.

Custom_Created    -       Defines whether the custom software definitions must be exported.

CA_Intellisig          -       Defines whether the CA Intellisisg definitions must be exported.

Custom_Intellisig   -        Defines whether the custom created intellisig definitions must be exported.

intellisig_Detail      -        Defines whether the CA Intellisisg definitions must be exported.

 

 

 Import Section

In this section, you can specify the following parameters for importing the files:

Hostname              -     Defines the name of the DSM manager where you want to export the files.

Enabled                 -     Specifies whether files are to be exported.

CA_Provided          -     Defines whether the CA Provided definitions must be exported.

Custom_Created    -     Defines whether the custom software definitions must be exported.

CA_Intellisig          -     Defines whether the CA Intellisisg definitions must be exported.

Custom_Intellisig   -     Defines whether the custom created intellisig definitions must be exported.

intellisig_detail      -      Defines whether the CA Intellisisg definitions must be exported.

 

NOTE: The Import fields that you select should match the Export fields that were selected.

 

3. Run the ContentUtilty job as an Administrator

   

4. If there is an Error here is a description of the Logs and where they are:

 

The content utility generates a set of log files from which you can determine the status or result of the export or import.
The following log files are located under ...\CA\DSM\logs: 

ContentUtility.<Source_Machine>.log     -    List the Tables and times of the records exported from the Source Machine 

ContentUtility.<Target_Machine>.log     -     List the Tables and times of the records Imported into the Target Machine  

TRC_CF_ContentUtility.log                     -     Logs of the whole run of ContentUtility 

 

Additional Information:        

SQL Bridge uses this process by Default, to get the signatures from Source machine to the Target.                          

File Attachments:
TEC528386.zip