How to successfully replicate the Software Delivery Portal Settings Task

Article:HOWTO7891  |  Created: 2007-08-24  |  Updated: 2007-08-24  |  Article URL http://www.symantec.com/docs/HOWTO7891
Article Type
How To



Problem
Manually exporting a cloned or new "Software Portal settings task" from one Notification Server and exporting it into another Notification Server, proves to be a simple and trouble-free operation.

However, if you are using Package Replication Solution as you wish to have hierarchical functionality in your Notification Server 6.0 infrastructure, then this operation causes issues, due to the fact that when a "Software Portal settings task" is created, a hidden "Software Portal settings task for "name of task" Task is also created. This means that when PRS runs its export, it is not exporting one item for the Software Delivery Solution Portal but two, as they are dependent on each other.

This scenario will cause the following error to be recorded in your Notification Server's a.log files when this Task is enabled and a client requests a new configuration:

Priority: 1
Date: 13/08/2007 07:02:38
Tick Count: 60446046
Host Name: NS6-VM3
Process: aexsvc.exe (1244)
Thread ID: 4116
Module: AltirisNativeHelper.dll
Source: Altiris.NS.ClientConfigManagement.ClientConfigManager.GetClientConfigXml
Description: Unable to get the config xml for the specified item (Item: Software Portal settings task for - "Corporate Software Portal Settings Task", Exception: Altiris.NS.Exceptions.AeXException: Unable to build the client configuration XML for advertisement with guid Software Portal settings task for - "Corporate Software Portal Settings Task". Reason: Did not get a row for Software Delivery Advertisement "Software Portal settings task for - "Corporate Software Portal Settings Task"", Guid = Software Portal settings task for - "Corporate Software Portal Settings Task" from the SWD tables. ---> Altiris.NS.Exceptions.AeXException: Did not get a row for Software Delivery Advertisement "Software Portal settings task for - "Corporate Software Portal Settings Task"", Guid = Software Portal settings task for - "Corporate Software Portal Settings Task" from the SWD tables.
   at Altiris.NS.StandardItems.SoftwareDelivery.AdvertisementItem.OnBuildClientConfigXml2(Guid workstationGuid, XmlNode requestDocumentElement, XmlTextWriter xmlBuilder)
   --- End of inner exception stack trace ---
   at Altiris.NS.StandardItems.SoftwareDelivery.AdvertisementItem.OnBuildClientConfigXml2(Guid workstationGuid, XmlNode requestDocumentElement, XmlTextWriter xmlBuilder)
   at Altiris.NS.StandardItems.Policies.ClientConfigPolicy.Altiris.NS.ItemManagement.IItemClientConfig2.GetConfigXml(Guid resourceGuid, String requestXml)
   at Altiris.NS.ClientConfigManagement.ClientConfigManager.GetClientConfigXml(GuidCollection itemGuids, Hashtable itemConfigXml, Guid resourceGuid, String requestXml, String extraKey))

Environment
Notification Server 6.0.6074 R5
PRS 6.0.1035
Software Delivery Solution 6.1.1058

Cause
The "Software Portal settings task" that you wish to have replicated, already contains its dependent hidden Task within its XML upon export. However, as this hidden Task is also an item that is placed in the same folder as the visible item, PRS exports that as well.

This causes the separate hidden item to be imported, overwriting the dependency data for itself that was imported when the visible Task was imported.

Resolution
In order to successfully replicate the "Software Portal settings task", the following process must be adhered to. If you have already replicated the "Software Portal settings task", then you will have to delete it from the Parent and allow replication to run in order to have it deleted from all Notification Servers.

  1. Either clone or create a new "Software Portal settings task", rename it, configure it, and then move it to your replication folder.
  2. Run the following query in order to find the GUID of the hidden Task that was also created:

    SELECT Guid,[Name] FROM Item WHERE [Name] LIKE 'Software Portal settings task for - %'

                                                                            
     GUID      Name
     A2E2FDF0-53F8-4F87-A143-0F472431A215   Software Portal settings task for - "New Software Portal settings task"
     FA2A002C-D6A9-4777-88D3-4B25690616F8   Software Portal settings task for - "Corporate Software Portal Settings Task"
          
  3. The top item will be present in all Notification Server databases, as it is the default item created during the installation of Software Delivery Solution. The second item references the Task that I created.
  4. If you run the tool that is attached to article 35427 you find that this hidden Task resides in your replication folder, which is what is causing this problem: 

     ItemGUID  ItemName  Depth
     FA2A002C-D6A9-4777-88D3-4B25690616F8   Software Portal settings task for - "Corporate Software Portal Settings Task"  0
     50463B79-3ED0-475F-BB54-A295DA40E8A4  SWD  1
     D19F85AF-58EF-44C3-A412-6180B96CF573  Corporate Configuration  2
     5D9E00C1-146F-478B-A94D-CCBBE89E0347  Configuration  3
     D0E33520-C160-11D2-8612-00104B74A9DF   Notification Server   4
                                                     
                                                                                                          
  5. The Notification Server components of the Administrator Software Development Kit will now need to be installed, so that we can move this hidden item to the Notification Server's "Internal Hidden Item" folder which is where is belongs.
  6. Enter the GUID of the hidden task into this command line, and then run it:

    "C:\Program Files\Altiris\Altiris ASDK\Bin\AltirisASDKNS.exe" cmd:MoveItem itemGuid:"<HiddenItemGuid>" destinationFolderGuid:"3B298F2D-3A83-4979-B58D-E819A2E41D51"

  7. Running the tool from article 35427 again will show that the move was successful: 
                                                                                                                                                                              
     ItemGUID  ItemName   Depth
     FA2A002C-D6A9-4777-88D3-4B25690616F8  Software Portal settings task for - "Corporate Software Portal Settings Task"  0
     3B298F2D-3A83-4979-B58D-E819A2E41D51  Internal Hidden Folder  1
     D0E33520-C160-11D2-8612-00104B74A9DF  Notification Server  2
     
  8. If you open the packages.zip file on your Notification Servers after replication has taken place, you will see that it does not contain the hidden item as a separate item, and that after the import this hidden item now resides in the "Internal Hidden Folder" on all Notification Servers, and that your Child Notification Servers clients now receive configuration policy details about the Portal.

Legacy ID



37651


Article URL http://www.symantec.com/docs/HOWTO7891


Terms of use for this information are found in Legal Notices