Installation Guide

WebEd9 Installation Overview

Before you begin the installation, ensure that you and your web host have the minimum requirements to run WebEd Cloud. Then download the required WebEd Cloud software to a local directory and extract the downloaded package. We provide two versions of WebEd Cloud a source code version and a no-source version.

Source Code version

STEP-BY-STEP
  • 1
    You need to Install Source Tree and know the basic setup of a Bitbucket repository
  • 2
    Make sure you are allowed to pull the source code from our repository by asking for credentials/permissions from the repository owner

Non-Source Code version

STEP-BY-STEP
  • 1
    Download the files in the link above. The link contains the latest code from the master branch of WebEd9

Running the site using IIS (package without source code)

To use IIS, copy the contents of the extracted WebEdCloud folder to an IIS virtual directory (or site root), and then view the site using a browser.

STEP-BY-STEP
  • 1
    Open IIS on your local machine, if you do not have one installed, please follow this guide.
  • 2
    Extract the zip file in the web app you created in your local IIS. If you are not familiar with creating a web app in IIS, please follow this guide.
  • 3
    Once you have extracted the files, access the web app you created locally and the installation screen will popup (see below)

    NOTE: If you are using IIS 7, configure it to run in integrated mode, and configure the application pool to run the .NET Framework version 4.


Running the site using Visual Studio (package with source code)

This step describes how to launch a site in Visual Studio:

STEP-BY-STEP
  • 1
    To run the site in Visual Studio, pull the full source code repository to your local folder.
  • 2
    Launch Visual Studio and open WebEd.sln.
  • 3
    Restore the NuGet Packages first to make sure that all packages are loaded (Right-click the Solution then click "Restore NuGet Packages")
  • 4
    Build (CTRL + SHIFT + B) the project first then make sure that there are no errors.
  • 5
    Create a new Blank Database in your SQL Server instance.
  • 6
    Set the WebEd.Web Project as the startup project and click Run or hit F5.
  • 7
    Make sure that you have had Git installation and configured the environment variables for it.

Getting the "ready to deploy" package (without source code) from a package with source code

STEP-BY-STEP
  • 1
    Unzip the Downloaded file into the desired location and proceed to the "Installation process"

WebEd Installation Process

WebEd Cloud requires to write permissions for IIS user account (IUSR) for the directories and files described below:

  • \App_Data\
  • \Logs\
  • \Media\

Before installing WebEd Cloud, ensure you have one of the following databases installed on your system:

  • SQL Server 2008 or higher
  • SQL Server Express

If you are using SQL Server 2008 or higher, you can use any of the following authentication methods to connect to the server:

  • SQL Server Account: When connecting using this method, logins are created in the SQL Server that is not based on the Windows user accounts. Both the user name and the password are created using the SQL Server and are stored in SQL Server. When using this method you must enter your login and password.
  • Integrated Windows Authentication: When connecting using this method, the SQL Server validates the account name and password using the Windows principal token in the operating system. This means the user identity is confirmed by Windows. The SQL Server does not request a password and does not perform identity validation. Windows Authentication is the default authentication mode and is much more secure than SQL Server Authentication. Windows Authentication uses Kerberos security protocol, provides password policy enforcement with regard to complexity validation for strong passwords, provides support for account lockout, and supports password expiration. A connection made using Windows Authentication is sometimes called a trusted connection, because SQL Server trusts the credentials provided by Windows.
STEP-BY-STEP
  • 1
    Once you open the site for the first time, you’ll be redirected to the installation page, as follows:
    Resizing Images
  • 1
    Read the Welcome file/text
  • 2
    Click Let's get started to go to the Licence screen
  • 3
    Read the licence
  • 3
    You need to open SQL Server Management Studio first and create a blank database (with or without credentials)
    Installation Guide
  • 3
    In the Server field, enter the required server name
  • 3
    In the Database name field, enter your database name. This database can be:
    • New empty database
    • If not created yet, the installation will generate it
  • 3
    Select the Integrated Security option if your SQL Server uses Integrated Windows Authentication and the database you created does not require credentials. Username and Password fields can be ignored.
  • 3
    If your database requires credentials (SQL Server Authentication), enter your login and password
  • 3
    Click Install and wait for the database generated
    Installation Guide
  • 3
    When the database is created successfully, click on Ok button to go to setup Email Account
    Installation Guide
  • 3
    Enter the information for Email Account. This step is optional and you can skip it but the system cannot send emails. You can update it later in Admin/Email Accounts
  • 3
    Click Skip this (a default email account will be created) or Save to go to Create User step
    Installation Guide
    • In the Email field, enter your email (also username)
    • In the First Name field, enter your first name
    • In the Last Name field, enter your last name
    • In the Phone field, enter your phone number
    • In the Password field, enter your password
    • In the Confirm Password field, enter your password again
    • Click Save to go to Setup company
    • Enter your company information. You can skip this step and update it later in the site settings
    • Click Skip this or Save to go to the next step
    Installation Guide
  • 3
    Starter Kit step:
    • This step is for generating some default templates for your CMS
    • The idea is that we will build up some default kit for you so that you can generate the site with CSS, script, template and HTML
    • Select a theme. There is only a default theme now
  • 3
    Congrats! You have finished the installation. Now you can:
    • Click Preview your new website to go Home page
    • Click Set up your new website to go to the Admin module

Note 1

Ensure that your application pool is set to Integrated mode

Note 2

If you want to completely reset a WebEd Cloud site to its default settings, you can delete the Site.config file from the App_Data directory. When using IIS you might want to read this article.

Note 3

There is a folder called Copy2Bin in WebEd.Web project that contains some bin files that need for the application to run correctly. These bin files are copied to the bin folder automatically at the build or publish time. But please check it, if they are not please copy these files to the bin folder

Note 4

When building/debugging WebEd Cloud with Visual Studio we use a Git command to get the version from the repository, so please make sure that you have Git installed and configured the environment variable for Git

WebEd Cloud Developer FAQ