Difference between revisions of "5.0-Nano: Install and Run"

From The Uniform Server Wiki
Jump to navigation Jump to search
(Cleanup and link fix)
Line 2: Line 2:
 
'''''5.0-Nano Installation and run guide'''''
 
'''''5.0-Nano Installation and run guide'''''
  
Uniform Server 5.0-Nano has a single installation option '''extract to any folder''' and two operation modes either as a '''standard program''' or '''service'''.
+
Uniform Server 5.0-Nano has a single installation option: '''extract to any folder''', and two operation modes, either as a '''standard program''' or '''service'''.
  
 
'''Portability''' is nothing more complex than '''copying folder UniServer''' to where you want to run the servers. That includes any hard drive or USB memory stick.
 
'''Portability''' is nothing more complex than '''copying folder UniServer''' to where you want to run the servers. That includes any hard drive or USB memory stick.
  
Can’t run UniServer because it clashes with an existing server three mouse clicks and a few key presses reconfigures the server allowing it to coexist with an existing host server.
+
Can’t run UniServer because it clashes with an existing server?  Three mouse clicks and a few key presses reconfigures the server allowing it to coexist with an existing host server.
  
Uniform Server tries not to impose any restrictions hence has numerous user configurable features allowing you to tailor the servers. This page explores some of these after first covering the basics.
+
Uniform Server tries not to impose any restrictions, hence has numerous user configurable features allowing you to tailor the servers. This page explores some of these after first covering the basics.
  
 
== Download ==
 
== Download ==
Download Uniform Server 5.*-Nano from [https://sourceforge.net/projects/miniserver/files/ Sourceforge] choose either '''UniServer5_*.exe''' or '''UniServer5_*.zip'''
+
Download Uniform Server 5.*-Nano from [https://sourceforge.net/projects/miniserver/files/ Sourceforge] choose either '''UniServer5_*.exe''' or '''UniServer5_*.zip'''.  The .exe is a self-extracting 7-zip archive, and is much smaller.
  
There are currently two versions main difference being PHP
+
For 5.0, 5.1, 5.2 and 5.3 there are two parallel versions, the main difference being the version of PHP:
 
* UniServer5_0.exe or UniServer5_0.zip - PHP 5.2.10  
 
* UniServer5_0.exe or UniServer5_0.zip - PHP 5.2.10  
 
* UniServer5_1.exe or UniServer5_1.zip - PHP 5.3.0  
 
* UniServer5_1.exe or UniServer5_1.zip - PHP 5.3.0  
 
* UniServer5_2.exe or UniServer5_2.zip - PHP 5.2.11 --- '''''New''''' See [[5.3-Nano: Introduction | supplementary section]] for details  
 
* UniServer5_2.exe or UniServer5_2.zip - PHP 5.2.11 --- '''''New''''' See [[5.3-Nano: Introduction | supplementary section]] for details  
* UniServer5_3.exe or UniServer5_3.zip - PHP 5.3.0  --- '''''New''''' See [[5.3-Nano: Introduction | supplementary section]] for details  
+
* UniServer5_3.exe or UniServer5_3.zip - PHP 5.3.0  --- '''''New''''' See [[5.3-Nano: Introduction | supplementary section]] for details.
 +
 
 +
Version 5.4 has dropped this to go only with PHP 5.3.1.
 +
 
 
'''''[[#top | Top]]'''''
 
'''''[[#top | Top]]'''''
  
Line 26: Line 29:
 
'''''Install and run'':'''
 
'''''Install and run'':'''
  
# Save '''UniServer5_*.exe''' to any folder
+
# Save '''UniServer5_*.exe''' to any folder.
# Double click '''UniServer5_*.exe''' its a self-extracting archive and unpacks to the current folder (where you saved the file).<br />''Note'': The exe '''does not''' install anything to the registry or other areas of a PC it just creates folder UniServer and extracts all folders and files to this folder.
+
# Double click '''UniServer5_*.exe'''. It's a self-extracting archive and unpacks to the current folder (where you saved the file).<br />''Note'': The exe '''does not''' install anything to the registry or other areas of a PC. It just creates folder UniServer and extracts all folders and files to this folder.
# Navigate to folder '''UniServer''' '''A)'''
+
# Navigate to folder '''UniServer''' '''A)'''.
# Run (doube click on) '''Start.exe''' this starts Unitray.
+
# Run (double click on) '''Start.exe'''. This starts Unitray.
# Left click on the tray icon, and click on '''Start UniServer''' (top menu)
+
# Left click on the tray icon, and click on '''Start UniServer''' (top menu), which starts both Apache and MySQL servers.
# Starts both Apache and MySQL servers
+
# If not already running, your browser will automatically start and display '''Intro page'''.
# If not already running your browser will automatically start and display '''Intro page'''
+
# Stop the servers. Left click on the tray icon, and click on '''Stop UniServer''' (second menu item).
# Stop the servers. Left click on the tray icon, and click on '''Stop UniServer''' (second menu item)
 
  
 
'''''Note 1'':'''
 
'''''Note 1'':'''
  
When the servers are run or stopped you will be challenged by your firewall always '''''ALLOW ACCESS''''' to the Internet even when running the servers locally for development.  
+
When the servers are run or stopped you will be challenged by your firewall: always '''''ALLOW ACCESS''''' to the Internet even when running the servers locally for development.  
  
 
'''''Note 2'':'''
 
'''''Note 2'':'''
  
The Web root folder '''H)''' UniServer\'''www''' contains example pages (intro page). With the exception of file '''.htaccess''' delete its content and copy your Web site (folders and pages) to this folder. To view your web site run the servers and type '''<nowiki>http://localhost</nowiki>''' into your browser.
+
The Web root folder '''H)''' UniServer\'''www''' contains example pages (intro page). With the exception of file '''.htaccess''', delete its content and copy your Web site (folders and pages) to this folder. To view your web site, run the servers and type '''<nowiki>http://localhost</nowiki>''' into your browser.
  
 
'''''Note 3'':'''
 
'''''Note 3'':'''
  
The server is fully portable for example copy folder '''UniServer''' '''A)''' and all it's content to a USB stick and run the servers from there.
+
The server is fully portable. For example, copy folder '''UniServer''' '''A)''' and all its content to a USB stick and run the servers from there.
  
 
'''''Note 4'':'''
 
'''''Note 4'':'''
  
Run as a service, at step 5 right click and use the top menu to install and run as a service. Use the second menu item to stop and uninstall services.
+
Run as a service. At step 5, '''right''' click and use the top menu to install and run as a service. Use the second menu item to stop and uninstall services.
 
|
 
|
 
[[Image:Structure_nano_1.gif]]
 
[[Image:Structure_nano_1.gif]]
Line 55: Line 57:
  
 
'''''[[#top | Top]]'''''
 
'''''[[#top | Top]]'''''
=== Put Server on-line ===
+
=== Putting the Server on-line ===
To allow '''Internet''' or Intranet access edit file '''.htaccess''' located in the root folder '''www''' '''H)''':  
+
To allow '''Internet''' or Intranet access, edit file '''.htaccess''' located in the root folder '''www''' '''H)''':  
 
{|
 
{|
 
|-
 
|-
Line 78: Line 80:
 
'''''Note 1'':'''
 
'''''Note 1'':'''
  
After saving the file no need to restart server, changes are automatically picked-up by Apache, your servers are now on-line.
+
After saving the file, there's no need to restart server. Changes are automatically picked-up by Apache, and your servers are now on-line.
  
 
'''''Note 2'':'''
 
'''''Note 2'':'''
  
The Secure Web root folder '''D)''' UniServer\'''ssl''' contains example pages that will be encrypted when served. With the exception of file '''.htaccess''' delete its content and copy your Secure Web site (folders and pages) to this folder. You need to enable SSL for pages to be served from this folder.
+
The Secure Web root folder '''D)''' UniServer\'''ssl''' contains example pages that will be encrypted when served. With the exception of file '''.htaccess''', delete its content and copy your Secure Web site (folders and pages) to this folder. You need to [[5.0-Nano:_Install_and_Run#Enable_SSL|enable SSL]] for pages to be served from this folder.
 +
 
  
 
'''''Note 3'':'''
 
'''''Note 3'':'''
  
If you experience difficulties in accessing your server from the Internet check out [[5.0-Nano: Known Issues#Server not accessible from Internet | '''this section''']].
+
If you experience difficulties in accessing your server from the Internet, check out [[5.0-Nano: Known Issues#Server not accessible from Internet | '''this section''']].
  
 
Also check out the [[5.0-Nano: DtDNS | '''DtDNS page''']] for a free domain name and how to resolve a dynamic IP address.
 
Also check out the [[5.0-Nano: DtDNS | '''DtDNS page''']] for a free domain name and how to resolve a dynamic IP address.
Line 93: Line 96:
  
 
=== Enable SSL ===
 
=== Enable SSL ===
Before serving encrypted pages the server requires a certificate and key. These are created by running a script as follows:
+
Before serving encrypted pages, the server requires a certificate and key. These are created by running a script as follows:
  
'''left click tray icon > Advanced > click "Server Certificate and Key Generator"'''  
+
'''Left click tray icon > Advanced > click "Server Certificate and Key Generator"'''  
  
* You are prompted for three pieces of information (CN, OU and O) press enter to accept the defaults.
+
* You are prompted for three pieces of information (CN, OU and O); press enter to accept the defaults.
* For Apache to pick-up the new configuration '''Restart the servers'''  
+
* For Apache to pick-up the new configuration, '''Restart the servers'''  
  
To view your secure web site run the servers and type '''<nowiki>https://localhost</nowiki>''' into your browser.
+
To view your secure web site, run the servers and type '''<nowiki>https://localhost</nowiki>''' into your browser.
  
 
'''''Note'':''' The script can also be run from Apanel.
 
'''''Note'':''' The script can also be run from Apanel.
Line 106: Line 109:
 
'''''[[#top | Top]]'''''
 
'''''[[#top | Top]]'''''
  
=== Put SSL Server on-line ===
+
=== Putting the SSL Server on-line ===
To allow '''Internet''' or Intranet access edit file '''.htaccess''' located in the SSL root folder '''D)''':  
+
To allow '''Internet''' or Intranet access, edit file '''.htaccess''' located in the SSL root folder '''D)''':  
  
 
UniServer\ssl\'''.htaccess'''
 
UniServer\ssl\'''.htaccess'''
Line 132: Line 135:
  
 
== Move Servers ==
 
== Move Servers ==
One of Uniform Server’s unique features is the capability to run more than one complete server on the same PC. When running a server from a USB memory stick you can use this to great advantage and prevent server clashes. You will have noticed UniTray’s icon displays one (meaning standard ports). Moving UniServer increments this digit and so on for each server move. In reality it’s not just a port change but a complete server update, running '''server status''' displays the server characteristics.  
+
One of Uniform Server’s unique features is the capability to run more than one complete server on the same PC. When running a server from a USB memory stick, you can use this to great advantage and prevent server clashes. You will have noticed UniTray’s icon displays one (meaning standard ports). Moving UniServer increments this digit and so on for each server move. In reality, it’s not just a port change but a complete server update. Running '''server status''' displays the server characteristics.  
  
 
'''''Move Servers'':'''   
 
'''''Move Servers'':'''   
 
# '''Stop all''' running Uniform Servers
 
# '''Stop all''' running Uniform Servers
# Start UniTray, in folder UniServer double click on '''Start.exe''' tray icon created.
+
# Start UniTray: In folder UniServer, double click on '''Start.exe''' creating the tray icon.
# Move servers, Left click '''tray icon > Advanced > click Move Servers multi-server operation'''.
+
# Move servers: Left click '''tray icon > Advanced > click Move Servers multi-server operation'''.
 
# In the pop-up window at '''all''' prompts '''press enter''' to accept defaults.
 
# In the pop-up window at '''all''' prompts '''press enter''' to accept defaults.
 
# The tray icon will display 2, if you already use a server with this number '''repeat steps 3 and 4''' each server must have a '''unique number'''.
 
# The tray icon will display 2, if you already use a server with this number '''repeat steps 3 and 4''' each server must have a '''unique number'''.
Line 145: Line 148:
  
  
First time you move the servers ports will have the following values, Apache port = 81 and MySQL port = 3307
+
The first time you move the servers, the ports will have the following values: Apache port = 81 and MySQL port = 3307
  
* Hence to access the index page add port as shown: '''<nowiki>http://localhost:81/</nowiki>'''
+
* To access the index page, add the port as shown: '''<nowiki>http://localhost:81/</nowiki>'''
* When installing new scripts, MySQL server name will be: '''localhost:3307'''
+
* When installing new scripts, MySQL server host will be: '''localhost:3307'''
  
  
Confused! No problem take a look at these two pages they provide real applications and hopefully will clarify any issues:
+
Confused? No problem. Take a look at these two pages. They provide real applications and hopefully will clarify any issues:
  
 
* [[Installing Joomla on 5.0-Nano | Installing Joomla]]
 
* [[Installing Joomla on 5.0-Nano | Installing Joomla]]
Line 158: Line 161:
 
'''''[[#top | Top]]'''''
 
'''''[[#top | Top]]'''''
 
== Web Root Folders ==
 
== Web Root Folders ==
There are two Web Root folders “www” and “ssl” Folder www is where you place your web site, pages served from this folder are not encrypted.  Any sites or pages you want served encrypted are placed in folder ssl.
+
There are two Web Root folders, “www” and “ssl”. Folder www is where you place your regular web site. Pages served from this folder are not encrypted.  Any sites or pages you want served encrypted are placed in folder ssl.
  
 
* '''www''' uses standard port 80 (on Unix systems this folder is generally named '''htdocs''')
 
* '''www''' uses standard port 80 (on Unix systems this folder is generally named '''htdocs''')
Line 169: Line 172:
  
 
# [[Home Web Server: Install | Home Web Server]] - Provides details for running a server
 
# [[Home Web Server: Install | Home Web Server]] - Provides details for running a server
# [[New Users: Quick Install Guide 3.5 | Quick Install Guide 3.5]] - Worth a read
+
# [[New Users: Quick Install Guide|Quick Install Guide]] - Worth a read
  
 
'''''[[#top | Top]]'''''
 
'''''[[#top | Top]]'''''
 
== Summary ==
 
== Summary ==
Although UniServer has significantly changed it remains easy to use.
+
Although UniServer has significantly changed, it still remains easy to use.
  
 
A central control architecture reduces complexity and adds more flexibility.
 
A central control architecture reduces complexity and adds more flexibility.

Revision as of 14:31, 27 November 2009

 

5.0-Nano Installation and run guide

Uniform Server 5.0-Nano has a single installation option: extract to any folder, and two operation modes, either as a standard program or service.

Portability is nothing more complex than copying folder UniServer to where you want to run the servers. That includes any hard drive or USB memory stick.

Can’t run UniServer because it clashes with an existing server? Three mouse clicks and a few key presses reconfigures the server allowing it to coexist with an existing host server.

Uniform Server tries not to impose any restrictions, hence has numerous user configurable features allowing you to tailor the servers. This page explores some of these after first covering the basics.

Download

Download Uniform Server 5.*-Nano from Sourceforge choose either UniServer5_*.exe or UniServer5_*.zip. The .exe is a self-extracting 7-zip archive, and is much smaller.

For 5.0, 5.1, 5.2 and 5.3 there are two parallel versions, the main difference being the version of PHP:

  • UniServer5_0.exe or UniServer5_0.zip - PHP 5.2.10
  • UniServer5_1.exe or UniServer5_1.zip - PHP 5.3.0
  • UniServer5_2.exe or UniServer5_2.zip - PHP 5.2.11 --- New See supplementary section for details
  • UniServer5_3.exe or UniServer5_3.zip - PHP 5.3.0  --- New See supplementary section for details.

Version 5.4 has dropped this to go only with PHP 5.3.1.

Top

Quick Start

Install and run:

  1. Save UniServer5_*.exe to any folder.
  2. Double click UniServer5_*.exe. It's a self-extracting archive and unpacks to the current folder (where you saved the file).
    Note: The exe does not install anything to the registry or other areas of a PC. It just creates folder UniServer and extracts all folders and files to this folder.
  3. Navigate to folder UniServer A).
  4. Run (double click on) Start.exe. This starts Unitray.
  5. Left click on the tray icon, and click on Start UniServer (top menu), which starts both Apache and MySQL servers.
  6. If not already running, your browser will automatically start and display Intro page.
  7. Stop the servers. Left click on the tray icon, and click on Stop UniServer (second menu item).

Note 1:

When the servers are run or stopped you will be challenged by your firewall: always ALLOW ACCESS to the Internet even when running the servers locally for development.

Note 2:

The Web root folder H) UniServer\www contains example pages (intro page). With the exception of file .htaccess, delete its content and copy your Web site (folders and pages) to this folder. To view your web site, run the servers and type http://localhost into your browser.

Note 3:

The server is fully portable. For example, copy folder UniServer A) and all its content to a USB stick and run the servers from there.

Note 4:

Run as a service. At step 5, right click and use the top menu to install and run as a service. Use the second menu item to stop and uninstall services.

Structure nano 1.gif

Top

Putting the Server on-line

To allow Internet or Intranet access, edit file .htaccess located in the root folder www H):

1) Locate these lines:    2) Disable local only access by commenting each line with an hash "#" as shown
Order Deny,Allow
Deny from all
Allow from 127.0.0.1

 

#Order Deny,Allow
#Deny from all
#Allow from 127.0.0.1

Note 1:

After saving the file, there's no need to restart server. Changes are automatically picked-up by Apache, and your servers are now on-line.

Note 2:

The Secure Web root folder D) UniServer\ssl contains example pages that will be encrypted when served. With the exception of file .htaccess, delete its content and copy your Secure Web site (folders and pages) to this folder. You need to enable SSL for pages to be served from this folder.


Note 3:

If you experience difficulties in accessing your server from the Internet, check out this section.

Also check out the DtDNS page for a free domain name and how to resolve a dynamic IP address.

Top

Enable SSL

Before serving encrypted pages, the server requires a certificate and key. These are created by running a script as follows:

Left click tray icon > Advanced > click "Server Certificate and Key Generator"

  • You are prompted for three pieces of information (CN, OU and O); press enter to accept the defaults.
  • For Apache to pick-up the new configuration, Restart the servers

To view your secure web site, run the servers and type https://localhost into your browser.

Note: The script can also be run from Apanel.

Top

Putting the SSL Server on-line

To allow Internet or Intranet access, edit file .htaccess located in the SSL root folder D):

UniServer\ssl\.htaccess

1) Locate these lines:    2) Disable local only access by commenting each line with an hash "#" as shown
Order Deny,Allow
Deny from all
Allow from 127.0.0.1

 

#Order Deny,Allow
#Deny from all
#Allow from 127.0.0.1

Top

Move Servers

One of Uniform Server’s unique features is the capability to run more than one complete server on the same PC. When running a server from a USB memory stick, you can use this to great advantage and prevent server clashes. You will have noticed UniTray’s icon displays one (meaning standard ports). Moving UniServer increments this digit and so on for each server move. In reality, it’s not just a port change but a complete server update. Running server status displays the server characteristics.

Move Servers:

  1. Stop all running Uniform Servers
  2. Start UniTray: In folder UniServer, double click on Start.exe creating the tray icon.
  3. Move servers: Left click tray icon > Advanced > click Move Servers multi-server operation.
  4. In the pop-up window at all prompts press enter to accept defaults.
  5. The tray icon will display 2, if you already use a server with this number repeat steps 3 and 4 each server must have a unique number.
  • After moving the servers you need to use the new ports to either access server pages or to install new scripts.
  • To find these: Left click tray icon > Server Status


The first time you move the servers, the ports will have the following values: Apache port = 81 and MySQL port = 3307

  • To access the index page, add the port as shown: http://localhost:81/
  • When installing new scripts, MySQL server host will be: localhost:3307


Confused? No problem. Take a look at these two pages. They provide real applications and hopefully will clarify any issues:

Top

Web Root Folders

There are two Web Root folders, “www” and “ssl”. Folder www is where you place your regular web site. Pages served from this folder are not encrypted. Any sites or pages you want served encrypted are placed in folder ssl.

  • www uses standard port 80 (on Unix systems this folder is generally named htdocs)
  • ssl uses standard port 443

Note: Moving the servers increments these ports, invalid ports are skipped

Top

Related Information

  1. Home Web Server - Provides details for running a server
  2. Quick Install Guide - Worth a read

Top

Summary

Although UniServer has significantly changed, it still remains easy to use.

A central control architecture reduces complexity and adds more flexibility.

This flexibility and control are covered on the next page Control and Alternative control.

Top