Setup and configuration steps to get Gummy Bear and Atomo Version 3.3 quickly up and running. For information about upgrading from prior Sueetie releases check the Sueetie Wiki
Upgrade Guides. If using Sueetie Version 3.2 and you are upgrading to Version 3.3, here is the
Sueetie 3.2 to 3.3 Upgrade Guide. Don't forget to view the
Post Installation Checklist before going live with any site.
This document details the most current full release of Sueetie, Version 3.3, released July 30, 2011.
Requirements
- Sueetie 3.3 supports IIS6/IIS7, Windows 2003 Server, Windows 2008 Server, Vista, Windows 7
- Requires .NET 4.0. It does NOT support .NET 3.5. Gummy Bear 2.0 is available for those without access to .NET 4.0.
- SQL Server 2005/2008.
- Gummy Bear must be run at the site root, not in a subfolder.
- If used in Visual Studio, Gummy Bear is pre-compiled and contains no .proj or .sln files. All source code is available in the Sueetie Development Package Atomo.
- Gummy Bear can run on a shared host environment or VPS. You will need the ability to create IIS application directories and modify directory permissions.
- Sueetie uses Windows Communication Foundation services, or WCF, so your host must support Windows Communication Foundation HTTP Activation. Check this Sueetie Discussion for a list of hosts who do/do not support WCF as of 11/1/10
Setup Process Overview
Gummy Bear uses a three-phase approach to installation: Setup Preparation, One-click Install and a Post-Installation Checklist Review.
Here is a screenshot of the Sueetie Installation Pages.
Note: The screenshots shown are of Version 3.2, but other than "3.2" references are identical to Version 3.3 in all respects
Identifying a Bad Database Connection
Sueetie will inform you if you attempt to run the installation with a bad database connection by displaying the message below. If you encounter this message, check your database connection strings in the various .config files listed on the installation page. Then try to load http://yoursite's home page where you will be redirected to the installation page, and if your database connection is good, no annoying message. All Systems Go!
Installation works like this
- Create and configure your SQL Database
- Confirm your website is running .NET 4.0 (Version 4.0.30319.)
- Complete the Setup Preparation steps of setting your connection strings and IIS applications.
- Go to http://yoursite.com where the Installation Page will automatically display. Confirm you completed the Setup Preparation steps.
- Walk through the Post Installation Checklist for issues that may pertain to your environment.
Setup Preparation Steps
To prepare your site to run the installation process, perform the following steps:
1. Verify that the .NET Framework Version you're using is .NET 4.0
Sueetie 3.3 supports .NET 4.0 (Version 4.0.30319.) .NET 3.5 users can use Sueetie v2.0 and any v2.x upgrade.
2. Create and Configure your SQL Database¶
Create a database and required SQL accounts used by the website (Network Service, IIS identity account, SQL user in Connection String)
3. Set IIS application folders
Set IIS application folders for the Sueetie Applications. Your website should look like this. Notice that "blog," "media," "forum" and "wiki" are IIS application folders. If you plan on changing the directory names ("photos" instead of "media" or "discussions" instead of "forum" for example), make those changes
after you install Gummy Bear.
One final note, remember to assign the same .NET 4.0 Application Pool to the IIS application folders that you assigned to the site.
4. Update Website SQL Connection Strings
- Update connection strings in the website .config files found in the following locations
- \util\config\connections.config
- \utils\config\Sueetie.config
- \forum\db.config
- \media\connections.config
- \wiki\Web.config
For your convenience, Gummy Bear uses the following connection string enabling you to update all connection strings with a single search-replace operation.
data source=(local);initial catalog=GummyBearDB;integrated security=SSPI.Updating the connection strings is quick and easy with any decent text editor. I use Notepad++. Below is the Notepad++ dialog box searching all *.config files in the /web contents folders for "GummyBearDB." The result is shown below. Double-clicking on any result item will load the file into Notepad++ editor to update. You can also, of course, do a global search and replace.
Please note: for Atomo Developers, use "AtomoDB" for your connection string search/replace operation instead of "GummyBearDB." Likewise on WCF web.config updates below, use "atomo" rather than "gummybear."Done!
You can now install Gummy Bear! When you go to http://yoursite it will automatically redirect to the installation page at /install/default.aspx.
Three user accounts are created:
- admin password is 'password'. This is the account you will use to get started with Gummy Bear. Admin has all permissions.
- testguy password is 'password'. This is a Registered User account. Testguy also has editor permissions on the site blog. He can also post to the test forum. He has no other permissions to upload to the media gallery or create wiki pages.
- anonymous used for system purposes only.
Post-Installation Checklist
Every good website installation program needs to finish with a checklist, and since Sueetie is a collection of 5 applications working as a single community we have a few items to check. Please visit the
Post-Installation Checklist here.
Top