Standalone Servers

Uniform Server Zero's modular architecture allows each server (Apache and MySQL) to be run independently of the main WAMP server. This requires renaming the server and controller executables. Optionally, moving servers to different ports allows you to run these servers alongside The Uniform Server Zero and IIS. This page details the changes required.

Apache

You can run Apache as an independent server running on standard ports. Alternatively, run independently on none-standard ports, catering for a multiserver environment. The following details configuration and modifications required.

Apache preliminary

Create individual Apache server as follows:

1. Create a new folder C:\New_UniServer2
2. Download and save the latest controller file (ZeroXV_unicontroller_x_x_x.exe) to folder New_UniServer2
3. The file is a self-extracting archive; double-click on above file to run the extractor.
4. A new folder C:\New_UniServer2\UniServerZ is created containing the controller application UniController.exe and support folders and files.
5. Download the following plugins and save to folder C:\New_UniServer2\UniServerZ
      ◦ ZeroXV_apache_x_x_x.exe - Apache server
6. For installation, double-click the plugin file to run the extractor.
7. If prompted, allow overwriting of existing files.
8. If you wish, delete the installation files; they are no longer required.

Apache Change controller name

You cannot run two instances of UniController.exe; the executable name must be unique.

• Rename file C:\New_UniServer2\UniServerZ\UniController.exe to C:\New_UniServer2\UniServerZ\UniController2.exe
     ◦ Note: You can use a different name so long as the name is unique and has the file extension .exe

Apache Change Icon

To distinguish between server instances, the tray icon requires changing.
The following parameters in configuration file C:\New_UniServer2\UniServerZ\home\us_config\us_config.ini allow you to change icon and hover text:

• ServerType - Set Server type (Valid values APS0 to APS3 sets icon. For this example, use APS1)
• ServerTypeText1 - First line of hover text (For this example, use Uniform Server Portable)
• ServerTypeText2 - Second line of over text (For this example, use Apache Standalone server 1)

Icons are shown below: From left to right: APS0, APS1, APS2 and APS3

Change Apache server executable

To avoid conflicts when running multi-servers requires the Apache executable to be renamed.

• Navigate to folder C:\New_UniServer2\UniServerZ\core\apache2\bin
• Rename Apache executable file from httpd_z.exe to httpd_z2.exe
     ◦ The file name must start with httpd_ followed by any unique string and terminated with file extension .exe
     ◦ For convenience, it is easier just to increment the digit.

Change Apache server ports:

To avoid conflicts when running multi-servers requires the Apache server ports to be changed. If this is the only instance of Apache, skip port change and allow server to run on default standard port.

• Start UniController2.exe
• Change standard port from 80 to 82:
     ◦ Apache > Change Apache ports > Change Apache port
     ◦ Enter 82 and click OK
     ◦ Note: Again, it is easier just to increment. However, you can enter a different, unique port.
• Change ssl port from 443 to 445:
     ◦ Apache > Change Apache ports > Change Apache SSL port
     ◦ Enter 445 and click OK
     ◦ Note: Again, it is easier just to increment. However, you can enter a different, unique port.

MySQL

You can run MySQL as an independent server running on standard ports. Alternatively, run independently on none-standard ports, catering for a multiserver environment. The following details configuration and modifications required.

MySQL preliminary

Create individual MySQL server as follows:

1. Create a new folder c:\New_UniServer3
2. Download and save the latest controller file (ZeroXV_unicontroller_x_x_x.exe) to folder New_UniServer3
3. The file is a self-extracting archive; double-click on above file to run the extractor.
4. A new folder C:\New_UniServer3\UniServerZ is created containing the controller application UniController.exe and support folders and files.
5. Download the following plugin and save to folder C:\New_UniServer3\UniServerZ
      ◦ ZeroXV_mysql_x_x_x.exe - MySQL server
6. For installation, double-click the plugin file to run the extractor.
7. If prompted, allow overwriting of existing files.
8. If you wish, delete the installation files; they are no longer required.

MySQL Change controller name

You cannot run two instances of UniController.exe; the executable name must be unique.

• Rename file C:\New_UniServer3\UniServerZ\UniController.exe to C:\New_UniServer3\UniServerZ\UniController3.exe
     ◦ Note: You can use a different name so long as the name is unique and has the file extension .exe

MySQL Change Icon

To distinguish between server instances, the tray icon requires changing.
The following parameters in configuration file C:\New_UniServer3\UniServerZ\home\us_config\us_config.ini allow you to change icon and hover text:

• ServerType - Set Server type (Valid values MYS0 to MYS3 sets icon. For this example, use MYS1)
• ServerTypeText1 - First line of hover text (For this example, use Uniform Server Portable)
• ServerTypeText2 - Second line of over text (For this example, use MySQL Standalone server 1)

Icons are shown below: From left to right: MYS0, MYS1, MYS2 and MYS3

Change MySQL server executable

To avoid conflicts when running multi-servers requires the MySQL executable to be renamed.

• Navigate to folder C:\New_UniServer3\UniServerZ\core\mysql\bin
• Rename MySQL executable file from mysqld_z.exe to mysqld_z3.exe
     ◦ The file name must start with mysqld_ followed by any unique string and terminated with file extension .exe
     ◦ For convenience, it is easier just to increment the digit.

Change MySQL server port:

To avoid conflicts when running multi-servers requires the MySQL server port to be changed. If this is the only instance of MySQL, skip port change and allow server to run on default standard port.

• Start UniController3.exe
• Change standard port from 3306 to 3308:
     ◦ MySQL > Change MySQL port
     ◦ Enter 3308 and click OK
     ◦ Note: Again, it is easier just to increment. However, you can enter a different, unique port.

Summary

With the above modifications, you can run Apache and MySQL as separate servers.