...

Pre-requisites:

Make sure your environment has the following items installed:

1. .NET 3.5 framework (325156342793)
2. .NET 4.5 framework https://confluence.aptify.com/download/attachments/78611714/dotNetFx45_Full_setup.exe?api=v2
3. MVC4 framework https://confluence.aptify.com/download/attachments/78611714/AspNetMVC4Setup.exe?api=v2
4. Aptify Desktop client (instructions/download can be found on Quick list for setting up a new Aptify database server/desktop client)

Database-side Setup:

These steps are only required if you are setting up app pool user for the first time. If you are setting up an Aptify Web site in a test server and the app pool user and such already exist in the database, you can skip to the IIS Setup section.

1. Make sure you've run the License Wizard so licenses match your database server. (This is required for your app pool user) If you haven't done it already, follow these steps:

2. Login to the database as SA, and run the Licensing Wizard to update licenses to match this server
   Image RemovedImage Added
   The wizard can be found above the Licenses service (under User Administration)
   Image RemovedImage Added
   Run it with "Update Licenses to Match this Server".

   Info
   If that's grayed out, it may already have been run.

   
   

3. User creation of app pool user:
   1. If doing this on a local environment: 
      1. Make sure you're connected to the Aptify VPN. Launch the Aptify desktop client.
      2. Go to Step 4.
   2. If doing this on a client environment: 
      1. You'll follow a similar path although you'll want to ask them who their app pool user should be, or if they've already created one. You'll need the password as well.
      2. Note, in a client environment, you do not want your app pool user to be the same as their e-Business user or app server user.
      3. Skip to Step 7 below.
4. Create a new user- This will be your app pool user.
5. Select Windows Integrated Security.
   Image RemovedImage Added
6. Change the domain to APTIFY and search for your user- it may take a bit to search, if it doesn't find the user, you might need to close Aptify, make sure you're not on any client VPNs, and connect to the client VPN.
   1. If this doesn't work and if this is on your local environment, you can create your own Windows user (named AptifyWebUser or something) and then use your computer's domain and your newly created user.
      To do so, follow the below instructions:
      Image RemovedImage Added
   2. Type Users in the Windows search and select this option.
      Image RemovedImage Added

   3. Select Add someone else to this PC.

      Info
      Your version of Windows may vary- Windows makes it harder to add a true local user now.

      Image Removed

      
      

      Image Added
   4. Select I don't have this person's sign-in information.
      Image RemovedImage Added
   5. Select Add a user without a Microsoft Account.
      Image RemovedImage Added
   6. Enter Username and Password.
   7. Save the user.
      Image RemovedImage Added
   8. Select Change Account Type.

   9. Change them to an Administrator.

      Note
      This security level is not required (and not recommended) in client environments, it is done here to make it a bit easier so you do not have to add the user to the appropriate IIS Users groups, as Admin automatically has those privileges.

      Image Removed

      
      

      Image Added
   10. Log back into Aptify.
       Create a new user and search your local computer's domain for your newly created person. (Your local domain should show up by default)
7. Assign your user an EndUser license. If you do not see licenses available, it may be one of several things:
   1. You may need to run the license import wizard to update the server type
   2. If dealing with a CDB environment and an all view of Licenses returns nothing, you'll need to import a license file
   3. In a client environment, you may not see one if all their licenses are assigned. You can free one up by either de-activating another user account (if it's not being used), purchasing a new license, or changing another users license assignment from End User to Administrator (if available)
8. Grant your user access to the CRM and e-Business modules. Leave the settings on Step 5 as is.
   Image RemovedImage Added
9. On step 6, if there's an existing record (like in a CDB environment) that has Aptify Web/SOA permissions, copy that profile. That'll automatically put them in the same security groups.Image RemovedImage Added
10. On Step 8, it'll be prepopulated if you copied a profile. If you didn't, add the user to the AptifySOAAppPoolGroup, the Basic Group, and the Users group. Make the Users group their Primary Group.Image RemovedImage RemovedImage AddedImage Added
11. On Step 9, assign them an Employee and Person record. If you're doing this for a client, ask them which records to assign here- often it'll be the same as their ebusiness user.
12. Click Finish.

IIS Setup:

1. You'll need to enable certain IIS features to create a website.
   1. If on a local environment:
      1. Search "Add Features" in the Windows start menu. Select "Turn Windows features on or off."
         Image RemovedImage Added
      2. Expand the Web Server Management Tool and World Wide Web Services trees.
      3. Add each everything from each sub-tree.
   2. If on a server environment: (Note, most clients set this up for you, but in case you have to:)
      1. you can add Windows features by opening the "Server Manager" application and selecting "Add Roles or Features."
         Image RemovedImage Added
      2. On the Installation Type page, leave it at "Role-based or feature-based installation. Click Next.
      3. On the Server Selection page, you should see your server listed, choose it and click Next.
      4. On Server Roles, select "Web Server (IIS)." Open the tree.
         1. Under Web Server, add the above features. Select all items from within each tree.
            Image RemovedImage Added

         2. Under Management Tools, add the above features.
            Image RemovedImage Added
            Image RemovedImage Added

            Note
            Note, the client may wish to add other features depending on what the web server is used for, but this is the minimum.

            
            

2. Save and Windows should apply the new features.
3. Search IIS Manager within Windows start menu. Launch the IIS Manager application.
4. At the top level, select Server Certificates.
   Image RemovedImage Added
5. It'll load server certificates. If you're doing this on a local environment, you'll need to create a self-signed cert. On client environments, they should import their certificate to the server, however, you can set it up temporarily with a self-signed cert and swap it later if they need to purchase or import one later. To create a self-signed cert:Image RemovedImage Added
   1. Select Create Self-signed Certificate on the right Actions column
   2. Name your certificate whatever you'd like.
   3. Place it in the Personal Certificate store.
      Image RemovedImage Added
6. You should see a Default Web Site on the top left. If you are installing multiple Aptify Web websites or multiple sites with HTTPS on this server, you'll need to setup new sites and bindings appropriately.
   Image RemovedImage Added
7. Select it, and on the far right Actions column, select Bindings.
   Image RemovedImage Added
8. If there is not an https binding, you'll need to add one. Add it like the above image, choosing your new self-signed cert. (If this is for a client, add their correct server cert). You can leave the IP address as all unassigned and host name blank unless you have a specific URL to assign it.
   Image RemovedImage Added
9. Your site bindings should look similar to the above image.

Aptify Web Installation

1. Download the latest version of the Aptify Web installer. Extract the zip file.

   Info
   Here is 6.0 for convenience https://confluence.aptify.com/download/attachments/78611714/APTIFY_60_Web.zip?api=v2

   
   

2. Run the Setup.exe as a Windows Administrator. Login to the server as the SA account.
   Image RemovedImage Added
3. Install it with the settings as given in the above image. You'll want to pick the correct SOA Pool Username/Password that you created before. You can fill in a site name if there's a specific URL to bind this to, or you can leave it blank to install on your local.
   1. If Aptify client is installed in a different folder from where the Object Cache Path is, navigate to the correct one.
   2. You may also change the Website Location if it should be located elsewhere.
   3. If you do not see the Default Web Site at the top of the installer and you cannot select it:
      1. Verify first that you have the right Windows features installed (step 1 of IIS setup)- This is usually the problem
      2. Launch IIS. If you have a default web site in IIS manager, but not in Aptify, make sure the Windows features are installed right, then verify that this site has a valid HTTPS binding and a correct certificate
      3. If you don't have a default web site in IIS manager, you may need to create one, although it's probably a missing Windows Feature at root. If you create one, make sure it has an HTTPS binding with the right cert.
4. Click Next.
   It'll verify you have the necessary components installed, as detailed in the Pre-install requirements section.

5. Click Finish, Aptify Web will install.

   Note
   Should take about 20-30 min, although it'll vary depending on server specs and client database size.

   
   

...

Dealing with SSL errors in Postman (Optional)

Image RemovedImage Added

You'll get an SSL certificate error each time you launch Aptify Web or Aptify Services API, except in client scenarios where presumably they have a valid certificate. Other than an annoyance, this can interfere with testing API calls with the tool Postman. By default, it blocks invalid SSL certs, so for testing purposes, you'll need to uncheck that setting as shown above.

...