Adding the App to multiple App Catalogs

You can add the K2 for SharePoint app to environments containing multiple web applications, each with their own app catalogs. Only one K2 app is permitted per app catalog. For multiple K2 servers of the same version, see Add the App to multiple K2 servers. For multiple K2 versions see the SharePoint On-premises > Upgrade steps section of K2 for SharePoint App Registration and Activation.

The following two scenarios are covered:

  • Scenario 1: Adding the app to a new SharePoint on-premises environment with multiple web applications and app catalogs for the first time.
  • Scenario 2: Adding the app to an existing SharePoint on-premises environment where additional web applications are added after K2 for SharePoint integration.
The scenarios discussed use two web applications, but the steps can be applied to environments with more than two web applications. Note that SharePoint Online is limited to one web application, so this does not apply to those environments.
  1. Create two web applications with their own app catalogs, and then run the K2 Setup Manager and install K2.
    Ensure that when creating web applications that each web application has a root site.
  2. On the K2 for SharePoint - App Deployment page, click Next.
  3. On the K2 Server page, specify a K2 URL, then click Next.
  4. Once the Configuration Analysis is complete, click Next.
  5. On the Web Applications with App Catalogs page, select the two app catalogs and then click Next.
  6. Finish the K2 Setup Manager.
  7. Open the app catalog for the first web application.
  8. Add the K2 for SharePoint app using the Site Contents or Add an App page.
  9. Click Trust It.
  10. Specify a K2 URL on the Registration Wizard page and then click Next.
  11. Once the Registration Wizard is complete, click Finish.
  12. Click Manage App Deployments (SharePoint).
  13. On the Manage App Deployments page specify the All Paths option in the Managed Paths section and click OK.

    You must use the Managed Paths > (All Paths) option to accomplish K2 integration with SharePoint.
  14. Click Trust It.
  15. Open the K2 app and click Manage App Activations.
  16. On the Manage App Activations page, specify the root site collection URL and click Activate.

    Ensure the Enable auto-activation on sites where the app is deployed is checked
  17. Click Close once the site collection activation is complete.
  18. Click Close on the Manage App Activations page. The K2 app is successfully registered, deployed and activated on the first web application.
  19. Open the app catalog for the second web application.
  20. Add the K2 Five for SharePoint app using the Site Contents or Add an App page.
  21. Click Trust It.
  22. Run the Registration Wizard on the second Web Application's app catalog.
  23. On the K2 app, click Deployment.
  24. The following message is displayed, click Delete.

    There is another app installation associated with the same app principal as this app installation. Are you sure that you want to delete that app installation's deployment data and only use this app installation's deployment data for the associated app principal?


  25. On the Manage App Deployments page specify the All Paths option in the Managed Paths section and click OK.
    You must use the Managed Paths > (All Paths) option to accomplish K2 integration with SharePoint.
  26. Click Trust It
  27. The K2 app is now registered, deployed and activated to both web applications and app catalogs.
  1. Create a secondary web application with its own app catalog.
  2. Run the AppDeployment.exe from the installation media or from the following location:
    "%ProgramFiles%\K2\K2 smartforms Setup"
  3. On the K2 for SharePoint - App Deployment page, click Next.
  4. On the K2 Server page, specify a K2 URL, and then click Next.
  5. Once the Configuration Analysis is complete, click Next.
  6. On the Web Applications with App Catalogs page, select the newly created app catalog and then click Next.
  7. Click Finish once the AppDeployment.exe is complete.
  8. Open the app catalog of the newly created web application.
  9. Add the K2 Five for SharePoint app using the Site Contents or Add an App page.
  10. Click Trust It.
  11. On the K2 for SharePoint app, click Deployment.
  12. The following message is displayed. Click Delete.

    There is another app installation associated with the same app principal as this app installation. Are you sure that you want to delete that app installation's deployment data and only use this app installation's deployment data for the associated app principal?


  13. On the Manage App Deployments page specify the All Paths option in the Managed Paths section and click OK.

    It is required to use the Managed Paths > (All Paths) option to accomplish K2 integration with SharePoint.
  14. Click Trust It
  15. Run the Registration Wizard and activate the K2 app on the root site collection for the second web application. The K2 app is now registered, deployed and activated on the new web application.