Are you a member? sign in or take a minute to sign up

Cancel
User Id: Password:
SyrinxLogo-beulah.png

Syrinx CS ASP.NET Starter Site Setup Guide


Download the Latest Version of Syrinx CS

You can download the Syrinx CS ASP.NET Starter site zip, which contains the deployable contents of a Syrinx CS Site that you run on your own server.  
The following link will redirect you to the codeplex project download.

Get Your Environment Setup

In order to successfully run Syrinx CS ASP.NET in your environment, you need to make sure it has the proper pre-requisits:

The right version of Windows

We recommend that you run the Syrinx CS ASP.NET server with either Windows 7/8 or Windows Server 2008. The SCS server has been tested with IIS 7+, with IIS 7.5 being the ideal execution environment. We host our servers with Windows Server 2008 R2, which has IIS 7.5.

Ensure you have IIS installed

There are various links on the web to step-by-step guide you through an IIS setup for your specific version of Windows.

Ensure you have .NET 4.0 Installed

If you dont have .NET 4.0 already, you can download version 4.0 from Microsoft directly at http://www.microsoft.com/net/download/version-4.

Ensure you have SQL Server 2005 or better

We recommend using Sql Server 2008 R2, but Sql Server 2005 and greater will work with SCS.

If you dont have SQL Server, you can down the free SQL Server 2008 R2 Express, which works great for most local environments.  It is available from Microsoft at http://www.microsoft.com/download/en/details.aspx?id=23650.

It is best to download the express version that comes with tools.

Setup the Syrinx CS Starter Site

Unzip the starter site download into the location you will use with IIS. The standard Syrinx CS directory structure looks like the following:

You should unzip into the [siteName] directory, as the zip contains the source and extfiles directories. We typically use the date of deployment for the directory for IIS to bind to, with the example above showing “2011_12_1”. This helps us to remember the date the directory was actually setup, and when new versions are deployed, new sibling directories are created with the given date, which makes it easy to rollback to a previous version if needed.

  • Setup IIS to reference the site

    Open the IIS control panel, and create a new site.

    Point the site to the execution directory, with our example using [siteName]\2011_12_1. 

    You can setup your site to use a custom domain name, as shown in the image below:

    If you don’t have a domain name, you can setup a custom port, as shown in the image below:

    Ensure the IIS app pool being used by the site is setup to use .NET framework version 4.0 (or greater), as shown in the image below:

    If you know your way around IIS, you can use whatever directory structure you want, but you’ll still need an ExtFiles directory which is external to the main site IIS hosts from.

  • Setup the site’s database

    You only need to setup a blank database and provide the appropriate userid/password for the site to use.  The basic steps for this are:

    1. Open SQL Server Manager and connect to your server
    2. Right click on the databases tree node and click "New Database..."
    3. In the database name field, type in the name of the database you want, such as Starter_5.0
    4. After creating the Database, you should also create a new database user specifically for the site to use when accessing the database.

    Create SQL User Login

    1. Open/Click + sign on Security folder.
    2. Right click the Logins folder and select New Login…
    3. In the Login name field type: scs_user
    4. Select SQL Server Authentication
    5. Uncheck Enforce password policy
    6. On the Password field type: scs_us3r
    7. Re-type the same on the Confirm Password field.
    8. Click the OK button when done.

    Mapping User as dbo on SyrinxCS

    1. Double click the newly created user login (scs_user)
    2. On the Login Properties window, click on the User Mapping on the Select a page section
    3. Under the Users mapped to this login grid, locate and tick the checkbox for the [sitename]_5.0
    4. Under database role membership (lower grid) tick the checkbox db_owner
    5. Click the OK button when done

Run the Site Setup Utility

If everything is setup properly, you should be able to navigate to your site and go to the SiteSetup.aspx page in the site's root.

  • Setting up the site options

    The first step involves verifying that the site can properly connect to the database.  If the "Can Connect to Database" checkbox is not checked, you need to verify that the database is configured with the proper user id.  You may need to edit the source\configFiles\Catalogs\DbDefinitions\Starter-Local.xml and adjust the connection string to fit your specific SQL Server configuration.

    Warning: Until you see the "Can Connect to Database" checkbox is checked, you will not be able to successfully setup a new database for the site.

    The second step involves populating the database with the proper tables and starter data.  The information you provide within the fields will also be pushed into content in things like site event notifications, articles used as email templates that are sent when user register or purchase items and other important items.

    At this point, the database version should be showing a value of 0 because the database has no tables in it.  Ensure you use thoughtful values for the following fields:

    • Site Name - This is used for things like page title bases, basic site background information and other situations that need a general name for the site.
    • Short Name - This is a critical short, no spaces allowed, name used like a nickname that also drives directory names, urls and other important things.  When running a single site web site, this can be any value that means something to you, but if you want to use the child site option of Syrinx CS, then each child site would need a unique short name from others.
    • Domain Names - This is the comma delimited list of domain names, like www.syrinxcs.org or syrinxcs.org, that are used to access the site.  This can be left blank if you will not be using child sites, but once one ore more child sites are created, these are important for helping to drive traffic to the right site.
    • Primary Domain Name - This is a critical value that is used for many situations where full URLs are needed, such as emails being sent when things happen on the site.
    • Default Currency - If you will be setting up the ecommerce portion of Syrinx CS, this is the value shown next to decimal prices to indicate the currency being used.  This is used as a default when multi-currency options are not used.
    • Admin User Id - The login userid used for the admin account created initially to access the site.  The default is admin.
    • Admin Password - The password user for the admin account.
    • Admin Email - The email address used by the admin, which is also used for event notifications for important things happening on the site, such as a user registering or a online sale happening.

    Once you have provided the needed values, you should use the "Setup New Database" button to trigger the creation process.  After the process has completed, which shouldnt take more than a few seconds, the Database Version field should show a value that matches the version of Syrinx CS you downloaded.

At this point, you should be able to go to the home page, login with the admin user id, and use the admin pages to configure the site in depth and create content.

Developer Knowledge