This topic describes how to install the Aptify e-Business 6.0 site on a web server.
To do this, perform the following steps:
Note
This setup is the e-Business 6.0 Beta version, and should be installed and tested only in a non-production environment.
STEP 1: Check the Pre-requisites:
Confirm that the database server is running Aptify 6.0 (see Server requirements for e-Business 6.0). Please note that e-Business 6.0 is supported only on Aptify 6.0 version.
Identify the web server that will host Aptify e-Business 6.0. This server must meet the required hardware and software requirements: (see Server requirements for e-Business 6.0 )
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.
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.0 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.0 and Aptify Web.
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.0 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.
- Download the Aptify e-Business 6.0 Installation ZIP file to a folder on the web server and unzip its contents.
- Right-click the Setup application file, and select the Run As Administrator option to launch the installation program.
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.
- Click OK to continue. On the Welcome page, 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. See Server requirements for e-Business 6.0 for more information on the pre-requisites.
- On the Web services Details page, enter the Web services Installation information as detailed below:
In the Website field, select the name under which the e-Business 6.0 site will be hosted. The recommended deployment for Aptify Web and e-Business 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.0 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.
Note
The Aptify e-Business 6.0 site has been successfully tested on cloud in following distributed environment set up:
- Aptify Web 6.0 and eBusiness 6.0 installed on two different cloud servers and pointing to a database server on different server.
- Aptify Web 6.0 and eBusiness 6.0 on same cloud server where both websites are installed separately, one on default site and another on non-default site respectively.
- eBusiness 6.0 SOA and eBusiness 6.0 Web UI installed on different cloud servers.
- In the Application Pool EbusinessWeb field, enter the application pool name to be used for the Aptify e-Business website.
- The default application pool name is Aptify_EbusinessWeb
- In the Application Pool SOA field, enter the application pool name to be used for the Aptify e-Business SOA site.
- The default application pool name is Aptify_EbusinessSOAWeb
- In the SOA Pool User Name field, specify the trusted user account that you want to use as the SOA App Pool user for the Aptify e-Business website.
- This is the user identified in Step 4.
- In the Password field, enter the password for this user.
- In the Website Location field, specify the location where the Aptify e-Business website files should be installed on the web server.
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.
- 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 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 Next to continue and review your installation options. The Installer automatically selects the options in the box(es) for the installation(s) not currently installed.
- Click Finish to begin the installation process.
- 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.
- Aptify e-Business is installed successfully, check the bindings for the site in IIS. A site should be bound with HTTPS as per the screenshot below. A valid SSL certificate should be associated with the bindings.
- 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.
- Now Connect to Aptify e-Business SOA to confirm that it loads correctly.
You can access the e-Business SOA site by typing the below URL and confirm that SOA help displays correctly on the browser.
https://servername.domain.com/SOA/help - Connect to the Aptify e-Business website to confirm that it loads properly using a supported web browser.
- You can access the e-Business site using the below URL where servername is the name of your web server and domain.com is your organization's domain:
If e-Business is installed on Default Website, below would be the URL to access:
https://servername.domain.com/ui
If e-Business is installed on the non-Default Website, then find the port on which the non-default website is linked and below would be the URL to access:
https://servername.domain.com:eBusinessPortNo/ui
- You can access the e-Business site using the below URL where servername is the name of your web server and domain.com is your organization's domain: