Contensive Installation and Setup

Installation

Server Setup and Configuration

For Amazon AWS, create an instance from the AMI Contensive41. This AMI is built from the latest version of these instructions.

This instruction prepares a Windows Server 2008 R2 for Contensive 4.1.636.

1. Windows Web Server 2008 R2-64
2. Install the latest Windows Updates$
3. Setup external firewal
   • 80
   • 21
   • 443
   • 3389 allow during setup, then disable after RDP 5901 setup in registry
   • 5900 for Contensive Monitor
   • 5901, for remote desktop, point-to-point if possible to
   • ICMP

1. reverse map the server’s domain (s13.kma.net) to the primary IP address

1. Disable User Access Control
   • Control Panel > users > Left Pane
   • Set the warnings all the way off

Create accounts Administrative tools > Computer Management > Local User and Groups kmaAdmin/, administrator, password never expires (aws - leave the original aws administrator account as-is) contensive/-pw-, user, password never expires SQLServer/-pw-, user, password never expires Windows Firewall (ignore if hosting firewall) Administrative Tools > Windows Firewall > Inbound Rules World Wide Web Services, ports 80 + 443, allow Remote Desktop + Remote DesktopFX, 3389. allow add rule for Contensive Monitor, 5900, allow add rule for Remote Desktop, 5901, allow ICMPv4 (ping), allow FTP, port 21, allow if DNS, add 53 (dns) and 123 (NTP) Networking (aws) add elastic ip to ec2 instance setup an a record to the elastic ip Networking (non aws) Control Panel, set small icons, Network and Sharing Center Local Area Connection > Properties > dbl click IP4 Set all IP addresses purchased 1and1 mask = 255.255.255.255 1and1 gateway = 10.255.255.1 DNS they provide, or 8.8.8.8 8.8.4.4 Local Security Policy Administrative Tools > Local Security Policy > LocalPolicies Local Policies > User Rights Assignment > Allow login through remote desktop + Administrators Security Options > “interactive Login: do not display last user name”=enable Account policies > Account Lockout Policy 3 invalid attempts 3 minute lockout Remote Desktop New Port (non-aws) Regedit HLM > System > Current Control Set > Control > Terminal Server > Winstations > RDP_TCP > PortNumber, set to 5901.

If a new server Build Install IIS Server manager → Roles → Install WebServer IIS Server Manager Administrative Tools > Server Manager > Root screen Configure IE ESC > Turn off Check “Do not show me this consol at login” Add Roles and Features Administrative Tools > Server Manager > Roles > Add Role Services Check ASP.NET, agree to add required roles Check ASP Check CGI Security, Basic Authentication Management Tools, IIS 6 management compatibility Administrative Tools > Server Manager > Features Check SMTP Server, agree to add required roles Windows Settings Set timezone to East Coast (aws leave utc) Turn on Automatic Windows Updates Create Working Folders and permission set administrators full control for hosts files D:\Archive D:\InetPub users: full control D:\Db D:\DbBackup users: full control C:\windows\temp users: list + read IIS_User: List + read Setup Upgrade Folder on Desktop ODBC32 - Windows\sysWow64\odbcad32.exe DComCnfg/32 - MMC comexp.msc /32 IIS shortcut Services shortcut Software Installation Microsoft Web platform Installer PHP Manager PHP 5.5.11 (previously 5.3.5) (skip if you can just use IE) Firefox open IE and google Firefox download Carbonite (non-aws) www.carbonite.com un: jay@contensive.com/-pw- click on user jay click “Add a Computer” New rows appears -- select “Install on this Computer” During setup, select Customize your backup. “Start with Nothing in your online backup” Create a schedule, once per day, start at 9pm Manually Add D:\DbBackup D:\InetPub C:\program Files (x86)\kma\Contensive Filezilla Server (nonaws) google search Download Filezilla Server Add user kmaAdmin/-pw-, home D:\ftpRoot set kmaAdmin user with read/write permissions on D:\ftpRoot Go to a local machine and verify the connection. Sql Server 2008 R2 SP2 - Express Edition (nonaws) Google search, “Microsoft® SQL Server® 2008 R2 SP2 - Express Edition” for 32-bit machines - use x86 for 64-bit machines - use x64 Install instance features, but check Default Instance during install service user: SQLServer/-pw- Account provisioning: mixed mode authentication sa pw -pw- add current user (kmaAdmin) as sql server admin 7Zip (nonaws) 64 bit windows version Contensive Run: Contensive Instillation found on s3 under the contensive folder → Latest ver is 41636 dcomcnfg - cckrnl42 permissions, set everyone/all identity, contensive/-pw- if ccKrnl does not show in dcomcnfg (make sure you are in the 32-bit view MMC comexp.msc /32), run 2 registry files found in the folder for this document (ccKrnl.reg, ccKrnl2.reg)(Note: on 64bit machines this has to run: at the command Line run “MMC comexp.msc /32”) Folder Permissions kma/contensive - user/all Run configWizard Server Service, verify it starts OK Run Application Manager Verify attach to local server Add Root Site, named for the server’s domain (s00.kma.net) Change Contensive config (MonitorConfig.txt) to use port 5900 for monitor, restart Contensive Monitor service kma Backup Tools Copy the BackupTools folder from another server Verify the d:\DbBackup folder matches in the Sql file Verify the source programs files are correct in the cmd file Run a test of the cmd file Setup a scheduled task to run the cmd file everyday at 8pm, IIS PHP Manager Open from root of IIS Manager Enable php_com_dotnet extension Add max_input_vars 2000 upload_max_filesize = 50M post_max_size = 50M IIS Manager Application Pools > set applicaiton pool default Enable 32-bit = true Recycling Private Limit = 40,000 Virtual Limit = 200,000 Requests = 100 Click on top node, set default in right-hand pane ASP Max Requesting Entity Body Limit = 10M Session Properties, Enable Session State = false Default Document list, only Index.php index.asp Error Pages Edit feature settings - custom error pages 404 set to /index.php (for each site)

If Migrating A site Please Refer to the Migrating a Contensive Site Document Setup SMTP Start IIS6 Manager go to SMTP Virtual Server 1, properties Leave IP set to all unassigned go to Access Tab Connect - grant only 127.0.0.1 Relay Restrictions - grant only 127.0.0.1 go to Delivery Tab, click advanced Set masquerade to server name i.e. s13.kma.net set FQN to server name i.e. s13.kma.net Domain node under Virtual Server, rename to this domain, s13.kma.met Run windows Updates auto install at 3am (while v42 does not start correctly, set to manual install) Services

administrative Tools → Services

SMTP - Start and set to automatic Contensive Monitor - Start and set to automatic Contensive Server - Start and set to automatic IIS Admin Services - Start and set to automatic SQL Server - Start and set to automatic

Upgrading Contensive Software

Upgrading Contensive requires you first uninstall the current version, then install the new version. When the software upgrade is complete, open the Contensive application manager, right click on your server node and click the "Upgrade all running applications". This process upgrades your database schema and content to support the newer build It takes about five to ten minutes per site.

Uninstalling Contensive Software

1. Click ccStop.cmd in the Contensive Program Files Directory. This stops the Contensive and IIS Services.
2. Open Task Manager to verify the following services have been stopped. If they have not after a minute, manually kill them

• cckrnl.exe
• ccprocessemail.exe
• ccservice.exe
• ccmonitor
• cchousekeep.exe

3. Use the Add/Remove Programs in Control Panel to remove Contensive.
4. After removal, restart necessary IIS services. Running the IISReset command from the command prompt (run as administrator) will do this.

Installing Contensive

1. You should have the following information available before beginning installation

a. Contensive Content Server Installation CD or download.

b. A Windows user login account for contensive with username and password. This account should have user privileges and read/write access to the wwwRoot and content files folders.

2. If a previous version of Contensive is installed backup all content, both database and content files.

3. Verify that the Service Control Manager (Services under Administrative tools) is closed. If left open, this may prevent windows from correctly installing the services.

4. Run the Contensive installation program.

5. When complete, the Configuration Wizard will start. It describes and tests your DCom settings that follow:

a. Open DComCnfg from the wizard, or at the run prompt, navigate to Component Services > Computers > My Computer > dcomcnfg.

b. Locate ccKrnl.KernelServices object.

c. Right click and go to Properties.

d. Under the General Tab, Use “Default” authentication type.

e. Under the Security, Select "Use Custom Access Permissions", and add Everyone allow access. Select Use Custom Launch Permissions, and add Everyone allow launch.

f. Under the Identity Tab, select “This User”, and enter the local Contensive user account.

g. When you continue, Contensive will start.

6. Go to the Program Files\kma\Contensive folder, and make sure:

a. Email Out folder has Read/Write permissions for Everyone.

b. Log folder has Read/Write permissions for Everyone

Installation Problem Isolation

1. Check Web server functionality

If the web site is returning an error and not a web page, check that the server is running correctly. A simple HelloWorld.htm page is provided in the Admin site at the following address. (http://YourDomain.com/admin/HellowWorld.htm). You should expect a page with “Hello World”. If this returns an error, verify the IIS configuration. This is not a Contensive error, but a server configuration problem.

2. Check ASP functionality

A simple HelloWorld.asp page is provided in the Admin site at the following address. You should expect a page with “ASP Hello World”. (http://YourDomain.com/admin/HellowWorld.asp) If this returns an error, verify the IIS configuration. This is not a Contensive error, but a server configuration problem.

3. Check Contensive functionality

If the previous tests passed, test the Contensive status method (http://YourDomain.com/admin/Index.asp?method=status). This should return “Contensive OK”. If it returns any other response, check the page source for an error comment. The most common issues are:

a. Contensive Application Not Found - Open the Contensive Application Manager and verify your application is running. If it is, the problem may be DCom permissions.

b. Connection Error opening Datasource Default or Audit - There is a problem with the database, the connection string, or the connection to the machine holding the database.

4. Check the Contensive Trace Log.

A trace log is created for all internal Contensive errors. The log is located at [Program Files]\kma\contensive\logs\Tracexxxxx.log. There may be several lines for each error, grouped together by the time of the error. Check the first line of each error group. Generally, the information most likely to assist you will be at the end of the line.

5. Windows 2003 - If you can not upload, IIS may be limiting the upload size. Use the IIS Metabase editor to set the upload size limit.

6. Windows 2003 - If ASP/ASPX pages will not run, IIS may be blocking them.

Site Lifecycle Considerations

When Contensive has been installed and the website integration is complete, you need to consider site lifecycle issues. These include site monitoring, database management, file system management, and log monitoring.

Site Monitoring

These are several ways to monitor your site. Contensive includes a status method, and a monitoring service. You can also setup a third-party monitor to hit any dynamic page.

1. Contensive status method with a third party monitor

Contensive includes several special 'methods' from the website URL. One is the status method. To call the status method, use the URL:

http://yourdomain/pagename?method=status

The expected response from the site is an HTTP response "Errors 0". Any other response indicates a problem with the site.

2. Contensive Monitor service

One of the services installed with Contensive is the Monitor Service. The monitor periodically checks the status method of each Contensive site on the server, as well a few other important checks like Contensive log size (an indicator of other site or Database problems) and current drive space availability.

The monitor is controlled by the monitor.txt file in the Contensive program files directory. After changes, the monitor service must be stopped and restarted.

The Monitor can be configured to automatically IISReset the system on error conditions. It also has an HTTP port 80 status screen at port 4532. When the monitor service is running, a hit to this page returns an HTML page with the results of the last checks the monitor ran.

If you have several sites on a server, you can setup a third party monitor or monitoring service to check the Contensive Monitor periodically (every 5 minutes). An error condition two cycles in a row may indicate a problem that IISReset could not recover.

3. Hit any dynamic page with a monitor

Another simple monitor is to setup a website monitor or monitoring service to hit any page on your site. We recommend hitting the status method, as it will report database and other process errors that may occur even when a physical page returns.

Creating a Web Site

Contensive is a content server the runs on Windows Server. Any website hosted on Windows Server can access Contensive.

Creating a new site using ASP scripting

To create a new site that uses ASP scripting as it's hosting page, you can either use the 'new site' wizard in the Application Manager, or create it manually.

Using the New Site Wizard

The Site Wizard creates a simple site, using MS Access as it's database. If you wish to use another database, you can easily switch after the site is created.

1. Open the Contensive Application Manager, by clicking Start > Programs > Contensive > Application Manager
2. Click on the server where you want to add your site. When the Application Manager connects to the server, the server's icon will turn green.
3. Right click on the server, and click Add Site. You will be prompted for the following:

a. Site Name

b. IP Address

c. Domain Name

d. HTML Documents Folder

e. Content Files Folder

f. ODBC DSN File Folder

g. Database File Folder

h. SMTP Email Server

i. Admin Email Address

Creating a new site using other programming environments

Contensive is a server that can deliver the entire site from a single API call. It uses an activex object to interface with the webserver's scripting environment.

You can use Contensive to manage content delivery form any programming language that can work with an instance of an activex object. The process is as follows:

1. Create the object from the program id ccweb3.mainclass
2. Initialize several contensive properties from the server context (an asp vb example is included here)
3. Call any Contensive method to deliver the site content. The simplest is "GetHTML()"

Contensive Installation and Setup

1. Installing Contensive on the Server

To configure Contensive, first run the installation program. This installs the softare, configures the Windows Services to start Contensive on reboot, and optionally installs a Sample website.

2. Creating a site

To create a website that uses Contensive, Open the Contensive Application Manager, right click on the server node where you want to create the site and click the Create Site link. Follow the wizard instructions.

This process creates a default MS Access database. To switch to another ODBC supported Db, create an empty Database and an ODBC data source to it. Open the Contensive Application Manager and right click on the site you wish to setup for your database. Stop the Contensive application, switch the Database Connection String, and Start with Upgrade. This will create the necessary tables to run your site.