Setup Guide - Part 4: Installation (Manual) – Kepion Support Center

In this article we'll look at manually installing Kepion. Unless there's a specific reason you need to install Kepion in this way, it's highly recommended you use the Installation and Configuration Wizards in this article, which will complete the following process automatically.

Before We Begin

Download the following files from the Kepion Resource Center:

Software Downloads > v6.0 > Manual Configuration

CPMAppHost.zip
EnableFeaturesOnServer.zip
Package.zip

Enable Web Server Features

Unzip the file EnableFeaturesOnServer.zip and run in a CMD prompt with Administrator privileges. The EnableFeaturesOnServer.bat script will turn on features on the Windows server that Kepion requires for its Web Server.

Next, open PowerShell with Administrator privileges and run the KepionConfigScript PowerShell script. This script will enable Kepion server event logging on the Windows Server.

Restore Databases

Open SQL Server Management Services (SSMS) and restore the CPMAppHost Application Database.

Configure Registry Items

Next, we'll need to configure the registry items required for a Kepion installation. Use the Run command to launch regedit.

Expand HKEY_LOCAL_MACHINE -> SOFTWARE and create a new Key named Kepion. Create another Key under Kepion and name it Kepion Planning. Under Kepion Planning, create a third Key called 6.0.

Right-click and create a new String Value. Name the value ConnectionString and give it the following value:

Tip: Replace LOCALHOST with the SQL Server name, if configured on a different server.

Data Source=LOCALHOST;Initial Catalog=CPMAppHost;Integrated Security=True

Create another String Value, give it the name InstallPath, and set the value to:

C:\Program Files\Kepion Planning 6.0\

Set Up the Directory

Create the following directory on the machine:

C:\Program Files\Kepion Planning 6.0\

Copy the files from the downloaded Package.zip into the Kepion Planning 6.0 directory.

Create the Application Pool

Now we'll need to create the Application Pool from the Internet Information Services (IIS) Manager. You can launch this from the run command using inetmgr.

Then right-click Application Pools and select Add Application Pool…

Choose the following settings in the Add Application Pool dialog:

Verify the following are configured for the Application Pool:

Create a Website in IIS

To create the actual Kepion Planning Website in the IIS Manager, right-click on Sites and select Add Web Site...

Configure the website with the following settings. Be sure to click Select… and select the Application Pool created previously.

To enable Windows Authentication, double-click on Authentication.

Then right-click on Windows Authentication and select Enable.

Tip: If the .bat file we ran earlier didn't execute properly, this option may not appear. To enable it manually, these resources here and here, may be helpful. Review the proper configuration from the first article.

With the Windows Authentication still selected, click on Providers… in the right-hand tab.

Select Negotiate and click Remove.

Grant permission for the Kepion SI to access the Web Site by clicking Edit Permissions... in the right-hand tab.

On the Security tab, click Edit…

Add your Kepion SI, and make sure your Kepion SI has the following selected:

Read & execute
List folder contents
Read

Launch Website

Launch the website in IE at:

 http://localhost:8888

Configure Your Browser

As Kepion is an online service, it's critical to ensure that you're connecting to Kepion through a compatible browser that's been configured correctly. If you're accessing Kepion from a modern browser (e.g. Chrome/Edge/etc.), ensure that you have Kepion enabled for use with HTML. To configure Kepion to be compatible with HTML, check out the Setup Guide Addendum.

If you are using IE to connect to Kepion, please ensure that Microsoft Silverlight 5.0 is installed. In addition, make sure the following settings are properly configured:

Click the Tools button in IE and click Internet options.

Go to the Security tab. Select Local intranet. Click Custom level…

Scroll down to the Scripting section -> Allow Programmatic clipboard access. Change the selection to Enable and click OK.

Wrap Up

Once all of the above has been configured to meet your requirements, you're all set to start using Kepion. Take a look at the Sample APPs section to get ideas and inspiration on what you can create, or look into our Modeler Tutorial or Video Tutorials series to follow along with the design, development, and deployment of a Kepion APP.

If you have additional questions, or more specific setup concerns and requirements, check out our Setup Guide - Addendum. If you have a question that hasn't been answered in this series, please send us a ticket and we'll do our best to help out.