5.0-Nano: Install and Run

From The Uniform Server Wiki
Revision as of 21:52, 14 August 2009 by Ric (talk | contribs) (New page: {{Nav 5.0-Nano}} '''''5.0-Nano Installation and run guide''''' With the release of 5.0-Nano you have a single installation option and two operation modes. Unpack and run either as a stand...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

 

5.0-Nano Installation and run guide

With the release of 5.0-Nano you have a single installation option and two operation modes. Unpack and run either as a standard program or service respectively.

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.0-Nano from Sourceforge choose either UniServer5_0.exe or UniServer5_0.zip

Top

Quick Start

Install and run:

  1. Save UniServer5_0.exe to any folder
  2. Double click UniServer5_0.exe its a self-extracting archive and unpacks to the
    current folder (where you saved the file).
  3. Navigate to folder UniServer A)
  4. Run (doube click on) Start.exe this starts Unitray.
  5. Left click on the tray icon, and click on Start UniServer (top menu)
  6. Starts both Apache and MySQL servers
  7. If not already running your browser will automatically start and display Intro page
  8. 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 it's 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.

Top

Put 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 no need to restart server, changes are automatically picked-up by Apache, 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.

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

Put 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 tray icon created.
  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


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

  • Hence to access the index page add port as shown: http://localhost:81/
  • When installing new scripts, MySQL server name 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 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 3.5 - Worth a read

Top

Summary

Although UniServer has significantly changed it remains easy to use. Central control architecture reduces complexity and adds more flexibility this can be seen on the next page alternative control.

Top