What is changing?

The deprecated marketplace listing of CSUMCloud has been marked for removal, meaning that after 1st October 2024, support and updates for the app will no longer be managed. The app will eventually be removed from Atlassian marketplace to reduce confusion of multiple app listings for the same add-on.

The correct marketplace listing is still actively maintained and support will be provided, so we encourage migration to the new add-on.

Why has this happened?

Due to limitations of linking Forge applications, when the Cloud version of CSUM was designed, it was not possible to link it as a Cloud version under the existing Atlassian marketplace listing.

Because of this, a new listing was created for the Cloud version of CSUM. Since then, it has now become possible to link Forge add-ons into existing marketplace listings. In order to mark all versions of CSUM under a single add-on, the existing deprecated Cloud listing must be removed from the marketplace.

Which app am I currently using?

The old app listing will display the following banner when you access the app:

If you see this, you are using the old marketplace listing, and will need to migrate.

Old (Incorrect) marketplace listing - Deprecated, pending removal

https://marketplace.atlassian.com/apps/1228612/custom-space-user-management-cloud-migrated-see-main-app?hosting=cloud&tab=overview

New (Correct) marketplace listing

https://marketplace.atlassian.com/apps/133/custom-space-user-management-csum-server-dc?hosting=cloud&tab=versions

If you see the following in your “Manage Apps” screen, you are using the old deprecated app and are encouraged to migrate.

When I migrate, what happens to my created groups or user membership changes?

Created Groups and changes to group membership are made against the existing User and Group directories within your Cloud product.

This means that changes made using the CSUMCloud Space page (Such as “Create Group”, “Add User” etc.) are not linked to the old CSUMCloud marketplace listing. If you navigate to the Group management Confluence page, you will see your created Groups here.

When I migrate, what happens to my CSUMCloud settings?

The new marketplace listing is treated as a new, separate app. In order to copy your CSUMCloud configuration (Such as SpaceGroupPattern, Permissions, etc.), you will need to export your configuration from the old app listing, and import into the new app.

See https://thepluginpeople.atlassian.net/wiki/spaces/CSUMC/pages/4220846098/Marketplace+listing+migration#Export-your-existing-data for further information on transferring your configuration.

Am I affected?

You are affected if you are using the old marketplace listing.

• In “Manage Apps”, if the CSUMCloud app has a Red logo, and mentions that is is migrated, you are using the old marketplace listing and are encouraged to migrate.

• On any CSUMCloud Space page, or System Admin page, if the warning banner mentions the app deprecation, you are using the old marketplace listing and are encouraged to migrate.

What steps are needed to migrate?

If you have not made any configuration changes in the System Admin configuration page, you can install the new app listing and pick up where you left off.

If you have made custom changes to the configuration, such as SpaceGroupPattern or Permission changes, please read on to learn how to migrate configuration from the old app to the new migrated listing.

I have already purchased a subscription for the existing app - what should I do?

We encourage you to reach out to our team through our support channels (or by emailing support@thepluginpeople.com).

What happens if I do not migrate to the correct marketplace listing?

From October 1st 2024, the old listing will be requested to be removed from the marketplace. At the same time, functionality of the addon will be restricted before the app is removed from the marketplace.

https://thepluginpeople.atlassian.net/wiki/spaces/CSUMC/pages/4220846098/Marketplace+listing+migration#What-happens-if-I-don%E2%80%99t-use-the-new-add-on%3F details the limitations of using the old marketplace listing instead of migrating as expected.

Migration guide

A detailed migration guide (along with configuration transfer steps via export/import) have been documented in https://thepluginpeople.atlassian.net/wiki/spaces/CSUMC/pages/4220846098/Marketplace+listing+migration#Export-your-existing-data.

Am I affected?

• You are affected if you try to render the Space page located in Space Settings, and the app attempts to load, but results in a blank screen:

The following issue is derived from our internal ticket: CSUMC-121 - Getting issue details... STATUS , and fixes app rendering for customers that have updated product URL or custom domains.

For other errors, please view our FAQ for more information on identified problems.

\uD83D\uDCD8 How to resolve the issue

As a System admin, you can resolve this issue for all Space admins by performing the following steps:

1. Update the CSUMCloud app to the latest version. Currently, 9.2.0 for the CSUMCloud addon, and 3.1.0 for the CSUM for DC and Cloud addon.

2. Navigate to the System admin section of the app (See System Admin Documentation for more information).

3. Export your current configuration to receive a json file.

4. Using a text editor of your choice, open the file, and navigate to the csumDefaultName attribute. . (If you do not see this attribute, please check step 1 and ensure you are on the latest version).

5. Replace the existing URL with the original Atlassian site URL. (If you are unsure of this, please read ‘How to retrieve my original site URL?’ below.)

6. Save your changes and Import the updated json file using the Import option.

After changes have been saved, you can navigate to the Space admin view of our app from within the Space Settings page to validate changes have been applied and will now render the app correctly.

How to retrieve my original site URL?

When creating your Confluence instance, the site url provided is used to generate default groups.

E.g. The site mysite.atlassian.net will create default groups containing mysite, such as confluence-admins-mysite.

You can navigate to the Atlassian Administration > Groups management section of your site to confirm the original site URL. By searching for admins or users, you should find the default created confluence-users-<SITENAME>.

Why did changing the URL break the app?

Due to limitations with the Confluence Cloud Rest API Group Search functionality, default access groups are exposed. In order to reduce exposure of these default groups, and to prevent Space Admins from being able to view, or edit memberships, of these groups, the CSUMCloud app attempts to filter out these groups from the space groups table and group search fields.

Some default groups are appended with the original site name. E.g. The site mysite.atlassian.net will create default groups containing mysite, such as confluence-admins-mysite. If the product URL changes, or a custom domain is applied, the CSUMCloud app is unable to filter these exposed groups. The default scenario was to prevent rendering in this scenario. After the above steps have been applied to resolve the issue, the CSUMCloud app should be able to continue filtering out the default groups when loading the space groups table.

We are currently discussing this issue with Atlassian on https://ecosystem.atlassian.net/servicedesk/customer/portal/34/ECOHELP-42134 to assess any further changes that can be made to improve performance without affecting customers that have updated their Site using custom domains.

After performing the above steps, subsequent changes to your product URL or custom domains should not affect how CSUMCloud filters default groups.

What is the issue?

We are aware of an issue that prevents users from installing the app from the marketplace. We have reached out to Atlassian regarding installation failures. Updates will be provided in Marketplace listing migration.

After confirming app installation/trial, the following error may appear:

Am I affected?

As per our Marketplace listing migration guide, we are encouraging users to install the https://marketplace.atlassian.com/apps/133/custom-space-user-management-csum-server-dc?hosting=cloud&tab=versions add-on, as the existing add-on (https://marketplace.atlassian.com/apps/1228612/custom-space-user-management-cloud?hosting=cloud&tab=overview ) is being sunset.

As we encourage all customers to switch to use the new add-on, being unable to install the add-on prevents all customers from migrating.

Is my data affected?

Whilst we await response from Atlassian, the original add-on will remain active. We encourage users not to uninstall to avoid data loss, especially if they have not yet exported their configuration (See https://thepluginpeople.atlassian.net/wiki/spaces/CSUMC/pages/4220846098/Marketplace+listing+migration#Export-your-existing-data ).