Installing the App Portal Web Service
App Portal / App Broker 2023 R2
Note:You are required to install the App Portal Web Service when using Microsoft System Center Configuration Manager deployment technology. It is not required when using Intune, Altiris, Jamf Pro, Jamf Cloud, Workspace ONE UEM deployment technology.
Important:You must first install the App Portal Web Site, as described in Installing App Portal / App Broker, before installing the App Portal Web Service on any server.
Important:If upgrading from an earlier version of App Portal, note that upgrading the existing App Portal web site will not upgrade the existing App Portal Web Services application. You need to manually run the AppPortalWebServiceSetup_2023_R2.exe installer on your System Center Configuration Manager server.
The location(s) where you install the App Portal Web Service depends upon the version of System Center Configuration Manager you are using:
| • | System Center 2012 Configuration Manager or Microsoft Endpoint Configuration Manager—When using single primary/CAS with System Center 2012 Configuration Manager or Microsoft Endpoint Configuration Manager, you need to install the App Portal Web Service only on the single primary/CAS. |
To install the App Portal Web Service, perform the following steps:
To install App Portal Web Service:
| 1. | Verify that the Microsoft .NET 4.6.1 or later framework is installed on the CAS or primary site server. If it is not installed, use Control Panel > Programs and Features > Turn Windows features on or off to install it. |
| 2. | To start the App Portal Web Service installer, open the App Portal Web Service installer file, AppPortalWebServiceSetup_2023_R2.exe. |
Note:You need to be an administrator to run this installer. To run as an administrator, you can right-click the App Portal Web Service installer file and select Run as administrator from the context menu.
| 3. | On the User Account Control dialog box, click Yes. The Welcome panel opens. |
| 4. | Click Next. The License Agreement panel opens. |
| 5. | Read and accept the license agreement and click Next to continue. The Destination Folder panel opens. |
| 6. | If you want to install App Portal Web Service in the specified directory, click Next. If you want to select a different directory, click Change, select a new directory, and then click Next. The Primary Site Server Setup panel opens. |
The fields on this panel are populated with information that the installer obtained from the Microsoft System Center Configuration Manager installation on this machine.
| 7. | Click Next. The Ready to Install the Program panel opens. |
| 8. | Click Install to begin the installation. When installation is complete, the Completed panel opens. |
| 9. | Click Finish to close the installer. |
| 10. | Upon completion of the installer, two new folders should have been created in Microsoft System Center Configuration Manager named App Portal Devices for site (SiteCode) under Device collections and App Portal Users for site (SiteCode) under User Collections. Open the Configuration Manager Console and expand Device collections and User collections nodes and verify that these folders exist. |
Note:The account used to install App Portal Web Service has been granted full administrative access to the site. See the App Portal Configuration Guide for information on configuring site security.
| 11. | Navigate your browser to http://<sitealias>/esd/. The App Portal web site opens. |
| 12. | When you first access App Portal you will be prompted to upload your license file provided. Follow the instructions on screen to upload the file. |
| 13. | Repeat this procedure for each Primary Site. |