Gallery v2.0

From Support Center

This is a step-by-step walk-through for installing Gallery 2.0 software. This guide assumes a basic understanding of how Globat Command Console's File Manager and Web Protect work. Tutorials for File Manager and Web Protect are available in the GCC tutorial. This tutorial also requires the manual creation of a Database, but it is explained in detail in that step.

Table of contents

1 Downloading Gallery 2 Decompressing the Package 3 Beginning the Installation 4 Following the Installation Steps

Downloading Gallery

If you are not yet familiar with the Gallery software, please visit http://gallery.menalto.com/

You will find information on both the 1.x and 2.x Gallery software. The guide you are reading is for installing the 2.x software. If you are interested in installing the Gallery 1.x software, please visit our Gallery 1 tutorial.

You have two options for downloading the Gallery software:

1. Download the software your computer with FTP, and then upload it to the httpdocs folder of your web space.
2. Use Upload from URL within GCC's File Manager -- this method is much faster, and is described below.

To upload with File Manager:

1. Log in to the GCC (https://login.globat.com/)
2. Click the Site Content Button. Then, click the "File Manager" link.
3. You will see a listing of the folders and files on your web site. Click the link for httpdocs.
4. You will see a button called Upload. Click it.
5. You will see radio buttons at the top of the screen, one for "From URL." Click that link, and then press the Upload button to the immediate left of the radio buttons. You should now see blank listings for http://

To get the exact download URL from SourceForge, you need to click the tar.gz link on this page: http://codex.gallery2.org/index.php/Gallery2:Download#Packages

We recommend that you use the Typical package.

Then, you'll need to select a mirror site. We selected the one from Arizona (AZ). Click the Download link. You'll get a message to Save the file, which is fine if you're going to FTP it to your site. (Some versions of Internet Explorer will give you a yellow security warning--ignore this warning.) We're going to click "Cancel" when asked to Save the file, and then copy and paste the exact download URL from the web page. You'll find the exact URL under the words:

"Your download should begin shortly.  If it does not, try:"

In our example, the file was named: http://easynews.dl.sourceforge.net/sourceforge/gallery/gallery-2.0-rc-1-typical.tar.gz

Paste the full download URL into the first http:// box in the Upload URL screen.

Click "Confirm" to upload.

Return to File Manager to verify that the tar.gz file is now in your web space in folder httpdocs. You may need to select "Items per page: 20" at the very bottom of the File Manager screen to see the file in the list.

Decompressing the Package

Once your tar.gz file is on the site (whether you FTP'ed it or Uploaded from URL), you'll need to create a .php file to decompress the file, and use CHMOD to change the .php file's permissions so that you are able to run the .php script from your web browser.

Within the httpdocs folder in File Manager, click "New File." Call it decompress.php. Enter the following text in the file:

<?php
exec("tar xzf gallery-2.0-rc-1-typical.tar.gz");
?>

You'll need to type the exact file name of your tar.gz file. It may vary depending on which version and revision you download. We copied and pasted our tar.gz filename from File Manager.

Click "Save" and then click "Go Back."

Next, you'll need to change the permissions of the file to 755 with CHMOD. Click the checkbox next to decompress.php in File Manager, and press the CHMOD button. Select User: R W X, Group R X, Other R X. (If you'd like a primer on CHMOD, click here and look for the section labeled CHMOD). Click "Confirm" once you have verified the permissions match as instructed.

Now, you'll need to run the PHP script from your web browser by visiting:

http://www.example.com/decompress.php

...replacing example.com with your Globat domain name.

It may take up to three or four minutes to decompress: be patient. You will see a blank screen once the script has finished executing.

Beginning the Installation

Within File Manager, look for a new folder within httpdocs containing the Gallery software. Ours was called gallery2. If you do not see this folder, please repeat the download and decompress steps above.

Once you have successfully decompressed the directory, enter the address to the folder in your web browser:

http://www.example.com/gallery2/

...replacing example.com with your Globat domain name.

Following the Installation Steps

You should see an 11 step install guide. Select your language, and click the "Begin Installation" link.

You will now see an Authenticate challenge. This requires you to create a text file called login.txt in your gallery2 folder with the random string on the page.

1. Within File Manager, create a New File called login.txt in httpdocs/gallery2.
2. Copy and paste the string from the Gallery 2 Installer page.
3. Click "Save" and "Go Back."
4. Return to your Installation web browser window, and click "Authenticate Me."

If you created the login.txt successfully, you should see a green colored message "Authentication successful!" If you do not see this message, double check the string you pasted into login.txt to verify that it is correct.

Next, click "Continue to Step 2." The Gallery software will run system checks on the server, which could take a few minutes. Please be patient while the checks are performed. One checks are finished, click "Continue to Step 3."

Note: You may be instructed that you should edit .htaccess. This is not the case on our servers, so please ignore that message.

On the next page, select "Standard installation" and click "Continue to Step 4."

Within Step 4, you are asked to create a folder for storage.

The installation guide suggests that you place the folder "outside" your web area, but Globat servers do not support this. Instead, you will need to create a folder and use Web Protect to prevent access to it.

Follow these steps:

1. Within File Manager, create a New Folder in httpdocs/gallery2 called g2data.
2. Then, click the "Web Protect" link within GCC.
   
3. Click "Add Directory." Enter g2data as the Directory, and Restricted as the Header Text.
4. Click "Add."
5. Add a user with a random, hard to guess password by clicking "Add User." This will prevent anyone from getting into your gallery storage unless they know both your username and password.
   
   Click "Create" after entering the user's data.

Next, you'll need to return to File Manager, locate the g2data folder (it's within httpdocs/gallery2), click the checkbox next to g2data and then click CHMOD and set the permissions to 700. User: R W X Group: NONE Other: NONE.

Once you have created the folder and used Web Protect to protect it, return to the Gallery Installation window and click "Save." You should see a message reading "Storage directory set successfully."

Click "Continue to Step 5."

In Step 5, you will be asked to configure a MySQL database. You will need to do this from within the GCC. While in the GCC, click the Databases button. Then click "Add Database."

Gallery suggests the name for the database to be gallery2. We recommend you prefix your database name with your domain name, or another creative name (someone else may have already created a gallery2 database on our servers). For our example domain globat-example.com, we called our database globat-examplegallery2.

Next, add a user and password by clicking "Add User." Again, we recommend you prefix the username with your domain name. We're going to call ours globat-examplegu (for gallery user). Pick a unique password.

Then click "Create."

Now you'll need to return to the Gallery Installation window and enter your database name, username, and password for the database you created.

Then, click "Save." You should get a message stating "Database set up successfully." Click "Continue to Step 6."

Step 6 is the Admin User setup. You can pick a username and password on this page, as well as set your e-mail address as administrator.

Please pick a unique password because the admin account will have full access to your gallery. Once you have modified all the fields, press "Create." You should see a message "Admin user info entered successfully." Click "Continue to Step 7."

Step 7 creates a config file. Click "Continue to Step 8." Step 8 may take a few minutes, so please be patient!

When Step 8 completes, you should see the message "Installed Gallery Core successfully." Click "Continue to Step 9."

Step 9 will give you module configuration options. If you are familiar with Gallery, you can select and unselect as you please.

If you are new to Gallery, we recommend that you uncheck "Archive Upload" and "FFmpeg" (you can install them later with a click). Then scroll down to the bottom of the page and click "Activate Selected Modules."

If some modules need extra configuration, they will be noted in orange. YOu may wish to write down the names of modules that need extra configuration. Then, click "Continue to Step 10."

Step 10 checks security. If you get the message "We've verified that your config.php is secure." you can click "Continue to Step 11."

If all is well, You will see the message "Finished!" Click "Go to my Gallery!" to start using Gallery 2!