Drupal 6.1 Install Tutorial

[lizon]

For users looking to use Drupal 7, Please click here for more info


The following tutorial is to help whose with little to no web experience install Drupal 6.15 onto their zymic account. I went ahead and made a new account from scratch with a fresh install to try and see every possible error that comes along and address each one.

Zymic Setup:


Goto the Zymic homepage and click on "Sign-up/Log-in"



Make up your username and e-mail address. Type in your password.



Be sure to make sure your human. ^.^



Click on the "login" link



Congrats you are now logged in! Now click on "Control Panel Home"



Click on "Create New Web Host Account"



Make up your subdomain name and primaty host



Type in your control panel password. Keep in mind this pasword is ALSO your FTP password. So remember it.



Don't be doing any naughty stuff with your website and check off "I agree"



I'm not sure if I'm a human....Resistance is Futile....o.O



Congradultaions!



Write down your ftp information, you'll need it later on then click on "Login to control panel"



Click on the login button as shown here



Type in your password, don't worry I won't look....



Now to get your database setup, click on "MySQL Database Management"



Create your database name and click on "create DataBase Name"



Now create your database username and password, be sure to confirm it and press "Create Username"



Now assign privileges to your username to the database you want, be sure everythign is checked off and click "Assign Privileges"



Congrats your database is now created. Be sure to write down your database name, database username, and password. You will need that info in a little bit.



Congrats your DONE with the Zymic setup! Now lets get to Drupal.

Drupal Setup

STEP 1:
Download the Drupal 6.15 Distribution here.

STEP 2: Unzip the file and save it's contents into a folder that you can refer back to easily (save it on your desktop if you want).

STEP 3:
Now for the fun part. Open up your drupal folder and find your default.settings.php file at /sites/default/

Open up the file in your favorite web editing tool (notepad, dreamweaver, ect ect) and find this section of code.

CODE

$db_url = 'mysql://username:password@localhost/databasename';

Input your DATABASE username and password into the spots provided. Leave the host as localhost.Then input your database name.

CODE

$db_url = 'mysql://90593_zymic:zymic132@localhost/lizontest_zxq_zymic';

STEP 4:
Next find this section of code

CODE

ini_set('arg_separator.output',     '&');
      ini_set('magic_quotes_runtime',     0);
      ini_set('magic_quotes_sybase',      0);
      ini_set('session.cache_expire',     200000);
      ini_set('session.cache_limiter',    'none');
      ini_set('session.cookie_lifetime',  2000000);
      ini_set('session.gc_maxlifetime',   200000);
      ini_set('session.save_handler',     'user');
      ini_set('session.use_cookies',      1);
      ini_set('session.use_only_cookies', 1);
      ini_set('session.use_trans_sid',    0);
      ini_set('url_rewriter.tags',        '');

Comment out the line by putting a # in front of each line till it looks liks this

CODE

@ini_set('arg_separator.output',     '&');
      @ini_set('magic_quotes_runtime',     0);
      @ini_set('magic_quotes_sybase',      0);
      @ini_set('session.cache_expire',     200000);
      @ini_set('session.cache_limiter',    'none');
      @ini_set('session.cookie_lifetime',  2000000);
      @ini_set('session.gc_maxlifetime',   200000);
      @ini_set('session.save_handler',     'user');
      @ini_set('session.use_cookies',      1);
      @ini_set('session.use_only_cookies', 1);
      @ini_set('session.use_trans_sid',    0);
      @ini_set('url_rewriter.tags',        '');

STEP 5:
Now save your default.settings.php AS settings.php This is VERY IMPORTANT!

Now lets open up bootstrap.inc file located at /includes/ in the base drupal directory. Find this line of code

CODE

  if (count(explode('.', $cookie_domain)) > 2 && !is_numeric(str_replace('.', '', $cookie_domain))) {
         ini_set('session.cookie_domain', $cookie_domain);
       }

Comment out the lines using // so it looks like this

CODE

//  if (count(explode('.', $cookie_domain)) > 2 && !is_numeric(str_replace('.', '', $cookie_domain))) {
     //    ini_set('session.cookie_domain', $cookie_domain);
     //  }

Save the file.

STEP 6:
Now open up the .htaccess file located in root directory (same spot where index.php is at). Scroll down to this code

CODE

  # If your site is running in a VirtualDocumentRoot at http://example.com/,
     # uncomment the following line:
     # RewriteBase /
     # Rewrite URLs of the form 'x' to the form 'index.php?q=x'.

Remove the # in front of RewriteBase / so it looks like this

CODE

  # If your site is running in a VirtualDocumentRoot at http://example.com/,
     # uncomment the following line:
     RewriteBase /
     # Rewrite URLs of the form 'x' to the form 'index.php?q=x'.

STEP 7:
Now using your favorite FTP program upload all the contents in the drupal folder to your website, Core FTP is a good one (www.coreftp.com). Grab a drink if you want, this should take a few minutes at least.

STEP 8:
Now in your ftp program goto your sites/default directory in your web directory and create a folder titles "files"



STEP 9:
Next right click on the folder and click on properties. This will allow you to set permissions for the directory. Set it up just how I've shown here. You can either check off the boxes or enter the value as 775



STEP 10:

Getting closer to the finish line. Goto your home directory. In this case it's lizontest.zxq.net/install.php



DON'T PANIC! ^.^

Click where indicated.

STEP 11:
Input the url to your website and click "Submit"



STEP 12:
It should now take you back to your homepage, if not simply go back to it, in this case it's lizontest.zxq.net/install.php. You should get the following screen. Click on "Install Drupal in English"



STEP 13: Installing.......




DONE!



STEP 14:
Put in your site name and e-mail address....



and your Admin username and e-mail address...



and your password for that username, be sure to confirm it....



Oh and click off "Enabled" for the Clean URLs. When I did this install I messed up with it, for you it should be available to click off.



Click "Save and Continue"

STEP 15:



Don't worry about the error message. The mail() function is disabled unless you pay for it. The website will still work. Click on the link that takes you to "your new website".

STEP 16:
Congrats your done!



Remember if you ever need help the drupal forums and knowledge base are an excellent reference tool. All can be found at drupal.org

SPECIAL THANKS:
To the Zymic support members in chat who suggested many of the changes here to make Drupal work for me. All credit goes to them and their efforts.[color="#FF0000"][/color]

[lizon]

updated the initial post with new screenshots covering some of the new steps with the zymic setup and database changes. I also put the coded sections into code format so they will always be there even if the pictures disappear.

[Ed]

updated the initial post with new screenshots covering some of the new steps with the zymic setup and database changes. I also put the coded sections into code format so they will always be there even if the pictures disappear.

Thank you for taking the time to write this, looks great and will be a godsend for those wanting to install Drupal.

One suggestion would be to use @ as opposed to commenting, this then means if the modifications are uploaded elsewhere it doesn't break the functionality, it merely suppresses the warnings.

[lizon]

Thank you for taking the time to write this, looks great and will be a godsend for those wanting to install Drupal.

One suggestion would be to use @ as opposed to commenting, this then means if the modifications are uploaded elsewhere it doesn't break the functionality, it merely suppresses the warnings.

I don't think it makes much of a difference personally. The sections I pointed out are the only areas where those modifications are needed. Everything else in drupal refers to that. So far I've yet to see it come up as an error. Right now I'm sprucing up the test page, going to see about using it as a repository of Drupal for Zymic information.

Drupal for Zymic

I'm going to see about adding new articles to it at least on a weekly basis. Mostly addressing common issues and mods that may need a bit help to work with Zymic (eyes SMF/Drupal integration keenly o.O)