Installing App Portal / App Broker

App Portal / App Broker 2023 R2

To install the App Portal / App Broker web site, perform the following steps.

Note:You need to be an administrator to run this installer. To run as an administrator, you can right-click the installer file and select Run as administrator from the context menu.

Important:Starting with App Portal 2013, your deployment technology is no longer specified during installation. Instead, you specify your deployment technology connection settings on the Deployment tab of the Settings view, as described in the App Portal / App Broker Administration Guide.

To install the App Portal / App Broker web site:

To start the App Portal / App Broker installer, launch AppPortalSetup_2023_R2.exe

Note:If OLE DB Driver 18 for SQL Server (x64) is not already installed on your machine, you will be prompted to install it before installation will begin. As this is a prerequisite, click Install.

The Welcome panel opens. Click Next.

Click Next. The License Agreement panel opens.

Read and accept the license agreement and click Next to continue. The Destination Folder panel opens.

Accept the default destination or click Change and select a different location. Click Next to continue.

Click Next. The Database Server panel opens.

Important:Only Windows authentication is supported when connecting to the App Portal SQL Server database. Therefore, the account running this installer needs DBO permissions to that SQL Server.

Enter the name of the database server that you are installing to or select it from the list.

If you are using a specific database instance (other than the default instance), enter the database server and SQL instance in the following format:

Important:Do not use (Local) as a database name.

In the Name of database catalog field, enter the name of the new App Portal database that will be created by this installer, or click Browse to select an existing catalog.

Click Next to continue.

10.

If you are creating a new database catalog, a message appears stating that a new database catalog will be created. Click OK to continue.

The Logon Information panel opens.

11.

A user account is required to interact with Active Directory and SQL. This same account will be used for the App Portal service. The account requires administrative rights on clients to make use of the remote policy execution and to rerun advertisements. In the User name field, enter user account information in Domain\Username format, along with a Password.

Note:Enter the credentials that App Portal will use to communicate with System Center Configuration Manager and other deployment technologies, SQL Server, Active Directory, and clients. This must be the same account, so it is recommended that you use a devoted service account. This account must also have administrator rights on all client machines.

12.

Click Next to continue. The App Portal Settings panel opens.

13.

In the DNS Alias (A-Record) field, enter one of the following:

•

If you have already created a DNS alias for the identity of the site, enter it in this field.

Note:If you enter an alias, it needs to already be created on your DNS servers. The App Portal installer will not create it for you.

Note:If you specify an alias, a DNS A-RECORD for that alias must be created in order to access the App Portal site. It is important that the alias be an DNS A-RECORD, and not a CNAME record.

•

If you do not want to use an alias, you can accept the default value, which is the server machine name.

Note:If you specify the server machine name, you do not need to create a DNS A‑RECORD because one already exists for the server.

Tip:After installation, you can edit the DNS Alias value on the General tab of the Site Management > Settings > Web Site view.

14.

In the AD Global Catalog Server field, confirm or enter the server value.

15.

In the SMTP Server fields enter the name of the SMTP Server that will be used for relaying email.

Note:You may need to configure the SMTP server internally to accept relay from this server’s IP address.

Note:You can also enter the mail settings after installation on the Site Management > Settings > Email view.

16.

In the SMTP Account field, enter the SMTP account name.

17.

For the Computer Discovery Method, select one of the following options to specify the method to use for discover the active machine visiting the App Portal site:

•

WebExtensions—If WebExtensions is selected, an administrator must ensure that the respective WebExtensions installer has been deployed and installed on each user's machine. A link to the installer is provided in the description provided next to the Primary computer discovery method field.

•

Reverse DNS—Uses the reverse DNS zones in Active Directory (if present) to look up the computer name by IP address.

Note:If you select Reverse DNS, every computer in your DNS will be discovered, not just those in SCCM. It only searches the Active Directory DNS, so if you have other DNS providers, it will not work.

18.

Click Next. The Ready to Install the Program panel opens.

19.

Click Install to begin the installation. When installation is complete, the Completed panel opens.

20.

Click Finish to close the installer.

Note:Check and ensure that the ASP.NET State Service is running, and the startup type is set to Automatic mode.