Unicon: Install: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
(New page: {{Uc nav Unicon}} '''Unicon how to install''' Unicon like Uniform Server is very flexible the following provides download and installation information. == Download == Use the following l...)
(No difference)

Revision as of 17:05, 23 November 2008

MPG UniCenter

MPG UniCenter

Unicon

Unicon how to install

Unicon like Uniform Server is very flexible the following provides download and installation information.

Download

Use the following link to download file unicon_project.exe this is a self-extracting archive file.

MD5: 4a30bf5e3496052dfb3ae649660a5f0d

Size: 170K

Extract

After downloading unicon_project.exe save to any folder double click to extract the files.

Files are listed below:

unicon.exe -– Main program
unicon.c -- Source
Logo.bmp -– image displayed in program
uslogo.ico – icon image
autorun.inf – USB auto run
unicon.ini -- Example for multi-servers

Top

Installation - basic

The utility is self-contained hence installation is just a matter of copying unicon.exe to Uniform Server 3.5’s folder “Uniform Server” if you wish delete

Server_Start.bat,
Stop.bat,
UniController.exe
Disk Start.vbs

unicon.exe does not use these files.

Top

Installation – USB (virtual drive)

Extract Uniform Server 3.5 to a USB stick (top level of USB stick) copy unicon.exe to Uniform Server 3.5’s folder “Uniform Server” run the servers by double clicking on unicon.exe.

Note: You can install Uniform Server in any folder the default operation is to create a virtual drive where the servers are run from making it location independent.

Top

Installation – USB autorun

Install Uniform Server and unicon.exe as above. Copy autorun.inf and uslogo.ico to the root (toplevel) of your USB memory stick. Autorun.inf contains the following lines of code:

[autorun]
open=Uniform_Server\unicon.exe
action=Run Unicon
icon=uslogo.ico

Autorun fails if the path to unicon.exe contains any spaces hence rename folder “Uniform Server” to “Uniform_Server” I have replaced the space with an underscore.

The folder name apart from it must not contain spaces is unimportant remember to change autorun.inf to match the name you use.

Remove and re-insert USB stick (always use Safely Remove Hardware). A pop-up is displayed “What do you want Windows to do” the action “Run Unicon” is automatically selected click OK to run. Note you can change this action name “Run Unicon” in autorun.inf, it can be anything you prefer. Similarly use your own icon.

Note: If you installed Uniform Server in a sub-folder make sure the path to unicon.exe includes this sub-folder.

Top

Installation – USB (no virtual drive)

With the exception of start and stop batch files Uniform Server's core uses relative paths. This means you can run the servers from a hard disk or USB sticks root (top level)

To achieve this extract Uniform Server 3.5 to any folder of your choice. Copy the entire contents of folder "udrive" to the top-level of either a hard drive or USB stick.

Also copy unicon.exe to the top-level (it auto tracks hence requires no changes) however if you want to control the servers using batch files copy hdusb_server_start.bat and hdusb_server_stop.bat refer to this page for details Additional batch files.

Note: If using the above auto run file change the path accordingly will look like this:

[autorun]
open=unicon.exe
action=Run Unicon
icon=uslogo.ico

Top

Installation – Multi-Servers

Running more than a single instance of Uniform Server requires changing the standard port for Apache and MySQL and changing Apache’s executable name to something unique.

I have split this section into two parts the first is a general method and does not use Unicon. The second part assumes you will use only Unicon to control the servers.

If you wish combine both methods this allows total control meaning you can use either the batch files or Unicon.

Top

Installation – Multi-Servers without Unicon

Uniform Server 3.5 is very flexible and easily modified to run more than one instance.

US 3.5 defaults: Drive W Apache port 80 MySQL port 3306

The following example shows how to change these to give a server with the following values:

Drive Z - Apache port 8080 - MySQL port 3308

1) Move server to port 8080

Edit File \udrive\usr\local\apache2\conf \ httpd.conf Change three occurrences (lines 125, 266 and 971) of 80 to 8080

Original

Listen 80                       ------- (line 125)
ServerName localhost:80         ------- (line 266)
<VirtualHost *>
	ServerName localhost:80 ---- (line 971)
	DocumentRoot /www
</VirtualHost>

New

Listen 8080
ServerName localhost:8080
<VirtualHost *>
	ServerName localhost:8080
	DocumentRoot /www
</VirtualHost

2) Move MySQL Port from 3306 to 3308:

Edit File \udrive\usr\local\mysql\bin\my-small

Change two occurrences (lines 9 and 18) of 3306 to 3308

3) Edit file: \udrive\home\admin\www\phpMyAdmin\config.inc.php

Change (line 38) cfg['Servers'][$i]['port'] = ; // MySQL port - leave blank for default port

To:

cfg['Servers'][$i]['port'] = '3308'; // MySQL port - leave blank for default port

4) Edit file: \udrive\home\admin\program\Close.bat

Change:

%Disk%:\usr\local\mysql\bin\mysqladmin.exe --character-sets-dir="/usr/local/mysql/share/charsets/" --user=root --password=root shutdown

To:

%Disk%:\usr\local\mysql\bin\mysqladmin.exe --character-sets-dir="/usr/local/mysql/share/charsets/" --port=3308 --user=root --password=root shutdown

5) Rename Apache file

From:

\udrive\usr\local\apache2\bin\Apache.exe

to:

\udrive\usr\local\apache2\bin\Apache_new.exe

Note: Apache_new can be any name however it must be unique

6) Edit file: Stop.bat

Change:

udrive\home\admin\program\pskill.exe Apache.exe c

To:

udrive\home\admin\program\pskill.exe Apache_new.exe c

7) Edit file: Server_Start.bat

Replace two occurrences (lines 13 and 28) of Apache.exe with Apache_new.exe

Replace line: if "%Disk%"=="" set Disk=w With: if "%Disk%"=="" set Disk=z

That’s it you can run this alongside the original US 3.5 and any mini-servers.

Note: If you use phpMyBackupPro click the configuration link

Change MySQL hostname* From: localhost To: localhost:3308

Top

Installation – Multi-Servers with Unicon

Using only the Unicon server control, changes required are reduced. For consistency I will use the port configuration as above. An additional file is required as explained below.

US 3.5 defaults:

Drive W - Apache port 80 - MySQL port 3306

The following shows how to change these and give a server with the following values:

Drive auto detection - Apache port 8080 - MySQL port 3308

1) Move server to port 8080

Edit File \udrive\usr\local\apache2\conf \ httpd.conf

Change three occurrences (lines 125, 266 and 971) of 80 to 8080

Original
Listen 80                        ------- (line 125)
ServerName localhost:80          ------- (line 266)
<VirtualHost *>
	ServerName localhost:80  ---- (line 971)
	DocumentRoot /www
</VirtualHost>

New

Listen 8080
ServerName localhost:8080
<VirtualHost *>
	ServerName localhost:8080
	DocumentRoot /www
</VirtualHost

2) Move MySQL Port from 3306 to 3308:

Edit File \udrive\usr\local\mysql\bin\my-small

Change two occurrences (lines 9 and 18) of 3306 to 3308

3) Edit file: \udrive\home\admin\www\phpMyAdmin\config.inc.php

Change (line 38)

cfg['Servers'][$i]['port'] = ; // MySQL port - leave blank for default port

To:

cfg['Servers'][$i]['port'] = '3308'; // MySQL port - leave blank for default port

4) Rename Apache file

From:

\udrive\usr\local\apache2\bin\Apache.exe

to:

\udrive\usr\local\apache2\bin\Apache_new.exe

Note: Apache_new can be any name however it must be unique

5) Create a configuration file

Unicon needs to pick-up the new Apache file name create a new text file unicon.ini with the following content:

[APACHE]
apache_exe=Apache_new.exe

Save this file to folder: \udrive\usr\local\apache2\bin

When Unicon is run it checks for the existence of file unicon.ini and picks up the new Apache file name, if file does not exist uses default name Apache.exe.

Top

Summary

A single instance of Uniform Server copy Unicon.exe to folder “Uniform Server” and run. Same for running on a USB stick when using autorun remember to rename folder “Uniform Server”. Running multi-instance of Uniform Server requires a few manual changes nothing overly complex.

If the utility does not meet your requirements next page covers installing source code on lcc-win32 where you can modify and recompile the code.

Top


Ric