Page tree
Skip to end of metadata
Go to start of metadata


With Linchpin Theme and Linchpin User Profiles reaching end of life, it's time for an upgrade. You can upgrade and migrate your Linchpin Theme/Linchpin User Profiles app to Linchpin Essentials. You will find all important information regarding such an upgrade here.

Migrate to Linchpin Essentials while upgrading the amount of user licenses

The migration from individual Linchpin apps to the Linchpin Essentials bundle app can be a bit different if the amount of user licenses changes, too.

Backup your data

To back up your data, please make a copy of the database first. This is usually done by your Confluence system administrator.

We recommend to perform the migration on a test instance first, regardless of whether you have performed a backup or not.

Install Linchpin Essentials with new licenses

Now, install the latest version of the Linchpin Essentials app. To do this, either upload the installation file onto your server or install the Essentials a via the Atlassian Marketplace.

See what's new in the latest release: https://seibert.biz/essentialslatestrelease.

Please note: If you already have the Linchpin User Profiles app installed, the installation process of Linchpin Essentials may hang in very rare cases.

Please read this knowledge base article to find more information: Installation or update of Linchpin Intranet Suite hangs.

Also, check out the FAQ just down below.

Uninstall all single apps with old licenses

After the installation of Linchpin Essentials with a new (higher) amount of licenses, apps which were previously activated as single apps (without the Essentials bundle) with other (smaller) amount of licenses will display a warning inside the App Manager.



Please uninstall all apps with the warning "Upgrade Required".

Then, please install the latest version of Linchpin Essentials again. To do this, either upload the installation file onto your server or install the suite via the Atlassian Marketplace.

Quality assurance

First of all, please make sure that all Linchpin apps are listed in the Confluence App Manager. Those apps should also be listed as active.

Re-index all your pages. To do that, navigate to Confluence administration → Administration → Content indexing → Search Indexes. 

You might have to reactivate the navigation menu. Furthermore, make sure that Linchpin Theme is activated in Confluence administration → Look and Feel → Themes.

Then, perform a quality assurance review on the apps and data as needed.

It might also be necessary to clear all Confluence caches!

To do this, navigate to Confluence administration → Administration → Cache Management. Scroll down, to the very bottom of the page. On the right side, there is a Flush all button. Press it to clear the caches.

If you have any problems, please contact your account manager or contact our support team: https://seibert.biz/help.

Optional: Deactivate not needed apps

Linchpin Essentials is a bundle featuring Linchpin Theme, Linchpin User Profiles and the Collapsible Admin Menu.

All Linchpin apps can be fully disabled if you don't wish to use them.


To disable an app, navigate to Confluence administration → Manage apps.

Find the app you wish to disable, open its tab and click on the Disable button.



Do you use a combination of Linchpin User Profiles x or older and Confluence 7.3.x or older?


Older versions of the Linchpin User Profiles app in combination with Confluence older than 7.4.7 or 7.4 Long Term Support

please read this knowledge base article and find out if your Confluence version is prone to this bug making certain parts of Linchpin unavailable.




FAQ & self-help

Help! My installation hangs!

Issue

If you already have the Linchpin User Profiles app installed, the installation of Linchpin Essentials may hang in very rare cases.


Prevention

To make sure that your installation can't begin to hang, uninstall the Linchpin User Profiles app before you install the Essentials app. Linchpin User Profiles will be re-installed with rest of Essentials.


Solution for the freeze

If you couldn't prevent the freeze from happening, there is a solution.

Further information on how to solve this issue can be found here:  Installation or update of Linchpin Intranet Suite hangs.

((warning) This article was written for the Linchpin Intranet Suite but it's applicable to the installation of Linchpin Essentials, too.)

I see a license warning for some Linchpin apps. What do I do now?

Issue

At some point after the initial installation of the Linchpin Essentials bundle, Confluence might display a license warning for some individual Linchpin apps.


Reason

If you've updated your custom set of Linchpin apps regularly in the past, the Linchpin Essentials app might not install the entire set of Linchpin apps in their bundled form. The Linchpin Essentials installer performs a version check in the background. The Essential bundle installs only bundled Linchpin apps that have a newer version than the one already installed on your system.


Solution

Don't worry - as long as a valid license for Linchpin Essentials exists, the individual apps will continue to work just fine.

Please do not uninstall or update any individual Linchpin apps. Instead, wait for the next release of Linchpin Essentials!

My Linchpin apps don't work after a migration to Linchpin Essentials.

Issue

You migrated you individual Linchpin apps to the Linchpin Essentials bundle and now some apps don't work anymore.


Reason

This might be the case if your individual Linchpin apps had a newer app version than the apps which were delivered with the Essentials bundle.

In this case, some things within the app structure and functionality might have changed and the older app version (which is included in the Essentials bundle) can't properly read the information anymore.



Solution

Please wait for a new release of the Linchpin Essentials app. A new version of Essentials will include newer app version and fix the problem by installing the newer app and restoring functionality.

Will I lose my data due to the migration?

No. Your data should not be lost during a migration.

If your apps don't work anymore (for example: macros failing to display content properly), it means that something in the app's structure changed and the older version of the app simply cant read the newer information stored in your system. If this happened to you, read the "My Linchpin apps don't work after a migration to Linchpin Essentials." FAQ entry.

Should I ever downgrade an app?

We can't recommend a downgrade of an app. Some downgrades may cause problems due to incompatibility with the newer data or incompatibility with other apps.

If you wish to try and downgrade the apps instead of waiting for a new Linchpin Essentials release, please use a test instance first. And remember that you do this at your own risk.

Do I need to do a test run first?

At least we strongly recommend to perform the migration on a test instance first. It's just a safer bet - regardless of whether you have performed a backup or not.




The information on this page are valid for both Linchpin Theme-only customers and Linchpin User Profiles-only customers. It does not matter what app you are migrating from, the procedure stays the same.


This page was last edited on 04/07/2021.