This topic describes how to install the Aptify site on a web server so users with trusted valid user 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 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 website installation. |
| Note | ||
|---|---|---|
| ||
If you have an existing Aptify site, see important information related in Updating an Existing Aptify Web SiteWebsite. |
- Confirm that the database server has the same version of Aptify as the version you are installing on the web server (i.e., the database server has Aptify 5.5.23, and you are installing the Aptify 5.5.2 3 on the web server). This is a pre-requisite before you can install the Aptify site.
- Identify the web server that will host Aptify. This server must meet the requirements specified in in Server Requirements for the Aptify Web Interface.
- If the web server is installed on a different computer than the database server and you have chosen to use Windows Authentication, confirm that your network is configured to support delegation. See See Aptify Site and Network Delegation for for details.
For web servers that will be available over the public Internet, you should install and test the Aptify site within the firewall first before moving the web server outside your organization's firewall.
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.
Create a new domain account or identify an existing domain with a valid end user license account to use on the Aptify web server.Anchor _Step3 _Step3 Note The Aptify web interface does not currently support the authentication of users from multiple domains from a single website. If your environment supports users in multiple domains, contact Aptify Technical Support for assistance.
- This is the user account that Aptify (SOA layer) uses to communicate with the Aptify database server.
The account must be a trusted user with a valid license on end user license (elevated permissions are not required) to the Aptify database server with the appropriate privileges to conduct Aptify activity. In Aptify 5.5.2, during The SOA user should also be in the Users group.
During the setup process, the SOA user is added to the AptifySOAAppPoolGroup. This group is only intended for the SOA user and ensure user tokens are secure.
Note Per packaging requirements for this version, the Application Pool Identity used by the Aptify web site website 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.
Warning
Log into the web server using an account with administrative privileges.
When installing Aptify 5.5.2, Aptify
SeeTip 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 for more details.
Warning It is highly recommended that the user account used for the SOA layer is not used to log into the Aptify web server. If the SOA layer user account is used to log into the web server and then logs out, you may need to reset Microsoft IIS to restore features such as reporting.
- If you have an existing Aptify site, perform a backup of the site.See See Updating an Existing Aptify Web SiteWebsite for more details.
- Determine whether the web server has the following software installed:
- Aptify 5.0 Desktop client
- Microsoft .NET Framework 4.5
- ASP .NET MVC 4
- If the Aptify 5.0 Desktop client is not installed on the web server, install it. See Installing the Aptify Desktop Client.
- The client application provides the active Aptify Object Repository service used during the installation process.
- The client application provides the active Aptify Object Repository service used during the installation process.
- If Microsoft .NET Framework 4.5 is not installed on the web server, download and install it from the following URL:
http://www.microsoft.com/en-in/download/details.aspx?id=30653 - If ASP.NET MVC 4 is not installed on the web server, download and install it from the following URL:
http://www.asp.net/mvc/mvc4
- Download the Aptify installation ZIP file to a folder on the web server and unzip its contents.
- Run the installation program locally on the web server that will host the Aptify site; do not run it over the network.
- Run the installation program locally on the web server that will host the Aptify site; do not run it over the network.
- Browse to the location of the installation files and run Setup.exe , right-click the Setup application file, and select the Run As Administrator option to launch the installation program.
- On Windows Server 2008, the Run as Administrator option bypasses the server's User Access Control (UAC) for the duration of the installation.
- On Windows Server 2008, the Run as Administrator option bypasses the server's User Access Control (UAC) for the duration of the installation.
- Review the set of requirements to install. If your environment does not meet one or more of the specified requirements, click click Cancel to to abort the installation. Otherwise, click click Next to to continue.
- See See Server Requirements for the Aptify Web Interface for more information on the Aptify site requirements.
- See See Server Requirements for the Aptify Web Interface for more information on the Aptify site requirements.
- Click Click Next to to continue.
When prompted, enter login information for the database server, specifying an installation account with system administrator privileges (such as sa).
- Click OK to continue.
- When installing Aptify 5.5.1, review the installation details and select one of the following options:
- 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.
- Select the Website under
privileges to both the Aptify database and SQL Server. The installation user should also be tied to a Developer license to ensure that the setup can perform such tasks as entity creation when needed.
Note Selecting the System Administrator option when creating a user in the Aptify database (through the Aptify User Administration wizard) sets the user to a dbowner in SQL Server. It does not add the user to the sysadmin role. You will need to manually add the user to the sysadmin role in SQL Server through SQL Management Studio. If in doubt, check the user's permissions in the Security > Logins area of SQL Management Studio before proceeding with the installation.
- Click OK to continue.
- In the Website field, select the name under which the Aptify site will be hosted.
- 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 website setup.
- 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 website setup.
- Enter In the Application Pool name HTML5Web field, enter the name to be used for the Aptify web sitewebsite.
- The default application pool name is is Aptify_HTML5HTML5Web
- Per packaging requirements for this version, the Application Pool Identity used by the Aptify web site website is set to to LocalSystem.
- Enter In the Application Pool name SOA field, enter the name to be used for the Aptify SOA site.
- The default application pool name is is Aptify_SOAWeb
- The default application pool name is is Aptify_SOAWeb
- Specify In the SOA Pool User Name field, specify the trusted user account that you want to use for the Aptify web site in the SOA Pool User Name field.Enter website.
- This is the user the identified in Step 3.
- This is the user the identified in Step 3.
- In the Password field, enter the password for this user in the Password field.
- Specify In the Website Location field, specify the location where the Aptify web site website files should be installed on the web server in the Website Location field.
The default installation path is is c:\inetpub\wwwroot and and the Aptify sub-folder is created automatically.
For example, if you want to use the location aptify1 rather than aptify, in the default location, you will need to create a folder called aptify1 under c:\inetpub\wwwroot\myorg to install the website files, the path to the Aptify sub-folder would be c:\inetpub\wwwroot\myorg\aptify.
Note title Note Concerning Aptify SOA Site 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 website is installed.
- Select the location in which the Aptify Desktop client is installed in the Object Cache Path field.
- The default location is C:\Program Files\Aptify 5.0.
- The default location is C:\Program Files\Aptify 5.0.
- When installing Aptify 5.5.1, enter a location on the SQL Server to which your user account has read/write access in the UNC Path to a Shared Folder field. (This is the Windows domain account you have used to log into the web server.)
- 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 
- Click Next to In the Site Name field, enter the name of the website to be used in creating URLs.
- It is not necessary to include the protocol prefix (https://) in the site name as Aptify appends it automatically.
- This is the site name for the website that user will enter to browse this site. For example, enter MyOrg.org, if users will browse to https://MyOrg.org to connect to the server.
This field can be left blank, and the setup program uses the server host name and domain name to create URLs.
Note Some additional configuration needs to be done to support the site name entered. Microsoft IIS must be updated with the new site name, and the host file at c:\windows\system 32\Drivers\etc\host must to be updated to include the web server’s IP address and the site name.
- In the Object Cache Path field, select the location in which the Aptify Desktop client is installed.
The default location is C:\Program Files\Aptify 5.0.
- Click Next to continue and review your installation options.
- Click Click Finish to to begin the installation process.
- If the setup detects that the server does not have Crystal Reports 32-bit and 64-bit installed, a dialog appears alerting the user that an installer will run to address this. Clicking Run starts the installer and closes the dialog.Click OK when
- If the setup detects that the server does not have the Microsoft Access Database Engine installed, a dialog appears alerting the user that an installer will run to address this. Clicking Run starts the installer and closes the dialog.
- Click OK when prompted that Aptify has been successfully installed to close the installer.
- If a problem occurs during the installation, the Aptify Installer will notify you that an error occurred.
- if the install is not successful.
- Restart the IIS service.
- 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.
- When you are installing Aptify 5.5.2 and up, if you If you want to support both trusted (Windows users) and untrusted (SQL server) users, you will need to make updates to the web config file to Aptify.Framework.Configuration.External.js file to support this. See See Configuring Alternate Authentication Methods for more details.
- If your environment contains over 10,000 products (or if you expect that it will exceed this amount), you will need to increase the value of the maxProductCount attribute to ensure that new products will be displayed in order lines. See Defining the Products Attribute for Aptify Web for more information.
- Connect to the Aptify web site website to confirm that it loads properly using a supported web browser.
- By default, this step assumes that you have a user account (trusted or untrusted) with a valid license in Aptify.
- If connecting to Aptify directly from a web server that is not in a nested (hierarchical) domain, enter the following address: https://localhost/Aptify
- If you accepted the default virtual directory name, enter http://localhost/aptify
- If connecting from another computer on the network, then enter enter http://[server name]/aptify in the browser window.