1、windows系统单独运行服务器
1)、下载最新版的jWebSocket Server Package (jWebSocketServer-<version>.zip)包,解压缩至文件目录;目录结构为:bin、lib、log、conf等;解压即可,免安装 ;
2)、安装jdk1.6版本及以上;设置JAVA_HOME至安装目录,并验证java –version版本;否则会出现jdk版本过低错误;
3)、设置系统环境变量JWEBSOCKET_HOME为jWebSocket安装目录;
4)、运行jWebSocketServer.bat,跟踪运行日志,无错误,最后开放tcp的8787端口和9797端口成功,标识jWebSocket Server已经安装完成。
2、linux系统单独运行服务器
1)、将解压后的jwebsocketserver目录上传至linux服务器,并设置环境变量JWEBSOCKET_HOME和JAVA_HOME;
2)、设置CLASSPATH为jdk和jre的lib目录;
3)、配置防火墙,iptables,开放tcp8787,9797端口;
4)、运行jWebSocketServer.sh,跟踪运行日志,无错误,最后开放tcp的8787端口和9797端口成功,标识jWebSocket Server已经安装完成。
3、linux系统集成Tomcat应用服务器
1)、安装tomcat6和jdk1.6及以上;
2)、设置环境变量:两种方法:a、系统级变量,在/etc/profile中设置;b、在tomcat\bin目录的catalina.sh中设置;
3)下载集成应用服务器的专用包(包含简化版和学习版),解压war上传至tomcat\webapps 目录下;
4)、将jWebSocket.xml上传至tomcat\conf目录下,使用其默认设置;
5)、将jWebSocketServer-Bundle-1.0.jar、jWebSocketSamples-1.0.jar、jWebSocketRPCPlugIn-1.0.jar上传至tomcat\lib目录;(如果缺少RPC的jar包,启动会报错:rpcclass not found,jwebsocket server并未启动成功)
6)、重启tomcat服务器。查看tomcat日志,无错误,最后开放tcp的8787端口和9797端口成功,标识jWebSocket Server已经安装完成。
目前安装tomcat集成服务器必须在第二部安装单独服务器,设置了JWEBSOCKET_HOME环境变量的基础上,才可以成功;否则会报错:找不到环境变量或者找不到jWebSocket.xml配置文件,即使classpath下存在该配置文件,也不可以。这个问题暂时未找到解决办法。
测试
运行jwebsocket的demo,例如chat,可以看到debug日志。如果连接后就出现连接断开,则表明server端并未安装成功,可详细查看websocket server启动日志。
遇到问题汇总:
1、jdk版本错误,major.minor is 49,50,均为实际jdk版本比要求的要低;
2、websocket server 启动异常:环境变量设置不完全,或者配置文件不完全;
3、启动Error:RPC not found,缺少RPC的相关包,应将包放入tomcat\lib目录下;
4、其他错误:防火墙设置不正确。