This topic describes how to install the Aptify e-Business 6.3 site on a web server.
To do this, perform the following steps:
This setup is e-Business 6.3 version and should be installed on Aptify 6.3 and tested first only in a non-production environment. Please take a backup copy of the database and website folder before starting the installation. If upgrading an existing Aptify e-Business 6.0+ installation, rename the existing UI and SOA folders so that the installer installs to clean directories. After the installer executes, run a file compare utility, such as WinMerge, to identify any custom dlls or file modifications to the web.config, index.html, or other files that must be transferred or reimplemented for existing configurations to function. For specific database which has customization done on process flow : 'eBusiness Login Cart Conversion for Anonymous Users', it has been observed that the changes done was replaced with the stock process flow changes. To minimize the errors, please take a copy of this process flow so that the custom changes can manually be updated on the process flow once e-Business is installed successfully. |
Confirm that the database server is running Aptify 6.3 (see Server requirements for e-Business 6.3). Please note that e-Business 6.3 is supported only on the Aptify 6.3 version.
Identify the web server that will host Aptify e-Business 6.3. This server must meet the required hardware and software requirements: (see Server requirements for e-Business 6.3.)
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. For more information on how to secure the site will SSL, see Securing the Aptify Web Site Using SSL. |
Create a new domain account or identify an existing domain with a valid end user license account to use on the Aptify e-Business 6.3 web server. If you have Aptify Web installed on the Web server, then you can use the same SOA App Pool user for e-Business 6.3 and Aptify Web. For more information on how to create a user, see Creating User Accounts.
The account must be a trusted user with a valid end user license (elevated permissions are not required) with the appropriate privileges to conduct the e-Business 6.3 activity. 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.
Log into the web server using an account with administrative privileges.
It is highly recommended that the user account used for the SOA layer is not used to log into the Aptify web server. |
When prompted, enter login information for the database server, specifying an installation account with system administrator 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.
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. |
In the Website field, select the name under which the e-Business 6.3 site will be hosted. The recommended deployment for Aptify Web and e-Business 6.3 is on separate servers or at least separate domains under different websites on the same web server.
Default Website is selected by default for e-Business installation. However, you should host the e-Business website under another site and not on the same site where Aptify Web is installed. If Aptify Web has been installed on a different website other than the default, then e-Business 6.3 can be installed on the 'Default Website'. The new site must be manually created through the IIS Manager prior to running the e-Business website setup. A valid port should be assigned to the Website which will be different for Aptify Web as well as for e-Business site. For additional steps to be followed on Aptify Web 6.3 after the e-Business 6.3 installation, see Installation of Aptify Web 6.3 and e-Business 6.3 on same DB instance. |
The Aptify e-Business 6.3 site has been successfully tested on a cloud in following distributed environment set up:
|
In the Password field, enter the password for this user.
The setup program, at this step, is unable to validate the user credentials entered. Make sure that the username and password entered are correct. |
The default path is c:\inetpub\wwwroot.
For example, if you have selected 'Website' of a non-default path then the same path should be mentioned in the Website location as well.
This field can be left blank, and the setup program uses the server hostname and domain name to create URLs.
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 be updated to include the web server’s IP address and the site name. |
To install the e-Business Database server components, ensure that the Install Database Component option is selected.
This option installs the e-Business specific 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.
To install only the Aptify e-business site, ensure that the Install Database Component option is cleared. This option is only applicable if you have previously installed the e-Business Database Components on the Aptify database server.
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. |
This section provides the instructions to carry out configurations to make sure that the e-Business 6.3 website works as expected:
Follow the below instructions for loading the product image on the e-Business 6.3 website.
LoadDefaultImage = true; // This value displays the 'No Photo Available' Image by default.
LoadDefaultImage = false; // This value searches for the product’s images in the Large and thumbnail folders and displays them accordingly.
For loading the Product images, set LoadDefaultImage = false.
Configuring Image Sync Utility:
For syncing the product images available in the database into the images folder of the website, 'Image Sync Utility need to be run. Following instructions need to be followed by the user for configuring the Image Utility:
Sync Image Record
' services.2. Create a new record under 'Sync Image Records' services with the following details (Refer the snapshot below):
Entity: Products
Field Name: Photo
Category: ProductDetails
Save and close the record.
3. Create a new record under 'Category
' with the following details (Refer the snapshot below):
Name: ProductDetails
Width: 100//This case be changed by the user based on the size of the image required.
Height : 100 //This case be changed by the user based on the size of the image required.
No Image : NoPhotoAvailable //This can be changed by the user with any other image required.
Image Format : Jpeg //This can be set to 'png' as well
Naming Convention: RecordId.Extension
Sync Path : <Database Server>\inetpub\wwwroot\UI\Images\large // The path 'c:\inetpub\wwwroot\UI\Images\large' can be used if the setup is installed on the default path. Else update the same to reflect the appropriate site path where the setup is installed.Update the 'Sync Path' field to reflect the following: '<e-Business Web setup path>\UI\Images\large' folder.
Save and close the record.
4. Create a new record under 'Sync Image Records
' services with the following details (Refer the snapshot below):
Entity: Products
Field Name : Photo
Category: ProductCatalog
Save and close the record.
5. Create a new record for 'Category
' with the following details (Refer the snapshot below):
Name: ProductCatalog
Width: 50 //This case be changed by the user based on the size of the image required.
Height: 50 //This case be changed by the user based on the size of the image required.
No Image: NoPhotoAvailable //This can be changed by the user with any other image required.
Image Format: Jpeg //This can be set to 'png' as well
Naming Convention: RecordId.Extension
Sync Path : <Database Server>\inetpub\wwwroot\UI\Images\thumbnail // This path 'c:\inetpub\wwwroot\UI\Images\thumbnail' can be used if the setup is installed on the default path. Else update the same to reflect the appropriate site path where the setup is installed. Update the 'Sync Path' field to reflect the following: '<e-Business Web setup path>\UI\Images\thumbnail' folder.
Save and Close the record
6. Close the SmartClient application.
Running the Image Sync Utility
Perform following steps for running the image sync utility:
Running the Application Server with e-Business 6.3:
For automatic sending of the order confirmation email, we have utilised the Aptify Application Server Async processor.
Following additional steps need to be performed for Aptify Application server to be working correctly with e-Business 6.3
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-10.0.0.0" newVersion="10.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>
AptifyAsyncProcessor.exe.config
" would appear as follows. Save and close the record.Aptify 5.5 Asynchronous Processor
'. The user should be able to use the application server with e-Business 6.3.Customers who want to configure default order values for the order associated with the shopping cart are instructed to change the last step in the Process Flow ‘Ensure Active Cart Exists
’. If you open this Process Flow in the designer you may see the last step as a rule step with the label ‘Assign Default Values
’ (pictured below)
Unfortunately, this is an orphaned rule step that is overlaying the real final step of the process flow. If you click and drag this step to a new position in the designer, you will see it is not wired up to the steps around it and the real final step is a sub-process step named ‘Assigned Default Values To Order
’ (pictured below).
Customers can feel free to delete the ‘Assign Default Values
’ step as it is no longer used. This will avoid confusion with developers thinking the ‘Assign Default Values
’ step is actually wired up, making changes to it, and not understanding why they are not being executed.
Checklist for basic Aptify Web/e-business 6 troubleshooting
Sample Aptify Web/e-Business 6 Troubleshooting story