This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Update WikiPakk

How to update WikiPakk

    Updating WikiPakk

    WikiPakk currently does not automatically check for updates, and neither does SharePoint. New versions can be discovered manually via AppSource.

    Checking for a new WikiPakk version on Microsoft AppSource

    You can see the latest version of WikiPakk in AppSource on this page: Details + support.

    In AppSource there will also be a changelog showing the changes per release:

    Changelog of WikiPakk as shown in AppSource

    Updating WikiPakk in SharePoint

    There are two steps to updating WikiPakk:

    1. the SharePoint tenant app catalog needs to be updated with the newest version from AppSource
    2. SharePoint sites that use WikiPakk might need to be updated to use this new version

    The following sections describe those steps.

    Update the SharePoint tenant app catalog

    As SharePoint administrator, open the tenant app catalog as follows:

    1. in a browser, open the SharePoint admin center
    2. in the left navigation, select More features
    3. on the right side, several options to choose from appear; look for the Apps section and select Open:

    Entry to the SharePoint tenant app catalog.

    1. the SharePoint tenant app catalog should show a previously installed version of WikiPakk:

    WikiPakk, installed from AppSource, showing version 2.3.1.

    1. Switch to the classic experience by selecting the classic experience link:
    1. In the classic experience, in the list of apps, select the WikiTraccs WikiPakk app
    2. At the top of the page, select the FILES tab to expand the ribbon menu (note: only if the ribbon menu is not yet visible)
    3. In the ribbon menu, select Upgrade Store App:

    You will be redirected to a screen that displays Downloading from:

    Once the file has been downloaded, you will be prompted to trust WikiTraccs WikiPakk:

    1. Choose Deploy and wait; it might appear that nothing is happening for up to 20 seconds

    Once the update has been completed, you should be redirected to the app catalog and the App version number should match the version number listed in AppSource.

    Now the new app version is ready to be used in SharePoint sites.

    Update WikiPakk in SharePoint sites

    In SharePoint, an app can have different versions in the tenant app catalog and in sites that the app had been added to.

    The previous section described how to update the app from AppSource via the tenant app catalog. This app version is now higher than in the sites that use the app. We need to update those sites as well so they use the latest version.

    To update each SharePoint site to the latest WikiPakk version proceed as follows.

    As site owner, or site collection administrator of the respective sites:

    1. In a browser, navigate to a SharePoint site that uses WikiPakk
    2. In this site, navigate to Site Contents
    3. For the WikiTraccs WikiPakk app, choose … > Details:
    1. Choose GET IT to update the app:

    After a moment, you will be redirected back to Site Contents. The WikiTraccs WikiPakk app title might display in gray, indicating that the update is still in progress.

    After a while (and you might have to refresh the page manually) the app title should display in black, indicating that SharePoint finished updating the app.

    For the app, select … > Details again. It should now read Good news - you already have this on your site.

    Note: this process can be automated, e.g. with the CLI for Microsoft 365.

    You can see the app version as well in WikiPakk as follows:

    1. Select Page Tree to expand the page tree panel on the right side
    2. Select the ? that is displayed at the bottom of the page tree; a window opens
    3. The app version is shown right at the top

    If the version shown here is lower than the one of the app you just installed, proceed reading the next section about Caching ssues.

    Caching issues

    There is one rather ugly behavior when updating SharePoint apps. Sometimes the browser caches old resources rather aggressively, making the app appear being older for users.

    This is the case when the version number in the ? dialog of WikiPakk shows a lower version number than the app’s version number.

    To solve this different strategies helped different clients:

    • Pressing F5 to reload the page
    • Clearing the browser cache
    • Deleting all service workers via the F12 developer tools

    This has to be done in all browsers where caching issues occur.