Administrator’s Guide
Version 2.3.3512
Gallery Server Pro 2.3 Administrator’s Guide Page 2 of 238
Table of Contents
1. Welcome ... 5
What is new? ... 6
How Gallery Server Pro works ... 6
Requirements ... 6
Product key ... 7
Known issues ... 7
2. Installing Gallery Server Pro ... 8
Installation overview ... 8
Upgrading from Gallery Server Pro 2.0 - 2.3... 12
Performing a new installation of Gallery Server Pro, SQLite ... 15
Performing a new installation of Gallery Server Pro, SQL Server ... 21
Uninstalling Gallery Server Pro ... 32
3. Running Gallery Server Pro ... 33
Running Gallery Server Pro for the first time ... 33
Adding your media library to Gallery Server Pro ... 35
4. Working with Albums ... 36
Overview of albums ... 36
Creating an album ... 37
Edit album information ... 39
Delete an album ... 41
Move or copy an album ... 42
Assign album thumbnail object ... 42
Synchronize an album ... 44
Gallery Server Pro 2.3 Administrator’s Guide Page 3 of 238
User Albums ... 53
Hiding Albums ... 57
5. Working with Media Objects ... 60
Overview of media objects ... 60
Adding media objects ... 60
Edit captions ... 75
Download media objects ... 78
Delete objects ... 84
Delete high-resolution version of images... 86
Move or copy media objects and albums... 88
Rearrange objects ... 92
Rotate objects ... 94
Watermarking ... 97
Image metadata ... 100
Searching ... 101
Rendering media objects in the browser ... 103
Microsoft Silverlight ... 111
6. User Management and Security ... 111
Overview... 111
Require everyone to log on ... 113
Users ... 113
Roles ... 119
Self Registration ... 124
7. Site Administration ... 128
Gallery Server Pro 2.3 Administrator’s Guide Page 4 of 238
Site Settings – General ... 129
Site Settings – Email ... 132
Site Settings – Backup and Restore Data ... 135
General – Error Log ... 141
Membership - User Settings ... 142
Membership – Users ... 146
Membership – Roles ... 146
Albums – General ... 146
Media Objects – General ... 149
Media Objects – Media Object Types ... 157
Media Objects – Images ... 158
Media Objects – Video / Audio / Other ... 164
Configuration Settings in galleryserverpro.config ... 167
8. Working with Galleries ... 186
Overview... 186
SQLite users ... 187
SQL Server users ... 187
Creating a read-only gallery ... 189
9. Membership Configuration ... 191
Membership overview ... 191
New membership in current SQL database ... 191
Use existing membership schema in current SQL database ... 192
Use existing membership schema in different SQL database ... 193
Integrate Gallery Server Pro with Active Directory ... 194
Gallery Server Pro 2.3 Administrator’s Guide Page 5 of 238
About the data provider model ... 199
Moving data between SQL Server and SQLite ... 199
Behind the scenes: how the data provider is specified in the config files ... 200
Create a custom data provider ... 204
11. Customizing Gallery Server Pro ... 205
Overview... 205
Styling ... 206
Multi-language support ... 206
Integrate into an ASP.NET web application ... 209
Integrate into non-ASP.NET web sites (iframe Method) ... 219
12. Using Internet Information Services (IIS) Manager ... 222
IIS 6 ... 222
IIS 7 and IIS 7.5 ... 228
13. Configuring NTFS Permissions In Microsoft Windows ... 231
14. Management Tools for SQLite and SQL Server... 236
Overview... 236
SQL Server... 237
SQLite ... 237
15. Glossary ... 237
1. Welcome
Gallery Server Pro is a free, open source web application for sharing photos, video, audio, documents and other files. It’s like having your own personal YouTube or Flickr site. It is intended for users who want to share large collections of media objects on their own web site while maintaining a high degree of control.
Gallery Server Pro 2.3 Administrator’s Guide Page 6 of 238
What is new?
View the Release History page to see full details of each release.
How Gallery Server Pro works
Gallery Server Pro is a web application you install on your web server or your web hosting company's server.
Add your media library by synchronizing your directory containing photos, videos and other media objects with the Gallery Server Pro database. You can also ZIP up your files and upload them. Gallery Server Pro automatically creates a thumbnail image to represent each media object. If you
upload a high resolution image, a bandwidth-friendly, compressed version is created. EXIF, IPTC and other types of metadata are extracted and stored in the database.
Media object files are stored on the local hard drive or a UNC-accessible location such as a NAS device or network share. Metadata about these files, such as width, height, caption, etc. are stored in the database.
When web users browse your albums and media objects, Gallery Server Pro queries the database for the necessary information, and dynamically renders a custom web page. If watermarking is enabled, the watermark is applied to the image before it is sent.
Requirements
Server Requirements:
Microsoft .NET Framework 2.0 or higher
Microsoft AJAX Extensions 1.0 (not required if .NET Framework 3.5 or higher is installed)
Internet Information Services (IIS) 5.0 or higher or a compatible web server such as UltiDev Cassini Web Server
Optional: SQL Server 2000 or higher, including the free Express versions. It does not have to be installed on your server, but it must be available on the network.
Optional: Microsoft .NET Framework 3.0 or higher. If present, Gallery Server Pro extracts additional image metadata not accessible to version 2.0 (primarily titles and keywords).
Optional: SMTP server (required for e-mail functionality).
The use of the SQLite database engine requires the web application to run under Full Trust or that System.Data.SQLite.dll be in the server's Global Assembly Cache (GAC). If these are not possible, SQL Server is supported in reduced trust environments.
Client Requirements:
Gallery Server Pro 2.3 Administrator’s Guide Page 7 of 238
Product key
Gallery Server Pro is fully functional for the first 30 days. At the end of the trial period, a watermark appears on each image and the Site admin area becomes read-only. Enter a product key to restore full functionality. The key is free and easily obtained from the Product Key Wizard at
www.galleryserverpro.com.
Note: The Web Platform Installer version of Gallery Server Pro acts a little different at the end of the trial period. No functionality is restricted. Instead, an annoying picture of Roger Martin appears on every page of the Site admin area, which goes away once you enter a product key.
The purpose of the product key is simple: to encourage you to return to the web site after a trial period to give you an opportunity to provide financial support.
Gallery Server Pro is supported entirely by your donations. Without them, I must look for work elsewhere, and that takes away from the time I can spend on it. You can help make Gallery Server Pro a success and prove that the open source model works by providing a donation when you request the product key.
To get your product key, go to the Product Key Wizard at www.galleryserverpro.com. If you provide a donation, the wizard will temporarily transfer you to PayPal where you can make a secure donation by credit card or through your bank. Whether or not you provide a donation, you will receive a valid product key at the end of the wizard.
BONUS: I periodically offer free thank you gifts to donors. If a promotion is active, it will be offered in the Product Key Wizard.
Known issues
Internet Explorer does not support the rounded corners CSS style, so objects appear with square corners.
(Upgrading from a previous version) The upgrade wizard imports some, but not all, settings in your current web.config and galleryserverpro.config files. If you edited either of these files with a text editor you may find those settings are not imported. In this case they must be manually migrated. All settings that are configurable through the UI are imported.
(SQL Server, after upgrading from 2.0 - 2.2) You may receive the error "EXECUTE permission was denied on the object 'gs_GetVersion'". This can occur when using a SQL login that was created during the original installation. This can be resolved by executing the following in SQL Management Studio: GRANT EXECUTE ON [dbo].[gs_GetVersion] TO [gs_GalleryServerProRole] Restoring data to a SQL Server 2000 database using the built-in restore function is not supported. Restoring data to SQL Server using the Restore function requires SQL permissions equivalent to that
provided in the db_ddladmin or db_owner roles. You may have to manually configure the SQL user using a tool such as SQL Management Studio to provide this permission prior to using the Restore feature.
Gallery Server Pro 2.3 Administrator’s Guide Page 8 of 238 If an upload is aborted because it violates the size limitation set by the administrator, the user
cannot upload another file until the page is refreshed. This is a limitation with the ComponentArt Upload control, which is used in IE and Firefox in Full Trust environments.
IIS 6: IIS will not serve .divx files unless you specify the .divx MIME type in IIS Manager.
2. Installing Gallery Server Pro
Installation overview
There are four versions of Gallery Server Pro available for download: Gallery Server Pro, Web Platform Installer version
Gallery Server Pro web application (pre-compiled, 32-bit) Gallery Server Pro web application (pre-compiled, 64-bit) Gallery Server Pro source code (Visual Studio format)
Note: The only difference between the 32-bit and 64-bit downloads is the SQLite provider located in System.Data.SQLite.dll.
Web Platform Installer Version
The Web Platform Installer version is the easiest way to get up and running. Just click the install button on the download page and a wizard will guide you through the process. Use one of the other versions if:
You want to use SQLite
You are using a hosted environment
You want complete control over every step of the installation You are a developer and want to compile from the source code
Compiled Versions
The pre-compiled versions of Gallery Server Pro use a web-based installer to configure the database and initialize the data. The setup process is largely the same whether you are installing it locally or using a hosting provider. The basic steps are:
1. Extract the files from the ZIP and convert the root directory to a web application in IIS. 2. Use your browser to run the web-based installer and step through the wizard.
3. You’re done!
Step by step instructions are later, but first let's touch on a few topics that may affect your installation: Upgrading previous versions
Gallery Server Pro 2.3 Administrator’s Guide Page 9 of 238 Choosing a data provider
Reduced trust installation
Integrating with an existing web site .NET Framework 3.5
What to do if you get an error
Upgrading previous versions
You can upgrade from previous versions and keep all your captions and other data.
To upgrade from Gallery Server Pro 1.0 - Follow the steps in the section Performing a new installation of Gallery Server Pro, SQL Server. The install wizard will detect the 1.0 data and offer to automatically import the data into the 2.X tables.
To upgrade from Gallery Server Pro 2.0 - 2.3 - Upgrading follows these basic steps (detailed instructions are below):
1. (2.0 users only) Run one or two SQL scripts to update the database structure.
2. Temporarily save your web.config, galleryserverpro.config and galleryserverpro_data.sqlite files. 3. Replace the files in the web application directory with the new ones (but don't delete your media
object files).
4. Run the upgrade wizard.
For detailed, step by step upgrade instructions, go to the section Upgrading from Gallery Server Pro 2.0 - 2.2.
Choosing a data provider
There are two types of data managed by Gallery Server Pro:
Media files - These are your images, videos, audio files, and documents. The default storage location is the gs\mediaobjects directory in the Gallery Server Pro web application, but you can specify any location on the web server's hard drive or any UNC-accessible location.
Gallery data - Information about the media files, such as captions, width, height, and the album to which they belong, are stored in either a SQLite or SQL Server database.
The web-based installer will ask you to choose whether to store data in SQLite or SQL Server. SQLite (www.sqlite.org) is a self-contained, serverless, zero-configuration, transactional, mostly ACID compliant SQL database engine. It is embedded in various Adobe products, Mozilla Firefox, and even in the Apple, Solaris, and Symbian operating systems. The data reside in a file named galleryserverpro_data.sqlite in the App_Data directory of your web application.
Gallery Server Pro 2.3 Administrator’s Guide Page 10 of 238 Microsoft SQL Server (www.microsoft.com/sqlserver/) is an enterprise class client-server database engine. It is in use by many companies and supported by a large number of web hosting providers.
Most users should choose SQLite due to its ease of management, high performance, and potentially lower hosting costs. You may want to use SQL Server if any of the following are true:
You are comfortable with SQL Server.
You are already using SQL Server and want to keep all your data in one place.
You are forced to run Gallery Server Pro in a Medium Trust environment and are not able to install System.Data.SQLite.dll in the Global Assembly Cache (GAC).
You require the gallery to continue working during Synchronize operations. (No other user can write to the database during a synchronization in SQLite, but SQL Server does not have this limitation.)
Your installation of Gallery Server Pro is mission-critical and you don’t want to take any chances with your data. Since SQLite is file-based, there are rare circumstances where the hard drive reports to the database engine that the data is written to disk, when in fact it has not yet completed the operation. If, at this moment, your PC loses power, SQLite will think the data is safely stored, but it is not.
You are already using ASP.NET membership and have your users in SQL Server. For example, you may have DotNetNuke installed and want GSP to use the existing user accounts in your SQL Server
DotNetNuke database.
You have other applications besides the Gallery Server Pro web application interacting with the data file. You may encounter file locking issues and slowed performance as multiple threads wrestle for access to the file. This is a situation where a traditional client-server database such as SQL Server is superior.
Reduced trust installation
Some hosting providers force .NET applications to run at Medium Trust. Gallery Server Pro runs well in this environment, but with a few caveats:
The SQLite data provider requires either Full Trust or that the System.Data.SQLite.dll assembly be installed in the Global Assembly Cache (GAC) on the web server. If you are running Gallery Server Pro in a reduced trust environment (such as GoDaddy), then SQL Server is your only option, unless you can convince the web administrator to install System.Data.SQLite.dll in the GAC. Instructions for installing an assembly into the GAC can be found in the document Assembly Cache Viewer. The directory containing the media object files must reside within the web application.
The real-time feedback provided by the ComponentArt File Upload control requires Full Trust. In reduced trust environments, Gallery Server Pro automatically replaces the ComponentArt control with the standard ASP.NET FileUpload control. It still lets you upload files to the server, but it doesn't give the fancy real-time feedback to inform you of the upload progress.
Gallery Server Pro 2.3 Administrator’s Guide Page 11 of 238
Installing Gallery Server Pro in Medium Trust using SQL Server
If SQLite is not an option because you are running in a reduced trust environment and you cannot install System.Data.SQLite.dll in the GAC, then you can install Gallery Server Pro using the SQL Server database engine. Before you run the installer, you must remove all references to SQLite from the application: 1. Replace the contents of web.config with the contents of web_sqlserver.config. You will find
web_sqlserver.config in the root of the Gallery Server Pro web application. (If you are running on a .NET 3.5 server, then use web_sqlserver_3.5.config.)
2. Delete the file System.Data.SQLite.dll from the bin directory.
3. Open gs\config\galleryserverpro.config in a text editor. Find this section:
<dataProvider defaultProvider="SQLiteGalleryServerProProvider">
Change it to this:
<dataProvider defaultProvider="SqlServerGalleryServerProProvider">
After you make these changes, follow the installation instructions below.
Integrating with an existing web site
The easiest way to install Gallery Server Pro is as a stand-alone web application living in its own directory. But you can integrate it with an existing web site using one of two techniques:
(ASP.NET sites only) Add the Gallery Server Pro user control to a page (.aspx) or user control (.ascx) in your web appliction
Install Gallery Server Pro as a stand-alone application on an ASP.NET-compatible server. Then add an iframe to your existing site that points to this location.
Read more in the section Customizing Gallery Server Pro.
.NET Framework 3.5
You do not need Microsoft AJAX Extensions 1.0 if you have.NET Framework 3.5 or higher installed. However, you do need to replace the web.config file with one that is configured for 3.5.
The download includes two versions of web.config that are pre-configured for .NET 3.5. They are in the same directory as web.config, and are named:
web_3.5.config
web_sqlserver_3.5.config
If you are using .NET 3.5, replace the web.config file in your web application with one of these. Most users, including ALL SQLite users, will use web_3.5.config. If you are running in a reduced trust environment,
Gallery Server Pro 2.3 Administrator’s Guide Page 12 of 238 then you may need to use web_sqlserver_3.5.config instead. (This version has all references to SQLite removed from it.)
What to do if you get an error
As a security measure Gallery Server Pro does not display detailed information if an error occurs. However, you can enable detailed error messages on the Site Settings - General page in the Site admin area. The option is called Display detailed error message when an exception occurs.
If the error is preventing the application from starting, you won't be able to get to the Site admin area. In this case, you can turn on detailed error messages by editing the configuration file
galleryserverpro.config. Open the file - located at \gs\config\galleryserverpro.config - in any text editor and set showErrorDetails="true".
Hopefully the detailed message will help you discover the cause. If you cannot figure it out and want to post a question to the support forum, please copy ALL the text and include it in your post. Remember to search this document and the forum before posting your question.
Once you get a detailed error message, search the Gallery Server Pro forums and/or the internet for more information. If you cannot resolve it on your own, post a message in the forum.
Upgrading from Gallery Server Pro 2.0 - 2.3
Attention Developers: If you wrote custom code that interacts with the column OwnedBy in the gs_Album table, be aware of an important change. This column is cleared of any data during the upgrade. Previous versions of Gallery Server Pro put the username who created the album in this field, but it was never used. This field is now critical to the new album ownership feature and for it to work correctly, this field must be initially blank. This only affects you if you customized Gallery Server Pro to use this field for some purpose.
Attention 2.0 Users
If you are upgrading from 2.0, you must update the database to the 2.1.3162 schema. You can do this by manually executing one or two SQL scripts against your database. Note that you do not need upgrade the web application to 2.1.3162; only the database structure through the SQL scripts described below.
Update the database before running the upgrade wizard. Backup your database before executing the SQL scripts as a safety precaution.
If you are upgrading from…
2.0.2830: Run the following SQL scripts: GS_2.0.2830_to_2.0.2886_upgrade.sql and then GS_2.0.2886_to_2.1.3162_upgrade.sql. They can be found in the installer\sql directory of these downloads: Gallery Server Pro 2.0.2886 and Gallery Server Pro 2.1.3162.
Gallery Server Pro 2.3 Administrator’s Guide Page 13 of 238 2.0.2886, 2.0.2887, or 2.0.2898: Run the SQL script GS_2.0.2886_to_2.1.3162_upgrade.sql. It can be
found in the installer\sql directory of this download: Gallery Server Pro 2.1.3162. Follow these detailed instructions for upgrading to the latest version.
1. Download the ZIP file containing the Gallery Server Pro web application from www.galleryserverpro.com.
2. Make a backup of web.config (in the root directory of the Gallery Server Pro web application) and galleryserverpro.config (in the config directory). The upgrade wizard will ask for these files so it can import your settings.
Attention 2.0 Users: Open web.config in a text editor such as Notepad. Search for all instances of the text GalleryServerDbConnection and replace it with SqlServerDbConnection. You are doing this because the name of the SQL Server connection string changed beginning with 2.1 If you skip this step the Upgrade Wizard will not import your connection string.
3. (SQLite users only) Make a backup of galleryserverpro_data.sqlite (in the App_Data directory).
4. Delete all the web application directories and files in your Gallery Server Pro web directory EXCEPT your mediaobjects directory. If you store your media objects outside this web directory, you can safely delete the mediaobjects directory.
5. Extract the contents of the Gallery Server Pro ZIP file to the web directory.
Note: If you downloaded the source code, you must compile it before copying the files.
6. Use Windows Explorer to give the IIS application pool identity modify permission to the web application directory (ex: C:\inetpub\wwwroot\galleryserverpro\).
Note: If you are not sure how to do this step, read the section Configuring NTFS Permissions In Microsoft Windows.
Note: Technically, Gallery Server Pro requires modify permission only to the following directories: App_Data, config, and mediaobjects. If desired, you can assign modify permission to each of these directories instead of applying them to the parent directory.
Note: This step is not necessary if the directories already contain the required permissions. Note: If you are using a hosting provider, follow the process provided by them for performing the above steps. Again, this step is often not necessary.
7. If .NET 3.5 is installed, replace the web.config file in the root of the web application with either web_3.5.config or web_sqlserver_3.5.config.
Note: For more information about the difference between the two 3.5 versions of web.config, refer to the .NET Framework 3.5 section.
Gallery Server Pro 2.3 Administrator’s Guide Page 14 of 238 8. (SQLite users only) Copy your backup of galleryserverpro_data.sqlite over the file in the App_Data
directory.
9. Use a web browser to navigate to the web upgrade wizard. The URL is in this form:
default.aspx?g=upgrade. For example, if you installed to http://localhost/gallery/, then the upgrade wizard is at http://localhost/gallery/default.aspx?g=upgrade.
10. Follow the instructions to complete the upgrade. The wizard will import common settings from your old web.config and galleryserverpro.config files.
Note: Some settings are not imported from the original files. This is intentional as some values, such as HTML templates in galleryserverpro.config, may have been updated and should not be overwritten. If you have manually edited either of these files, there is the possibility those changes will not be imported by the wizard. In this case, manually update the file.
11. When the upgrade is complete, you will see a confirmation message. Congratulations! Click the link to go to your upgraded Gallery Server Pro site.
12. If you want your gallery to support playing H.264 video and audio files (.mp4 and .m4a) with the
Silverlight plug-in, there is one more step. Open galleryserverpro.config in a text editor like Notepad and make sure the silverlightFileTypes setting includes the .mp4 and .m4a file extensions, like this:
silverlightFileTypes=".mp3,.wma,.wmv,.asf,.asx,.mp4,.m4a". Attention SQL Server users upgrading from 2.0, 2.1, or 2.2
Version 2.3 requires a new table and some other changes to the data schema. Gallery Server Pro checks the version of your database schema during the first page load after running the upgrade wizard. If your schema is out of date, as it will be after upgrading the web application, Gallery Server Pro automatically runs a SQL script to update the data schema.
You may get a SQL error if your SQL logon does not have permission to create or alter database objects. If this happens, temporarily update your connection string in web.config to specify a user with elevated permissions. You can revert to the original connection string once the SQL script has
completed.
Another option is to manually run the SQL upgrade script. You will find it in the source code download, in the TIS.GSP.Data.SqlServer project. The file is named
SqlUpgrade_2_1_3162_to_2_3_3421_SqlServer2005.sql. If you are using SQL Server 2000, use the file named SqlUpgrade_2_1_3162_to_2_3_3421_SqlServer2000.sql
IMPORTANT! When you are finished, it is strongly recommended that you disable the install and upgrade wizards to prevent unauthorized access to your server. To disable, change the value of the ENABLE_SETUP hidden field to FALSE in install.ascx and upgrade.ascx (in the gs\pages directory) or delete the files.
Gallery Server Pro 2.3 Administrator’s Guide Page 15 of 238
Troubleshooting Your Upgrade
If, after upgrading, you cannot log in or your gallery appears empty, it is possible that one or more settings from your old config files were not migrated to the new ones. Open your old and new copies of web.config and galleryserverpro.config and inspect the following sections:
web.config: <connectionStrings>
web.config: <membership>, <roleManager>, and <profile>, especially the defaultProvider and applicationName attributes.
galleryserverpro.config: <dataProvider>
Each of the sections above should be the same between the old and new versions. If you discover that you must manually update something, this is a bug, so please report it.
If using SQLite, verify that you copied your .sqlite data file over the empty one in the App_Data directory.
If you receive a generic error like "I am sorry, but Gallery Server Pro encountered an error", enable detailed reporting as described above.
Performing a new installation of Gallery Server Pro, SQLite
Follow these instructions to install Gallery Server Pro using SQLite as the data store.Set up the web application
1. Download the ZIP file containing the Gallery Server Pro web application from www.galleryserverpro.com.
2. Extract the contents of the zip file to a directory on your web server. For example, C:\inetpub\wwwroot\galleryserverpro\.
3. (.NET 3.5 users only) Replace web.config with the 3.5 version. See the .NET Framework 3.5 section for more information.
4. Use Internet Information Services (IIS) Manager to configure this directory as a web application. (Click Start – Run and then type inetmgr to start IIS Manager.)
5. (IIS 5 and 6 only) Use IIS Manager to make sure the application is running under ASP.NET 2.0 and that the default document is default.aspx.
Note: For more information on using IIS Manager, refer to Using Internet Information Services (IIS) Manager.
6. Use Windows Explorer to give the user account IIS is running under modify permission to the web application directory (ex: C:\inetpub\wwwroot\galleryserverpro\).
Note: If you are not sure how to do this step, read the section Configuring NTFS Permissions In Microsoft Windows.
Gallery Server Pro 2.3 Administrator’s Guide Page 16 of 238 Note: Technically, Gallery Server Pro requires modify permission only to the following directories:
App_Data, config, and mediaobjects. If desired, you can assign this permission to each of these directories instead of applying them to the parent directory.
Note: Depending on your system and where you install the files, this step may not be needed. You can skip this step for now and come back to it if you receive permission-related errors.
Note: If you are using a hosting provider, follow the process provided by them for performing the above steps. This step is not necessary for some hosting companies, so you can try skipping it for now and only come back to it if you receive an error.
Running the web-based installer
1. Start the Install Wizard located at default.aspx?g=install. For example, if you installed to
http://localhost/gallery/, then enter http://localhost/gallery/default.aspx?g=install. The screen should look like this:
Gallery Server Pro 2.3 Administrator’s Guide Page 17 of 238 Note: You may receive the following error:
Configuration Error
Description: An error occurred during the processing of a configuration file
required to service this request. Please review the specific error details below and modify your configuration file appropriately.
Parser Error Message: Could not load file or assembly 'System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. The system cannot find the file specified.
If you get this message, you do not have Microsoft ASP.NET 1.0 AJAX installed. Get it here:
http://www.microsoft.com/downloads/details.aspx?FamilyID=ca9d90fa-e8c9-42e3-aa19-08e2c027f5d 6
Or you can upgrade to .NET Framework 3.5, which includes Ajax functionality. If you do this, read the section .NET Framework 3.5 for more information.
2. Click next. Review the license agreement. If you agree to the terms, select the checkbox and click Next.
3. The following screen appears. Select the SQLite database engine. If you want to use the SQL Server engine, then follow the instructions in the section Performing a new installation of Gallery Server Pro, SQL Server.
Gallery Server Pro 2.3 Administrator’s Guide Page 18 of 238 4. The next step requests the username, password, and email address you would like to use for the
administrator account of your new Gallery Server Pro site. You will use this account to log on to Gallery Server Pro to perform administrative tasks. Fill in the fields and click Next.
Gallery Server Pro 2.3 Administrator’s Guide Page 19 of 238 5. The final step indicates that all required information has been gathered and it is ready to perform the
Gallery Server Pro 2.3 Administrator’s Guide Page 20 of 238 6. If the installation was successful, you will see a confirmation message. This page may also specify
additional steps you must take to complete the installation. Follow the instructions given. For example, in the screen shot below, the galleryserverpro.config file must be manually updated. Be sure to update the file before clicking the link to go to your gallery.
Note: You must manually update web.config and/or galleryserverpro.config when the IIS application pool identity does not have modify permission to the directory containing these files.
Gallery Server Pro 2.3 Administrator’s Guide Page 21 of 238
7. Congratulations! Click the link to go to your new Gallery Server Pro site.
IMPORTANT! When you are finished, it is strongly recommended that you disable the install and upgrade wizards to prevent unauthorized access to your server. To disable, change the value of the ENABLE_SETUP hidden field to FALSE in install.ascx and upgrade.ascx (in the gs\pages directory) or delete the files. All the files in the directory \gs\pages\installer\ may be deleted as well.
Performing a new installation of Gallery Server Pro, SQL Server
Follow these instructions to install Gallery Server Pro using SQL Server as the data store.Note: Users upgrading from Gallery Server Pro 1.0 should also follow these steps. Make sure you choose SQL Server from the Select Data Provider step and select your existing database from the Select Database Instance step.
Set up the web application
1. Download the ZIP file containing the Gallery Server Pro web application from www.galleryserverpro.com.
Gallery Server Pro 2.3 Administrator’s Guide Page 22 of 238 2. Extract the contents of the zip file to a directory on your web server. For example,
C:\inetpub\wwwroot\galleryserverpro\.
3. (.NET 3.5 users only) Replace web.config with the 3.5 version. See the .NET Framework 3.5 section for more information.
4. Use Internet Information Services (IIS) Manager to configure this directory as a web application. (Click Start – Run and then type inetmgr to start IIS Manager.)
5. (IIS 5 and 6 only) Use IIS Manager to make sure the application is running under ASP.NET 2.0 and that the default document is default.aspx.
Note: For more information on using IIS Manager, refer to Using Internet Information Services (IIS) Manager.
6. Use Windows Explorer to give the user account IIS is running under modify permission to the web application directory (ex: C:\inetpub\wwwroot\galleryserverpro\).
Note: If you are not sure how to do this step, read the section Configuring NTFS Permissions In Microsoft Windows.
Note: Technically, Gallery Server Pro requires modify permission only to the following directories: App_Data, config, and mediaobjects. If desired, you can assign this permission to each of these directories instead of applying them to the parent directory.
Note: Depending on your system and where you install the files, this step may not be needed. You can skip this step for now and come back to it if you receive permission-related errors.
Note: If you are using a hosting provider, follow the process provided by them for performing the above steps. This step is not necessary for some hosting companies, so you can try skipping it for now and only come back to it if you receive an error.
7. Use your SQL management tool such as SQL Management Studio to create a new, empty database. Note: You can optionally install Gallery Server Pro into an existing database that contains other
applications. The only requirement is that there must not be any name conflicts. All database objects in Gallery Server Pro are prefixed with “gs_”, so there is a good chance the tables and stored
procedures used by Gallery Server Pro will be unique.
Running the web-based installer
Note: The SQL Server database objects are created with the dbo schema. To specify another schema, add an AppSetting to web.config before running the installer, like this:
<appSettings> ...
<add key="SqlServerSchema" value="your_schema_name" /> </appSettings>
Gallery Server Pro 2.3 Administrator’s Guide Page 23 of 238 The schema must already exist in your database. Membership, Roles, and Profile database objects are always created using the dbo schema, regardless of this setting. (This is because the
Microsoft-supplied scripts that create these objects hard code dbo and I thought it unwise to change them.)
1. Start the Install Wizard located at default.aspx?g=install. For example, if you installed to
http://localhost/gallery/, then enter http://localhost/gallery/default.aspx?g=install. The screen should look like this:
Note: You may receive the following error: Configuration Error
Description: An error occurred during the processing of a configuration file
required to service this request. Please review the specific error details below and modify your configuration file appropriately.
Parser Error Message: Could not load file or assembly 'System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. The system cannot find the file specified.
Gallery Server Pro 2.3 Administrator’s Guide Page 24 of 238 If you get this message, you do not have Microsoft ASP.NET 1.0 AJAX installed. Get it here:
http://www.microsoft.com/downloads/details.aspx?FamilyID=ca9d90fa-e8c9-42e3-aa19-08e2c027f5d 6
Or you can upgrade to .NET Framework 3.5, which includes Ajax functionality. If you do this, read the section .NET Framework 3.5 for more information.
2. Click next. Review the license agreement. If you agree to the terms, select the checkbox and click Next.
3. The following screen appears. Select the SQL Server database engine. If you want to use the SQLite engine, then follow the instructions in the section Performing a new installation of Gallery Server Pro, SQLite.
Gallery Server Pro 2.3 Administrator’s Guide Page 25 of 238 4. On the next screen, specify the desired SQL Server instance and the security credentials the Installer
should use to configure the database. The credentials must have permission to create database objects and, if you request a new login be created (see step 7), must be able to create a new login as well. Note: These credentials are used only by the installer and are discarded once the installation is complete. A later step in the wizard will request the connection setting used for normal operation.
Note: The SQL Server database engine does not have to be installed on the web server. As long as the web server can “see” the database, it doesn’t matter where it is. If you are connecting to a local installation, specify (local), 127.0.0.1, or the name of the server. Include the SQL Server instance name if necessary, such as when using SQL Express or when there is more than one instance of SQL Server. The instance name of a default installation of SQL Express on the local server is .\SQLExpress (replace the period with the server name or IP address if it is on another machine, such as
Gallery Server Pro 2.3 Administrator’s Guide Page 26 of 238 5. When you click Next, the installer will attempt to connect. If it is successful, you will see a drop-down list
Gallery Server Pro 2.3 Administrator’s Guide Page 27 of 238 6. When you select the database, the web installer will check to see if it contains any data from Gallery
Server Pro 1.0. If it finds data, it will give you the option to import the data from version 1.0 into the version 2.3 tables.
7. Specify the account Gallery Server Pro will use to communicate with the database during normal operation. This can be the same account specified earlier, an existing login, or a new SQL login. The credential entered here will be used for the runtime connection string and written into the web.config file in the root of the web application.
Note: If you specify a login that does not exist or is not a member of the database you selected, the wizard will attempt to create it during installation.
Gallery Server Pro 2.3 Administrator’s Guide Page 28 of 238 8. The next screen provides installation options. Leave the option “Script ASP.NET Membership” checked
unless the database already has the ASP.NET Membership installed or you want to configure Gallery Server Pro to communicate with an external Membership data store.
Note: For more information on configuring the membership, see the Membership Configuration section below.
Gallery Server Pro 2.3 Administrator’s Guide Page 29 of 238 9. The next step requests the username, password, and email address you would like to use for the
administrator account of your new Gallery Server Pro site. You will use this account to log on to Gallery Server Pro to perform administrative tasks. Fill in the fields and click Next.
Gallery Server Pro 2.3 Administrator’s Guide Page 30 of 238 10. The final step indicates that all required information has been gathered and it is ready to perform the
Gallery Server Pro 2.3 Administrator’s Guide Page 31 of 238 11. If the installation was successful, you will see a confirmation message. This page may also specify
additional steps you must take to complete the installation. Follow the instructions given. For example, in the screen shot below, the web.config and galleryserverpro.config files must be manually updated. Be sure to update these files before clicking the link to go to your gallery.
Note: You must manually update web.config and/or galleryserverpro.config when the IIS account that the installer is running under does not have “modify” permission to the directory containing these files.
Gallery Server Pro 2.3 Administrator’s Guide Page 32 of 238
12. Congratulations! Click the link to go to your new Gallery Server Pro site.
IMPORTANT! When you are finished, it is strongly recommended that you disable the install and upgrade wizards to prevent unauthorized access to your server. To disable, change the value of the ENABLE_SETUP hidden field to FALSE in install.ascx and upgrade.ascx (in the \gs\pages\ directory) or delete the files. All the files in the directory \gs\pages\installer\ may be deleted as well.
Uninstalling Gallery Server Pro
To uninstall Gallery Server Pro, delete the web application files and the data store. Gallery Server Pro does not use any other location such as the registry or the Program Files directory.
To delete the files and directories in the web application, navigate to the directory using a file utility such as Windows Explorer. Delete the root application directory. For example, if you installed Gallery Server Pro to C:\inetpub\wwwroot\galleryserverpro\, then delete C:\inetpub\wwwroot\galleryserverpro\.
Note: Use caution when deleting the mediaobjects directory, since it may contain media files that you want to keep!
If using SQL Server as the data store, then use Enterprise Manager (SQL 2000) or Management Studio (SQL 2005/2008) to delete the database containing Gallery Server Pro.
Gallery Server Pro 2.3 Administrator’s Guide Page 33 of 238 Note: If you are using the database to store more than just Gallery Server Pro data, then obviously you do not want to delete the entire database. You can delete just the Gallery Server Pro objects. All Gallery Server Pro objects have the prefix “gs_”, so they are easy to identify. There are several tables, stored procedures, and one user-defined function. If you are storing users and roles in the database, and they are not needed for any other application, they can be deleted by deleting the tables and stored procedures that begin with “aspnet_” and views that begin with “vw_aspnet_”.
3. Running Gallery Server Pro
Running Gallery Server Pro for the first time
The first time you run Gallery Server Pro, a screen similar to the one shown below is displayed.
Log in with the administrator account you specified during the installation. An Actions menu appears to the left of the album breadcrumb menu. This menu gives you access to most of the functionality in Gallery Server Pro. Any function the logged on user does not have permission to execute is disabled.
Gallery Server Pro 2.3 Administrator’s Guide Page 34 of 238 The installer adds an album named Samples and one photo. Click the album to see a thumbnail of the photo. Click the thumbnail of the photo to see a larger version, as shown below.
Show image metadata
Download media file
Download objects in ZIP
Get permalink
Start/pause slideshow
Move to another album
Copy to another album Rotate image
Gallery Server Pro 2.3 Administrator’s Guide Page 35 of 238 Notice the toolbar that appears above the photo. Individual buttons are shown or hidden based on the authorization of the current user and whether certain features are enabled. Below is a table that describes the toolbar buttons.
Toolbar button Description
Show image metadata Displays a resizable, movable popup window with metadata, such as EXIF and IPTC, from the image. Does not apply to non-image media objects.
Download media file Download the media file to the user’s computer.
Toggle hi-res image Shows or hides the original, high resolution version of an image, if it exists. This button is hidden when no high resolution image exists or the user does not have permission to view it.
Get permalink Displays a hyperlink that can be used to link directly to the current media object. This is useful because the Next/Previous buttons use AJAX callbacks to load the media object, which does not update the URL in the browser’s address bar. Start/pause slideshow Starts or pauses a slide show of images in the current album. Slide shows only
display images; any video, audio, or documents in the album are skipped. Move to another album Transfers the current media object to another album. The user is redirected to
another page where the destination album can be selected. Not shown if the user does not have permission to move media objects.
Copy to another album Copies the current media object to another album. The user is redirected to another page where the destination album can be selected. Not shown if the user does not have permission to copy media objects.
Rotate image Redirects the user to another page where the image can be rotated. Applies only to images. Not shown if the user does not have permission to edit media objects. Delete media object Deletes the current media object, including the thumbnail, compressed version
(for images), and original media file.
Adding your media library to Gallery Server Pro
This section helps you add your existing media library to Gallery Server Pro. See the section Working with Media Objects for additional options and more detailed information.
Let’s say you have thousands of photos and video clips on your hard drive at C:\MyPicsAndVideo\. Follow these steps to add them to Gallery Server Pro.
Gallery Server Pro 2.3 Administrator’s Guide Page 36 of 238 1. Copy your media files from C:\MyPicsAndVideo\ to the mediaobjects directory in the Gallery Server
Pro web application. For example, if you installed Gallery Server Pro at C:\inetpub\wwwroot\galleryserverpro\, then copy the files to C:\inetpub\wwwroot\galleryserverpro\mediaobjects\.
Note: By default, Gallery Server Pro uses the mediaobjects directory to store and manage the media files, but you can specify any UNC-accessible location. Refer to the section Media Objects - General for more information.
2. Configure Gallery Server Pro to accept the types of media files in your collection. For example, your collection may consist of JPG, GIF, WMV, and AVI files. Use your browser to log on as an administrator, then click Site admin on the Actions menu. In the menu that appears, click Media Object Types. A list with more than 100 file types appears. By default, only JPG and JPEG files are enabled. Select those file types that exist in your collection and click Save changes.
3. Select Synchronize from the Actions menu. The Synchronize page appears. Select the option Include child directories (recursive). Click Synchronize. A popup window appears showing the progress of the synchronization as Gallery Server Pro analyzes each of your files. Click Close when finished.
4. You are done! Browse your media collection by clicking the root album from the album breadcrumb menu (default name is All albums).
4. Working with Albums
Overview of albums
Gallery Server Pro stores media objects in albums, and each album holds zero or more media objects and/or child albums. This is similar to how Windows stores directories and files. In fact, Gallery Server Pro stores albums as directories in the file system, and media objects are stored as files (which makes sense, since they are files.)
Gallery Server Pro starts with one album that serves as a container for all other albums. This top-level album is called the root album and by default is named All albums. This album can never be deleted. Media objects and albums are added to the root album. In turn, each child album can store additional media objects and/or child albums.
There is no limit to the number of media objects and albums one can store, except the limit presented by hard drive space limitations and the operating system for maximum file path length. That is, since some versions of Windows have a maximum file path length of 260 characters, the full path to the album
(directory) must be less than this limit.
You must be logged on to perform any action in Gallery Server Pro that modifies albums or media objects. Once logged on, the Actions menu (shown below) is displayed.
Gallery Server Pro 2.3 Administrator’s Guide Page 37 of 238 Note: If the Actions menu does not appear when you are logged on, that means you do not have
permission for any of its menu items. In this case, Gallery Server Pro does not render the menu. Only those menu items that are valid for the current album, and for which the current user has permission, are enabled. For example, if the logged on user does not have Add album permission, the Create album menu item will be disabled.
Creating an album
An album is a container that holds one or more media objects and/or child albums. Upon installation Gallery Server Pro has one album named All albums.
Gallery Server Pro 2.3 Administrator’s Guide Page 38 of 238 Step 1: Type the desired name of the album in the Album name field. The album name is limited to 200 characters. To make the album private, check the box labeled Private album. Learn more about private albums in the Hiding Albums section.
Step 2: Specify the album to contain the new album. The existing albums are displayed in a tree view. A check box appears next to all albums for which the current user has Add album permission. By default, the album you were viewing when you chose Create album from the Actions menu, is selected.
Note: Only those albums the user has permission to add an album to are shown.
After clicking Create album, the album is created and a screen showing its contents is displayed, as below. It is, of course, empty.
Gallery Server Pro 2.3 Administrator’s Guide Page 39 of 238
Edit album information
To edit the information for the albums, select Edit album info from the Actions menu or double click the rectangular area in which the Album’s name, summary and begin and end dates appear, as shown below.
Note: If nothing happens when you double click in the album area, then you are not logged on or you do not have Edit album permission.
The Edit album box appears as shown below.
Gallery Server Pro 2.3 Administrator’s Guide Page 40 of 238 Fill in the text boxes as desired. Note character maximums for the text boxes and the necessary format for the date fields. All fields are optional. To learn more about private albums see the section Hiding albums. Click Save to return to the album view with the newly entered information displayed.
Note: Learn more about album ownership in the Album Ownership section.
The begin and end date is not used by Gallery Server Pro and is intended only convey to the viewer the dates associated with the contents of the album. When not specified, the date label is hidden. It will re-appear if a date is entered.
* Behind the Scenes * Album information is saved to the web server through an AJAX callback.
How album titles correspond to the directory names on the hard disk
Recall that each album in Gallery Server Pro has a matching directory in the media objects folder. When an album’s title is changed, Gallery Server Pro modifies the name of the directory for that album to match the title. In the example above, the album title is Photos and the corresponding directory in the media objects folder is also named Photos. If the title is changed to My Favorite Photos, Gallery Server Pro will modify the directory name to My Favorite Photos.
This is all well and good, but we have a problem. Most (all?) Windows operating systems cannot handle a directory path longer than 255 characters. Since a title in Gallery Server Pro can be up to 200 characters, one could reach this limitation pretty easily. To help prevent this, Gallery Server Pro only uses the first twenty-five characters of the title for the directory name. As a result, you will notice an album with the title “This is a long title for an album” has a directory with the name “This is a long title for ”.
Gallery Server Pro 2.3 Administrator’s Guide Page 41 of 238 Note: When a gallery is configured as read-only, Gallery Server Pro never changes the files or directory names.
You might want to change this behavior. For example, you may have all your photos in a directory structure with lots of long names, and you don’t want Gallery Server Pro truncating them when you edit the album’s title. There are two configuration settings in galleryserverpro.config available to modify this
behavior:
defaultAlbumDirectoryNameLength – Gallery Server Pro will truncate directory names longer than this value. The default value is 25, but it can be any value from 1 to 255.
synchAlbumTitleAndDirectoryName – Indicates whether to update the directory name corresponding to an album when the album's title is changed. The default value is true. Setting it to false tells Gallery Server Pro to never alter the directory name. The only exception to this is when Gallery Server Pro has to slightly tweak the name of a directory to prevent a naming conflict. For example, this may happen if you move or copy an album into a directory containing another album with the same name. When this setting is false, the configuration setting defaultAlbumDirectoryNameLength has no effect. This setting can be changed on the Media Objects - General page in the Site admin area.
Delete an album
To delete an album, first navigate to album to be deleted. Choose Delete this album from the Actions menu. The following confirmation page appears.
If you are sure you want to delete the album, click Delete album. The album, all child albums, and all media objects in the album(s) are permanently deleted. There is no undo function, so use caution!
Gallery Server Pro 2.3 Administrator’s Guide Page 42 of 238 Note: For media objects, both the records in the data store and the media files on the hard drive are
permanently deleted.
Note: The current user must have Delete child album permission for the parent album of the album being deleted. If the album contains media objects, they are also deleted, even if the user does not have Delete media object permission.
Performance tip: ASP.NET automatically restarts the web application when a directory within the application hierarchy is deleted. This causes a noticeable delay when deleting albums and may cause errors for other users who are synchronizing, uploading files, or performing other tasks. This,
unfortunately, is a "feature" of ASP.NET 2.0 that occurs when a directory is deleted within the web application. The easiest solution is to put the media objects directory the web application (for example, D:\my_media_objects). Read the section Media Objects – General for more information about changing the media objects directory. Another solution is to create a directory junction.
Move or copy an album
Albums are copied in the same way that media objects are copied. See Move or copy media objects and albums for instructions.
Assign album thumbnail object
Each album has an album thumbnail image. This image is shown whenever an icon representing an album is displayed on a web page. In the screen shot below, there are two albums and two images. The images shown for the two albums are the thumbnail images for that album.
Gallery Server Pro 2.3 Administrator’s Guide Page 43 of 238 By default, the first media object added to an album is used as the thumbnail image for the album. However, you can choose any media object in the album. To designate an album’s thumbnail image, choose Assign
thumbnail from the Actions menu. The media objects are then displayed—each with a radio button underneath, as below.
Gallery Server Pro 2.3 Administrator’s Guide Page 44 of 238 Select the image you would like to use as the thumbnail image for the album. When you click Assign thumbnail, the image you selected is now set to be displayed whenever an icon view of the album is shown.
NOTE: You must select an image from the current album.
If the image currently set as the thumbnail image for an album is moved or deleted, Gallery Server Pro automatically selects the next media object in the album as the thumbnail image. If no image is available (because the album is empty), a default image is used. The format and text displayed on the default image can be specified on the Albums – General page in the Site administration console.
Synchronize an album
Gallery Server Pro maintains two related sets of data – the media files stored in directories on the web server’s hard drive and metadata about those files and albums in the database. If the two sets of data ever
Gallery Server Pro 2.3 Administrator’s Guide Page 45 of 238 get out of synch, you can synchronize the database with the media files on the hard drive to restore data integrity.
When should you synchronize? You might want to synchronize when:
You just installed Gallery Server Pro and you want to load the database with your entire media library.
You just extracted a bunch of photos or videos from your digital camera and you want to quickly add them to Gallery Server Pro. You could ZIP them up and use the Add objects menu command, but some people find it easier to copy the media files to the web server and then synchronize. You have a read-only gallery and want to add or remove media objects and albums.
You prefer using FTP to transfer files to the web server. FTP is generally more reliable when dealing with large files.
You added, moved, copied, or deleted images using Windows Explorer instead of the Gallery Server Pro interface, causing the database to become out of synch with the media files on the web server's hard drive.
You used a third party program like PhotoShop to alter one or more images, and you want Gallery Server Pro to recreate the thumbnail and compressed images.
In simple terms, the synchronization procedure updates the Gallery Server database with information about the media files on the web server’s hard drive and makes sure the media files have valid thumbnail and compressed versions. Remember that the files themselves are not stored in the database; only metadata about them (size, width, height, etc…)
Synchronizing also ensures the album has a valid album thumbnail image. See the section about setting the album thumbnail image to learn more about what this is.
You can synchronize an album, an album and all child albums, or the entire gallery.
To synchronize an album, navigate to the album you want to synchronize. Then click the Synchronize command from the Actions menu. The following screen appears.
Gallery Server Pro 2.3 Administrator’s Guide Page 46 of 238 There are four options you can check. They are:
Include child directories (recursive) – When checked, any albums within this album are also synchronized. Recently added directories are added to the gallery as new albums. If the current album does not contain any child albums, this setting has no effect.
Overwrite existing thumbnail images – When checked, new thumbnail images are created when you
synchronize the database, even if it means overwriting existing thumbnails. The thumbnails are created from the original media object. If unchecked, a new thumbnail is created only if it doesn't exist. Synchronizing the database will run faster if you leave this option unchecked.
Overwrite existing compressed images – When checked, new compressed images are created when you synchronize the database, even if it means overwriting existing compressed images. The compressed images are created from the original image. If unchecked, a new compressed image is created only if doesn't exist. This setting applies only to images in the gallery. Synchronizing the database will run faster if you leave this option unchecked.
NOTE: Compressed versions of images will exist only for images whose file size is larger than the Compression limit or whose length is larger than the Compressed image length. More information about these settings can be found in the Media Objects – Images section.
Gallery Server Pro 2.3 Administrator’s Guide Page 47 of 238 Re-import metadata for existing images – When checked, metadata that was extracted from images when they were first added to Gallery Server Pro are replaced with the current metadata in the original image file. Metadata includes items such as camera model, shutter speed, title, and keywords. Gallery Server Pro supports the following formats: EXIF, XMP, tEXt, IFD, and IPTC. For example, this is useful if you used a program like Vista Photo Gallery to add keywords to the image files and you want Gallery Server Pro to retrieve this information to aid in searching. This setting has no effect on non-image media objects. More information about image metadata is in the Image metadata section.
Note: Metadata that may exist in the original image files are not replicated to the thumbnail and compressed versions. If you delete the original versions of photos using the Delete high-res images command, that means there is no metadata to extract during subsequent synchronizations. The consequence of this is that checking this option after you have deleted the original images will cause you to lose the metadata that was extracted from the original files. Therefore, it is recommended to leave this option unchecked when you synchronize an album whose original, high resolution photos have been deleted.
When you have selected the desired options, click Synchronize. A popup window like that shown below provides real-time status of the task.
Gallery Server Pro 2.3 Administrator’s Guide Page 48 of 238 A message will indicate when the task is complete, and a Close button will appear on the popup window. Click Close to close the popup window.
NOTE: You can click Cancel to stop a synchronization, but be aware this can cause the database to become out of synch with the media files on the hard drive. If you discover issues after cancelling, start another synchronization and allow it to finish.
Some additional points to remember about synchronizing:
Note: The properties mentioned below in bold can be found on the Media Objects – General page in the Site administration console (i.e. Original file storage location, Thumbnail image storage location, and Compressed image storage location)
Gallery Server Pro will ignore any file whose type is not enabled on the Media Object Types page in the Site administration console. It also ignores hidden files, even if they are an enabled file type.
Gallery Server Pro 2.3 Administrator’s Guide Page 49 of 238
Gallery Server Pro NEVER modifies or deletes the original media files during synchronizing. (Rotating is the only function in Gallery Server Pro that modifies the original media file, and that applies only to images.)
Gallery Server Pro searches for media files only in the directory corresponding to the specified album. If the Include child directories option is enabled, then all files below the specified directory will also be synchronized. Gallery Server Pro never searches for or adds media files from outside the Original file storage location.
Thumbnail images are stored in the Thumbnail image storage location. By default, all thumbnail images begin with the prefix zThumb_. If desired, this can be changed on the Media Objects - General page in the Site admin area.
Compressed images are stored in the Compressed image storage location. By default, all compressed images begin with the prefix zOpt_. If desired, this can be changed on the Media Objects - General page in the Site admin area.
If the thumbnail or compressed images are ever deleted, they can be recreated by performing a synchronization.
Depending on your web server, Gallery Server Pro typically synchronizes from one to one hundred images per second. Keep in mind that if you have thousands of images, it may take a long time. Gallery Server Pro does its best to preserve captions and other information you enter about a media
object. For example, if you use Windows Explorer to move a media file from one directory to another, and then synchronize the database, Gallery Server Pro will re-link the file with the existing database record, thus preserving the information. (This is done by creating a hash code of the file based on its name and creation date and searching for a matching hash code.) However, Gallery Server Pro does not preserve album information (e.g. the summary and begin/end dates) if you move a directory to another directory outside of the Gallery Server Pro user interface. In general, you should use the Gallery Server Pro web interface when you add, move, copy, and delete media objects and albums.
You can modify any Gallery Server Pro media object in a third party program like PhotoShop without losing the caption or other data you entered, as long as you don’t change the file name or the file’s created date/time stamp.
* Behind the Scenes * During a synchronization, database records are inserted, updated and deleted, and compressed and thumbnail versions of media objects are created and/or overwritten on the hard drive. Specifically, synchronizing performs these steps:
1.
A table named gs_Synchronize exists in the database to manage the synchronization process. When a synchronization is started, this table is updated so that other users cannot begin a second synchronization until the first one is complete.2.
Starting with the first file Gallery Server Pro finds in the directory representing the specified album, Gallery Server Pro checks its file type to determine if it should be managed by Gallery Server Pro. If it is, it tries to find the corresponding record in its database, based on a hash of the file name and the date/time stamp of when the file was created.Gallery Server Pro 2.3 Administrator’s Guide Page 50 of 238
3.
If a record is found, it is updated with current information about the file, such as its size and the album to which it belongs.4.
If a record isn’t found, a new media object is created.5.
Gallery Server Pro checks to make sure a thumbnail image exists to represent this media object. If the media object is an image, it verifies a compressed image exists. If not, one is created. If the option Overwrite existing thumbnail image or Overwrite existing compressed image is checked, then new versions are always created, even if it means overwriting an existing compressed or thumbnail image.6.
Gallery Server Pro continues processing each file it finds. If the Include child directories option is checked, then all the album’s subdirectories are recursively processed.7.
If any album or media object records in the data store weren’t updated during thissynchronization, then they must not have corresponding media files on the hard disk, and the records are deleted from the data store.
Album Ownership
An album owner can add, edit, and delete objects within the album. Think of it as being an administrator of an album.
The permissions an owner has propagate to all child albums and cannot be revoked at a lower level. For example, if an owner can create child albums, he or she can create child albums on those child albums, and so on. This is consistent with the overall security pattern in Gallery Server Pro that permissions always propagate downward.
Only administrators (that is, users in a role with Allow Administer Site permission) can assign a user as the owner of an album. Owners cannot re-assign ownership to another user (unless the owner is an administrator, of course).
Assign the owner of an album on the Edit album info dialog window. The window appears when you select Edit album info from the Actions menu or double click the album title and summary area. The dialog appears as seen here: