Ektron CMS400.Net Reference
Note: The installation program checks for
- MSSQL on your server. If it is not installed, it will attempt to install SQL Express.
Installing Ektron CMS400.NET involves these actions. The installation program guides you through them.
Phase |
Action |
What it does |
For details, see |
1 |
Copy installation files to C:\Program Files |
ensures system requirements installs non-working copy of files needed to set up site |
A screen displays Ektron’s License Agreement. Please read the agreement. |
2 |
Set up a site - (can be started any time after Phase 1) |
moves files based on selected Web folder creates IIS application directories sets upload folder permissions updates web.config (path, version, and build number) |
|
3 |
Set up a database |
references database folder for scripts needed to create a database creates new tables and populates them adds and sets user permissions updates the web.config file tests database connection |
Step |
Setup Screen |
1. Go to the Ektron Web site |
|
2. Double click the downloaded CMS400Basevreleasenumber.exe file. |
|
3. Ektron CMS400.NETverifies that your server has all required components. Any that are not installed must be installed before you can continue. |
|
4. A screen displays Ektron’s License Agreement. Please read the agreement. Click I Accept... to accept the agreement. If you do not accept, this action ends the setup. |
|
5. Select Complete to install all components. Or, select Custom to choose which components to install. You can also choose where to install the components. |
|
Note: When you click Next, the install checks for SQL or SQL 2005
|
|
6. The Ready to Install the Program screen appears. Click Install. |
|
7. The installation program copies the necessary files to the C:\Program Files folder. Warning! - After completing the installation, you should further configure your permissions based on your network security model before using Ektron CMS400.NET. |
|
8. Click Yes to check for updates. This verifies that you have the latest version of Ektron CMS400.NET. |
|
9. You might be prompted to restart your server. If so, Ektron recommends doing a restart now. Warning! If this dialog appears, do not run the site setup until the system reboots. |
|
Setting up a SiteThis section sets up an Ektron CMS400.NET site. The installation copies the following folders from C:\Program Files\Ektron\CMS400v8x to the Web root folder you specify: BIN workarea documentation uploaded files and uploaded images a login page the VS 2005 solution file You can manually run the site setup by clicking the cms400sitesetup.exe file located in C:\Program Files\Ektron\CMS400v8x\Utilities\SiteSetup or by choosing Start > Programs > Ektron > CMS400vXX Utilities > CMS400 Site Setup. |
|
10. The Setup Type screen appears. Choose an option and click Next. CMS400 Full Installation - For setting up a new site installation. CMS400 Upgrade - For upgrading existing site. Upgrades the database and site files as necessary. CMS400 Database Setup - For setting up a new site database. Site files, such as .aspx pages are not included in this setup. |
|
11. In the License Key field, enter your primary license key for Ektron CMS400.NET. 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. See Updating Setup Information. |
|
12. 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 will appear. |
|
13. If your server operating system accommodates multiple Web sites (for example, Windows Server 2003), select the site to which you want to install Ektron CMS400.NET from the dropdown list. Otherwise, accept the default. |
|
14. Enter the destination folder for the site. If your Web site 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 CMS features, such as Aliasing, Menus, and eSync. |
|
15. Enter the path of the Secure Asset Location. Warning! 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. |
|
16. 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 indexing catalogs are setup the site is set up to use .NET 3.5 web.config settings are configured IIS is configured |
|
Setting up a DatabaseYour 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 |
|
17. You are asked if you want to set up a database. Click Yes. |
|
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 |
|
18. Enter the name of the database you are creating. |
|
Warning! Ektron strongly urges you to change the user name and password for the builtin user. 19. Change the builtin user’s name and password. For instructions on editing the builtin account in the Workarea, see BuiltIn User.
|
|
20. This screen prompts for database connection information. 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. |
Administrator |
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 tests the database connection to verify the information is valid. If the database name already exists, you are asked to assign a different name. Once a connection is made and the name is available, the installation program creates a database using the provided information. |
|
21. If your server has Visual Studio.NET installed, the following prompt appears. |
|
22. If you want to install Ektron CMS400.NET’s Software Developer’s Kit (SDK), click Yes. Otherwise, click No. If you click No, skip to The site and database setup portion of the install is complete.. See Also: Ektron’s Developer SDK. |
|
23. Choose the type of Setup for the CMS400.NET SDK. Click Next. |
|
24. Click Install to begin the installation. 25. The Setup Status screen appears. |
|
26. When the SDK install is finished, the following screen appears. Click Finish. The site and database setup portion of the install is complete. |
|
27. If your license key supports eCommerce, this screen appears. To learn more about PCI Compliance, see the following KB article: http://dev.ektron.com/kb_article.aspx?id=26304 |
|
28. If your license key is Enterprise-level or Professional with an eSync modifier, this screen appears. For details on how to complete it, see Managing eSync Security Certificates. |
|
The installation automatically sets up user permissions based on data collected during setup. However, if there is a problem setting permissions for the user, this section describes how to set the permissions manually.
Note: If you are using SQL Authentication, you only need to set up the SQL user. If you are using Windows Authentication, you need to set up IUSR and an ASPNET, IIS_WPG, or Network Service user. The IIS_WPG user replaces ASPNET in Microsoft Windows 2003 server and Windows Vista. The Network Service user replaces ASPNET in Microsoft Windows 2008 server and Windows 7.
Step |
Setup Screen |
1. In the SQL Enterprise manager, select Security > Logins. |
|
2. Right click and select New Login. 3. On the Login Properties dialog, click the button to the right of the Name field. 4. Select your server. 5. From the user list, select the ASPNET , IIS_WPG, or Network Service user (depending on your Windows version) and IUSR user. 6. Click Add then OK. |
|
7. On the Database Access tab, select your Ektron CMS400.NET database. Then, assign permission to read and write to that database (as illustrated). |
|
8. Run the grant permission script. Note: Before doing this, review your users and their permissions. Adjust as necessary for your configuration. Also, if you use Windows Authentication and all users are domain users (and the database administrator wants it this way), you may not have to perform this step. Follow these steps to do that. Open the SQL Query Analyzer. From the dropdown list, select the Ektron CMS400.NET database.
Choose File > Open. Open C:\Program Files\Ektron\CMS400vnn\Utilities\SiteSetup\Database\cms400_permissions.sql. (nn represents the release number) Within that file, replace [MACHINENAME or DOMAINNAME\USERNAME] with your domain name, backslash (\), and ASPNET (the ASP.NET machine account). For example, [ws10080\ASPNET]. Note: If you are using Microsoft Windows 2003 Server or Microsoft Widows Vista, the user is IIS_WPG. For example, [ws10080\IIS_WPG]. Click Execute Query (). Replace the text between square brackets with your domain name, backslash (\), and the IIS Internet Guest Account. For example, [ws10080\IUSR_ws10080]. Click Execute Query (). If using SQL server authentication, replace the text between square brackets with the SQL server authentication name only. Do not include the domain name. Click Execute Query (). |
Possible cause |
Suggested solution |
User does not have permission to create objects |
Grant user permission to create objects. For information on how to, read IIS Security help topic “Setting NTFS Permissions for a Directory or File.” |
IIS is not installed |
Make sure IIS is installed on the server. |
Host is not localhost |
Install Ektron CMS400.NET on localhost machine only. |
Cause |
Solution |
You installed Ektron CMS400.NET for .NET 2.0 but have the 1.1 .NET framework. |
Install the .NET 2.0 framework. Or, install the version of Ektron CMS400.NET for the 1.1 .NET framework. |