Step 3 - Installing e-Business

Choose these install instructions if you want to install the Aptify user controls and the ASP.NET sample site.

1. Create a new domain account or identify an existing domain with a valid license account to use on the e-Business server.
   • This is the user account that the e-Business server will use to communicate with the Aptify database server.
   • See Specifying an e-Business Server User Account for more information.
   • For DMZ installations outside of your organization's domain, see Installing e-Business in a DMZ Environment.
     
     
2. Add the designated domain account as a trusted user in Aptify, with the appropriate privileges.
   • Note that this user must be assigned a valid user license to successfully communicate with the database server.
   • You must link this account to an Employees record.
   • The specific permission set required for the e-Business user depends on the type of user activity that will be conducted on your website. For testing and development environments that use Aptify sample data, add the e-Business user to the Users group.
   • See Creating User Accounts.
     
     
3. Using Microsoft SQL Server Management Studio, back up the APTIFY database before continuing.
4. Log in to the Web server that will host the e-Business site with an account that is an administrator on that server.
   • If using Windows Integrated Security (i.e., using a trusted user based on Windows credentials) when installing the e-Business site, you must be logged in as a trusted user with system administrative privileges (in other words, your user needs to be in the computer's Administrators group).
5. Install the Aptify Windows Desktop client on the e-Business server. See Installing the Aptify Desktop Client.
    
6. Download the installation ZIP file for your release to a folder on the computer and unzip its contents.
   • e-Business 5.5.3: APTIFY_553_eBiz_FULLSETUP.zip
   • e-Business 5.5.2: APTIFY_552_eBiz_FULLSETUP.zip
   • e-Business 5.5.1: APTIFY_551_eBiz_FULLSETUP.zip
   • e-Business 5.5: APTIFY_550_eBiz_FULLSETUP.zip
   • Run the installation program locally on the computer; do not run it over the network.
     
     
7. Browse to the location of the installation files and right-click on the Setup application (look for the Setup file with the Aptify "A" icon). Select Run as Administrator to launch the installation program.
   • The Run as Administrator option bypasses the server's User Access Control (UAC) for the duration of the installation.
     
     
8. When prompted, enter login information for the database server, specifying an account with system administrator privileges (such as sa).
   • If you are logging in as a trusted user based on Windows credentials, select Use Windows Integrated Security.
   • If you are logging in as an untrusted user using SQL server security, select Specify a User Name and Password. 
     
     
9. Click OK to continue.

10. Review the information on the Welcome screen and click Next to continue.

    The database server must have the supported Aptify version installed prior to installing e-Business. The installer will check the database's version, and you will be unable to proceed with the installation unless Aptify meets this requirement. The following table identifies the supported version of Aptify for the e-Business releases:

    e-Business Release	Requires this Aptify Release
    e-Business 5.5.3	Aptify 5.5.3
    e-Business 5.5.2	Aptify 5.5.1 or Aptify 5.5.2
    e-Business 5.5.1	Aptify 5.5.1
    e-Business 5.5	Aptify 5.5

    
    If this installation is for an e-Business 5.5.2 environment, know that these instructions assume you are installing on a system running Aptify 5.5.2 or later. If you are running on Aptify 5.5.1, contact Aptify Technical Support for additional instructions.

    
    
    

11. Review the set of requirements to install e-Business. If your environment does not meet one or more of the specified requirements, click Cancel to abort the installation. Otherwise, click Next to continue.
    • See  e-Business System Requirements for more information on the e-Business requirements.
      
      
12. In the Specify Installation Details screen, select the CMS Site option.
13. Select the Configure IIS and Update Web.config option.
14. Specify the trusted user account that you want to use for the e-Business website in the e-Business User field.
15. Enter the password for this user in the e-Business PWD and Confirm Password fields.
16. Specify the URL for the site in the Website field. This field defaults to localhost.
17. If you are installing e-Business 5.5 or 5.5.1, enter ebusiness (as created in Step 2 - Creating a New Sitefinity Site) as the VIrtual Directory to use for the e-Business website.
    • The default location of the e-Business website is automatically populated in the Website Location field based on the Virtual Directory field.
       
18. Specify the location where the e-Business website files should be installed on the Web server in the Website Location field.
    • This is the location where you created the Sitefinity site. See Step 2 - Creating a New Sitefinity Site.
    • When integrating with Sitefinity, the default location of the installation folder is C:\inetpub\wwwroot\ebusiness
       
19. Check both Install Sitefinity Controls and Include Sample Site Pages.
20. Verify the name of the Database Server.
    • The Database Server field is automatically populated after the previous step is performed.
      
      
21. Enter the name of the database (identified when setting up the Sitefinity site in Step 2 - Creating a New Sitefinity Site) in the Database Name field.
22. Verify/select a login method for the database administrative user to access the database:
    • The installation populates the login credentials based on the information you specified in the first step of the setup program. You should modify this as necessary. The Sitefinity Database Login should match the database user account you specified when setting up the Sitefinity project in Step 2 - Creating a New Sitefinity Site.
    • If using Windows Integrated Security (i.e., using a trusted user based on Windows credentials) select the Integrated Security option. You must be currently logged in as a trusted user with system administrative privileges to the SQL Server.
      • If Integrated Security is selected, Aptify accepts the login credentials (for the user that is currently logged in to the Web Server) that have already been authenticated by the Windows Domain and a username and password does not have to be specified.
    • If not using integrated security, specify a user with the appropriate administrative privileges in the DB Admin User field as well as the password for the administrative user in the DB Admin PWD field.
      
      
23. Enter a location on the SQL Server to which your user account has read/write access in the UNC Path to a Drop Directory on the SQL Server 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. This location should be a shared drive or folder on the server.
    • During installation, the installer copies a database backup file that contains the sample site pages to the location you specify on the server that hosts the Sitefinity database (See Step 2 - Creating a New Sitefinity Site for details). Therefore, the account currently logged into the Web server must have read/write access to that location on the database server. The account that runs the SQL Server process on the database server also needs to have read access to backup drop directory.
      
      
24. Click Next to continue.
25. Review the Server Option screen and choose one of the following options:
    • To install only the sample site and Sitefinity controls, do not select any check boxes on this screen. This option is only applicable if you have previously installed the e-Business Server -Components on the Aptify database server.
    • To install the e-Business Server Components but not the sample data, select the Install Server Components option.
      • This option installs the e-Business entities on your database server.
      • While you can run the installer multiple times to create multiple e-Business sites that communicate with the same database server, you should only install the e-Business entities on your database server once.
        
        
    • If you want to install the e-Business server components and sample data, select the Install Server Components and Install Sample Data options and enter a location on the SQL Server to which your user account has read/write access. (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. This location should be a shared drive or folder on the server.

      • During installation, the installer copies a database backup file that contains the sample data to the location you specify on the server. Therefore, the account currently logged into the Web server must have read/write access to that location on the database server. The account that runs the SQL Server process on the database server also needs to have read access to backup drop directory. 

        Only select the Install sample data option if you installed the sample CRM data on the Aptify server during initial installation since there are dependencies between the e-Business sample data and the CRM sample data. Also, for best results when using sample data, you should run the e-Business installation immediately after installing the Aptify server and the CRM sample data.

    • If installing the sample data, specify the URL for the e-Business sample site in the e-Business URL field. The system uses this URL within the sample Web Articles RSS Feeds record.
      
      
26. Click Next to continue.
27. Click Finish to begin the e-Business installation.
28. Click OK when prompted that the installation is complete.
29. 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.
      
      
30. Connect to the sample site to confirm that it loads properly.
    • Open a Web browser window and enter the following address to connect to the sample site: http://localhost/ebusiness
    • If connecting from another computer on the network, enter http://[server name]/ebusiness in the browser window.

    • If the site fails to load with a PageHandlerFactory-Integrated error, try repairing the server's .NET 4.0 installation or re-register ASP.NET with this command (update the .NET 4 version in this command to match the version on your server):
      
      

      %windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i