Unicon: Install: Difference between revisions
(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
Unicon: Introduction | Install | Compile |
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 |
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.
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.
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.
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
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.
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
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.
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.
Ric |