So rather than call the main ElectroServer app (which is just a shell script), I’m opening the ElectroServer jar file, and that way I can tell java how much memory to use (and other options) as parameters.

I’m pretty sure Java is installed somewhere on Media Temple (you need to install the dev tools) but I couldn’t find it anywhere! And if I just typed java it couldn’t find it. I even ran a find command, but it was nowhere! But then I realised that the Java runtime is packaged with ElectroServer in the jre folder!

So with a bit of fiddling I worked out that I could start ElectroServer with more memory by running the jar file, but I had to do it while in the server subfolder within the ES install.

../jre/bin/java -Xmx128M -jar lib/ElectroServer4-bootstrap.jar -mode StandAlone -config config/ES4Configuration.xml

where 128M is the amount of RAM made available.

[UPDATE]

There is a better way! Thanks to Paul Hayes (a colleague at Plug-in Media, see comments below) I have now realised that ElectroServer’s main app is nothing more than a shell script that you can edit. Furthermore there is a line you can uncomment right at the top to change the Java parameters :

# Uncomment the following line to add additional VM parameters
# INSTALL4J_ADD_VM_PARAMS=

Change this to :

# Uncomment the following line to add additional VM parameters
INSTALL4J_ADD_VM_PARAMS="-Xmx512m"

Where 512 is the amount of RAM in Mb you want ElectroServer to use.

Related posts:

1. Installing ElectroServer on Mac OSX
2. ElectroServer security sandbox violation error
3. Further adventures with ElectroServer


Error #2044: Unhandled securityError:. text=Error #2048: Security sandbox violation: http://sebleedelisle.com/games/moonlander/MoonLanderViewer.swf cannot load data from 72.47.193.154:9899.


I posted to the ElectroServer forums and quick as a flash, Teresa got back to me – apparently ElectroServer was running out of memory. But apparently that’s not surprising – all Java gives it is 64Mb by default! But before I could fix it I had to stop ElectroServer from running, which isn’t easy when it’s running in the background.

Earlier Teresa had told me how to do this.

First, find the process by typing :

ps -ef | grep java

For me, that return a whole bunch of junk! :

root 3492 3482 2 06:02 pts/0 00:00:09 /opt/ElectroServer_4_0_6/jre/bin/java -server -Dinstall4j.jvmDir=/opt/ElectroServer_4_0_6/jre -Dexe4j.moduleName=/opt/ElectroServer_4_0_6/ElectroServer -classpath /opt/ElectroServer_4_0_6/.install4j/i4jruntime.jar:/opt/ElectroServer_4_0_6/server/lib/ElectroServer4-bootstrap.jar com.install4j.runtime.Launcher launch com.electrotank.electroserver4.bootstrap.Main false false true true false true true 0 0 20 20 Arial 0,0,0 8 500 version 4.0.6 20 40 Arial 0,0,0 8 500 -1 -mode StandAlone
root 32208 1741 0 06:08 pts/0 00:00:00 grep java


But it’s actually only two processes, both starting with the word root (which is my current user name). The second process is the one that we just started by typing ps -ef | grep java and the first one is our ElectroServer, and that’s the one we have to kill. To do this we need the process id. I must admit I’m a bit confused why there are two numbers next to our process, 3492 and 3482. But I found that it worked for me using the first number.

kill -9 3492

But of course you’ll have to replace 3492 with whatever number you get. You can check it’s not running by typing ps -ef | grep java again, and this time you should no longer see the ElectroServer process :

root     32208  1741  0 06:08 pts/0    00:00:00 grep java

So now I’ve killed the server process, I can now give ElectroServer more RAM, thankfully there’s this useful post on the ElectroServer wiki. I must admit I found it quite confusing, but for my Media Temple installation I used the Instructions for Unix. These instructions show you how to create a shell script that starts the server with more RAM. I had some trouble getting it to work, but that was because the capitalisation was different so check that you’re typing ElectroServer with the right caps – Unix is fussy.

Now it seems to be working again, but let me know if you see any more issues.

[UPDATE] those instructions didn’t seem to work. See this post on how I actually added more memory to ElectroServer.

Related posts:

1. Giving ElectroServer more memory
2. Installing ElectroServer on MediaTemple
3. Installing ElectroServer on Mac OSX

Anyone playing my Lunar Lander game won’t know it, but we’re spying on them! The game gets around 20,000 hits a month, which is very roughly one a minute or so, so I thought it’d be the perfect vehicle to test out some real-time gaming techniques.

I’ve replaced the original game with one that transmits your position to ElectroServer, although you won’t notice any difference at all. The only way to see the all the current players is via the swf below :

The button in the top left makes it full screen. If all you can see is an empty landscape, it means that no one is playing. Usually someone will turn up within a couple of minutes, but if you can’t wait, then why not open the game in a new window and watch yourself playing?
The ElectroServer is no longer installed so sadly this won’t work any more!

At the moment it’s very very primitive. It’s just literally receiving the data and updating the visuals as it gets them, that’s why the movement is quite jerky, even despite the fact that there’s a little realtime easing on there. Of course, I’m going to have to get a lot more into this, comparing the timings with the server so I can adjust for any inconsistencies in data, and of course predicting where the players should be now, rather than where they were a few hundred mils ago.

But I still find it utterly compelling, and naturally I’ll be explaining all of this in my upcoming Flash game programming training courses.

Last night, I left it running (it draws the trails of anyone playing as they go) and this is the image I woke up to :

I can’t help but think that Jer Thorp would be proud of me

[UPDATE] due to popular request there is a high res version of this now on my Flickr page.

Related posts:

1. Lunar Lander 3D in 5K
2. Making a multi-track recorder in Flash
3. Making a multi-track recorder in Flash part 2

After some minor tweaks I got the Java extension compiled (the methods should not be marked @Override as the class isn’t extending anything) and tested them locally – all was fine.

So I uploaded them to the server and restarted but ElectroServer wouldn’t come back! There was a Java error message and it was just way beyond my capabilities to troubleshoot it. Thankfully, Teresa from ElectroServer checked the forum at 7.30am on a Sunday morning and responded to my plea for help! She assures me that she’s not usually so ultra-responsive but I have yet to see evidence of that! So far, the support I’ve got from Teresa is just phenomenal.

I never did quite get to the bottom of what happened, but I suspect it was a problem with a persistent room as I had been playing with those settings in the web admin interface (frankly without really knowing what I’m doing ) . But I fixed it by reinstalling ElectroServer with these instructions, and I was back where I started! I’m still working on getting chat logging done, but in the meantime I wanted to try something a little more interesting to me. There’s a tutorial on the ElectroServer wiki which extends the chat example and shows everyone’s mouse as they move it around!

And here’s what it looks like screen captured :

And here’s the actual app!

Again I’ve adapted it for Flex, and made some minor changes, including showing the username attached to the cursors. I’ve also changed how the easing works (with spring) and optimised it so it only broadcasts the mouse position when it changes, rather than every frame.

It’s really interesting to see how the updates come in and what that looks like – this is all good research into the next phase of these experiments – real time multiplayer gaming.

Download the Flex archive project source code for the Flex Chat with Cursors.

Related posts:

1. Installing ElectroServer on MediaTemple
2. ElectroServer Flex simple chat
3. Giving ElectroServer more memory

Here’s what it looks like, and it’s connecting to an ES4 install with only 20 connections so forgive me if you can’t connect :

Here’s the source:

<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" applicationComplete="init()" width="450" height="365">
 
<mx:Script>
	<![CDATA[
		import mx.utils.URLUtil;
		import com.electrotank.electroserver4.message.event.PublicMessageEvent;
		import com.electrotank.electroserver4.message.request.PublicMessageRequest;
		import com.electrotank.electroserver4.user.User;
		import com.electrotank.electroserver4.message.request.LoginRequest;
		import com.electrotank.electroserver4.room.Room;
		import com.electrotank.electroserver4.message.event.JoinRoomEvent;
		import com.electrotank.electroserver4.message.event.UserListUpdateEvent;
		import com.electrotank.electroserver4.message.request.CreateRoomRequest;
		import com.electrotank.electroserver4.message.response.LoginResponse;
		import com.electrotank.electroserver4.message.event.ConnectionEvent;
		import com.electrotank.electroserver4.message.MessageType;
		import com.electrotank.electroserver4.ElectroServer;
		import mx.rpc.events.FaultEvent;
		import mx.rpc.events.ResultEvent;
		import mx.controls.Alert;
 
		private var es : ElectroServer; 
		private var serverInfo : Object; 
		private var myRoom : Room; 
		[Bindable]
		private var users : Array; 
 
		public function init():void
		{
			// There MUST be a better way of getting the app's path than this! suggestions welcome. 
 
			var pathelements: Array = Application.application.url.split("/"); 
			pathelements[pathelements.length-1] = settings.url; 
			settings.url = pathelements.join("/"); 
 
			settings.send(); 
			users = []; 
		}
		public function sendMessage() : void
		{
 
			var msg:String = msg_text.text;
	  		if (msg != "") {
	  			msg_text.text = ""; 
				msg_text.setFocus(); 
 
	  			//create the request
	  			var pmr:PublicMessageRequest =new PublicMessageRequest();
	  			pmr.setRoomId(myRoom.getRoomId());
	  			pmr.setZoneId(myRoom.getZone().getZoneId());
	  			pmr.setMessage(msg);
 
	  			//send it
	  			es.send(pmr);
	  		}
 
 
 
		}
 
		public function onPublicMessageEvent(e:PublicMessageEvent):void 
	  	{
	  		var from:String = e.getUserName();
	  		var msg:String = e.getMessage();
 
	  		output(from+": "+msg);
 
	  	}		
 
		public function xmlLoaded(e : ResultEvent) : void
		{
 
			es = new ElectroServer(); 
			serverInfo = []; 
			for each (var lis:XML in e.result.Listener) {
				var protocol:String = lis.@protocol;
				var ip:String = lis.@ip;
				var port:Number = Number(lis.@port);
				serverInfo[protocol] = new Object();
				serverInfo[protocol].ip = ip;
				serverInfo[protocol].port = port;
			}
 
			es.addEventListener(MessageType.ConnectionEvent, "onConnectionEvent", this);
			es.addEventListener(MessageType.LoginResponse, "onLoginResponse", this);
			es.addEventListener(MessageType.JoinRoomEvent, "onJoinRoomEvent", this);
			es.addEventListener(MessageType.PublicMessageEvent, "onPublicMessageEvent", this);
			es.addEventListener(MessageType.UserListUpdateEvent, "onUserListUpdateEvent", this);
 
			//Create the connection
			output("Attempting connection with this ip/port combo: "+serverInfo.text.ip+":"+serverInfo.text.port);
			es.createConnection(serverInfo.text.ip, serverInfo.text.port);
 
		}
 
 
		public function onConnectionEvent(e:ConnectionEvent):void 
		{
			if (e.getAccepted()) {
				output("Connection accepted");
				var name:String = "user"+Math.round(10000*Math.random());
				output("Attempting to login as: "+name);
				//Build the LoginRequest and populate it
				var lr:LoginRequest = new LoginRequest();
				lr.setUserName(name);
				//send it
				es.send(lr);
			} else {
				output("Connection failed: "+e.getEsError().getDescription());
			}
		}
	 	public function onLoginResponse(e:LoginResponse):void 
	  	{
	  		if (e.getAccepted()) {
	  			output("Login accepted.");
	  			output("You are logged in as: "+e.getUserName());
	  			joinRoom();
	  		} else {
	  			output("Login failed: "+e.getEsError().getDescription());
	  		}
		}			
 
		private function joinRoom():void 
		{
		  	//tries to create a room. if it already exists, then you join that room
		  	//create the request
			var crr:CreateRoomRequest = new CreateRoomRequest();
			crr.setRoomName("MyRoom");
			crr.setZoneName("ZoneName");
			//send it
			es.send(crr);
		}	
 
		public function onJoinRoomEvent(e:JoinRoomEvent):void 
		{
			myRoom = e.room;
			showUserList();
		}
		public function onUserListUpdateEvent(e:UserListUpdateEvent) : void
  		{
  			showUserList();
  		}
 
		public function showUserList() : void
		{
			var userobjs : Array = myRoom.getUsers(); 
			users = [];
 
			for each(var user : User in userobjs)
			{
				users.push(user.getUserName()); 
			}
 
		}
 
		public function xmlLoadFailed(e : FaultEvent) : void
		{
			trace("failed"); 
		}
 
		public function output(msg : String) : void
		{
			chat_text.text += msg+"\n"; 
			chat_text.verticalScrollPosition = chat_text.maxVerticalScrollPosition;
		}
	]]>
</mx:Script>
 
	<mx:HTTPService 
	id="settings"
	url="./ServerSettings.xml" 
	resultFormat="e4x"
	result="xmlLoaded(event);"
	fault="xmlLoadFailed(event);"
	/>
 
	<mx:Model id="users_model">
      <users>
 
      </users>
    </mx:Model>
 
	<mx:Button x="386" y="333" label="Send" id="send_button" click="sendMessage()"/>
	<mx:TextInput x="10" y="333" width="368" id="msg_text" enter="sendMessage()"/>
	<mx:TextArea x="10" y="10" width="302" height="316" id="chat_text"/>
	<mx:List x="320" y="8" width="120" id="user_list" dataProvider="{users}" height="318"></mx:List>
 
</mx:Application>

This example also requires a ServerSettings.xml file that contains the server details, which if you’re running ElectroServer locally, should be :

 <Listeners>
       <Listener ip="127.0.0.1" port="9898" protocol="text" />
       <Listener ip="127.0.0.1" port="1935" protocol="rtmp" />
 </Listeners>

Download the MXML source code for the ElectroServer Flex Simple Chat.

I very rarely use Flex so please feel free to comment with improvements!

Particularly with how to load a file with a relative path in an HTTPService. It seems ridiculous that I have to specify a full path name, and the hack I’ve employed to extract the local path from the application URL is equally ridiculous. There must be a simpler method?

Related posts:

1. Further adventures with ElectroServer
2. Simple Flash 3D drawing API
3. Simple real-time easing in Flash & 3D panels

I had no problems following although there are a couple of bits that confused me. The first was that the download link didn’t work so I just found the Linux RPM link on the ElectroServer download pages and used that, which for the current version is :

wget http://electro-server.com/downloads/builds/ElectroServer_4_0_6_linux.rpm

The other thing that got me is that I put in the domain name into the ES4Configuration.xml which didn’t work. I should have put the ip address for the virtual server (which you should find in your Media Temple account or you could always just ping your domain from a terminal window).

Once I’d opened the ports and started the server running I tried to telnet in to port 9898 (the default chat port) but it was refused. So I edited the crossdomain.xml on the main webserver to include the IP address of my home internet connection and it seemed to be OK after that. (At least I think that’s what fixed it!).

So apart from a few minor hassles it was pretty seamless and only took me an hour or so. I must admit to feeling way out of my depth, this isn’t something I’m particularly expert on so please feel free to comment with further advice

Related posts:

1. Installing ElectroServer on Mac OSX
2. Further adventures with ElectroServer
3. Giving ElectroServer more memory

ES4 runs on Java 1.6 and OSX is shipped with 1.5. You can find instructions on getting the update here, but whatever you do don’t complete the steps to make 1.6 the default Java Virtual Machine (JVM), otherwise FlexBuilder won’t work any more!

Now you need to download the Unix package (the one marked “without JVM”) on the ElectroServer downloads page, and unzip it somewhere suitable (I put it in my documents folder).

Then open up a terminal window and navigate into the folder where you unzipped it. (Handy shortcut : type “cd” followed by a space and then drag the folder from the finder onto your terminal where the full path name will be inserted).

There’s a file in here called ElectroServer that you run but you need to tell it where to find the latest JVM. According to this rather useful thread you can do this by typing :

export INSTALL4J_JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home/

And then start the server normally by typing :

./ElectroServer

At which point you should see the happy message :

16:28:08,523 [main] INFO  DisplayLogger  - 
-=-=-=-=-=-=-=-
Starting ElectroServer 4.0.6
Go to http://www.electro-server.com/ for the newest version.
-=-=-=-=-=-=-=-
Computer Information
	Operating System: Mac OS X
	Operating System Architecture: x86_64
	Processors Available: 2
	Memory Available: 682Mb
-=-=-=-=-=-=-=-
Virtual Machine Information
	Virtual Machine Vendor: Apple Inc.
	Virtual Machine Version: 1.6.0_17
 
 
16:28:14,863 [pool-1-thread-1] INFO  DisplayLogger  - 
-=-=-=-=-=-=-=-
ElectroServer has started successfully

After several hours of fiddling around this was somewhat of a relief.

The next problem was that I couldn’t navigate to the admin panel which by default you can find at 127.0.0.1:8080/admin. But whenever I pointed my browser at it all I got was an empty binary file in my downloads folder. Thank goodness for Twitter where Matt Bolt saved the day with his tweet :

@sebleedelisle Make sure you’re using https, not http – I run into this constantly

Thank you Matt! I have no idea how I would have figured that one out without you! So I just navigated to https://127.0.0.1:8080/admin and it worked.

I expect to be furthering my adventures in ElectroServer over the next few days so I’ll keep you informed of how I get along.

Related posts:

1. Installing ElectroServer on MediaTemple
2. Giving ElectroServer more memory
3. Further adventures with ElectroServer