ACO configuration modification using XPSExplorer on Policy Server

Products

• SITEMINDER

Issue/Introduction

Having to modify all the agent configuration objects (ACOs) at once, and being investigating the XPSExplorer tool that allows downloading an XML file with all the information of the ACOs.

What would be the correct way to upload all the information with XPSExplorer?

Environment

Policy Server 12.8SP7

Resolution

1. Put all the ACO configurations that need to be modified in an .xml file;
2. Modify the values that need to be changed;
3. Import the data with XPSImport.

Sample

Here's a full sample of changing the ACO name myACO to myACO-1.

Note that the menu number might change if run on a different version of 12.8SP7.

# XPSExplorer

  Enter Option (#,F,B,X,P, or Q): 108
  Enter Option (ALNFSQ): S

    7-CA.SM::AgentConfig@21-000213d9-52e3-251g-8s56-055548ssc555sd
                (I) Name  : "myACO"

  Enter Option (#, +, -, B, X, Y, M, Q): 7

  ------------------------- Object Meta Data ------------------------
           XID: CA.SM::AgentConfig@21-000213d9-52e3-251g-8s56-055548ssc555sd
  [...omitted for brevity...]

  X - Add to XCart (use Mode: DEFAULT)
  ------------------------------------
  Enter Option (MJLRPWDAX+Q): X

  Enter Option (MJLRPWDAXQ): Q
  Enter Option (#, +, -, B, X, Y, M, Q): Q
  Enter Option (ALNFSQ): Q

  X - XCart Management (1 item(s)) - UNSAVED
  ------------------------------------------

  Enter Option (#,F,B,X,P, or Q): X

  There is 1 object in the cart

   1-CA.SM::AgentConfig@21-000213d9-52e3-251g-8s56-055548ssc555sd
  Import mode: DEFAULT
   (I) Name                            : "myACO"

   Enter Option (L,M,N,T,A,O,R,D,Z or Q): R
   Enter Option (Object (enter to abandon)): 1

   There is 1 object in the cart

   1-CA.SM::AgentConfig@21-000213d9-52e3-251g-8s56-055548ssc555sd
  Import mode: REPLACE
   (I) Name                            : "myACO"

  Enter Option (L,M,N,T,A,O,R,D,Z or Q): N
  Path to save:/opt/CA/siteminder/xcart.xml

  S - Save cart to file (/opt/CA/siteminder/xcart.xml)

  Enter Option (L.S,M,N,T,A,O,R,D,Z or Q): S
  Enter Option (L.S,M,N,T,A,O,R,D,Z or Q): Q
  Enter Option (#,F,B,X,P, or Q): Q

# cat xcart.xml

  # Type: CA.SM::AgentConfig
  #  (I) Name                            : "myACO"
  REPLACE=CA.SM::AgentConfig@21-000213d9-52e3-251g-8s56-055548ssc555sd

# XPSExport pstore.xml -xf xcart.xml -npass

# cat pstore.xml

  <?xml version="1.0" encoding="UTF-8"?>

  [...omitted for brevity...]
  
          <Object Class="CA.SM::AgentConfig" Xid="CA.SM::AgentConfig@21-000213d9-52e3-251g-8s56-055548ssc555sd" CreatedDateTime="2023-11-08T09:21:10" ModifiedDateTime="2023-11-14T09:30:35" UpdatedBy="<name>" UpdateMethod="GUI" ExportType="Replace">

  [...omitted for brevity...]

              <Property Name="CA.SM::AgentConfig.Name">
                  <StringValue>myACO</StringValue>
              </Property>
          </Object><!-- Xid="CA.SM::AgentConfig@21-000213d9-52e3-251g-8s56-055548ssc555sd" -->
      </PolicyData>
  </XPS>

Here, edit the pstore.xml to make the changes.

For instance, let's change the AgentConfig.Name value to myACO-1:

            <Property Name="CA.SM::AgentConfig.Name">
                <StringValue>myACO-1</StringValue>

Save the pstore.xml file.

# XPSImport pstore.xml -c

 

Then, running XPSExplorer and showing objects from menu 108, the ACO myACO is being named myACO-1.

The AdminUI will show the ACO name myACO-1 too.