Z controller Introduction

From The Uniform Server Wiki
Revision as of 16:17, 17 October 2012 by Olajideolaolorun (talk | contribs) (Text replace - "projects/uniformserver" to "projects/miniserver")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Uniform Server 5.6-Nano.


Z-Controller is an alternative controller for Uniform Server 5.6-Nano. It incorporates features from UniTray and Apanel with a user interface similar to UniController.

Z-Controller is a self-contained plugin that uses the WinBinder module. This module allows you to write powerful Windows application in PHP. Z-Controller consists of several PHP scripts easily modifiable allowing you to tailor it for your own specific requirements.

Z-Controller is aimed at both novice and professional users. Emphasise has been given to ease of use and accessibility of Uniform Servers main features. All configuration files are directly accessible removing that game of hunt the file.

Working Code

Real purpose of this plugin it provides working code complimenting following WinBinder tutorials.

Summary of features

  • Start and stop severs from a single tab
  • Single button click puts servers on-line
  • Easily configure server features


  • Install and run services from a single tab
  • Direct access to server configuration files
  • Provide user with feedback and hints.


Download and install

The plugin is installed (extracted) to Uniform Server's plugin folder.

You have two installation options as explained below, option one is the easier of the two:

Options 1

  1. Download file V56_ZCON_1.2.exe from SourceForge
  2. Save the file to folder UniServer
  3. To extract files, double click on file V56_ZCON_1.0.exe, no need to change the path.
  4. If you wish to save space delete V56_ZCON_1.2.exe

Options 2

  1. Download file V56_ZCON_1.2.zip from SourceForge
  2. Save to any folder (e.g. temp1)
  3. Extract files, navigate to folder V56_ZCON_1.2
  4. Copy file Z-CON.exe to folder UniServer
  5. Navigate to folder C:\temp1\V56_ZCON_1.2\plugins
  6. Copy folder zcon to Uniform Server's folder UniServer\plugins
  7. If you wish to save space delete temp1


  • Version 1.2 - Bug Fix
    • Incorrect Apache port used other than 80 window_passwords.inc.php - (Forum WufDog)
    • Incorrect Apache port used other than 443 window_passwords.inc.php
    • Same as above for file zcon.phpw
  • Version 1.1
    • Added MySQL tab
    • Now uses Uniform Server's PHP binaries
    • Size 175K
  • Version 1.0
    • Initial release
    • Plugin is independent of Uniform Server
    • Size 12.5M


Starting Z-Controller

Start Z-Controller by double clicking on Z-CON.exe

(Located in folder UniServer)

Initial run will check for ports in use and alert you accordingly. Either closedown the offending applications or move Uniform Server to different ports.


Start Uniform Server

With all those menu and tab options at first sight z-controller looks intimidating. In reality they are there only if you want to use a particular server feature.

Running Uniform Server is extremely easy just use the default tab (Program) and click appropriate buttons. From this tab you can start both servers or individually start a server Apache and or MySQL.

Program Tab

Both servers are run as a standard program meaning when you turn your PC off you need to restart the servers next time you switch your PC on.

  • Start All Starts both Apache and MySQL servers as a standard program
  • Start Apache Starts only the Apache server as a standard program
  • Start MySQL Starts only the MySQL server as a standard program

Top indicator flashes blue indicating servers are starting or stopping.

Indicators adjacent to each server button indicate server status:

  • Red Server not running. Green Server is running.


Initially greyed outs buttons become enabled when the servers start allowing you to access associated server features such as phpMyAdmin and view your web site.

No configuration is required just click and go. OK you will be nagged to set a MySQL password you can safely ignore this if you are running a test server.

I strongly recommend you set a new password, it stops the nagging and if you inadvertently put the server on-line you are safe.

Set MySQL password

Starting the MySQL server for the first time you are nagged to set a password.

A the MySQL nag prompt click Yes to set password.

This opens a server configuration pop-up form.

At the bottom of this form you will see a text field where you enter a new password.

Note: The current password is displayed (default root)

  • Enter a new password
  • Click Set MySQL password button

This updates MySQL server and password file. You can continue running the servers no need to restart.

Note: If you decided not to change the password at this time you can open the configuration at any time as follows:

  • Click Passwords from the drop down menu clck Set MySQL Password


If this is a production server expect it to be blown away if that password remains as “root”

Put Servers On-line

For security Uniform Server is locked down allowing only local access.

If you wish other users to view your web site from either an Intranet or the Internet you need to put your servers on-line.

This takes just two mouse clicks as follows:

  • Click File from the drop down menu click Put www On-line

This opens a new window (see image on right) it is displayed for confirmation purposes.

To the right of section "SERVER ROOT WWW" you will see On-Line Access (second line down) confirming server is on line.

Click cross top right to close the window. OK so it was three mouse clicks.


Where to put your web site pages

Copy your web site (folders, pages, images and css etc) to the root folder UniServer\www

This folder already contains some files and folders with the exception of file .htaccess these can safely deleted.

File .htaccess is where local and remote access is switched, in addition you can set a name and password to restrict access (covered later).

Pages you wished to be encrypted are placed in the ssl root folder UniServer\ssl

To run a secure server (serve encrypted pages) requires you enable additional server features (covered later)



The above shows how easy it is to run Uniform Server using Z-Controller.

For a test server there is no configuration required (assuming it is the only server running on your PC) running the servers requires only a few mouse clicks.

Remainder of this series shows how to enable additional Uniform Server features. Main features are accessible via individual tabs each tab groups associated controls and indicators with that feature.

Some features are duplicated on the top row of drop-down menus this provides quicker access.

Next page provides a tour of all tabs, where appropriate Wiki links are included taking you to a more detailed description of a particular function or feature.