Update API Community Manager
Keep your Anypoint API Community Manager instance up to date to take advantage of new and improved functionality in your community.
For information about updates, see Important Notifications.
After you install an update with this process, it is not possible to undo the installation and return to a previous version. Follow this best-practice workflow:
-
Keep a partial copy sandbox or a full copy sandbox as a long-term staging environment.
The staging environment will have a partial or full copy of the data in the production environment.
-
Create a short-term developer sandbox.
-
Install the update in the developer sandbox and test it.
-
Discard the developer sandbox.
-
Install the update in the staging sandbox and test it.
-
Install the update in your production environment.
To update your API community:
-
Before performing any steps, read all the steps, including pre-install and post-install.
-
If necessary, notify your customers and stakeholders of the update, and that APIs, docs, and client app pages may not work during the update during the time after installing the new package and before completing the required configuration changes.
-
Ensure that your Salesforce organizations have the External Data Change Tracking for OData 4.0 Adapter feature enabled:
-
Before upgrading the package in your production or sandbox organization, check that your organization has this feature enabled by going to Setup > External Data Source and editing the Exchange data source.
-
If you don’t see an Eligible for External Change Data Capture checkbox, raise a support case through the MuleSoft support portal and list the IDs of all your Salesforce API Community Manager organizations, including the IDs of all production and sandbox organizations.
Attempting to upgrade the package without this feature enabled causes the process to fail with errors due to missing objects and fields related to a missing ChangeEvent object.
-
-
Open the API Community Manager control panel.
-
In the same browser session, open the package update installation link provided by your MuleSoft representative.
-
Verify the version number and name of the release.
-
If you are upgrading from a package version before 1.26, follow the Pre-Install Steps When Upgrading from a Version before 1.26 and then continue with these instructions.
-
If you are upgrading from a package version before 1.74, follow the Pre-Install Steps When Upgrading from a Version before 1.74 and then continue with these instructions.
-
Select Install for admins only.
-
Select Upgrade.
This starts the installation process.
When the upgrade finishes, you receive a notification email.
-
If you are upgrading from package version 1.62 or earlier, follow the Post-Install Steps When Upgrading from Version 1.62 or Earlier and then continue with these instructions.
-
If you are upgrading from a package version before 1.69, follow the Post-Install Steps When Upgrading from a Version before 1.69 and then continue with these instructions.
-
If you are upgrading from a package version before 1.74, follow the Post-Install Steps When Upgrading from a Version before 1.74 and then continue with these instructions.
-
If you are upgrading from a package version before 1.77, follow the Post-Install Steps When Upgrading from a Version before 1.77.
Pre-Install Steps When Upgrading from a Version before 1.26
If you are upgrading from a package version before 1.26, follow these steps:
-
Go to Salesforce Workbench: https://workbench.developerforce.com/
-
Select Standard.
-
Enter your username and password.
-
Click the Login button.
-
In the Queries menu, click SOQL Query.
-
In the Object list, select NavigationLinkSet.
-
In the Fields list, select Id and MasterLabel.
-
Click the Query button.
-
The query results are displayed as a list of records.
-
Find the records with the MasterLabel field set to NTO_Nav0 and acm_template_Nav0.
-
Click the Id of the record with the MasterLabel field NTO_Nav0.
-
Click the Delete button.
-
Click the Confirm delete button.
-
Click the Id of the record with the MasterLabel field acm_template_Nav0.
-
Click the Delete button.
-
Click the Confirm delete button.
-
Continue with normal package installation.
Return to the main list of update instructions and continue to follow them.
Pre-Install Steps When Upgrading from a Version before 1.74
If you are upgrading from a package version before 1.74, follow these steps:
-
Create a new named credential:
-
Click Setup > Named Credentials.
-
Copy the configuration information from the named credential
anypoint_mulesoft
. -
Create a new named credential with the name
Anypoint
and matching configuration.
-
-
Update the external data source:
-
Click Setup > External Data Source > Exchange > Edit.
-
Set URL to
callout:Anypoint/odatabridge/odata.svc/
. -
Ensure that Eligible for External Change Data Capture is enabled.
-
Save.
-
-
Update the previous named credential:
-
Click Setup > Named Credentials.
-
Modify the named credential
anypoint_mulesoft
. -
Set Identity Type to Named Principal.
-
Set Authentication Protocol to Password Authentication.
-
Set Username to the placeholder value
user
. -
Set Password to the placeholder value
pass
. -
In the section Callout Options, enable Generate Authorization Header, Allow Merge Fields in HTTP Header, and Allow Merge Fields in HTTP Body.
-
Return to the main list of update instructions and continue to follow them.
Post-Install Steps When Upgrading from Version 1.62 or Earlier
If you are upgrading from package version 1.62 or earlier, after installing, ensure both Member
and Guest
profiles have field-level Read
access to the ParentId
field in the CommunityAPI
object:
-
Configure the
Member
profile:-
Click Setup > Profiles.
-
Open the
Member
profile. -
Click Object settings > CommunityAPI.
-
Ensure the
ParentId
field hasRead
access. -
Save.
-
-
Configure the
Guest
profile:-
Click Community builder > Settings > General.
-
Open the
Guest
profile. -
Click Object settings > CommunityAPI.
-
Ensure the
ParentId
field hasRead
access. -
Save.
-
Return to the main list of update instructions and continue to follow them.
Post-Install Steps When Upgrading from a Version before 1.69
If you are upgrading from a package version before 1.69, update the permissions of the Member
and Guest
profiles on the SelfRegisterUserRequests object:
-
Configure the
Member
profile permissions:-
Click Setup > Profiles.
-
Open the
Member
profile. -
Click Object settings > SelfRegisterUserRequests.
-
Ensure there are no object level permissions and no field level permissions for this profile on this object.
-
-
Configure the
Guest
profile permissions:-
Open the community builder.
-
Click Settings > General.
-
Open the
Guest
profile. -
Click Object settings > SelfRegisterUserRequests.
-
Ensure that object level permissions include only
Create
andRead
. -
Ensure that field level permissions for all fields include only
Read
andEdit
.
-
-
Check that your permissions match those in the Configure Profiles and Permissions documentation.
Return to the main list of update instructions and continue to follow them.
Post-Install Steps When Upgrading from a Version before 1.74
If you are upgrading from a package version before 1.74, follow these steps:
-
Click Setup > External Data Source > Exchange.
-
In the section Custom HTTP Headers, set X-Auth-Proto to the value
'JWT'
, including the single quotes. -
Save.
-
Upgrading to version 1.74 removes the Spec Downloader component from the community API Details page.
In the community builder, in Pages > CommunityApi > API Detail, add the Spec Downloader component.
Return to the main list of update instructions and continue to follow them.
Post-Install Steps When Upgrading from a Version before 1.77
Potential degraded service of your community: Upgrading from a package version before 1.77 requires mandatory configuration updates. When the new package is installed, user access to assets in the community is disabled. When the configuration is complete, user access to assets in the community is enabled.
If you are upgrading from a package version before 1.77, follow these steps:
Configure sharing settings for guests:
-
In Setup, search for Security using the Quick Find box and click Sharing Settings.
-
Scroll to the CommunityAssetVersions Sharing Rules section near the bottom of the page and click New.
-
In the Rule Name section, update Label with
[Community Name] Sharing Rule
. -
In the Select your rule type section, select
Guest user access, based on criteria
. -
In the Select which records to be shared section, add these criteria.
-
Field:
Community Name
Operator:equals
Value:[Community Name]
-
Field:
Visibility
Operator:equals
Value:Public
-
-
In Select the users to share with, select
[Community Name] Site Guest User
. -
In Select the level of access for the users, select Read Only.
-
Save.
-
In the API Community Manager control panel, open Community Builder and click Settings > General.
-
In the Guest user profile section, click [Community Name] Profile.
-
For each of the four objects CommunityAssetVersions, AnypointAssetCategories, AnypointAssets, and AnypointAssetVersion, in Object Permissions ensure Read is enabled, and in Field Permissions ensure all fields have Read Access enabled.
-
For the object CommunityAssetVersions, in Custom Object Permissions ensure Read is enabled.
-
For the object AnypointApiInstances, in Field Permissions ensure that Version and VersionGroup have Read Access enabled.
-
In External Object Permissions, ensure each item has Read enabled.
-
Save.
Configure sharing settings for members:
-
In Setup, search for Communities using the Quick Find box and click Communities Settings.
-
Scroll to Sharing Sets and click Edit next to the set [Community Name] Sharing Set.
-
In the Select Objects section, select CommunityAssetVersions from Available Objects and add it to Selected Objects.
-
In the Configure Access section, select Set Up under the Action column next to CommunityAssetVersions.
-
In the Access Mapping for *CommunityAssetVersions page enter these values.
-
Account in the User list.
-
acm_pkg__Account_c in the Target CommunityAssetVersions list.
-
Read Only in the Access Level list.
-
-
Update.
-
Save.
-
In Setup, search for Users using the Quick Find box and click Profiles.
-
Repeat the following steps for each of the profiles for your users.
There may be one or more user profiles to configure.
-
Click the profile.
-
In the profile page, click Edit.
-
For each of the four objects CommunityAssetVersions, AnypointAssetCategories, AnypointAssets, and AnypointAssetVersion, in Object Permissions ensure Read is enabled, and in Field Permissions ensure all fields have Read Access enabled.
-
For the object CommunityAssetVersions, in Custom Object Permissions ensure Read is enabled.
-
For the object AnypointApiInstances, in Field Permissions ensure that Version and VersionGroup have Read Access enabled.
-
In External Object Permissions, ensure each item has Read enabled.
-
Save.
If you ever change the name of your community, be sure to update this configuration. |