Installing Gummy Bear

Requirements¶

• Gummy Bear supports IIS6/IIS7, Windows 2003 Server and Windows 2008 Server.
• Requires .NET 3.5
• 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 available as a separate download.
• Supports both SQL Server 2008 and SQL Server 2005 (though 2005 tested only for successful installation and version upgrades)
• Gummy Bear must be run at the site root, not in a subfolder.
• If used in Visual Studio, Gummy Bear is a Web Site Project. It contains no .proj or .sln files.
• 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 installation page. 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.

As you'll see on that 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 (screenshot on install page.)
• 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
  • /marketplace/photos
  • /media/app_data
  • /media/gs/config
  • /media/gs/mediaobjects
  • /wiki/public
  • /images/slideshows
    

• Update connection strings (list of .config files whose connection strings require updating are listed on Gummy Bear install page and below.)
  
  
  • \connections.config
  • \Sueetie.config
  • \Blog\connections.config
  • \forum\db.config
  • \marketplace\connections.config
  • \media\Web.config
  • \wiki\Web.config
    

• Update the Web Service URLs in the root web.config to support the JQuery/Ajax-to-WCF processes in Sueetie, like member following, friends and favorites. Replace "http://gummybear" with the host name of your site in the area at the bottom of the root /web.config file.
• Update the Gallery Server Pro 32x DLLs if you're running a 32x-bit system. Gummy Bear is compiled for 64x-bit systems by default. If you're using a 32x-bit system, download the GSP.32x.DLLs.ZIP and copy the 3 Dlls into your /media/bin folder or the Gallery Server Pro install wizard will bomb on you.
• Set a root url property in /marketplace/app.config (only if using Marketplace)
• Vista Users and the Gallery Server Pro Setup Wizard This was found by The Tonster, who discovered the GSP Setup Wizard did not display any images or execute properly on Vista IIS7. In summary, he commented out the staticContent element in the Web.config and added the mime type via the IIS Features View window. Here is the Sueetie Forums thread Tonster was good enough to share with us.
  

At this point you will walk through the Setup menu, creating the ASPNET Membership and Sueetie Framework SQL objects, step through the YetAnotherForum.NET and Gallery Server Pro setup wizards, click on the Post-Installation SQL Script link and you're done!

The YAF.NET and GSP setup wizards are very straight-forward, but it is essential to enter Sueetie-specific information. Details and screenshots for both wizards are available on these pages: YetAnotherForum.NET wizard information. Gallery Server Pro wizard information.

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 items¶

• Sueetie.config Gummy Bear and the various applications use app.config files. Gummy Bear uses a sueetie.config file in the web root 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 site or the path to your media gallery. This is optional and is only required if not using default /media path or wish to change the dimensions of user avatars.
• /forum/app.config. A SUEETIE.AppPath property contains the path to the forum. If the path to your forums is, say "/forums/" you'll want to change the default value of "/forum/" accordingly.
• Contact Us email configuration. The Contact Us page uses the BlogEngine.NET /blog contact form. You will want to enter your site's email settings on the BlogEngine.NET admin setting page. This will also enable comment notification and other BlogEngine.NET
• Membership email configuration. For functions like emailing lost passwords, update the MailSettings in the /web.config and in the Sueetie Administration Email Settings page.
• Give Album Read Permissions to Registered Users in Gallery Server Pro. Gallery Server Pro creates album roles and permissions on the first time it is loaded. See Giving Album Read Access to Registered Users for a step-by-step guide.
• Disable Gummy Bear Setup Property. To prevent anyone from re-installing Gummy Bear over your live data, you'll want to set ENABLE_SETUP = false in /install/default.aspx.cs, or simply delete /install/default.aspx. (Note that since Sueetie is a Website project type, no compile is necessary after updating default.aspx.cs.)
• 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" please download the 32x GSP DLLs in the Gummy Bear folder of the Media Gallery.
• Configure Site menu You may wish to modify the Site Menu, perhaps not right away, but at some point shortly after installation. Information on that is located here.
• General Site Settings The first step you should probably take is login as "admin" (password "password") and become familiar with the control panel. (Site "Administration" link.) You will want to set email settings as well.
• Disable Any Applications Not Installed While in the Control Panel, configure your site Applications settings (under Applications -> Site Applications) and disable any applications you did not install. Otherwise you will encounter errors when creating new users. Regarding the creation of new users after changing application settings, while the application object cache is flushed on update you should touch the web.config to ensure app restart before creating users.
• Create 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 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 \members\EmailTemplates. Take a minute to customize them to include links and info specific to your community.
• BlogEngine.NET 1.6 Extensions Change BlogEngine.NET 1.6 no longer has an /app_code/ExtensionsManager folder so you'll want to delete it.
  

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. The only table I can think you'll want to preserve is Sueetie_ContentParts, and then only if you created custom Content Parts you'll want to keep.
  
• Walk through the Setup steps in /install. When you do Go Live, it's a very good idea to set the ENABLE_SETUP property to "false" to make sure no one re-installs your site 6 months down the road and you have a very bad day as a result. This is located in /install/default.aspx.cs. Because Sueetie is a web site project, simply change the .cs file. No re-compile necessary.
  
• 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
    
• That should reset your site, preserving your theme changes. Copying over sueetie_contentparts, if necessary, should conclude the reload.
  

Top