Issuu on Google+

Composite C1 Install ation Composite 21-01-2010


Contents 1

INTRODUCTION .................................................................................................... 3

2

ENSURING COMPOSITE C1 REQUIREMENTS ARE IN PLACE ........................ 4

2.1 2.2 2.3 2.4

Installing Microsoft .NET Framework 3.5 Installing IIS on Windows XP and Server 2003 Installing IIS on Windows Vista and Windows Server 2008 Ensuring that ASP.NET 2.0 is installed and enabled

3

DOWNLOADING AND INSTALLING THE SOFTWARE ...................................... 6

3.1

Create a new website on Windows Vista, Server 2003, Server 2008

7

3.1.1

Using the IIS Manager to manage sites

8

3.2 3.3

Create a new website on Windows XP Register and log in for the first time

8 10

3.3.1 3.3.2

Registering Composite C1 Your first log in

10 11

4

TAKING FIRST STEPS ........................................................................................ 12

4.1 4.2 4.3

Installing a content language Creating the first template Creating the homepage

5

TROUBLESHOOTING ......................................................................................... 14

5.1 5.2 5.3 5.4 5.5 5.6

I get no response when requesting http://localhost/ 14 I get a “default web site” pertaining to IIS and not Composite C1 14 I can see the site locally, but my colleagues cannot see it remotely 15 I get an ASP.NET Error Screen pertaining to a configuration error in web.config 15 I get a “Directory Listing Denied” screen when I launch the site 16 I get file permission errors 17

6

UNINSTALLING COMPOSITE C1 ....................................................................... 18

6.1

Deleting websites and files

4 4 4 5

12 12 13

18


1

Introduction

This document is a manual for installing Composite C1 for evaluation, training and testing purposes. It covers the basics of installing the C1 software and creating a new C1 website on various operating systems, including configuring IIS (Internet Information Services) when needed. Depending on your operating system and existing settings you may need to make changes to get Composite C1 up and running. These changes do require that you are a Windows super user, but intensive knowledge about IIS is not required Note that Composite partners can help you to install and run Composite C1 in a fully managed web hotel, where they take full care of setting up and maintaining a web server for you. If you are using such a service, this document is not required reading.


2

Ensuring Composite C1 requirements are in place

When the Composite Installer package (CompositeC1.MSI) is started, it will automatically check that your system contains the standard Windows components required for Composite C1 to run. The required components are: The correct version of Microsoft Windows (XP Professional SP2, Server 2003 SP2, Vista, Server 2008) Microsoft .NET Framework 3.5 Internet Information Services (IIS - version 5.1 or newer) Minimum of 512 MB memory If any of these components are missing, the install program will inform you and then abort the installation.

2.1

Installing Microsoft .NET Framework 3.5

If the Microsoft .NET Framework 3.5 is not installed on your machine, Google the words “.net framework 3.5 download” to find to download page, or click this link: http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531508D977D32A6. Once downloaded, run the .NET 3.5 installation package and follow the wizard.

2.2

Installing IIS on W indows XP and Server 2003

If the Internet Information Services has not been installed on your machine, you can install it via the “Add or Remove programs” applet located in your Control Panel. To do this, execute the following steps: 1) Open “Control Panel” 2) Open “Add or Remove Programs” 3) Click “Add/Remove Windows Components” 4) In the “Windows Component Wizard” check the “Internet Information Services” check box (located below “Application Server” on Windows Server 2003) 5) Complete the installation.

2.3

Installing IIS on W indows Vista and W indows Server 2008

1) Open “Control Panel” 2) Open “Programs and Features” 3) Open “Turn Windows features on or off” 4) Browse to Internet Information Services -> World Wide Web Services -> Application Development Features 5) Ensure that the following are checked:


- ASP.NET - .NET Extensibility

2.4

Ensuring that ASP.NET 2.0 is installed and enabled

ASP.NET 2.0 is the Web part of the Microsoft .NET framework, and it must be enabled for Composite C1 to run. If you are uncertain whether ASP.NET 2.0 is installed and enabled, execute the following steps: 1) Start the Internet Information Services (IIS) Manager from Administrative Tools 2) Browse to the Web Service Extensions node and ensure that “ASP.NET v2.0.50727” is present and allowed.

If ASP.NET 2.0 is not present or allowed, execute the following command steps: 1) Click the Start button 2) Click Run 3) Type “cmd” and press Enter, yielding a command prompt window 4) Write (or copy/paste) the following command and press Enter: %windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i 5) Wait for the command to complete.


3

Downloading and installing the software

Composite C1 is distributed as a Microsoft Install package – a file named CompositeC1.MSI – which starts the installation procedure when double clicked in Windows Explorer. When started, it will automatically check your system configuration to ensure that you have all required components on your computer for Composite C1 to run. Download the latest version of Composite C1 from http://docs.composite.net/. The installer is packaged as an MSI file.

After downloading the installer file, run it.

Read and accept the EULA to continue.

Verify or specify installation folder and click Next and then Install.


Click Finish when the installation is done. Once the basis software has been installed, you can use the site installer to create one or more new Composite C1 websites.

3.1

Create a new website on W indows Vista, Server 2003, Server 2008

Start the Composite C1 Site Installer. This program will be automatically launched if you have the option “Launch Composite C1 Site Installer” selected when finishing the installation wizard. You can also start this program at a later point from the menu “Start | All Programs | Composite C1”.

On Windows Server 2003, Vista and Server 2008 the site creator tool will create a new website automatically in accordance with the values you specify. Website description This field is used to name the new website in the Internet Information Services console and is intended as a title for human reference. Website http port This field lets you control the HTTP port number, the website uses when registered in IIS. The port number is the numeric part of an address like http://www.contorso.com:80/ and you can use the port number to have multiple websites running on the same IP. Port 80 is the default port number on the web; hence http://www.contorso.com/ means the same thing with and without the “:80” part.


Website host name This field lets you control the host name the website uses when registered in IIS. The hostname is the “localhost” part in the address http://localhost/ and is yet another way to enable multiple websites to exist on the same server. The name “localhost” is special in that it always refers to the machine in front of you – the local host. Leave the field blank to bind to all host names. Website folder path This field lets you control where on your local file system web files and folders are located. ASP.NET Identity This field should contain the name of the security account that ASP.NET uses when executing Composite C1, read/write files etc. On non-XP systems this is typically “NetworkService” – you can obtain this information by launching the IIS Management Console, locate the default application pool and check the identity. The Website http port and host name combine to create the “address” of the website. You should remember this address since you will need to use it when starting Composite C1 in your browser. To start the site creation process, fill out the fields and click “OK”. When the process has completed, your browser will launch automatically and display the (initially blank) Composite C1 site. 3. 1. 1

Us i n g th e I IS Ma n ag er t o m an a ge s it es

If your computer already contains a website that uses this address, the two sites will compete for the same address and only one can run at a time. If you should happen to specify an address that is already in use, the site will still be created and you will be informed that the new site must be started manually. To do so, launch the Internet Information Services (IIS) Manager from Administrative Tools.

The IIS Manager enables you to start and stop sites and also change site settings like the host names, ports.

3.2

Create a new we bsite on W indows XP

Start the Composite C1 Site Installer. This program will be automatically launched if you have the option “Launch Composite C1 Site Installer” selected when finishing the installation wizard. You can also start this program at a later point from the menu “Start | All Programs | Composite C1”.


On Windows XP the Site Installer tool will copy all required web files to the folder specified. When the file copying has completed, the specified folder can be published as a “web folder” via the Windows XP web server by executing the following steps: 1) Locate the folder on the file system, right click it and select Properties. 2) Go to the “Web Sharing” tab. 3) Select the “Share this folder” option. 4) In the “Edit Alias” dialog that pops up, ensure that the “Read” option is selected in “Access permissions” and “Scripts” is selected in “Application permissions”. Click OK. Make a note of the specified Alias or change it if desired. The Alias will be used as a website folder name. 5) Click OK.


After these steps you should be able to launch the website using the address http://localhost/Alias/ where “Alias” is the alias you specified in the steps above.

3.3

Register and log in for the first time

Composite C1 is a web application and you run it inside a browser like Internet Explorer or Mozilla Firefox. On non-XP systems the web address depends on the host name and http port settings specified when the site was created. http://localhost:80/ Display the public part of the site. Host name and port may vary. http://localhost:80/Composite Display the administrative part of the site. Host name and port may vary. On Windows XP systems the web address depends on the “Alias” you specified when creating the web folder. http://localhost/Alias/ Display the public part of the site. The “Alias” string should be the alias specified when the web folder was created. http://localhost/Alias/Composite Display the administrative part of the site. The “Alias” string should be the alias specified when the web folder was created. 3. 3. 1

Re g is t er i ng C om pos it e C 1

The administrative user interface is launched by clicking the red button labelled “Start Composite”.


The first time Composite C1 is launched you are required to register the new site. Doing so will issue a free trial license automatically and takes only a few minutes. To start the registration process, click the “register installation” link in the Composite C1 window.

Once you have completed the registration form and received the congratulations screen, return to the Composite C1 window and click the button labeled “Activate”. 3. 3. 2

Yo ur f ir s t l og i n

When a new Composite C1 site is created, it contains no data and no users. To ensure that you can log in and start using Composite C1, a “first time use user name” exists, which is admin If you specify this user name, the system will accept – and remember – any password you specify, but only at the first login. At all subsequent logins you must specify password you chose. Once your login has been submitted, the system will initialize and a user named “admin” will be automatically created – this make take several seconds, depending on the speed of the machine.


4

Taking first steps

When Composite C1 is installed, it’s a “blank solution” ready for customization. Before you start creating your first website, you need to: Install one or more content languages Create the first template Create the homepage These are required first steps you should take before you can create and customize your website.

4.1

Installing a content language

A page in C1 can be in multiple languages. In the administration module, you will see only one language at a time. In the lower right corner of the C1 console, you can switch between different languages. When Composite C1 is installed, it has no languages. To install a language: 1) Log in to the administrative console as an administrator 2) Go to the “System” area 3) Select “Languages” and click “Add Language” 4) The language adding wizard is launched. Complete the wizard. Languages The list of available languages not yet installed URL mapping name The string inserted into the URL of the page translated into the languages specified above (It can be blank for pages on a website in the default language) User access A check mark here indicates that the language will be available to all registered users for viewing and editing 5) Click “OK” If you have not added at least one language, you will be prompted to do so when you try to create a template or a page.

4.2

Creating the first template

Each page in C1 is template-based. The template lay out the content and sets a number of defaults that various pages can share. The template makes pages look the same in terms of layouts and styles. When Composite C1 is installed, it has no templates aboard. You have to create at least one. When you create a template it will already have some default content, which you can accept or totally replace with your own. 1) Log in to the administrative console as an administrator 2) Go to the “Layout” area


3) Select “Website Templates” and click “Add Template” 4) Type in the title for the template and click “OK” 5) The template will open in the working area on the right and you can edit it. If you have not added at least one template, you will be prompted to do so when you try to create a page.

4.3

Creating the homepage

A homepage is an entry point to your website. You create all the pages for a website below the homepage. Having added at least one language and one template, you are ready to create a homepage. 1) Log in to the administrative console as an administrator 2) Go to the “Content” area 3) Select “Websites” and click “Add Homepage”. 4) Fill out the fields: Title The title of the page that appears in a browser’s title bar (Required) Description A short description of the page (Optional) Template One of the templates available to base the page on (Required) Position The position of the page in the “Content” tree (Required) – by default, set to “Insert at the bottom” 5) Here, you can click either “Finish” (default) or “Next”. By clicking “Finish”, you have C1 set other fields for you. By clicking “Next”, you can also override values generated by C1 for you: URL title A relative path to the page that appears as in a browser’s address bar (Required) Menu title The title of the page used in the navigation on the website (Optional) 6) Click “Finish”. Now you can edit the homepage by adding content of your choice to it. When you save and publish the homepage, it becomes available online. You can now access it in your browser by typing the URL of this page in your web browser: http://localhost/MyFirstHomePage.aspx Please note that you need to replace “localhost” with the name of your server and “MyFirstHomePage” with the title of your home page.


5

Troubleshooting

If you experience technical problems when installing or using Composite C1, connect to http://support.composite.net/ and search for a knowledge base article relating to the problem you experience. Below are descriptions of typical issues when setting up a new web applications and how to solve the problems. Please note that the steps described below may vary in your operating system.

5.1

I get no response when requesting http://localhost/

If your browser times out or reports about connection problems when connecting to http://localhost/, you should ensure that the Internet Information Services are running and that your Composite C1 site is running. To fix this problem do the following: 1) Start the Internet Information Services (IIS) Manager from Administrative Tools 2) Right click on your server – the item located below “Internet Information Services” and select All tasks | Restart IIS… 3) In the dialog “Stop/Start/Restart…” click OK 4) This will ensure that your IIS is running 5) Open the Web Sites folder and select the Composite C1 site. If it is labelled with the text “(Stopped)”, right click it and select Start

5.2

I get a “default web site” pertaining to IIS and not Composite C1

If you get a website that does not relate to Composite C1 or no page is found on http://localhost/Composite, another website is probably running instead of Composite C1. Note to Windows XP users: The Composite C1 website is created in a sub folder below the default Windows XP web site, and getting a default IIS page when requesting http://localhost/ should be expected on Windows XP. Please read the section “Register and log in for the first time” above on what web address to use on Windows XP. To fix this problem do the following: 1) Start the Internet Information Services (IIS) Manager from Administrative Tools 2) In the “Web Sites” folder locate the Composite C1 site and try to start it – right click the website and select Start. 3) If you get a message saying that the site could not be started because another site is using the same address, stop existing running sites and try to start the Composite C1 site again


5.3

I can see the site locally, but my colleagues cannot see it remotely

If the web site was created with the host name “localhost” it is unreachable from other computers. To fix this problem do the following: 1) Start the Internet Information Services (IIS) Manager from Administrative Tools 2) In the “Web Sites” folder locate the Composite C1 site, right-click it and select “Properties” 3) On the “Web Site” tab, click the “Advanced…” button in the “Web site identification” group. 4) Add a new Web Site Identification line, specifying “(All unassigned)”, 80 and an empty host deader value. Click OK on the 3 open dialogs. 5) Reference the website from a browser using your computers machine name or IP number (and not “localhost”) and ensure that the Composite C1 site launches. 6) If you get another site than expected, go through the list of websites and ensure that other running sites are not using the same Web Site Identification configuration as the one you just created.

5.4

I get an ASP.NET Error Screen pertaining to a configuration error in web.config

If you get an error relating to web.config the most likely cause is that the website or IIS does not support or is not configured to use ASP.NET 2.0. To fix this problem do the following 1) Click the Start button 2) Click Run


3) Type “cmd” and press Enter, yielding a command prompt window 4) Write (or copy/paste) the following command and press Enter: %windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i 5) Wait for the command to complete and re-request the web page.

5.5

I get a “Directory Listing Denied” screen when I launch the site

If your web server hasn’t been configured to use ASP.NET pages as default content pages, you will see a “Directory Listing Denied” error when you launch http://localhost/.

To fix this problem do the following: 1) Start the Internet Information Services (IIS) Manager from Administrative Tools 2) In the “Web Sites” folder locate the Composite C1 site, right-click it and select “Properties” 3) On the “Documents” tab, click the “Add…” button in the “Enable default content page” group – and ensure that the checkbox in this group is checked. 4) In the “Add Content Page” dialog write default.aspx and press OK. 5) Press OK In the properties window.


5.6

I get file permission errors

When a new Composite C1 site is created and files and folders are copied to the location you specify, file permissions are set on the files and folders. The user specified as “ASP.NET Identity” when the site is created is granted read and write access. If the website runs in a different security context than the one specified, file permissions must be updated to reflect this. On a test installation in a secure environment you can fix this by executing the following steps: 1) Locate the folder containing the Composite C1 site 2) Right click it and select “Properties” and select the “Security” tab 3) Click the Add button and write “Everyone” (without the quotes) and press OK 4) In the properties dialog, give the “Full Control” right to the “Everyone” user. 5) Click the “Advanced” button, check the box labelled “Replace permission entries on all child objects…” and press OK. Press Yes in the confirm box. 6) Press OK to close the Properties dialog.


6

Uninstalling Composite C1

You can uninstall Composite C1 through the “Add or Remove Programs” applet located in your control panel. Locate Composite C1 in the list, press the “Remove” button and follow the wizard. Please note that uninstalling Composite C1 will leave existing Composite C1 websites intact on your machine.

6.1

Deleting websites and files

To remove created websites on Windows XP, locate the file folders you have created using the “Create new Composite C1 site” tool and delete them. This will remove website specific files from your system and unregister the folders from you web server. To remove created websites on Windows Server 2003, Vista and Server 2008 execute the following steps: 1) Start the Internet Information Services (IIS) Manager from Administrative Tools 2) In the “Web Sites” folder locate all Composite C1 sites you may have created and delete them. 3) Locate the file folders you have created using the “Create new Composite C1 site” tool and delete them.


Guide2