This topic describes how to install the Aptify Configuration Migration Utility on a server (source or destination) so users with trusted accounts in Aptify can access the system using a supported web browser.
To do this, perform the following steps:
| Note | ||
|---|---|---|
| ||
The Aptify web interface should be installed and tested on a non-production environment first before applying to a production web server, just as if you were installing an Aptify Service Pack. Be sure to back up the server where you will install the production Aptify web server, to provide a fall-back option, in case a problem occurs during the Aptify web site installation. |
| Note | ||
|---|---|---|
| ||
If you have an existing Aptify site, see important information related in Updating an Existing Aptify Web Site. |
...
| Info |
|---|
For web servers that will be available on the public Internet, you must secure the site using HTTP over a Secure Socket Layer (SSL) to create an HTTPS site. The default installation of the Aptify site requires SSL. The site will not load successfully unless the site is configured to use SSL. See Securing the Aptify Web Site Using SSL for additional information. |
...
The account must be a trusted user with a valid license on the Aptify database server with the appropriate privileges to conduct Aptify activity.
...
| Note | ||
|---|---|---|
| ||
Per packaging requirements for this version, the Application Pool Identity used by the Aptify web site is set to LocalSystem and the identity used by the AptifyServiceAPI (SOA layer) site is set to run as the user specified in the setup program. |
...
Log into the web server using an account with administrative privileges.
When installing Aptify 5.5.2, Aptify recommends that you log into the web server with a Windows domain user with administrative privileges. There are certain updates related to the authentication model with the Aptify browser-based interface that requires a domain user with access to the database server. If you do choose to install as a local administrative, these updates must be done manually. See Choosing an Authentication Method in Aptify 5.5.2 for more details.
...
- See Updating an Existing Aptify Web Site for more details.
...
- Aptify 5.0 Desktop client
- Microsoft .NET Framework 4.5
- ASP .NET MVC 4
...
- The client application provides the active Aptify Object Repository service used during the installation process.
...
- Run the installation program locally on the web server that will host the Aptify site; do not run it over the network.
...
When prompted, enter login information for the database server, specifying an account with system administrator privileges (such as sa).
| Aptify 5.5.1 Login | Aptify 5.5.2 Login |
...
- To install only the Aptify site, ensure that the Web Site option is selected and the Install Server Component option is cleared. This option is only applicable if you have previously installed the Aptify Server Components on the Aptify database server.
- To install the Aptify web site and the Aptify server component, keep both options selected.
- To install only the Aptify server components, ensure that the Web Site option is cleared and the Install Server Component option is selected.
- This option installs the necessary entities and metadata on your database server.
- While you can run the installer multiple times to create multiple Aptify sites that communicate with the same database server, you should only install the necessary entities and metadata on your database server once.
...
- Default Website is selected by default, however you can host the Aptify website under another site. The site must be manually created through the IIS Manager prior to running the Aptify web site setup.
...
- The default application pool name is Aptify_HTML5
- Per packaging requirements for this version, the Application Pool Identity used by the Aptify web site is set to LocalSystem.
...
- The default application pool name is Aptify_SOAWeb
...
The default installation path is c:\inetpub\wwwroot and the Aptify folder is created automatically.
...
| Note | ||
|---|---|---|
| ||
The default installation path of the Aptify SOA layer is c:\inetpub\wwwroot\ and the web folder is AptifyServicesAPI. The path and location can be modified manually once the Aptify web site is installed. |
...
- The default location is C:\Program Files\Aptify 5.0.
...
- You must enter the location's path in the UNC (Universal Naming -Convention) format. The location should be a shared drive or folder on the SQL server.
During installation, the installer copies certain assemblies to the server location you specified. Therefore, the account currently logged into the web server must have read/write access to that location on the database server.
Aptify 5.5.1 Web Services Installation Aptify 5.5.2 Web Services Installation
...
- Although technically not required, restarting the IIS service will ensure that all existing sessions connected to the web server are terminated before the website is used.
- You can restart the IIS service from either the Internet Information Service (IIS) Manager or from the Windows Services dialog.
...
- If you accepted the default virtual directory name, enter http://localhost/aptify
...