Domains in which You Can Use a License Key

The license key is assigned to your base URL, which is typically your domain name. For example, if your domain name is www.mycompany.com, the license key follows this pattern: www.mycompany.com(expdate)(Modifiers)?1234567890.

Each domain name requires its own license key. For example, to support the domain names, www.mycompany.com, sales.mycompany.com and support.mycompany.com, you need 3 license keys.

When you purchase a license key, be sure to register a domain name, not an IP address. For example, register www.mycompany.com, not 192.168.0.1.

Although Ektron supports IP addresses, the domain that you license becomes the required URL in the browser address. For example, if you register 192.168.0.1, you would need to access the site as http://192.168.0.1/somedirectory/myloginpage.aspx.

Because users would typically not identify a Web page by its IP address, you should register the domain name instead.

Using Ektron without a License Key

For evaluation purposes, when you install Ektron, you do not need a license key. During the installation process, leave the License Key field blank and click Next on the License screen. This lets you use Ektron as localhost.

Inserting the License Key

If you download the executable (.exe) file, you are prompted to enter a license key during installation. Otherwise, you can enter it by choosing Workarea > Settings > Setup and clicking Edit and then add the license key to the License Key(s) field.

Upgrading a License Key

If you upgrade Ektron and want to replace the old license key with a new one, choose Workarea > Settings > Setup and click Edit. Next, add the license key to the License Key(s) field. On the other hand, if you want to add new keys in addition to old keys, create a comma-delimited list of keys in the License Key(s) field.

When cutting and pasting license keys, keep the full license key intact without adding or deleting characters. License keys that are changed in any way render Ektron inoperable.

Before You Install

1. Create a folder for the site. Make sure the drive and folder to which you install your Ektron website have sufficient space. Anticipate future needs, since the site is likely to grow over time.
2. Make sure that Internet Information Server (IIS) is installed on your server. See Creating Multiple Websites on a Single Server.
3. Install and configure your Web Application Server. For more information, see Microsoft ASP.net.
4. If you are setting up one website that uses multiple Ektron servers and points to a single database server, make sure both servers connect to the same database. This configuration ensures that membership user registrations, forum/blogshort for Web Log posts, statistics, and so on, are the same on both servers. For more information, see Installing Ektron.
5. Decide which search provider you will use. See Also: Setting Up Search for Your Website
   If you will use any Microsoft search provider, install it. See Also: Working With Microsoft FAST Search; Setting Up Microsoft Search Server 2010; Using Solr Search
6. Enable IIS 6 metabase compatibility and ASP.NET. To do that:
   1. From the Windows Control Panel, choose Programs and Features.
   2. From the left panel, choose Turn Windows Features On or Off.
      —Image—

      

   3. Click to open Internet Information Services > Web Management Tools > IIS 6 Management Compatibility.
   4. Check IIS Metabase and IIS 6 configuration compatibility.
   5. Click to open Internet Information Services > World Wide Web Services > Application Development Features.
   6. Check ASP.NET.
   7. Click OK.
7. Obtain a license key from Ektron. Send email to license@ektron.com.

Installing the CMS Base

1. Contact your Ektron account manager to obtain a link to download Ektron. See Also: Contact Ektron.
2. Double click the downloaded CMS400Basevreleasenumber.exe file.
3. Ektron verifies that your server has all required components. You must install any missing ones before you can continue.
   —Image—

   

4. A screen displays Ektron’s License Agreement. Please read it and click I Accept. If you do not accept, the setup ends.
   —Image—

   

5. Select Complete to install all components. Or, select Custom to choose which components to install. You can also choose where to install them.
   —Image—

   

6. When you click Next, the install checks for SQL or SQL Express on the server. If SQL is not installed, a dialog prompts you to install SQL Express.
7. If you will use a remote SQL server, click Continue. If you plan to use SQL Server on this computer, click the link on the message to install SQL Server Express 2008 R2 RTM. If you do, the Ektron installation terminates. After installing SQL Server Express, restart the Ektron installation.
   —Image—

   

8. The Ready to Install the Program screen appears. Click Install. The installation program copies files to the C:\Program Files folder.
   —Image—

   

   IMPORTANT: After completing the installation, you should further configure your permissions based on your network security model before using Ektron.

9. Click Yes to check for updates. This verifies that you have the latest version of Ektron.
   —Image—

   

10. You might be prompted to restart your server. If so, you should restart now.

    IMPORTANT: If this dialog appears, do not run the site setup until the system reboots.

    —Image—

    

    After you install Ektron, the web.config file is updated as follows.

    • ek_sitePath—webroot/siteroot
    • ek_buildNumber—current build number of Ektron
    • ek_cmsversion—current version of Ektron
    • Connection String—information about the database's connection to Ektron.

    See Also: Managing the web.config File

Installing a Site

NOTE: Continue with these steps after completing Installing the CMS Base.

The installation copies the following folders from C:\Program Files\Ektron\CMS400vxx to the Web root folder you specify:

• BIN
• workarea
• documentation
• uploaded files and uploaded images
• a login page
• the Visual Studio solution file

1. You can create a new site manually by clicking the cms400sitesetup.exe file located in C:\Program Files\Ektron\CMS400vxx\Utilities\SiteSetup or by choosing Start > Programs > Ektron > CMS400vXX Utilities > CMS400 Site Setup. The Setup Type screen appears.
2. Choose an option and click Next.
   • CMS400 Full Installation—For setting up a new site installation.
   • CMS400 Upgrade—For upgrading existing site's database and site files.
   • CMS400 Database Setup—For setting up a new site database. Site files, such as .aspx pages, are not included in this setup.
3. In the License Key field, enter your primary license key for Ektron. License keys are typically emailed to your organization when you request a copy of the application. When cutting and pasting a license key, keep the full license key intact without adding or deleting characters. If you do not have license keys now, you can insert them later.
   —Image—

   

4. You can select a site to install. This screen does not appear the first time you run the site setup for a starter site. If you run it again and have multiple sites, this dialog box appears.
   —Image—

   

5. If your server operating system accommodates multiple websites (for example, Windows Server 2008), select the site to which you want to install Ektron from the drop-down list. Otherwise, accept the default.
   —Image—

   

6. Enter the destination folder for the site. If your website resides in a folder other than the default, click Browse and navigate to that folder. The default reflects your selection in the previous dialog.

   WARNING! Do not install under another application’s folder within the Web root.

   IMPORTANT: Ektron does not support the installation of nested sites, each having its own web.config file. Nested sites can disrupt Ektron features, such as Aliasing, Menus, and eSync.

   —Image—

   

7. Enter the path of the Secure Asset Location. The Site Options screen appears.

   IMPORTANT: If you plan to load balance several servers, make sure this path is the same for all servers in the cluster. See Also: Balancing the Load on Your Servers

   NOTE: Be sure the drive to which you install the asset library has sufficient storage space plus room for growth.

   —Image—

   

8. On the Search Provider screen, determine which search provider you will use with Ektron.
   —Image—

   

   See Also: Working With Microsoft FAST Search; Setting Up Microsoft Search Server 2010; Using Solr Search

9. On the Site Options screen, check each option you want to install. Boxes are grayed out if an option is not available.

   See Also:

   • Viewing Network Server Diagnostics
   • an eSync security certificate. See Also: Managing eSync Security Certificates
   • Using Ektron’s Developer SDK
   • Security Compliance
   —Image—

   

   NOTE: PCI Compliance is only available if the eCommerce Modifier (E) is in your license key. eSync is only available if the eSync modifier is in your license key. SDK is only available if Visual Studio 2010 or 2012 is installed on your server.

10. After choosing, click Install. The Moving Files dialog appears, and the following things happen.
    • files are copied to the site
    • permissions are set for the site’s directories
    • ASPNET, IIS_WPG, or Network Service user and IUSR are given permissions to the directories
    • the site is set up to use .NET 4.5
    • web.config settings are configured
    • IIS is configured

Setting up a Database

NOTE: Continue with these steps after completing Installing a Site.

Your database contains information such as users and content blocks. The database setup program:

• checks for SQL or SQL Express server. If either is installed on your server, an appropriate database is set up.
• loads database tables
• updates the web.config file with information about your database connection, based on your responses

1. You are asked if you want to set up a database. Click Yes.
   —Image—

   

   If you are using a separate database server, you need the following information:

   • database server host name or IP address
   • if the database server is on the same domain as the application server, it must support NT or SQL authentication
   • if the database server is on a separate domain from the application server, it must support SQL authentication
   • you must have database administrator or database creator privileges
2. Enter the name of the database you are creating.
   —Image—

   

3. Enter the Ektron administrator user's password. It cannot be admin. You may also change the user's username if you wish.
   —Image—

   

   Once the installation is complete, you may edit these values in the Ektron Workarea > Settings > Users screen.

   The Ektron administrator user is a member of the Administrators group. Group members have access to all Ektron Workarea screens.

4. Enter the builtin user’s password. For information about the builtin user, see Getting Started with Ektron.
   —Image—

   

5. Click Next. The SQL Server DB Setup screen appears and prompts for database connection information.
   —Image—

   

   • Server—List the database server on this system. To setup the database on this server, accept the default. Otherwise, enter a SQL or SQL Express server that already exists. For SQL, this would typically be (local) if it’s installed on the local server. Otherwise, enter the Server’s name. For SQL Express enter (local)\SQLEXPRESS.
   • Username—Enter the username you will use to access the database.
   • Password—Enter the password you will use to access the database.

     NOTE: If you want to use NT authentication, leave the username and password blank. This will set up a trusted connection.

   After you complete the screen, the setup verifies the database connection information. If the database name already exists, you are asked to assign a different name. When a connection is made and the name is available, the installation program creates a database using the provided information.

6. Click Install to begin the installation. The Setup Status screen appears.
   —Image—

   

7. When the SDK install is finished, the following screen appears. Click Finish. The site and database setup portion of the install is complete.
   —Image—

   

8. The following screen appears, providing information about setting up a search provider. The message varies according to the chosen search provider.
   —Image—

   

9. If your Assets folder will have more than 50 PDF files, you should to speed up the indexing of PDF files.
10. If you checked the eSync box in Step 9 of Installing a Site, the following dialog appears.
    —Image—

    

    To learn about eSync security certificates, see Part 2: Generate and Copy Security Certificates.

Troubleshooting Installation Issues

Effect of Removing a Website

When you uninstall a website, the following happens.

1. The IIS and Indexing Service stops.
2. The website's database is deleted.
3. The website folder's files are deleted.
4. The IIS and Indexing Service starts.

Effect of Removing a Website's Database

If you check the Remove Websites Database box, the site database is removed.

Effect of Removing the Ektron Application Directory

If you check the Remove Ektron Application directory box, the following items are removed.

• All Ektron services
• These Program Files (x86)\Ektron directories (if they exist)
  • CMS400vx5
  • CMS400vx0
  • CMS400v76
  • CMS400v75
  • CMS400v70
  • Dms400
  • EktronWindowsService40
  • EktronWindowsService30
  • EktronWindowsService20
  • EktronWindowsService
  • EktronCmsFileHelperService
  • EktronNotificationServices
  • Plugins
  • CMS400SDK
• Various system directory files
• These registry entries
  • Everything under Software\Ektron
  • All StarterSite keys
  • SDK install key
• The base installer key

Removing Search Server Files and Services

If you check the Remove Ektron Search Server Files and Services box, the services and files that Ektron uses for Microsoft Search Server are removed. (This action does not remove Microsoft Search Server 2010).

Removing All Sites and Application Directory

If you check the Remove All Sites and Application Directory box, all Ektron files are removed.

NOTE: After you complete the uninstall, you may need to manually remove the AssetLibrary, EktronSearchData directories.

Removing Third-Party Programs

To remove all third-party applications required to run Ektron, go to Windows Control Panel > Uninstall a Program and remove these programs.

• Your search provider (for example, Microsoft Search Server 2010)
• SQL 2008 R2 Reporting Services Sharepoint 2010 Addin
• Microsoft Sync Framework 2.1 SDK
• Microsoft Visual C++ 2010 x64 Redistributable
• Microsoft Filter Pack 2.0
• Microsoft Visual C++ 2008 Redistributable
• MSXML 4.0 SP2 Parser and SDK
• Microsoft Visual C++ 2005 Redistributable (x64)
• Microsoft Server Speech Recognition Language = Tele (enUS)
• Adobe PDF iFilter for 64bit platforms
• Microsoft Chart Controls for Microsoft .NET Framework 3.5
• Microsoft Server Speech Platform Runtime (x64)
• Microsoft ASP.NET 2.0 AJAX Extensions 1.0
• Microsoft .NET Framework 4 Extended
• Microsoft .NET Framework 4 Client Profile
• Microsoft Sync Services for ADO.NET v2.0 (x64)
• Microsoft Report Viewer Redistributable 2008 SP1
• Microsoft Office 2003 Web Components

NOTE: Some applications may have been installed before you installed Ektron.

Step 1: Download and Install the Help Folder on your Web Server

1. Click on the following zip file link:
   http://documentation.ektron.com/cms400/v9.00/Reference/Zip/EktronReference.zip
2. Download the file to your Ektron server, typically to the download folder.
3. Unzip the file to your Ektron server; typically inetpub/wwwroot/your-website/Workarea. (You can install help to any website folder.)

Step 2: Change Your Website's web.config File

1. Edit your website's siteroot/web.config file.
2. Find ek_helpDomainPrefix.
3. If you installed the help folder to this website's Workarea folder, remove the path value. For example

   <add key="ek_helpDomainPrefix" value=""/>

   If you installed help to any other folder, replace the default value with the complete URL to that folder.