Installation

The 3DR depends on a lot of things being set up correctly to run on a server. It depends on MySQL, Fedora Commons, and ASP.NET. We've created an installer that can help set up an installation for you, provided you have a few basic things ready to go. Most importantly, the installer requires you to have a working copy of IIS already installed and running on the target machine. We highly recommend IIS 7 or greater, as the installer can configure these versions for you. If you are running IIS 6, you will have to manually configure the web server.

For best results, choose a blank Windows 2008 server setup, and instruct the installer to perform a "Full Install on Local Machine" install type. This will install Fedora Commons, MySQL, MySQL Administrator, the Java Runtime Environment and .Net 4 if necessary. It will also configure IIS to host the application.

When the installer launches the setup for Fedora Commons, choose the "Quick" install type, and be sure to install to "C:\Fedora". This will be smoothest install. Be sure to remember the password for the default fedoraAdmin account. You'll need this later.

The installer will launch the configuration wizard for MySQL. Be sure to remember the root password you supply here.

When the installer prompts you for the Fedora name and password, and the MySQL name and password, it's not asking for you to set up these passwords - you've already done that. It's asking you to enter the ones you choose from within the Fedora Commons and MySQL installers.

When choosing a Fedora Namespace, choose something unique. In the future, we'll enforce uniqueness by checking your entry against the global federation list, but for now, it's very important you choose something not likely to be used by another 3DR install. If you have a collision in the namespace, you will not be able to join the federation, and changing the namespace after you've imported content is quite difficult.

Currently, the installer does not set up Fedora Commons to run on startup of the server. This means that you'll have to manually configure the machine to run the c:\Fedora\Tomcat\bin\startup.bat on boot.

Upgrade Tips

On Windows Server, right click and choose "Run As Administrator" when running the installer.

If you see file copy errors, stop your web server. The installer will try to stop and restart the app, but if you have custom IIS config, it may not work.

The installer will backup your files under /backups/.

I'd create a manual backup of your web.config beforehand, just in case.

When upgrading from an older version: After you've run the installer you will have to re-enter config info. Be sure to have all your passwords for Fedora, MySQL and the 3DR handy.

If you had manual changes to the web.config, you will have to manually add them back to the new web.config after upgrading.

Make sure that the MySQL server is running during the install - it's required to upgrade the database.

The web server now keeps a local copy of thumbnails which were previously stored in Fedora. You'll have to create these cached files for old uploads.

On the "Administrators" page, choose the link that says "Rebuild Thumbnail Cache".

Click "Rebuild", then wait for the little status label to say "Finished"