Error Updating Portal Integration

Products

• CA API Gateway

Issue/Introduction

Attempting to update the portal integration component from 'Policy Manager->Tasks->Extensions And Add-Ons->Update Portal Integration' results in the following error seen in the generated output and the update fails:

<l7:Mapping action="NewOrExisting" errorType="UniqueKeyConflict" srcId="07abf4540a8e97558800e0e0a5f2e414" type="SCHEDULED_TASK">
                <l7:Properties>
                    <l7:Property key="ErrorMessage">
                        <l7:StringValue>(name)  must be unique</l7:StringValue>
                    </l7:Property>
                </l7:Properties>
            </l7:Mapping>

Environment

Gateway 10.x

Cause

The portal scheduled tasks are expected to have a particular id associated with them.  In this case the Portal Sync API scheduled task within this environment had an id which was different from the expected value of 07abf4540a8e97558800e0e0a5f2e414

Resolution

We need to recreate the Portal Sync API scheduled task with the appropriate id.

1)Execute the following restman call to get output of all existing scheduled tasks:

https://GatewayHostName:8443/restman/1.0/scheduledTasks

2)Copy that data off to a text file for use later on.

3)From Policy Manager->Tasks->Global Settings->Manage Scheduled Tasks->Choose the Portal Sync API task and then select the 'Remove' button to delete it from the environment.

4)We then need to use a utility like postman to generate a call to create the scheduled task with the appropriate id.

HTTP Method: PUT

Authorization: Basic Auth , specify a policy manager admin user and password

request to execute: https://GatewayHostName:8443/restman/1.0/scheduledTasks/07abf4540a8e97558800e0e0a5f2e414

Body of request:  Copy your Portal Sync API data which we produced earlier on in step 1 and formulate a request body which looks similar to the following:

<l7:ScheduledTask xmlns:l7="http://ns.l7tech.com/2010/04/gateway-management">
<l7:Name>Portal Sync API</l7:Name>
<l7:PolicyReference id="b181a5210c08830073fd5e188327b39d" resourceUri="http://ns.l7tech.com/2010/04/gateway-management/policies"/>
<l7:OneNode>true</l7:OneNode>
<l7:JobType>Recurring</l7:JobType>
<l7:JobStatus>Scheduled</l7:JobStatus>
<l7:CronExpression>0 */3 * * * ?</l7:CronExpression>
<l7:ExecuteOnCreate>false</l7:ExecuteOnCreate>
<l7:Properties>
<l7:Property key="idProvider">
<l7:StringValue>0000000000000000fffffffffffffffe</l7:StringValue>
</l7:Property>
<l7:Property key="userId">
<l7:StringValue>00000000000000000000000000000003</l7:StringValue>
</l7:Property>
</l7:Properties>
</l7:ScheduledTask>

5)Execute the above request and the Portal Sync API scheduled task should get recreated and seen within policy manager

6)Attempt to update the portal integration components once again.

Additional Information

The error which was originally generated when attempting to update the portal integration indicated a conflict with a particular scheduled task id of 07abf4540a8e97558800e0e0a5f2e414.  This value is specific to the Portal Sync API scheduled task.  If you are seeing a different value then please contact support so we can determine which scheduled task is having a conflict in your environment.