Install the Windows Azure Pack Service Management APIs
Applies To: Windows Azure Pack
The Windows Azure Pack for Windows Server Service Management API includes three separate components:
Windows Azure Pack: Admin API
Windows Azure Pack: Tenant API
Windows Azure Pack: Tenant Public API
For security reasons, you should install the Windows Azure Pack Admin API and the Windows Azure Pack Tenant API on machines that are behind a firewall or that are otherwise not accessible by the public. The Windows Azure Pack Tenant Public API should not be installed behind a firewall.
API component |
Sample machine name |
Publicly accessible? |
|---|---|---|
Admin API |
WAPAdminAPI |
No |
Tenant API |
WAPTenantAPI |
No |
Tenant Public API |
WAPTenPubAPI |
Yes |
For more information about suggested machine configurations, see Windows Azure Pack architecture.
You must complete the following steps three times, one time for each API component, the Admin API, the Tenant API, and the Tenant Public API.
To install the Admin API, Tenant API, and Tenant Public API
Ensure that the machine on which you want to install the API complies with all the hardware and software prerequisites that are listed in the Windows Azure Pack system requirements overview.
Log on to the machine on which you want to install the API. If you followed the recommended Windows Azure Pack machine naming conventions, log on to WAPAdminAPI, WAPTenantAPI, or WAPTenPubAPI.
Start the Microsoft Web Platform Installer.
Type Windows Azure Pack in the search box. Click Add next to the Service Management API component that you want to install, for example, Windows Azure Pack: Admin API, and then click Install.
.jpeg "The Web Platform Installer for Windows Azure Pack")
Review the software to be installed. To view the privacy information for each component, click Privacy Terms.
To accept the terms and conditions on the Prerequisites page, click I Accept.
On the next page, scroll down and indicate whether you want to use Microsoft Update to keep the Windows Azure Pack component up to date. Then click Continue.
Tip
We recommend that you do use Microsoft Update. This ensures that any fixes we need to create for the Windows Azure Pack component are automatically installed.
The installation begins.
When the installation is completed, ensure that all Internet Explorer windows are closed, and then click Continue to start the configuration site.
The configuration site https://localhost:30101/ opens in Internet Explorer. If the Internet Explorer security certificate warning page is displayed, click Continue to this website.
.jpeg "Certificate warning for Windows Azure Pack")
Tip
If you need to restart Internet Explorer, be sure to use the Run as administrator option.
On the Database Server Setup page, enter the name of the database server.
.jpeg "Database setup for Windows Azure Pack")
Select the type of authentication that you want to use, SQL Server Authentication or Windows Authentication.
If you select SQL Server Authentication, enter the database server administrator user name (sa) and password.
Enter a passphrase that is to be used to encrypt and to decrypt data in the Configuration Store, and then click the next arrow.
Important
Ensure that you write down the passphrase. Each component must use the same passphrase. If you forget or lose this passphrase, there is no way to recover it.
Indicate whether you want to participate in the Customer Experience Improvement Program (CEIP), and then click the next arrow.
Warning
If possible, please participate in the CEIP. We use the data collected by CEIP (data that contains no personal information) to understand how you are using the controller and to identify any issues that you run into.
Review the features and then click the check mark in the bottom right corner of the Features Setup page.
After the features are successfully configured, click the check mark in the bottom right corner of the Features Setup page.
In the Web Platform Installer, click Finish.
Repeat these steps for each of the Service Management APIs, Admin API, Tenant API, and Tenant Public API.
Note
If you want to change the URL for the API services, see Change the URLs to load balance API services
Next steps
- After you installed each of the API components, you should install the management portal for administrators and management portal for tenants, as described in Install the Windows Azure Pack management portals.