unity

Unity Technote 00002: Upgrading to Unity Multiuser Server 2.0.3

Unity Multiuser Server 2.0.3 is now available as a free update to all Unity Multiuser Server owners. This update starts a policy file server by default, as required by Flash Player 9.0.124.0, and also includes a number of minor bug fixes (see the server change history).

How to upgrade

To upgrade your copy of Unity Multiuser Server, follow these steps:

1. Email unity@moock.org with the subject [UNITY UPGRADE]. Commercial-licence holders: please include your original Order ID. Non-commercial-license holders: please include your original licence-approval email. You will be issued download instructions.
2. Download the new software (.zip or .gz format).
3. Unpack the file you downloaded to the directory of your choice.
4. Configure Unity to serve a socket master policy file (see instructions) or a regular socket policy file (see instructions).
5. Start the server.

Optional steps for updating an existing installation

Customers who wish to upgrade to Unity Multiuser Server 2.0.3 without disrupting an existing installation should replace steps 3-5 in the preceding procedure with the following steps:

1. Unpack the the file you downloaded into a temporary location.
2. Copy the following files from the temporary directory to your existing installation directory:
   • /unity/lib/unity_core.jar
   • /unity/lib/unity_optional.jar
   • /unity/policy.xml
   • all script files (*.bat, *.sh) found in the /unity/ directory
3. In your existing installation directory, edit uconfig.xml.
4. Nested inside the existing <SERVER> tag, insert the following XML code. Change 9102 to the port on which you wish to serve policy files (for help deciding on a port, see Unity Technote 00001: Policy Files Now Mandatory).

   <SERVICE>
     <ID>PolicyFileService</ID>
     <CLASSNAME>org.moock.unity.opt.policyserver.PolicyServer</CLASSNAME>
     <ATTRIBUTES>
       <PORT>9102</PORT>
       <POLICY_FILE>policy.xml</POLICY_FILE>
     </ATTRIBUTES>
   </SERVICE>

5. Configure Unity to serve a socket master policy file (see instructions) or a regular socket policy file (see instructions).
6. Start the server.

Revision history

April 5, 2008: Posted