Archived

This topic is now archived and is closed to further replies.

Vger

Quick Install Guide

2,388 posts in this topic

I'm posting this here so that people who need to can find a quick Installation Guide for osCommerce. It goes a bit further than the Installation Guide in the Knowledge Base.

 

---------------------------------------------------------------------

 

Here's the quick install guide.

 

1. Create a blank database via your web hosting control panel.

 

2. Download the osCommerce 2.2 MS2 zip file from the downloads section of www.oscommerce.com, unzip it and extract the 'catalog' folder.

 

3. If you want your shop to be available at http://www.yourdomain.com/catalog then upload the whole of the catalog folder to the root directory of your website via FTP. If you want the site to be available at http://www.yourdomain.com then just upload all of the contents of the catalog folder, but not the folder itself.

 

4. Make sure that the permissions on all of the folders are set to 755, and if that does not work then set them to 777. Make sure that the includes/configure.php file and the admin/includes/configure.php file are set to 777 for the duration of the install. Once the install is complete reset to 644, 444, or 400 depending on your server setup.

 

5. Then go to http://www.yourdomain.com/install and begin the install procedure. Your DB Server will probably be 'localhost', your db user name and password (for mysql access) will have been provided to you by your web hosting company. The name of the database you already know - because you just set it up. Do not enable SSL, elect to store sessions in the database and not files (untick the box), and do not enable persistent connections.

 

6. After the install create a folder called 'backups' inside the 'admin' folder (via FTP), and delete the install folder. Reset permissions on the two configure.php files.

 

7. Password Protect your 'admin' folder using the Password Protect feature in your web hosting control panel.

 

Away you go!

 

Vger

9 people like this

Share this post


Link to post
Share on other sites

I don't suppose you could add a 'quick install EPDQ module' could you?

1 person likes this

Share this post


Link to post
Share on other sites
I don't suppose you could add a 'quick install EPDQ module' could you?

 

See what you've started Vger :lol:

Share this post


Link to post
Share on other sites

Hi Vger,

 

please be gentle with me, this is my first post!!

 

Thanks for the more in depth insight into installing oscommerce.

 

I am wanting to initially develop my shop on my PC before I upload it.

 

I am having difficulty setting up the database also.

 

I have used the search function in the forum, but without exact string match clauses, there are thousands of hits, which are extremely confusing and relate to stuff that I am lightyears away from.

 

I am using the Xmapp suite, and can see the database creation within phpmyadmin. How do I find out how many fields I need to creat, their types / attributes. Is it a flat or relational database?

 

Has someone got a blank database that I could use?

 

I really do seem to be spending many hours going round in circles and never getting anywhere. Any help would be greatly appreciated.

 

Thanks

 

Glyn :'(

 

 

 

 

 

 

I'm posting this here so that people who need to can find a quick Installation Guide for osCommerce.  It goes a bit further than the Installation Guide in the Knowledge Base.

 

---------------------------------------------------------------------

 

Here's the quick install guide.

 

1. Create a blank database via your web hosting control panel.

 

2. Download the osCommerce 2.2 MS2 zip file from the downloads section of www.oscommerce.com, unzip it and extract the 'catalog' folder.

 

3. If you want your shop to be available at http://www.yourdomain.com/catalog then upload the whole of the catalog folder to the root directory of your website via FTP. If you want the site to be available at http://www.yourdomain.com then just upload all of the contents of the catalog folder, but not the folder itself.

 

4. Make sure that the permissions on all of the folders are set to 755, and if that does not work then set them to 777. Make sure that the includes/configure.php file and the admin/includes/configure.php file are set to 777 for the duration of the install. Once the install is complete reset to 644, 444, or 400 depending on your server setup.

 

5. Then go to http://www.yourdomain.com/install and begin the install procedure. Your DB Server will probably be 'localhost', your db user name and password (for mysql access) will have been provided to you by your web hosting company. The name of the database you already know - because you just set it up. Do not enable SSL, elect to store sessions in the database and not files (untick the box), and do not enable persistent connections.

 

6. After the install create a folder called 'backups' inside the 'admin' folder (via FTP), and delete the install folder. Reset permissions on the two configure.php files.

 

7. Password Protect your 'admin' folder using the Password Protect feature in your web hosting control panel.

 

Away you go!

 

Vger

Share this post


Link to post
Share on other sites

I'm doing a new installation over server and got this error:

 

The following error has occurred:

 

 

The configuration files do not exist, or permission levels are not set.

 

Please perform the following actions:

cd /hsphere/local/home/orenji/domain.com/catalog/includes/

touch configure.php

chmod 706 configure.php

cd /hsphere/local/home/orenji/domain.com/catalog/admin/includes/

touch configure.php

chmod 706 configure.php

 

both files are set to 777 but installation still can't go thru, and anyone kindly explain what is 706? thanks.

Share this post


Link to post
Share on other sites
<snip>

6. After the install create a folder called 'backups' inside the 'admin' folder (via FTP), and delete the install folder. Reset permissions on the two configure.php files.

<snip>

Vger

 

I am only finding one config*.php file to modify. Am I overlooking one?

 

thanks

Buck

Share this post


Link to post
Share on other sites

includes/configure.php

admin/includes/configure.php

 

Vger

Share this post


Link to post
Share on other sites
includes/configure.php

admin/includes/configure.php

 

Vger

 

Mine doesn't reference the Admin in any form from includes/configure.php. The admin/includes/configure.php requires a change in address name.

 

 

Buck

Share this post


Link to post
Share on other sites
Mine doesn't reference the Admin in any form from includes/configure.php.

 

Correct. There's one for admin and one for the shop front.

 

Vger

Share this post


Link to post
Share on other sites

this can get long and funky :lol:

 

but Im sure it will help some :thumbsup:

 

very nice of you Vger

Share this post


Link to post
Share on other sites

Hi Vyger,

 

Do you have any ideas on how to install a local machine for testing, please?

 

Cheers!

 

Mike W

 

I'm posting this here so that people who need to can find a quick Installation Guide for osCommerce.  It goes a bit further than the Installation Guide in the Knowledge Base.

 

---------------------------------------------------------------------

 

Here's the quick install guide.

 

1. Create a blank database via your web hosting control panel.

 

2. Download the osCommerce 2.2 MS2 zip file from the downloads section of www.oscommerce.com, unzip it and extract the 'catalog' folder.

 

3. If you want your shop to be available at http://www.yourdomain.com/catalog then upload the whole of the catalog folder to the root directory of your website via FTP. If you want the site to be available at http://www.yourdomain.com then just upload all of the contents of the catalog folder, but not the folder itself.

 

4. Make sure that the permissions on all of the folders are set to 755, and if that does not work then set them to 777. Make sure that the includes/configure.php file and the admin/includes/configure.php file are set to 777 for the duration of the install. Once the install is complete reset to 644, 444, or 400 depending on your server setup.

 

5. Then go to http://www.yourdomain.com/install and begin the install procedure. Your DB Server will probably be 'localhost', your db user name and password (for mysql access) will have been provided to you by your web hosting company. The name of the database you already know - because you just set it up. Do not enable SSL, elect to store sessions in the database and not files (untick the box), and do not enable persistent connections.

 

 

 

6. After the install create a folder called 'backups' inside the 'admin' folder (via FTP), and delete the install folder. Reset permissions on the two configure.php files.

 

7. Password Protect your 'admin' folder using the Password Protect feature in your web hosting control panel.

 

Away you go!

 

Vger

Share this post


Link to post
Share on other sites

Go to http://www.apachefriends.org/en and download XAMPP to your computer. It's a 1-click install, and includes all you need, Apache server, PHP 4 and 5, Open SSL, Mail Server, FileZilla etc.

 

Once you've done the XAMPP installation then you can use the Quick Install Guide to get your local testing site up and running.

 

Be aware that XAMPP uses php5 by default, but comes bundled with php4 also. Go to http://localhost and into your XAMPP control panel. Then click on the XAMPP icon to shut down Apache, click on the switch-php.bat link and enter 4 when the terminal window pops up. Then restart Apache using php4.

 

Vger

Share this post


Link to post
Share on other sites

Hi Vyger,

 

Now using XAMPP as suggested - got a little further this time.

 

Now able to get installed on a local machine - still getting errors, however.

 

See below:

 

 

Warning: session_start(): open(/tmp\sess_a107a1e1f4976478288304e93e4f51a7, O_RDWR) failed: No such file or directory (2) in D:\XAMPP\xampp\htdocs\catalog\includes\functions\sessions.php on line 67

Warning Warning: The sessions directory does not exist: /tmp. Sessions will not work until this directory is created.

 

Yep - OK - where exactly should this tmp directory be created?

 

Other errors:

 

Warning: session_write_close(): open(/tmp\sess_a107a1e1f4976478288304e93e4f51a7, O_RDWR) failed: No such file or directory (2) in D:\XAMPP\xampp\htdocs\catalog\includes\functions\sessions.php on line 106

 

Warning: session_write_close(): Failed to write session data (files). Please verify that the current setting of session.save_path is correct (/tmp) in D:\XAMPP\xampp\htdocs\catalog\includes\functions\sessions.php on line 106

 

Any advice gratefully recieved.

 

Many thanks!

 

 

Mike W

Share this post


Link to post
Share on other sites

The latest errors are caused by the first error - so fix that and the others will disappear. To fix the first error just edit the last line of both configure.php files to read 'mysql' where indicated - this stores session data in the database and so no need for a'tmp' folder and the error goes away.

 

Vger

Share this post


Link to post
Share on other sites
The latest errors are caused by the first error - so fix that and the others will disappear.  To fix the first error just edit the last line of both configure.php files to read 'mysql' where indicated - this stores session data in the database and so no need for a'tmp' folder and the error goes away.

 

Vger

 

 

Im trying the quick install but i cant locate my folder named 'catalog'. Could somebody please help me locate it. Sorry in advance I am new to this.

Share this post


Link to post
Share on other sites

The name 'catalog' is used because the default osCommerce files/folders come inside a folder called 'catalog'. It used to be the case that most people installed osCommerce not in the root of their web but in a folder, so their address would be http://www.yourdomain.com/catalog

 

If however you install in the root of your website (http://www.yourdomain.com) then there would be no 'catalog' folder.

 

Vger

Share this post


Link to post
Share on other sites
The name 'catalog' is used because the default osCommerce files/folders come inside a folder called 'catalog'. It used to be the case that most people installed osCommerce not in the root of their web but in a folder, so their address would be http://www.yourdomain.com/catalog

 

If however you install in the root of your website (http://www.yourdomain.com) then there would be no 'catalog' folder.

 

Vger

I installed this fine on my local machine with Xampp. I went to install it on our hosts machine and have a blank page on my admin screen. Storefront seems to function, but not the admin, any ideas?

Jim

Share this post


Link to post
Share on other sites
Host says 4.3 I will check

Jim

The host indicates this is the problem " That is becuase you have not set the database information in html/admin/includes/configure.php" Isn't this an automatic setup?

Jim

Share this post


Link to post
Share on other sites

Sometimes when you do the osCommerce install it only writes to the includes/configure.php file and misses out on writing to the admin/includes/configure.php file. This is most likely to happen on a Windows server for some unknown reason.

 

Vger

Share this post


Link to post
Share on other sites

Hello. I seem to be getting the same problem. The catalog seems to be working, but when I try to open index.php from the admin folder I get a blank page. No error messages. I have php5. I translated the code from php4 to php5 (I substituted the $HTTP_*_VARS with $_GET, $_POST, etc), I let the register_globals disabled in the ini file (the default option in php5) to avoid security problems, and I modified the condition that chacks that. Probably I've done smth wrong in the /admin/includes/configure.php file. I've seen that it's a bit different from /catalog/includes/configure.php.

This is the content of the file... if you see anything that might be wrong I'd greatly appreciate it if you could point me to the solution...

 

define('HTTP_SERVER', 'http://my_IP'); // eg, http://localhost or - https://localhost should not be NULL for productive servers

define('HTTP_CATALOG_SERVER', 'http://my_IP');

define('HTTPS_CATALOG_SERVER', '');

define('ENABLE_SSL_CATALOG', false); // secure webserver for catalog module

define('DIR_FS_DOCUMENT_ROOT', $DOCUMENT_ROOT); // where your pages are located on the server. if $DOCUMENT_ROOT doesnt suit you, replace with your local path. (eg, /usr/local/apache/htdocs)

define('DIR_WS_ADMIN', '/admin/');

define('DIR_FS_ADMIN', DIR_FS_DOCUMENT_ROOT . DIR_WS_ADMIN);

define('DIR_WS_CATALOG', '/catalog/');

define('DIR_FS_CATALOG', DIR_FS_DOCUMENT_ROOT . DIR_WS_CATALOG);

define('DIR_WS_IMAGES', 'images/');

define('DIR_WS_ICONS', DIR_WS_IMAGES . 'icons/');

define('DIR_WS_CATALOG_IMAGES', DIR_WS_CATALOG . 'images/');

define('DIR_WS_INCLUDES', 'includes/');

define('DIR_WS_BOXES', DIR_WS_INCLUDES . 'boxes/');

define('DIR_WS_FUNCTIONS', DIR_WS_INCLUDES . 'functions/');

define('DIR_WS_CLASSES', DIR_WS_INCLUDES . 'classes/');

define('DIR_WS_MODULES', DIR_WS_INCLUDES . 'modules/');

define('DIR_WS_LANGUAGES', DIR_WS_INCLUDES . 'languages/');

define('DIR_WS_CATALOG_LANGUAGES', DIR_WS_CATALOG . 'includes/languages/');

define('DIR_FS_CATALOG_LANGUAGES', DIR_FS_CATALOG . 'includes/languages/');

define('DIR_FS_CATALOG_IMAGES', DIR_FS_CATALOG . 'images/');

define('DIR_FS_CATALOG_MODULES', DIR_FS_CATALOG . 'includes/modules/');

define('DIR_FS_BACKUP', DIR_FS_ADMIN . 'backups/');

 

// define our database connection

define('DB_SERVER', 'localhost');

define('DB_SERVER_USERNAME', 'osCommerce_user');

define('DB_SERVER_PASSWORD', 'osCommerce_pass');

define('DB_DATABASE', 'osCommerce');

define('USE_PCONNECT', 'false');

define('STORE_SESSIONS', 'mysql');

----------------------------

I've substituted my IP real IP, user and pass. but in the configuration file I wrote the good ones.

I have php5, apache 1.3.33, mysql 4.1, and they are all running on an xp + sp2 machine.

If you know the problem and you have the solution, please let me know. Thanks in advance.

Share this post


Link to post
Share on other sites

If you have left Register Globals to 'off' in php.ini then you will have to install the Register Globals Patch Files (link below my name). It's either that or turning Register Globals to 'on' in php.ini.

 

Vger

Share this post


Link to post
Share on other sites
If you have left Register Globals to 'off' in php.ini then you will have to install the Register Globals Patch Files (link below my name). It's either that or turning Register Globals to 'on' in php.ini.

 

Vger

 

I am having the same problem. I changed php.ini which fixed the catalog but the admin page still comes up blank. Help

 

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Contents of OsCommerce\catalog\includes

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

 

<?php

/*

osCommerce, Open Source E-Commerce Solutions

http://www.oscommerce.com

 

Copyright © 2003 osCommerce

 

Released under the GNU General Public License

*/

 

// Define the webserver and path parameters

// * DIR_FS_* = Filesystem directories (local/physical)

// * DIR_WS_* = Webserver directories (virtual/URL)

define('HTTP_SERVER', 'http://ww304-146-39.aut.ac.nz'); // eg, http://localhost - should not be empty for productive servers

define('HTTPS_SERVER', 'https://ww304-146-39.aut.ac.nz'); // eg, https://localhost - should not be empty for productive servers

define('ENABLE_SSL', true); // secure webserver for checkout procedure?

define('HTTP_COOKIE_DOMAIN', 'ww304-146-39.aut.ac.nz');

define('HTTPS_COOKIE_DOMAIN', 'ww304-146-39.aut.ac.nz');

define('HTTP_COOKIE_PATH', '/private/OsCommerce/catalog/');

define('HTTPS_COOKIE_PATH', '/private/OsCommerce/catalog/');

define('DIR_WS_HTTP_CATALOG', '/private/OsCommerce/catalog/');

define('DIR_WS_HTTPS_CATALOG', '/private/OsCommerce/catalog/');

define('DIR_WS_IMAGES', 'images/');

define('DIR_WS_ICONS', DIR_WS_IMAGES . 'icons/');

define('DIR_WS_INCLUDES', 'includes/');

define('DIR_WS_BOXES', DIR_WS_INCLUDES . 'boxes/');

define('DIR_WS_FUNCTIONS', DIR_WS_INCLUDES . 'functions/');

define('DIR_WS_CLASSES', DIR_WS_INCLUDES . 'classes/');

define('DIR_WS_MODULES', DIR_WS_INCLUDES . 'modules/');

define('DIR_WS_LANGUAGES', DIR_WS_INCLUDES . 'languages/');

 

define('DIR_WS_DOWNLOAD_PUBLIC', 'pub/');

define('DIR_FS_CATALOG', 'I:/htdocs/private/OsCommerce/catalog/');

define('DIR_FS_DOWNLOAD', DIR_FS_CATALOG . 'download/');

define('DIR_FS_DOWNLOAD_PUBLIC', DIR_FS_CATALOG . 'pub/');

 

// define our database connection

define('DB_SERVER', '156.62.146.39'); // eg, localhost - should not be empty for productive servers

define('DB_SERVER_USERNAME', 'oscomm');

define('DB_SERVER_PASSWORD', '2ZYsmv7LJXTywW:V');

define('DB_DATABASE', 'oscommerce');

define('USE_PCONNECT', 'false'); // use persistent connections?

define('STORE_SESSIONS', 'mysql'); // leave empty '' for default handler or set to 'mysql'

?>

 

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Contents of OsCommerce\catalog\admin\includes

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

 

<?php

/*

osCommerce, Open Source E-Commerce Solutions

http://www.oscommerce.com

 

Copyright © 2003 osCommerce

 

Released under the GNU General Public License

*/

 

// Define the webserver and path parameters

// * DIR_FS_* = Filesystem directories (local/physical)

// * DIR_WS_* = Webserver directories (virtual/URL)

define('HTTP_SERVER', 'http://ww304-146-39.aut.ac.nz'); // eg, http://localhost - should not be empty for productive servers

define('HTTP_CATALOG_SERVER', 'http://ww304-146-39.aut.ac.nz');

define('HTTPS_CATALOG_SERVER', 'https://ww304-146-39.aut.ac.nz');

define('ENABLE_SSL_CATALOG', 'true'); // secure webserver for catalog module

define('DIR_FS_DOCUMENT_ROOT', 'I:/htdocs/private/OsCommerce/catalog/'); // where the pages are located on the server

define('DIR_WS_ADMIN', '/private/OsCommerce/catalog/admin/'); // absolute path required

define('DIR_FS_ADMIN', 'I:/htdocs/private/OsCommerce/catalog/admin/'); // absolute path required

define('DIR_WS_CATALOG', '/private/OsCommerce/catalog/'); // absolute path required

define('DIR_FS_CATALOG', 'I:/htdocs/private/OsCommerce/catalog/'); // absolute path required

define('DIR_WS_IMAGES', 'images/');

define('DIR_WS_ICONS', DIR_WS_IMAGES . 'icons/');

define('DIR_WS_CATALOG_IMAGES', DIR_WS_CATALOG . 'images/');

define('DIR_WS_INCLUDES', 'includes/');

define('DIR_WS_BOXES', DIR_WS_INCLUDES . 'boxes/');

define('DIR_WS_FUNCTIONS', DIR_WS_INCLUDES . 'functions/');

define('DIR_WS_CLASSES', DIR_WS_INCLUDES . 'classes/');

define('DIR_WS_MODULES', DIR_WS_INCLUDES . 'modules/');

define('DIR_WS_LANGUAGES', DIR_WS_INCLUDES . 'languages/');

define('DIR_WS_CATALOG_LANGUAGES', DIR_WS_CATALOG . 'includes/languages/');

define('DIR_FS_CATALOG_LANGUAGES', DIR_FS_CATALOG . 'includes/languages/');

define('DIR_FS_CATALOG_IMAGES', DIR_FS_CATALOG . 'images/');

define('DIR_FS_CATALOG_MODULES', DIR_FS_CATALOG . 'includes/modules/');

define('DIR_FS_BACKUP', DIR_FS_ADMIN . 'backups/');

 

// define our database connection

define('DB_SERVER', '156.62.146.39'); // eg, localhost - should not be empty for productive servers

define('DB_SERVER_USERNAME', 'oscomm');

define('DB_SERVER_PASSWORD', '2ZYsmv7LJXTywW:V');

define('DB_DATABASE', 'oscommerce');

define('USE_PCONNECT', 'false'); // use persisstent connections?

define('STORE_SESSIONS', 'mysql'); // leave empty '' for default handler or set to 'mysql'

?>

Share this post


Link to post
Share on other sites

I found the problem

 

in the OsCommerce\catalog\admin\includes\classes\upload.php there was '$this' i changed it to '$th_s' and i fixed the problem.

 

Thanks anyway.

 

David

Share this post


Link to post
Share on other sites