Running Multiple Instances

Parent Previous

Last updated 7/15/2014

Requirements



Limitations



Notes


Steps


  1. Create a folder on your server as c:\a5\config.
  2. Create a folder also for c:\a5\logs.
  3. If not already installed, install one copy of Alpha Web Application Server.
  4. Fire up the server.
  5. Look in the "system tray" right-bottom side of the Desktop.
  6. Click on Configure Server and go through the licensing process under the Sessions tab -- make sure your server is properly licensed at this point.
  7. Go to the Logging tab and change all of the folder and names for all of the logs (even if you do not check to include the log.) Use this naming structure:
  1. Save and close the configuration dialog.
  2. Right-click on the red server icon again and select Interactive Window. Enlarge the window if necessary.
  3. Type "?a5_GetAppServerConfigFile()" in the Interactive Window. This will give you the path to the configuration file. Grab that full path (excluding the file name), and open the config file path.
  4. Copy the configuration file to c:\a5\config and rename it to Instance1.xml (or any other name such as "myapplication.xml").
  5. Make as many copies of this file as you need, one for each instance. Rename each to Instance2.xml, Instance3.xml, etc. or some other naming structure.
  6. Open each configuration file in turn and make the following edits (in order as they appear in the file):
  1. Save each xml file.


You should now have one XML file for each instance in the c:\a5\config folder.

Document Root


Using AlwaysUp


AlwaysUp is a 3rd party utility that runs the Alpha Web Server as a "Windows service". This means if your server reboots for any reason, the Alpha Web Server will start back up. There are alternatives to AlwaysUp such as the windows utility "srvany" but none provide the desirable extra features found in AlwaysUp.


  1. Start up AlwaysUp.
  2. Select Application > Add.
  3. Enter something like "My Application ABC" in the Name field, something to identify your application for this Instance.
  4. For the Application field, click the builder and go find your Alpha Five Web App Server EXE file, such as C:\Program Files (x86)\a5V12 ApplicationServer\A5ApplicationServer.exe.
  5. For the Arguments field, enter your Instance XML file in this format: -ConfigFile=C:\A5\Installs\instance1.xml
  6. Go to the Extras tab. You can set the Run the application on these CPU(s). But this is not supposed to be necessary, Alpha is supposed to spread instances across the available CPUs.
  7. Do that for all of your instances.
  8. There are other configuration settings you can make for AlwaysUp, but this minimal settings should suffice.
  9. Select Application > Start All (if not already started)


That's it. All of your instances should be running.


You need to complete the process by setting your DNS, etc.