Renewing SharePoint Akumina App

The following are the instructions on how to renew the Akumina SharePoint app.

Download Expired/Expiring SharePoint App 

1. Navigate to Admin > Admin Centers (more features)> SharePoint > Apps > App Catalog 
2. Navigate to “Apps for SharePoint”, and locate the existing “Akumina InterChange” App and download (3 ellipses > 3 ellipses > Download)
3. Once downloaded, navigate to file in your Windows file explorer. 
4. Rename the downloaded file by adding the “.zip” file extension. 
5. Extract all files to a new folder. 
6. Open the “AppManifest” file with a program like Notepad. 

Register New SharePoint App 

1. Back in the browser, navigate to “Site Contents” in the App Catalog. 
2. In the address bar, replace the portion of the URL containing “/viewlsts.aspx” with “/appregnew.aspx” 
3. Generate a new ‘Client ID’ and a new ‘Client Secret’ by clicking each “Generate” button. 
4. In the ‘Title’ field, enter the following title: “Akumina InterChange (Dev/Prod/QA)” 
• Example: “Akumina InterChange Dev" or "Akuming InterChange Prod”.  The title MUST include Akumina Interchange or it won't work.
5. In the “App Domain” field, enter the site URL from the “AppManifest” without “https://” 
• From AppManifest: <StartPage>https://siteurl.onakumina.com/?{StandardTokens}</StartPage> 
• App Domain field input: “siteurl.onakumina.com” 
6. In the “Redirect URI” field, enter the same site URL but with the https:// 
• Redirect URI field input: “https://siteurl.onakumina.com” 
7. Once the form is complete, click “Create”. 
8. Save the keys (i.e. in Notepad) shown on the confirmation page for use in updating AppManifest file.

Update AppManifest for New SharePoint App 

1. Generate new GUID for ProductID 
• Example: https://www.guidgenerator.com/online-guid-generator.aspx 
• The new GUID replaces the Product ID in the AppManifest file.
2. Update “Title” to include the new expiration date (one year from today) 
• Example: “Akumina InterChange Dev Exp 11 20 2020" 
3. Update "Client ID" to match new Client ID generated when registering app. 
   
4. Once completed, save file and rezip all folder contents in Windows File Explorer. 
5. Once zipped, rename zipped folder to remove “.zip” extension and add “.app” extension. 

Add New App to SharePoint App Catalog 

1. In the App Catalog, upload the new “.app” file you’ve just updated.  
• We recommend removing the expired InterChange app. 
2. Once uploaded, return to the regular site's (not app catalog) “Site Contents”, and click “New” > “App” to add a new app to the catalog.
   
3. Locate the newly added InterChange app (which can typically be found under the “Apps you can add” section as the first item). Once found, click on the app to add it.
4. When the pop up opens asking you to trust the new app, click “Trust”.
   
5. You should now see the new app in your list of SharePoint apps. Once added, you will need to remove the expired Akumina Interchange app. 
6. After completing this, you’ll need to update the web.config file on the App Manager server with the new client ID and client secret keys. 

Updating the Akumina Tray

Classic SharePoint

Once those keys are updated, you’ll need to confirm that you can access the App Manager from the tray widget. If not, there are some steps to fixing this. 

1. From App Manager > Management Apps > Site Creator, select the core site and “update configuration”, scroll all the way to the bottom and click "Update". After completing this, clear cache on the front end and try opening the App Manager again from the tray. 
2. In some older versions, if the previous steps don’t update the tray, you’ll need to clear the Akumina cache from the App Manager (admin/debug). 

Note: Be sure to have your users refresh the page to access the new App Manager from the tray.

Modern SharePoint

In order to update the tray in SharePoint Modern, you'll need to update the SPA settings by following the steps below.

1. From the Akumina tray, open the debug panel.
2. From the debug panel, navigate to the "Modern" tab on the left.
3. Toggle the "Command Bar" (and in some cases, the "SharePoint Bar" as well, if this option exists) and close the debug panel.
4. The SharePoint "Edit" should appear in the top right corner of the page. Click the "Edit" button. This will open the SPA setting panel.
5. From this panel, you'll need to click the "Select App Manager App" button to select the new AppManager SharePoint app from the new dropdown that appears on the left side of the page. Once selected, click the "Select" button.
6. Once you have the new AppManager selected, click "Save".
7. This process will need to be repeated for each subsite.