Setup

Union Admin is distributed as a .swf file that can be posted to a website for web access or run locally in standalone mode. Union Admin requires Flash Player 9 or higher.

Security Note
Union Admin sends Union Server's administration password over the internet in plain text. Hence, where maximum security is required, Union users should run Union Admin behind a firewall on a trusted network only.

Running Union Admin Locally

To run Union Admin locally, follow these steps:

  1. Download the version of Union Admin that matches your Union Server version (if the versions do not match, Union Admin will fail to connect).
  2. Unzip Union Admin. A folder containing Union Admin's .swf file will be created.
  3. Using one of the following two procedures, give Union Admin access to Union Server.
    • Option 1 (recommended). Add Union Admin to your list of Flash Player trusted locations:
      1. Visit Adobe's Flash Player Settings Manager.
      2. Under Global Security Settings>Always trust files in these locations, click Edit locations>Add location....
      3. Enter or browse to the folder that was created in Step 2, above.
      4. Click Confirm.

      —or—

    • Option 2 (discouraged). Configure Union Server to allow connections to your admin port from any domain:
      1. In Union Server's root directory, edit the file policy.xml.
      2. After the line that reads "<cross-domain-policy>", add the following <allow-access-from> tag:
        <allow-access-from domain="*" to-ports="9110" />
      3. If your Union Server's administration port is not 9110, replace 9110 in the preceding code with your actual administration port. Union Server's administration port is specified in the file union.xml, found in Union Server's root directory.
      4. Save policy.xml.
      5. Wait 30 seconds for Union Server to refresh policy.xml.

      Warning: Allowing connections to your admin port from any domain, as described in the preceding procedure, is discouraged because it enables any .swf file on any website to connect to your admin port.

  4. Open Union Admin's .swf file in the standalone version of Flash Player, or in a web browser with Flash Player installed.
  5. In Union Admin's Login dialog, enter your server's domain, admin port, and password.
    Note that Union Server's admin port is not the same as Union's main port. Union Server's admin port and password are specified in the file union.xml, found in Union Server's root directory. By default, Union Server's admin port is 9110.

Running Union Admin On a Website

To run Union Admin on a website, follow these steps:

  1. Download the version of Union Admin that matches your Union Server version (if the versions do not match, Union Admin will fail to connect).
  2. Unzip Union Admin. A folder containing Union Admin's .swf file will be created.
  3. Upload Union Admin's .swf to your website.
  4. Add your Union Admin web server domain and your Union Server admin port to your Union Server's policy.xml file. For example, if you posted UnionAdmin.swf on example.com, and your Union Server admin port is 9110, you would update policy.xml as follows:
    1. In Union Server's root directory, edit the file policy.xml.
    2. After the line that reads "<cross-domain-policy>", add the following <allow-access-from> tag:
      <allow-access-from domain="example.com" to-ports="9110" />
    3. Save policy.xml.
    4. Wait 30 seconds for Union Server to refresh policy.xml.
  5. In a web browser, navigate to the URL you selected for Union Admin's .swf file in Step 3, above.
  6. In Union Admin's Login dialog, enter your server's domain, admin port, and password.
    Note that Union Server's admin port is not the same as Union's main port. Union Server's admin port and password are specified in the file union.xml, found in Union Server's root directory. By default, Union Server's admin port is 9110.