Page Comparison

This topic describes how to install the Aptify Configuration Migration Utility (CM) Tool 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: 

...

...

The account must be a trusted user with a valid license on the Aptify database server with the appropriate privileges to conduct Aptify activity.

...

...

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.
   

...

Perform the following tasks before installing the Aptify CM Tool on a source or destination server:

• Verify the Aptify Desktop client is installed with an active Aptify Object Repository 
• Verify that the user installing the tool has sufficient rights to the Aptify database and SQL Server.
• Verify the user installing the tool has system administrator privileges to both the Aptify database and SQL Server. 
• Verify that the CM Tool setup files are NOT set to read-only
• Verify that the Aptify installation directory where the CM Tool is to be installed is NOT read-only

Perform the following steps to install the CM Tool.

1. Download the Aptify CM Tool installation ZIP file to a folder to the server you want to install the tool (source or destination) and unzip its contents. 
2. Browse to the location of the installation files and run Setup.exe to launch the installation program.Review the set of requirements to install. 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 Server Requirements for the Aptify Web Interface for more information on the Aptify site requirements.
   Image Removed
   
3. Click Next to continue.
4. , double-click the Setup application file.
   • You can also right-click the Setup application file and select the Run as Administrator option. On certain Windows servers, the Run as Administrator option bypasses the server's User Access Control (UAC) for the duration of the installation.
      

5. When prompted, enter login information for the database server, specifying an installation account with system administrator privileges (such as sa).

   Aptify 5.5.1 Login Image Removed

   Aptify 5.5.2 Login Image Removed

6. Click OK to continue.
7. 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.
8. Select the Website 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 setup.
      
9. Enter the Application Pool name to be used for the Aptify web site.
   • 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.
      
10. Enter the Application Pool name to be used for the Aptify SOA site.
    • The default application pool name is Aptify_SOAWeb
       
11. Specify the trusted user account that you want to use for the Aptify web site in the SOA Pool User Name field.
12. Enter the password for this user in the Password field.
13. Specify the location where the Aptify web site files should be installed on the web server in the Website Location field.

14. The default installation path is c:\inetpub\wwwroot and the Aptify 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.


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 is installed.

Select the location in which the Aptify Desktop client is installed in the Object Cache Path field.The default location is 

privileges to both the Aptify database and SQL Server. 



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.

15.  Click OK to continue.
16. Review the set of requirements to install. If your environment does not meet one or more of the specified requirements, click Cancel to abort the installation. Otherwise, click Next to continue.
17. In the Aptify Directory field, enter the directory path where your Aptify Desktop client is installed.  
    • Aptify is typically installed under C:\Program Files\Aptify 5.0.
       
    When installing
    • or C:\Program Files\Aptify 5.5.
    1
    • 
       
18. In the Shortcut Name field, 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 Image Removed

      Aptify 5.5.2 Web Services Installation Image Removed

       

19. Click Next to continue and review your installation options.
20. Click Finish to begin the installation process.name for the tool's shortcut. This name is used to create a Windows Desktop shortcut for this application. 
    • The name should be unique, if the name already exists, the setup program will not be able to create the Windows Desktop shortcut.
       
21. Click Next.
22. Click Finish to start the installation. 
    • Installation will take several minutes to complete.
       
23. 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.
    See What to Do
    • If the
    Aptify Site Is Not Installed Correctly if the
    • install is not successful
    .
    Image Removed
    
24. Restart the IIS service.
    1. 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.
    2. You can restart the IIS service from either the Internet Information Service (IIS) Manager or from the Windows Services dialog.
        
25. When you are installing Aptify 5.52, 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 support this. See Configuring Alternate Authentication Methods in Aptify 5.5.2 for more details.
26. Connect to the Aptify web site 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 to Aptify directly from a web server that is in a nested (hierarchical) domain, you must address it with the fully qualified domain, such as: http://server.teir2.teir1.com/aptify
    • If connecting from another computer on the network, then enter http://[server name]/aptify in the browser window, contact Aptify Technical Support for assistance.
      
      
27. Repeat the above steps for the other server (source or destination).