Setup and configuration steps to get Gummy Bear quickly up and running. If you are upgrading Gummy Bear from 1.2 to 1.3, please see the 1.2 to 1.3 Upgrade Guide. If upgrading from Gummy Bear v1.1, as so much has changed, please consider doing a fresh install if possible. Otherwise, the process of upgrading consists of executing the v1.1 to v1.2 SQL update script, then copy the v1.2 website files over your existing site, then upgrade as normally as described in the Gummy Bear 1.2 to 1.3 Upgrade Guide.

(For all previous upgrade guides, please see the Sueetie Wiki Upgrade Guides Category.)

Requirements¶

• Gummy Bear supports IIS6/IIS7, Windows 2003 Server and Windows 2008 Server.
• Requires .NET 3.5 SP1
• 32x and 64x bit systems are supported. Gummy Bear is compiled for 64x-bit systems by default. 32x-bit DLLs to support Gallery Server Pro are located in /media/gs/32x.
• SQL Server 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. A Sueetie Development Package called Atomo contains the source code.
• 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. You will also require direct SQL Server database access to run upgrade scripts of future releases.
  

Setup Process Overview¶

Gummy Bear uses a single one-step installation process. Here is an exact copy of the page at http://gummybear.sueetie.com. The Installation Page loads automatically when it detects you have not yet installed Gummy Bear. So to begin the installation process once you've completed the Setup Menu Preparation Steps, simply go to http://yoursite.com where you will be automatically redirected to http://yoursite.com/install.

Here is the Installation Page and a secondary Configuration and Setup Page. In the past we walked through the YetAnotherForum.NET and Gallery Server Pro setup wizards. In Gummy Bear 1.3 the wizards have been integrated into the Gummy Bear Setup process. You'll click on the button pointed to by the arrow on the Installation Page which will load the Configuration and Setup form consisting of only three fields.





As you'll see on the installation page, the process consists of:

• Create a database and required SQL accounts used by the site (Network Service, IIS identity account, SQL user in Connection String)
• 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.
  

• Update connection strings (list of .config files whose connection strings require updating are listed on Gummy Bear install page and below.)
  
  
  • \util\config\connections.config
  • \utils\config\Sueetie.config
  • \Blog\connections.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.





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¶

• General Site Settings The first step you should probably take is login as "admin" (password "password") and become familiar with the control panel. (Menu "Admin" link or http://yoursite/admin.)
• Set Read-Write folder permissions. Certain site folders require read-write permissions. For play purposes, set IIS Identity permissions to full read-write. For live sites, here are the folders you need to give Read-Write permissions to:
  
  
  • /images/avatars
  • /blog/app_data
  • /blog/web.config (new requirement in BE.NET 1.6 when updating settings in BE Admin)
  • /forum/uploads
  • /media/app_data
  • /media/gs/config
  • /media/gs/mediaobjects
  • /wiki/public
    

• Configure WCF Services. Certain Sueetie functions use WCF Services which are configured in the area of the web.config (at bottom of file.) Replace any appearances of "http://sueetie" with the domain for your site. Also remember that if this is your first use of WCF Services on a Windows 7 or Vista PC, be sure to enable Windows Communication Foundation HTTP Activation in Programs and Features -> Turn Windows features on or off -> Microsoft .NET Framework 3.5.
• Sueetie.config Gummy Bear and the various applications use app.config files. Gummy Bear uses a sueetie.config file in the /util/config folder which you will have already seen when updating its SQL Connection String. Look through the sueetie.config file for any items you wish to change, like avatar thumbnail size.
• Update Email Settings. Each application's administration area contains an Email Settings area. Walk through each and confirm they are correct and working. Also update the Email Settings in Sueetie Administration, your web.config and in forum/mail.config.
• Disable Gummy Bear Setup. To prevent anyone from re-installing Gummy Bear over your live data, you'll want to set ENABLE_SETUP = false in /install/default.aspx, or simply delete /install/default.aspx. To be safe, also delete /forum/install/sueetie.aspx.
• Change Admin, Testguy and Anonymous passwords. Change the Admin, Testguy and Anonymous user passwords in the Gummy Bear Control Panel.
• Media Gallery and 32x/64x Gummy Bear is built with 64x-bit support by default. If you get a "cannot load GalleryServerPro.Data.SQLite.dll" you need to replace the SQLite Dlls in /media/bin with the 32x GSP DLLs located in /media/gs/32x.
• Configure the site menus You may wish to modify the site header and footer menus, perhaps not right away, but at some point after installation. Menus are located in /themes/lollipop/menus. Additional information on Sueetie Menus is located here.
• Create a Welcome Message You will want to customize the site Welcome Message when new users join your community. First impressions are important, so load the /members/welcome.aspx page in your browser as an Administrator and create a welcome message appropriate for your community. If no message is created the default "Thank you for becoming a member of our Community!" will be displayed.
• Customize Email Templates You'll find Password Update and Change Password HTML templates in \util\email. Take a minute to customize them to include links and info specific to your community.
• Update the Lollipop Theme. Gummy Bear 1.3 includes two variations on the Lollipop Classic Red theme installed by default, Lollipop Black and Blocked Lollipop. It's very easy to switch to sample these themes on your new site. Information in Customizing the Lollipop Theme.
  

Gummy Bear Reloaded¶

You most likely will want to fill-up your site with fun content as you familiarize yourself with the great apps supported in the Sueetie Framework, perhaps style it to your liking along the way, then return the site to its virginal state for Go Live! Here is how you might want to do that.

• Create a new database or copy the dummied-up one. Remember to save any Content Part text! The easiest way to do that is to copy the HTML into notepad and paste on re-load.
  
• You'll then want to clean out any site file storage folders or restore originals. Here are the ZIP folder locations containing the original contents of file storage folders you'll want to reload:
  
  • /images/avatars
  • /blog/app_data
  • /media/gs/mediaobjects
  • /wiki/public
    
• Now you can re-execute the one-click setup at /install/default.aspx. Any theme changes to Lollipop will not be affected.
  

Top