Installing Drupal on 5.0-Nano
|Installing Drupal on 5.0-Nano|
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: maybe wait for D7.
Preparation - 1
Install Uniform server
Copy files to Uniform Server
Switch to production, start servers
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 that the production configuration is selected.
Check configuration file:
- 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.
- If Production displayed, no action required; you can start servers.
- If development displayed, proceed as follows:
- Switch to production: Left click tray icon > Advanced > click php.ini to switch to Production.
- Start Uniform Server. Left click tray icon > click Start UniServer
Preparation - 2
Create Drupal database
Creating the Drupal database is straight forward. Note that tables are automatically inserted during installation.
- You can start phpMyAdmin from Apanel. Start Apanel by typing http://localhost/apanel/ into your browser address bar.
- From Apanel click on the phpMyAdmin link. (left menu under tools)
Optionally configure PHP email
After you complete the final step in Install and set-up Drupal, see below. You will receive the following warning message:
warning: mail() [function.mail]: Failed to connect to mailserver at "localhost" port 25, verify your "SMTP" and "smtp_port" setting in php.ini or use ini_set() in Z:\www\drupal\includes\mail.inc on line 193. Unable to send e-mail. Please contact the site admin, if the problem persists.
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
Open php.ini located in folder UniServer\usr\local\php
Locate this section:
[mail function] ; For Win32 only. SMTP = localhost smtp_port = 25 ; For Win32 only. sendmail_from = firstname.lastname@example.org
Replace: SMTP = localhost with your ISP's SMTP server; for details check out this page PHP mail function
Replace: sendmail_from = email@example.com with your real email address issued to you by your ISP.
Note: The above changes also need to be made to files:
- php.ini_delvelopment_nano (note spelling error)
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
If your ISP requires authentication, install Fake Sendmail for Windows
C) Install a mailserver
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 Installing hMailServer
Install and set-up Drupal
The Drupal set-up is straight forward. I have shown what needs to be entered in the action column.
For a test server enter what's highlighted in bold, or enter your own specific data.
|Type the following into browser address bar http://localhost/drupal/
This opens Drupal's installation page (http://localhost/drupal/install.php?profile=default)
|1. Choose language||Click Install Drupal in English|
|2. Verify requirements||Automatically Confirmed OK|
|3. Set up database||
Note: Use Advanced Options if you moved servers (new MySQL port)
|4. Install site||Automatically Confirmed|
|5. Configure site||
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 http://localhost/drupal/).
When you log into admin (click administer link) at the top of the admin page you will see
"Cron has not run. Please visit the status report for more information."
- Click the status report link:
- Navigate to "Cron maintenance tasks" to the right click "run cron manually"
- After a short time you will receive a message "Cron ran successfully."
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.
Enable portable Cron
Edit file: UniServer\unicon\main\run_cron.php
Uncomment this line as shown:
$dummy = file("http://localhost/drupal/cron.php");
Change the timer to suit application
sleep(15); // Set required delay (seconds)
Run portable Cron
Manually run cron from UniTray
- Start: Left click tray icon > Advanced > click Start Portable Cron
- Stop: Left click tray icon > Advanced > click Stop Portable Cron
Automatically start and stop with servers
Edit file: UniServer\unicon\tray_menu\UniTray1.ini
Locate these lines under [Menu.Left] Menu section (for convenience lines have been split):
Type: item; Caption: "Start UniServer (Apache MySQL)"; Action: shellexecute; FileName: "%PHP%\php.exe"; Parameters: " -n %ServerConMain%\start_servers.php 7";ShowCmd: hidden; Glyph: 9 Type: item; Caption: "Stop UniServer (Apache MySQL)"; Action: shellexecute; FileName: "%PHP%\php.exe"; Parameters: " -n %ServerConMain%\stop_servers.php 7";ShowCmd: hidden; Glyph: 11
- Replace start_servers.php 7 with start_servers.php 23
- Replace stop_servers.php 7 with start_servers.php 23
Note: Values are binary coded
Note: Binary 1+2+4+16 = 23 1 - Run Apache server 2 - Run MySQL server 4 - Start Index page 16 - Run cron
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.
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. Uniform Server 5.0-Nano uses Portable Cron which is built into the server.