[documentation] [bug] HOWTO: Install Drupal using cPanel

Mon Mar 6 20:45:12 UTC 2006

Issue status update for 
http://drupal.org/node/49791
Post a follow up: 
http://drupal.org/project/comments/add/49791

 Project:      Documentation
 Version:      <none>
 Component:    Installation
 Category:     bug reports
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  sgwyrdd
 Updated by:   pulsifer
 Status:       active

RE: "The basic assumptions: you have a domain name
(http://www.example.com) and want to install Drupal at the document
root, where it is reachable via the URL http://example.com or
http://www.example.com."

How about adding this sentence: "In order to accomplish this, the
Drupal files such as .htaccess and index.php have to be uploaded into
your server's document root, along with the Drupal subdirectories such
as includes, modules, themes, etc."

pulsifer

Previous comments:
------------------------------------------------------------------------

Fri, 17 Feb 2006 00:54:10 +0000 : sgwyrdd

The 'Easy way to install drupal with the cPanel control panel'
instructions at http://drupal.org/node/25310 omit the step of defining
the base_url.

The third bullet point, which currently reads:

Change the setting in settings.php: $db_url =
"mysql://levavie_u1:234@localhost/levavie_db1";

should perhaps read:

Change the database setting in settings.php: $db_url =
"mysql://levavie_u1:234@localhost/levavie_db1";
and set $base_url to match the address to your web site: $base_url =
"http://www.example.com";

You'll see from http://drupal.org/node/49544 that this omission seems
to be causing problems.

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

Fri, 17 Feb 2006 06:44:45 +0000 : Heine

Yes, this page needs a major rewrite. I'll do it as promised [1]. Thanks
for the reminder.
[1] http://drupal.org/node/48075#comment-90594

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

Thu, 23 Feb 2006 16:30:30 +0000 : Heine

'Major' rewrite completed: http://drupal.org/node/25310. I welcome
comments & critique.

I believe the current comments on the page can be deleted as well.

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

Thu, 23 Feb 2006 16:35:10 +0000 : Heine

Just changing the title

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

Thu, 23 Feb 2006 16:55:11 +0000 : sepeck

looks good

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

Mon, 06 Mar 2006 18:56:00 +0000 : webchick

Hey, Heine! Thanks a lot for re-writing that page.

There was one comment someone made in this issue over here:
http://drupal.org/node/52607#comment-79014 -- I guess the fact that the
.tar.gz extracts to a folder is giving CPanel users some trouble when
they want to install to just the root directory. Maybe you could put in
something like what greggles mentions below to help people in this
situation? I would update this myself, but I don't have CPanel to test
on and want to make sure the instructions are 100% clear/accurate since
this is likely a page that gets a lot of attention from newbies.

Thanks a lot. :)

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

Mon, 06 Mar 2006 19:19:19 +0000 : pulsifer

One way to get the drupal files into public_html using cPanel File
Manager is to uncompress the .tar.gz on your PC and rezip it without
the "drupal..." prefix on all of the file names.  See
http://drupal.org/node/52602 and http://drupal.org/node/52607

Note that the cPanel File Manager will also expand .zip files.  It
might be easier for most PC people to recompress the installation file
into a zip rather than a targz.

Note that IMHO it would be easier for someone to just do this once and
post this file at drupal.org, rather than trying to explain how to do
it.

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

Mon, 06 Mar 2006 19:27:28 +0000 : Heine

I just tested if cPanels filemanager supports zip and it does: the
instructions for repackaging as zip or tar file have been added. Please
review.

-1 on the packing without top directory, but that's another issue.

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

Mon, 06 Mar 2006 19:41:33 +0000 : pulsifer

"...but omit the top folder (drupal-x.x.x) from the archive."

I'm not sure that's going to make much sense to people who are reading
this for the first time.  I suggest describing the steps, like my
comment here: http://drupal.org/node/52602#comment-99230

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

Mon, 06 Mar 2006 19:59:24 +0000 : Heine

I'm not sure we can assume people use Winzip on Windows. I'm looking for
a better description.

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

Mon, 06 Mar 2006 20:31:59 +0000 : pulsifer

How about:

First unpack the drupal archive on your local computer.  Then navigate
to the drupal-x.x.x directory, select all of its contents (files and
folders) and re-compress them into a zip file or into a new tar file. 
The result should be that "drupal-x.x.x" no longer appears in front of
each file and folder name in this newly created archive.  Upload this
new archive to the document root on the server and extract its
contents. The Drupal files and folders should now be located in the
document root.

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

Mon, 06 Mar 2006 20:44:38 +0000 : pulsifer

I've never tested this: what happens if there is already an .htaccess
file in the document root?  (Many hosts have one preinstalled.)  Will
cPanel File Manager overwrite it?