2.3.3456 Administrator's Guide - Gallery Server Pro

bawltherapistSoftware and s/w Development

Dec 13, 2013 (3 years and 10 months ago)

650 views


Administrator’s Guide

Version 2.
3
.
3456

Released
June

18
, 2009













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 Ga
llery 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

Album Ownership

................................
................................
................................
................................
............

50

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

Overview

................................
................................
................................
................................
........................

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

................................
................................
................................
..........................

14
2

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

10. Data Provider

................................
................................
................................
................................
...................

199

Gallery Server Pro
2.3

Administrator’s Guide

Page
5

of
238


About the data provider model

................................
................................
................................
.....................

199

Moving data betwee
n SQL Server and SQLite

................................
................................
...............................

199

Behind the scenes: how the data provider is specified in the config files

................................
....................

200

Create a custom data provide
r

................................
................................
................................
......................

204

11. Customizing Gallery Server Pro

................................
................................
................................
.......................

205

Overview

................................
................................
................................
................................
........................

205

Styling

................................
................................
................................
................................
............................

206

Multi
-
language support

................................
................................
................................
................................
.

206

Integrate into an ASP.NET web application

................................
................................
................................
...

209

Int
egrate 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. M
anagement Tools for SQLite and SQL Server

................................
................................
...............................

236

Overview

................................
................................
................................
................................
........................

236

SQL Server

................................
................................
................................
................................
......................

237

SQLite

................................
................................
................................
................................
.............................

237

15. Glossary

................................
................................
................................
................................
...........................

237


1.
W
elcome

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
w
orks



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 s
ynchronizing 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. I
f 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 s
uch 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, a
nd 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 Fram
ework 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 Exp
ress versions. It does not have to be
installed on your server, but it must be available on the network.



Optional: Mic
rosoft .NET Framework 3.0 or higher
. If present, Gallery Server Pro extracts additional
image metadata not accessible to version 2.0 (prim
arily 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:



Any
modern

web browser

(IE 5+, Netscape 6+, Firefox, Opera, Safari
, Chrome
)

Gallery Server Pro
2.3

Administrator’s Guide

Page
7

of
238


Product k
ey

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
.

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 wor
ks 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 y
ou 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
i
ssues



Internet Explorer does not support the rounded corners CSS style, so objects appe
ar 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 setti
ngs are not imported. In this case they must be manually migrated.
A
ll settings that are configurable through the UI are imported.



(
SQL Server,
a
fter
u
pgrading from
2
.0
-

2.2
)

You may receive the error "
EXECUTE permission was
denied on the object 'gs_GetVersion'
"
.

T
h
i
s
can occur when using a SQL login that was
c
reated
dur
ing the original installation.

This can be reso
lved 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 Serv
er 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 pr
ovide this permission

prior to using the Restore
feature.



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.

Gallery Server Pro
2.3

Administrator’s Guide

Page
8

of
2
38




IIS 7: If the .divx MIME type has been previously configured in IIS, the web site will not render
correctly. Either remove the MIME type using IIS Manager or delete the following
section in
web.config:

<staticContent><mimeMap fileExtension=".divx" mimeType="video/divx"
/></staticContent>



IIS 6: IIS will not serve .divx files unless you specify the .divx MIME type in IIS Manager.

2.
Installing Gallery Server Pro

Installation
o
vervie
w

There are
three

versions of Gallery Server Pro available for download:



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)

Most users wi
ll want the

32
-
bit or 64
-
bit

pre
-
compiled web application.
Download
the source code
version if you are interested in viewing or modifying the code. The source code version must be compiled
prior to deployment.
It is packaged as a Visual Studio solution and

can be opened in either Visual Studio
2005 or Visual Studio 2008, including the freely available
Visual Web Developer 2008 Express SP1
,
downloadable from Microsoft. If you are using VS 2005, use the solu
tion file named
TIS.GSP (Visual Studio
2005).sln
.

Note: The only difference between the 32
-
bit and 64
-
bit
downloads

is the

SQLite provider

located in
S
ystem.Data.SQLite.dll
.

Gallery Server Pro uses a web
-
based installer to configure the database and initia
lize 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 few topics that may affect your installation:



Upgrading previous versions



Choosing a data provider



Reduced trust installation



Integrating with an existing web site

Gallery Server Pro
2.3

Administrator’s Guide

Page
9

of
238




.NET Framework 3
.5



What to do if you get an error

Upgrading p
revious

v
ersions

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.
2

-

Upgradin
g 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_d
ata.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
\
mediaobj
ects 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
wh
ich 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.

Microsoft SQL Server

(
www.microsoft.com/sqlserver/
) is an enterprise class client
-
server database
engine. It is in use by many companies and support
ed 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:

Gallery Server Pro
2.3

Administrator’s Guide

Page
10

of
238




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 requ
ire 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 y
ou 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 thi
s 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 acco
unts 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
t
he file. This is
a situation
where a traditional client
-
server database such as SQL Server is superior.

Reduced t
rust
i
nstallation

Some hosting providers force .NET applications to run at Medium Trust.
Gallery Server Pro runs well in
this
environment, albe
it 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.

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 us
ing the SQL Server database
engine.

Before you run the installer, you must remove all references to SQLite from the application:

Gallery Server Pro
2.3

Administrator’s Guide

Page
11

of
238


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 replac
e 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

Replace t
he 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, then you may need to use
web_sqlserver_3.5.config instead. (This version has a
ll
references to

SQLite removed from it.)

Gallery Server Pro
2.3

Administrator’s Guide

Page
12

of
238


What
t
o
d
o
i
f
y
ou
g
et an
e
rror

As a security measure Gallery Server Pro does not display detailed information if an error occurs.
However, you can enabled 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 m
essages 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 c
annot 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 Galle
ry 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 t
he column Owne
dBy 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 critic
al 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 a
r
e upgrading from 2.0
, you m
ust 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
descr
ibed below.

U
pdate 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 th
en
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
.

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 i
nstructions for upgrading to the latest version
.

Gallery Server Pro
2.3

Administrator’s Guide

Page
13

of
238


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 director
y). 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 S
erver 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 A
pp_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 directo
ry.

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 Serv
er 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 nece
ssary 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 th
e 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 F
ramework 3.5 section
.


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
.

Gallery Server Pro
2.3

Administrator’s Guide

Page
14

of
238


10.

Follow the instructions to complete the upgrade. The wizard will impor
t 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 sh
ould 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.

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 o
f 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
t
o 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, tempo
ra
rily update your connection string in web.config to specify a user with
elevated permissions.
Y
ou 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.SqlS
erver 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_SqlServer200
0
.sql


IMPORTANT
!

When yo
u 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
\
pa
ges directory) or
delete the files.

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>

Gallery Server Pro
2.3

Administrator’s Guide

Page
15

of
238


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
n
ew
i
nstallation of Gallery Server Pro, SQLite

Follow these instructions
to install

Gallery Server Pro using
SQL
ite
as the
data store.

Set up the web application

1.

Download the ZIP file
containing

the Gallery Server Pro we
b 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 w
ith 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
U
sing Internet Information Services (IIS)
Manager
.

6.

Use Windows Explorer to give the user accou
nt 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 st
ep, read the section
Configuring NTFS Permissions In
Microsoft Windows
.

Note: Technically, Gall
ery Server Pro requires
modify

permission only to the following directories:
App_Data, config, and mediaobjects. If desire
d, 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 com
e back to it if you receive an error.

Gallery Server Pro
2.3

Administrator’s Guide

Page
16

of
238


Running the web
-
based installer

1.

Start t
he 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
17

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 scree
n 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
installation. Click Next.

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,
i
n 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 inst
all 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
n
ew

i
nstallation

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 shoul
d 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 wit
h 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 s
tart 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
Usi
ng 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 i
f 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 requir
ement is that there must not be any name conflicts. All database o
bjects
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

1.

St
art
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 shoul
d
look like this:

Gallery Server Pro
2.3

Administrator’s Guide

Page
23

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.

Gallery Server Pro
2.3

Administrator’s Guide

Page
24

of
238



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 cre
ate 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 installati
on 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
MYSERVER
\
SQLExpress or 192.168.10.100
\
SQLExpress).


Gallery Server Pro
2.3

Administrator’s Guide

Page
26

of
238



5.

When you click Next, the installer will attempt to conne
ct. If it is successful, you will see a drop
-
down list
with your database as one of the options. Select your database and click Next.

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 ins
talled 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, passw
ord, 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 i
ndicates that all required information has been gathered and it is ready to perform the
installation. Click Next.

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 comple
te 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 mu
st 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 instal
l.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 me
dia 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,
s
tored 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 tha
t begin with “vw_aspnet_”.

3.
Running Gallery Server Pro

Running Gallery Server Pro
for
the f
irst
t
ime

The first time you run Gallery Server Pro, a screen similar to the one show
n

below

is

displayed
.


Log in with the administrator account you specified du
ring 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
3
4

of
238


The ins
taller 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

Downlo
ad media file

Download objects in ZIP

Get permalink

Start/pause slideshow

Move to another album

Copy to another album

Rotate image

Delete media object

Gallery Server Pro
2.3

Administrator’s Guide

Page
35

of
238


Notice the toolbar that appears above the photo. Individual bu
ttons are shown or hidden based on the
authorization of the current user and whether certain featu
res are enabled.

Below is a table that describes
the toolbar buttons.

Toolbar button

Description

Show image metadata

Displays a resizable, movable popup wind
ow 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.

呯gg汥⁨l
-
牥猠sm慧e

卨o睳wo爠桩T敳⁴U攠o物r楮慬Ⱐ桩HU⁲ 獯汵瑩on v敲獩on o映慮⁩ 慧攬
楦⁩琠數楳瑳⸠WU楳i
bu瑴on⁩猠U楤T敮e睨敮o U楧U⁲ 獯汵瑩on⁩m慧攠數楳is

o爠瑨攠畳敲eTo敳eno琠Uave
p敲e楳獩on⁴o v楥眠楴
.

䝥G⁰敲m慬ank

M楳i污祳⁡ UXp敲汩e欠瑨慴⁣an⁢攠u獥搠so楮k⁤楲散elX⁴o⁴U攠捵cr敮琠m敤e愠ob橥捴⸠
周楳⁩猠畳敦T氠l散慵獥⁴U攠N數琯P牥
viou猠扵瑴on猠畳s 䅊䅘⁣慬ab慣歳⁴o 慤⁴U攠
media object, which does not update the URL in the browser’s address bar.

却慲琯p慵獥⁳汩 敳eow

却慲瑳So爠灡r獥s⁡ 獬sTe⁳桯眠of⁩ 慧敳e楮 瑨攠Wu牲敮琠慬aum⸠卬楤攠獨o睳won汹
T楳i污礠業慧敳e⁡湹 v楤eoⰠ慵T楯ⰠH
r⁤ 捵m敮瑳W楮⁴Ue⁡汢um⁡ 攠獫楰p敤e

Move⁴o⁡湯瑨敲⁡汢um

呲慮獦敲猠瑨攠Wu牲敮琠m敤e愠ab橥捴cWo⁡ o瑨敲⁡汢um⸠周攠
u獥s⁩猠牥摩r散e敤⁴o
慮o瑨敲⁰慧攠睨敲攠瑨攠摥獴楮s瑩Wn⁡汢um⁣慮⁢攠s敬e捴cT⸠.o琠獨o睮⁩映瑨攠
u獥爠To敳eno琠Uav攠p敲m楳s楯n⁴o move敤
楡iob橥jW献

䍯pX 瑯⁡湯瑨敲e慬aum

䍯p楥猠瑨攠Wu牲敮琠m敤e愠ob橥j琠Wo⁡ o瑨敲⁡汢um⸠周攠u獥爠楳⁲ T楲i捴cT 瑯
慮o瑨敲⁰慧攠睨敲攠瑨攠摥獴楮s瑩Wn⁡汢um⁣慮⁢攠s敬e捴cT⸠.o琠獨o睮⁩映瑨攠
u獥爠To敳eno琠Uav攠p敲m楳s楯n⁴o⁣opX m敤e愠abj散e献

副瑡瑥⁩m慧e

剥R
楲散i猠sUe⁵獥爠瑯 慮o瑨敲ep慧攠睨敲w⁴U攠im慧e⁣慮⁢攠牯瑡W敤e⁁ p汩e猠snlX
瑯⁩m慧敳e⁎ W⁳桯睮⁩映wU攠u獥爠To敳 W⁨慶攠p敲mi獳楯n⁴o 敤e琠m敤e愠ob橥j瑳W

M敬e瑥 m敤eabj散e

M敬e瑥猠瑨攠Wu牲敮琠m敤e愠ob橥jWⰠ楮捬uT楮g⁴U攠瑨Wmbn慩aⰠHomp牥獳敤⁶敲獩on

⡦(爠rm慧敳⤬)慮T o物r楮慬am敤e愠晩a攮

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 addition
al 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
mediaobje
cts

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 Pr
o uses the
mediaobjects

directory to store and manage the media
files, but y
ou can
specify

any
UNC
-
accessible
location. Refer to the section
Media Objects

-

General

for
more information.

2.

Configure Gallery Server Pro to a
ccept 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 Ob
ject 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 co
llection by

clicking the root album from the album breadcrumb
menu (default name is
All albums
).

4
. W
orking
with

Albums

Overview of a
lbums

Gallery Server Pro stores
media objects

in albums, and each album holds zero or more media objects
and/or child album
s. 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 o
ne 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 o
n to perform any action in Gallery Server Pro that modifies albums or
media
objects
. Once
logged
o
n, 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 tho
se 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 a
lbum

An
a
lbum

i
s a container that holds one or more
media
objects and/or child albums.
Upon installation
Gallery Server Pro has one album named
All albums
.

To create a new album select
Create album

from the

Actions

menu
.
The following page appears.

Gallery Server Pro
2.3

Administrator’s Guide

Page
38

of
238



Step 1
: Type the des
ired
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
:

S
pecify

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

a
lbum
i
nformation

To
edit the information for the albums
,
select
Edit
album

info

from the

Actions

menu or

d
ouble click the
rectangular

area in which the Album’s name, summary and begin and end dates appear
, as shown below
.


Note: If nothing happens wh
en 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.

Double click to edit

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
p
rivate album
s see the section
Hiding albums
.

Click
Save
to return to the album view with the newly entered information displayed.

Note: Learn more about albu
m 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
d
a
te 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 S
erver 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 opera
ting 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 lon
g tit
le for
”.

Gallery Server Pro
2.3

Administrator’s Guide

Page
41

of
238


Note: When a gallery is configured as read
-
only, Gallery Se
rver 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 2
5
, but it ca
n 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 alt
er 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 wit
h 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 a
lbum

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 per
manently 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
p
arent 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 mor
e information
about changing the media objects directory. Another solution is to create a
directory junction
.

Move or c
opy

an
a
lbum

Albums are
copied

in the same way that media objec
ts are copied
. See
Move or copy media objects and
albums

for instructions.

Assign
a
lbum
t
humbnail
o
bject

Each album has an album thumbnail image. This image is shown whenever an icon representing an
album is displayed on a we
b page. In the screen shot below, there are two albums and
two

image
s
. 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. Howe
ver,
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.

Album thumbnail images

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 a
lbum

Gallery Server Pro maintains two related sets of data


the media files stored in di
rectories 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 shoul
d 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
a
dd them to Gallery Server Pro.

Y
ou 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 a
nd 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 d
atabase 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 t
he
files

themselves are no
t 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 synchro
nize 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.

Note: The current user must

have
Synchrn
o
ize

permission for the album being synchronized.

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.