Difference between pages "Package:Drupal" and "Install/Stage3"

(Difference between pages)
m (add base url config)
 
(Created page with "<noinclude> {{Note: This is a template that is used as part of the Installation instructions, to describe the process of installing the Stage3 tarball. Templates are being use...")
 
Line 1: Line 1:
{{Ebuild
+
<noinclude>
|Summary=PHP-based open-source platform and content management system
+
{{Note: This is a template that is used as part of the Installation instructions, to describe the process of installing the Stage3 tarball. Templates are being used to allow multiple variant install guides that use most of the same re-usable parts.}}
|CatPkg=www-apps/drupal
+
</noinclude><includeonly>
|Maintainer=
+
=== Installing the Stage 3 tarball ===
|Homepage=http://drupal.org/
+
After creating filesystems, the next step is downloading the initial Stage 3 tarball. The Stage 3 is a pre-compiled system used as a starting point to install Funtoo Linux. Load one of the following URLs in another browser window:
}}
+
Drupal is a powerful [[Web-server-stack]] web application that can be used to craft custom websites, for example: http://www.whitehouse.gov
+
  
== Install ==
+
{{MirrorList}}
{{note|drupal likes php emerged with the gmp use flag enabled}}
+
  
<console>
+
Now, let's navigate the directories on the mirrors to find the appropriate build of Funtoo Linux for you.
###i## emerge drupal
+
</console>
+
  
=== MySQL ===
+
==== Stable or Current? ====
{{warning|default "changeme" passwords are insecure, change them!}}
+
Funtoo Linux has a "stable" build and a "current" build. Most people use the "current" build of Funtoo Linux, and it's generally recommended that you do too. You will find "current' builds in the main <code>/funtoo-current</code> directory on our mirrors, and "stable" builds in <code>/funtoo-stable</code>.
 +
<br />If you want to read more about this, have a look at [[Funtoo_Linux#What_are_the_differences_between_.27stable.27.2C_.27current.27_and_.27experimental.27_.3F|Differences between stable, current and experimental]].
  
To create a database for drupal to interact with:
+
==== 32 or 64-bit? ====
 +
There are three different types of Funtoo Linux that you can install. If you are installing on an older 32-bit system (if you don't know, then you probably are not) then you want to grab a stage3 tarball from the <code>x86-32bit</code> sub-directory. Most likely, you'll want to grab a 64-bit build from the <code>x86-64bit</code> sub-directory.
  
<console>###i## mysql -u root -p
+
==== Your SubArch ====
mysql> ##i##CREATE DATABASE IF NOT EXISTS `drupal` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
+
Inside <code>/funtoo-current/x86-64bit/</code> on one of our mirrors, you'll see a bunch of directories for various ''subarches'' of Funtoo Linux.
mysql> ##i##CREATE USER 'drupal'@'localhost' IDENTIFIED BY 'changeme';
+
mysql> ##i##GRANT LOCK TABLES, SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `drupal`.* TO 'drupal'@'localhost' IDENTIFIED BY 'changeme';
+
mysql> ##i##\q
+
</console>
+
=== webapp-config ===
+
{{note|1=
+
<code>webapp-config</code> is currently broken for Drupal so you must run it yourself:}}
+
  
To run <code>webapp-config</code>, you must know the version number of the webapp you're installing. To find the version number:
+
Subarches are builds of Funtoo Linux that are designed to run on a particular type of CPU, to offer the best possible performance. They take advantage of the instruction sets available for each CPU.  
  
<console>###i## equery l drupal</console>
+
For example, the <code>corei7</code> and <code>corei7-pure64</code> sub-arches require an Intel Core i7 processor to run (this includes Xeon x3400+ series, or other Nehalem-based CPUs such as Xeon x5500/x5600 series.)
  
then run something similar to this, making sure to replace the version number with your current drupal version.
+
If you are using an AMD-based CPU, download a stage3 from <code>generic_64</code>, <code>amd64-k8</code> or <code>amd64-k10</code>.  
  
<console>###i## webapp-config -I -h localhost -u root -d /drupal drupal 7.31</console>
+
If you are using an Intel-based CPU, download a stage3 from <code>generic_64</code>, <code>atom_64</code>, <code>core2_64</code> or <code>corei7</code>.
  
=== web install ===
+
===== Pure64 Builds =====
Start your web server, and database.
+
Inside <code>/funtoo-current/</code>, you may notice a sub-directory named <code>pure64</code>. These builds are recommended for server systems, and they do not offer any 32-bit compatibility, which is generally not needed on server systems. If you are setting up a desktop or workstation system, it's recommended that you avoid these builds as you will need 32-bit compatibility to run several binary desktop-oriented applications such as Skype. But for servers, pure64 is recommended.
  
==== nginx ====
+
==== Setting the Date ====
configure your nginx similar to official documentation.  http://wiki.nginx.org/Drupal
+
  
point your browser @ http://localhost/drupal/install.php
+
{{fancyimportant|If your system's date and time are too far off (typically by months or years,) then it may prevent Portage from properly downloading source tarballs. This is because some of our sources are downloaded via HTTPS, which use SSL certificates and are marked with an activation and expiration date.}}
  
==== apache ====
+
Now is a good time to verify the date and time are correctly set to UTC. Use the <code>date</code> command to verify the date and time:
If you are using apache 2.4, or newer run this sed command.
+
<console>###i## sed -i 's\Order allow,deny\Require all granted\' /var/www/localhost/htdocs/drupal/.htaccess</console>
+
  
point your browser @ http://localhost/drupal/install.php
+
<console>
 +
# ##i##date
 +
Fri Jul 15 19:47:18 UTC 2011
 +
</console>
  
=== Permission Adjustments ===
+
If the date and/or time need to be corrected, do so using <code>date MMDDhhmmYYYY</code>, keeping in mind <code>hhmm</code> are in 24-hour format. The example below changes the date and time to "July 16th, 2011 @ 8:00PM" UTC:
==== Enable Theme & Module Uploads ====
+
{{note| if you're using nginx change to nobody:nogroup}}
+
<console>###i## chown -R apache:apache /var/www/localhost/htdocs/drupal/sites/all/</console>
+
  
* [https://www.drupal.org/project/project_theme drupal theme index]
+
<console>
 +
# ##i##date 071620002011
 +
Fri Jul 16 20:00:00 UTC 2011
 +
</console>
  
* [https://www.drupal.org/project/project_module drupal extensions]
+
==== Download the Stage3 ====
 +
Once you are in your Funtoo Linux root filesystem, use <code>wget</code> to download the Stage 3 tarball you have chosen to use as the basis for your new Funtoo Linux system. It should be saved to the <code>/mnt/funtoo</code> directory as follows:
  
==== Adjust for Security ====
+
<console># ##i##cd /mnt/funtoo
<console>###i## chmod 640 /var/www/localhost/htdocs/drupal/sites/default/settings.php</console>
+
# ##i##wget http://ftp.osuosl.org/pub/funtoo/funtoo-current/x86-64bit/generic_64/stage3-latest.tar.xz
 +
</console>
  
== Post Install ==
 
=== base url ===
 
To set your base url:
 
  
{{file|name=/var/www/localhost/htdocs/drupal/sites/default/settings.php|lang=php|desc=ip address listening to external requests or domain name|body=
+
Note that 64-bit systems can run 32-bit or 64-bit stages, but 32-bit systems can only run 32-bit stages. Make sure that you select a Stage 3 build that is appropriate for your CPU. If you are not certain, it is a safe bet to choose the <code>generic_64</code> or <code>generic_32</code> stage. Consult the [[Download]] page for more information.
$base_url = 'http://0.0.0.0/drupal';  // NO trailing slash!
+
}}
+
=== Cron ===
+
Drupal automates several tasks by cron.  see official documentation to setup a cron job.
+
https://www.drupal.org/node/23714
+
  
=== Maintenance Mode Access ===
+
Once the stage is downloaded, extract the contents with the following command, substituting in the actual name of your stage 3 tarball:
If you suddenly find your self locked out of your drupal cms because it is in maintenence mode:
+
<console>
 
+
# ##i##tar xpf stage3-latest.tar.xz
http://localhost/drupal/user
+
</console>
 
+
== Troubleshooting ==
+
If you are having problems logging into the admin console flush your browser cache.
+
 
+
== Media ==
+
=== Overview ===
+
{{#widget:YouTube|id=kaOuQxsjs3E}}
+
 
+
=== Tutorials ===
+
{{#widget:YouTube|playlist=PL15BE2E8313A4E809}}
+
  
== External Resources ==
+
{{fancyimportant|It is very important to use <code>tar's</code> "<code>'''p'''</code>" option when extracting the Stage 3 tarball - it tells <code>tar</code> to ''preserve'' any permissions and ownership that exist within the archive. Without this option, your Funtoo Linux filesystem permissions will be incorrect.}}
* https://wiki.gentoo.org/wiki/Drupal
+
</includeonly>
* [http://youtu.be/sfrfuCLH9sg google tech talks: implementing drupal]
+
* [https://www.youtube.com/channel/UCyLF5zO6ghZcOXKHRWTipvw drupalize.me youtube channel]
+
{{EbuildFooter}}
+

Revision as of 04:58, November 12, 2014

Template:Note: This is a template that is used as part of the Installation instructions, to describe the process of installing the Stage3 tarball. Templates are being used to allow multiple variant install guides that use most of the same re-usable parts.