Untitled
Segue is a web-based tool which should be run from a computer that is always on and has a static ip-address. You could run it otherwise, but then it would not be accessable to users when the machine is off or when the ip-address changes.
For production use, Windows 2000 or XP (or even better, Linux, BSD, OS X, or another unix-like operating system) is preferred for stability, but Apache and MySQL should run on Windows 95/98 as well. The system requirements are minimal and Segue/Apache/MySQL runs just fine on anything that Windows will run on. If you want to run on even more minimal equipment, Segue/Apache/MySQL should run just fine under Linux on a 33Mz 386 with 64MB of RAM.
Option 1: Set Up Your Server Via Apache2 Triad installer:
If you already have Apache with PHP and MySQL set up, skip parts 1 and 2 of this step.
-
Download Apache2 Triad
Download Apache2 Triad from SourceForge.net
.
-
Run the Installer
The installer will ask to restart the computer. After restarting Apache and MySQL should be running. Point your browser to http://localhost -
Set Up MySQL
Point your browser to http://localhost/phpmyadmin/ -
Create a database for Segue
Click “Home” in the top-left of PHPMyAdmin.
Enter a database name, i.e. “segue”; then hit “Create”. -
Add a “segue” user
Go to Home –> Privileges –> Add a New User
Enter a username and password, i.e. “segue”, “secret”. Set host to “localhost”, as this will prevent anyone from using this account from remotely accessing the database. Then hit “Go”. -
Give the “segue” user access to the “segue” database.
If you have just created the “segue” user, you should already be at the correct screen if not, got to Privileges –> Edit (next to the “segue” user).
Go down to the “Database-specific privileges” section and select the “segue” database from the drop-down menu.
Check all of the Data and Structure boxes then hit “Go”.
to test Apache. If you don’t get errors, Apache is running. Apache2 Triad puts several admin tools in your Start menu by default.
to use PHPMyAdmin to set up a MySQL account and database for Segue.
Opition 2: Install and configure Apache, Php and MySQL
Follow the instructions on the following webpages
PHP: http://www.devside.net/web/server/windows/php-bin (Make
sure to make necessary changes to the apache config file)
MySQL: http://www.devside.net/web/server/windows/mysql-bin
Apache: http://www.devside.net/web/server/windows/apache (You
do not have to build the Apache web server, a msi installation download is
available on the apache website. The installation file installs the start,
restart and stop shortcuts on the start menu. Make sure to follow the
configuration directions). The apache website has some excellent configuration
instructions as well: http://httpd.apache.org/docs/windows.html
Make sure to install apache, php and mysql in <drive>:\www\ folder.
Segue should be installed in c:\www\apache2\htdocs\ folder
Set Up Segue
- Download Segue
Download the latest version of Segue from
SourceForge.net. - Unzip Segue
Unzip the segue-1.x.x.zip file into your webserver’s
root directory. By default this is
C:\apache2\htdocs if you
use option 1 or c:\www\apache2\htdocs if you use option
2 to set up your web server
This will create a directory called segue-1.x.x
in C:\apache2\htdocs or
c:\www\apache2\htdocs. Rename this directory to “segue”. - Create a userfiles directory
Create a directory for the Segue
userfiles. This directory is outside of the segue directory to allow you to
update the Segue code without loosing the userfiles. you should now have a
“segue” and a “segue_userfiles” directories in C:\apache2\htdocs
or c:\www\apache2\htdocs. - Configure Segue
Rename the file
C:apache2htdocsconfig_sample.inc.php to “config.inc.php”.
Open
config.inc.php in a text editor (such as Notepad) and edit the various values to
fit your system.
Below are examples of the parts that you must change:
Untitled
* full_uri – Segue’s full URL path (ie, https://segue.middlebury.edu/view/html/site/segue)
* Don’t put a slash “/” at the end of the url!
******************************************************************************/
$cfg[full_uri] = $_full_uri = “http://140.233.12.105/segue”;
Contact your network administrator to set up a DNS hostname and static IP address for your server to give you a url such as https://segue.middlebury.edu/view/html/site/segue/
/******************************************************************************
* uploaddir – the local folder where userfiles are kept
* uploadurl – the URL equivalent of the above folder
******************************************************************************/
$cfg[uploaddir] = $uploaddir = “/apache2/htdocs/segue_userfiles”;
$cfg[uploadurl] = $uploadurl = “http://140.233.12.105/segue_userfiles”;
Note the lack of “C:”
/******************************************************************************
* DB AUTHENTICATION – REQUIRED
*
* dbhost the hostname of the sql server (ie, sql.middlebury.edu)
* dbuser the user to connect as (ie, segue)
* dbpass the above user’s passwd. may be blank
* dbdb the name of the database to use (ie, segue)
******************************************************************************/
$cfg[dbhost] = $dbhost = “localhost”;
$cfg[dbuser] = $dbuser = “segue”;
$cfg[dbpass] = $dbpass = “secret”;
$cfg[dbdb] = $dbdb = “segue”;
Start Segue
Point your browser to http://localhost/segue/ or http://xxx.xxx.xxx.xxx/segue/ (where the xxx’s are your IP address) to use Segue.
The first time that you go to Segue, you should see messages saying that Segue created the necessary tables in your database.
Log in with user/pass admin/changeme to start using Segue.
Enjoy!