487
edits
Installing Drupal on 5.0-Nano: Difference between revisions
Jump to navigation
Jump to search
Installing Drupal on 5.0-Nano (view source)
Revision as of 19:05, 23 November 2009
, 23 November 2009Proofreading and grammatical changes
m (Proofreading and grammatical changes) |
|||
| Line 7: | Line 7: | ||
This step-by-step guide shows how to install Drupal on Uniform Server 5.0-Nano and how to resolve common issues such as PHP mail and cron. | This step-by-step guide shows how to install Drupal on Uniform Server 5.0-Nano and how to resolve common issues such as PHP mail and cron. | ||
'''''Provisional release | '''''Provisional release: maybe wait for D7.''''' | ||
== Preparation - 1 == | == Preparation - 1 == | ||
| Line 16: | Line 16: | ||
# '''A)''' Create a new folder named '''drupal_b''' (Can be any name) | # '''A)''' Create a new folder named '''drupal_b''' (Can be any name) | ||
# Extract a new copy of Uniform Server V5.0-Nano to this folder<br> --- Database user name '''root''' - No need to change this<br> --- Database password '''root''' - Before installing Drupal I recommend changing this using [[5.0-Nano: Security & passwords#MySQL Password | apanel]] | # Extract a new copy of Uniform Server V5.0-Nano to this folder<br> --- Database user name '''root''' - No need to change this<br> --- Database password '''root''' - Before installing Drupal, I recommend changing this using [[5.0-Nano: Security & passwords#MySQL Password | apanel]] | ||
# '''Start''' Uniform Server. | # '''Start''' Uniform Server. | ||
| Line 23: | Line 23: | ||
<li> '''B)''' Create a new folder '''drupal_a''' (Can be any name its only a temporary folder)</li> | <li> '''B)''' Create a new folder '''drupal_a''' (Can be any name its only a temporary folder)</li> | ||
<li> Download Drupal '''6.13''' (or newer version) from [http://drupal.org/ here] save to a convenient folder for example '''drupal_a'''</li> | <li> Download Drupal '''6.13''' (or newer version) from [http://drupal.org/ here] save to a convenient folder for example '''drupal_a'''</li> | ||
<li>Unzip the downloaded file (drupal-6.13.tar.gz) Windows cannot do this | <li>Unzip the downloaded file (drupal-6.13.tar.gz) Windows cannot do this. Use something like 7-Zip Portable<br> --- Download site: [http://portableapps.com/apps/utilities PortableApps.com]<br> --- File name: 7-Zip Portable - Multilingual file archiver and compressor</li> | ||
<li>'''B)''' Extract '''drupal-6.13.tar.gz''' to current path | <li>'''B)''' Extract '''drupal-6.13.tar.gz''' to current path; creates a new folder '''drupal-6.13.tar'''. Open this folder '''C)'''</li> | ||
<li>'''C)''' Extract drupal-6.13.tar to current path | <li>'''C)''' Extract drupal-6.13.tar to current path; creates a new folder drupal-6.13 '''(D)'''.<br> | ||
Inside this is a second folder drupal-6.13 containing all the drupal files '''E)'''.</li> | |||
</ol> | </ol> | ||
| Line 41: | Line 41: | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
== Switch to production, start servers == | == Switch to production, start servers == | ||
UniServer’s default is to use the production PHP configuration file | UniServer’s default is to use the production PHP configuration file. However, you may have switched configuration files during development. | ||
Before installing any applications ensure the production configuration is selected. | Before installing any applications, ensure that the production configuration is selected. | ||
'''''Check configuration file'':''' | '''''Check configuration file'':''' | ||
# Start UniTray, in folder UniServer double click on '''Start.exe''' tray icon | # Start UniTray, in folder UniServer double click on '''Start.exe''', which creates the tray icon. | ||
# Check configuration: Left click '''tray icon > Server Status''' – Top of page php.ini displays either Production or development. | # Check configuration: Left click '''tray icon > Server Status''' – Top of page, php.ini displays either Production or development. | ||
# If Production displayed no action required you can start servers. | # If Production displayed, no action required; you can start servers. | ||
# If development displayed proceed as follows: | # If development displayed, proceed as follows: | ||
# Switch to production | # Switch to production: Left click '''tray icon > Advanced > click php.ini to switch to Production'''. | ||
'''''Start Servers'':''' | '''''Start Servers'':''' | ||
| Line 59: | Line 59: | ||
== Preparation - 2 == | == Preparation - 2 == | ||
=== Create Drupal database === | === Create Drupal database === | ||
Creating the Drupal database is straight forward | Creating the Drupal database is straight forward. Note that tables are automatically inserted during installation. | ||
{| | {| | ||
|- | |- | ||
| Line 74: | Line 74: | ||
|} | |} | ||
'''''Note'':''' | '''''Note'':''' | ||
* You can start phpMyAdmin from Apanel | * You can start phpMyAdmin from Apanel. Start Apanel by typing <nowiki>http://localhost/apanel/</nowiki> into your browser address bar. | ||
* From Apanel click on the '''phpMyAdmin''' link. (left menu under tools) | * From Apanel click on the '''phpMyAdmin''' link. (left menu under tools) | ||
| Line 80: | Line 80: | ||
=== Optionally configure PHP email === | === Optionally configure PHP email === | ||
After you complete the final step in '''Install and set-up Drupal''' see below | After you complete the final step in '''Install and set-up Drupal''', see below. You will receive the following warning message: | ||
<pre> | <pre> | ||
warning: mail() [function.mail]: Failed to connect to mailserver at "localhost" port 25, | warning: mail() [function.mail]: Failed to connect to mailserver at "localhost" port 25, | ||
| Line 87: | Line 87: | ||
Unable to send e-mail. Please contact the site admin, if the problem persists. | Unable to send e-mail. Please contact the site admin, if the problem persists. | ||
</pre> | </pre> | ||
If you are only exploring and testing Drupal's functionality you can safely ignore this | If you are only exploring and testing Drupal's functionality, you can safely ignore this; it's only a warning and not an error. However, if you would like to send emails via your ISP, you have three options. | ||
==== A) Edit php.ini ==== | ==== A) Edit php.ini ==== | ||
| Line 103: | Line 103: | ||
</pre> | </pre> | ||
Replace: SMTP = '''localhost''' with your ISP's SMTP server; for details check out this page [[PHP mail function | PHP mail function]] | Replace: SMTP = '''localhost''' with your ISP's SMTP server; for details check out this page [[PHP mail function|PHP mail function]] | ||
Replace: sendmail_from = '''me@localhost.com''' with your real email address issued to you by your ISP. | Replace: sendmail_from = '''me@localhost.com''' with your real email address issued to you by your ISP. | ||
| Line 109: | Line 109: | ||
'''''Note'':''' | '''''Note'':''' | ||
The above changes also need to be made to files: | The above changes also need to be made to files: | ||
* '''php.ini_delvelopment_nano''' | * '''php.ini_delvelopment_nano''' (note spelling error) | ||
* '''php.ini_production_nano''' | * '''php.ini_production_nano''' | ||
These files are selectable from UniTray and overwrite php.ini | These files are selectable from UniTray and overwrite php.ini. This allows switching between production and development for testing. | ||
==== B) Install Fake Sendmail for Windows ==== | ==== B) Install Fake Sendmail for Windows ==== | ||
If your ISP requires authentication install [[Installing Fake Sendmail for Windows |Fake Sendmail for Windows]] | If your ISP requires authentication, install [[Installing Fake Sendmail for Windows |Fake Sendmail for Windows]] | ||
==== C) Install a mailserver ==== | ==== C) Install a mailserver ==== | ||
One final option | One final option: If you want to run your own mail server and your ISP does not block the mail ports, check out this page [[SSL Part 2: Installing hMailServer | Installing hMailServer]] | ||
| Line 123: | Line 123: | ||
== Install and set-up Drupal == | == Install and set-up Drupal == | ||
The Drupal set-up is straight forward I have shown what needs to be entered in the action column. | The Drupal set-up is straight forward. I have shown what needs to be entered in the action column. | ||
For a test server enter | For a test server enter what's highlighted in bold, or enter your own specific data. | ||
{|cellpadding="4" cellspacing="1" style="background:#000000;" | {|cellpadding="4" cellspacing="1" style="background:#000000;" | ||
|-style="background:#e8e8e8;" | |-style="background:#e8e8e8;" | ||
| Line 150: | Line 150: | ||
'''''Note'':''' Use Advanced Options if you moved servers (new MySQL port) | '''''Note'':''' Use Advanced Options if you moved servers (new MySQL port) | ||
* Database host: '''localhost''' | * Database host: '''localhost''' | ||
* Database port: '''3307''' (Note: 3307 is an example | * Database port: '''3307''' (Note: 3307 is an example. Use UniTray to find MySQL port. Run '''Server Status''') | ||
* Table prefix: (leave blank) | * Table prefix: (leave blank) | ||
| Line 165: | Line 165: | ||
* Confirm password: '''MPG-root66''' Use your own password | * Confirm password: '''MPG-root66''' Use your own password | ||
<br> | <br> | ||
* Clean URL's radio button is '''Enabled''' no need to change | * Clean URL's radio button is '''Enabled'''; no need to change | ||
* Update notification leave '''checked'''. | * Update notification leave '''checked'''. | ||
* Click '''Save and continue''' | * Click '''Save and continue''' | ||
|} | |} | ||
I mentioned in Preparation-2 you will receive a mail warning | I mentioned in Preparation-2 you will receive a mail warning. This can safely be ignored. If you implemented any of the above solutions a warning will not be issued. | ||
To view your new site click "'''your newsite'''" link (or type <nowiki>http://localhost/drupal/</nowiki>). | To view your new site, click "'''your newsite'''" link (or type <nowiki>http://localhost/drupal/</nowiki>). | ||
When you '''log into admin''' (click administer link) at the top of the admin page you will see | When you '''log into admin''' (click administer link) at the top of the admin page you will see | ||
| Line 184: | Line 184: | ||
== Cron == | == Cron == | ||
Cron is unavailable on Windows | Cron is unavailable on Windows. It is a Unix process that periodically runs certain scripts. Although Drupal allows you to manually run '''cron.php''' this can can be inconvenient. The following section shows how to enable UniServer5.0-Nano's portable cron. | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
| Line 241: | Line 241: | ||
== Portability == | == Portability == | ||
If you want a portable version of Drupal copy the folder '''UniServer''' and all its content to your USB memory stick | If you want a portable version of Drupal, copy the folder '''UniServer''' and all its content to your USB memory stick. That’s it. Don’t expect fantastic speeds, however it is usable. | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
| Line 248: | Line 248: | ||
I have shown how easy it is to install Drupal on Uniform Server 5.0-Nano. | I have shown how easy it is to install Drupal on Uniform Server 5.0-Nano. | ||
Cron a Unix process is required to periodically update Drupal's status | Cron, a Unix process is required to periodically update Drupal's status. Uniform Server 5.0-Nano uses Portable Cron which is built into the server. | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||