|
Manual Installation
|
Top Previous Next |
|
Recommend Installation Directory Structure
| |
|
.. /
|
Your Home Directory
|
|
/data
|
Application data directory (keep out side of web root)
|
|
/phplib
|
Hyperseek PHP Libraries (keep out side of web root)
|
|
/htdocs
|
Your Web root Directory
|
|
/search
|
.php applications, image and include directories
|
|
/admin
|
Admin Center application
|
|
Typical Installation Directory Structure
| |
|
.. /
|
Your Home Directory
|
|
/htdocs
|
Your Web root Directory
|
|
/search
|
.php applications, image and include directories
|
|
/data
|
Application data directory
|
|
/dsX
|
Hyperseek PHP Libraries
|
|
/admin
|
Admin Center application
|
| Telnet Users
|
|
|
| · | Login to your server, change to your "document root" directory.
|
| · | Create a new subdirectory for the installation (ie: mkdir search)
|
| · | You can use any directory name you like... (we use "search" in all of the examples)
|
| · | Change into this directory (ie: cd search)
|
| · | Using your FTP Program, upload the .zip or .tar.gz file (whichever you have) containing the distribution files to the newly created directory, using binary transfer
|
| · | From the telnet prompt, extract the files.
|
| · | If it's a .zip file: unzip
|
| · | If it's a .tar.gz file: tar zxvf
|
| · | This will extract all of the necessary files, and create the directories you need for you.
|
| · | The "Getting files on your server" portion of the installation is complete. To ensure that you did it right, you should be able to go to http://www.yoursite.com/search/ in a browser and see either an index of files, or a "Forbidden" error in your browser. Either of these would indicate that everything is in the right spot, and you're ready to move on.
|
|
|
| FTP Users
|
|
|
| · | You want to start off by extracting the .zip file or .tar.gz file onto your local computer using a program such as WinZip.
|
| · | Be sure to tell the extractor program to preserve the directory structure!
|
| · | Open your FTP Client, and connect to your web server.
|
| · | Change to your "document root" directory.
|
| · | Create a new sub directory (ie: search) using your FTP Client and change into it.
|
| · | You can use any directory name you like... (we use "search" in all of the examples)
|
| · | Browse your local computer, using your FTP client to the directory where you extracted the files in the first step.
|
| · | Select every file and directory. Set your FTP program to ASCII mode, and transfer all of the files and directories to your web server. This should create a bunch of directories (and subdirectories) below the one you created, along with the main program files. The only files that should be transferred in "binary" mode are the files in the "images" directory
|
| · | The "Getting files on your server" portion of the installation is complete. To ensure that you did it right, you should be able to go to http://www.yoursite.com/search/ in a browser and see either an index of files, or a "Forbidden" error in your browser. Either of these would indicate that everything is in the right spot, and you're ready to move on.
|
| Telnet Users
|
|
|
| · | You should still be in your /search (or whatever you called it) directory. Issue this command
|
| · | chmod -R 755 *
|
| · | Now, change the permissions on your "data" directory full read-write by issuing this command
|
| · | chmod -R 777 data
|
| · | Note that if you did the installation according to the "Recommended" directory structure, where the data directory is outside of your document root, you will need to change to the data directory prior to issuing the above command.
|
| · | Note the capital "R" in these commands. Once run, these commands make your data globally accessible, and everything else setup to execute only.
|
| · | This step is now complete, you can move on to the File Edit Stage
|
|
|
| FTP Users
|
|
|
| · | Very Important: Read your FTP Client's instructions for information on how to use it to modify permissions on the web server using it's functions...you'll be using that process a lot over the next few steps...
|
| · | You will need to, manually, set the permissions of every file, directory, files within directories, etc to 755. ...Do this for every directory EXCEPT for the "data" directory
|
| · | Using the same method you did for the above step, change the permissions of the data directory, and every file, subdirectory, etc beneath it to 777
|
| · | Note that if you did the installation according to the "Recommended" directory structure, where the data directory is outside of your document root, you will need to change to the data directory prior to issuing the above command.
|
| · | This step is now complete, you can move on to the File Edit Stage
|
| The Telnet/FTP Portion is complete, all users follow the instructions below:
|
| In the directory where you have installed your "PHP Applications", there is a file called "settings.php". You will need to edit this file, and make a few changes. The file will look like this, by default:
|
| global $settings;
|
| global $include_dir;
|
|
|
| // Edit these 2 variables, to indicate the proper paths for
|
| // your installation.
|
| // The location of your 'data' directory
|
|
|
| $settings[data_dir] = "/home/sites/htdocs/search/data";
|
|
|
| // The directory where you have placed your "dsX" directory
|
| $include_dir = "/home/sites/htdocs/search";
|
|
|
| /*
|
| ------------------------------------------------------------
|
| DO NOT EDIT BELOW THIS POINT
|
| ------------------------------------------------------------
|
| */
|
|
|
| ini_set( "include_path",
|
| ini_get("include_path") . ":" . $include_dir
|
| );
|
| You need to change the 2 settings in there, to point to the proper directories. The "$include_dir" should point to the directory on your server where you installed the JJS Software & Consulting PHP Libraries. This could be inside of your script installation directory (default), or outside of your web tree in your home directory, depending on where you decided to put it. Do not include "dsX" in the value you enter for this setting. The program is looking for the full path to the directory that contains the dsX directory, not the path to the dsX directory itself.
|
|
|
| The "$settings[data_dir]" setting should be set to the full system path to your data directory (including the directory name "data" itself), which could be outside of your web tree in your home directory.
|
|
|
|
|