RMS Installation ¶ wget http://get.boonex.com/RMS-LINUX-v.7.0-RC
* Log into your shell account using your favorite SSH client.
Choosing a Folder to install RMS ¶
* Choose the folder where RMS will be installed in. You can create a separate folder for that. It doesn't matter where you create this folder but remember that if you want to prevent the folder of being accessed in a browser, you should create it in the root directory of your hosting account (/) or your home directory if root is not accessible or writable (/home/myaccount/).
Let's assume you have created "ray_server" folder inside "/opt" directory. Now the absolute path to your Ray Media Server folder is /opt/ray_server/.
Uploading Files ¶
* Download the Ray Media server archive applicable for your operating system (UNIX or Windows). Unzip the archive and upload the contents of the extracted folder in the folder you created on your server (for example /opt/ray_server).
Note: if you're installing the Windows version, you will have to run the extracted executable file on your Windows server. After you have followed the wizard instruction, RMS will be installed by default in C:\Program Files\RMS.
Uploading Suite/Widgets Contents to RMS ¶
* If you're installing the full Ray Widget Suite, unzip the archive and upload the contents of ray_rms (i.e. chat/, im/ and video/) folder in webapps folder inside the Ray Media Server folder on your server (for example /opt/ray_server/webapps/ or C:\Program Files\RMS\webapps\ (for Windows) ).
If you're installing "Chat", "Instant Messenger" or "Video Recoder" separately, you'll have to unzip the respective archive and upload the folders with _rms/ postfixes into "webapps" folder inside the Ray Media Server folder on your server. Remove the _rms/ postfixes from the folders' names.
Note: The widgets stated above use audio/video facilities of Ray Media Server. The other widgets don't use RMS and you can omit RMS installation for them.
Configuring RMS ¶
* Make the following changes to some files inside the Ray Media Server directory:
* access.dat – input all domain names which will be allowed to access RMS. Every domain name should be written on a separate line and should not contain "http://" and "www", just yourdomain.com;
* ray.sh (UNIX only) – set the value for JAVA_HOME variable. It should be the path to the folder where JRE is installed. For example:
JAVA_HOME=/opt/ray_server/jre1.x;
* run_daemon.sh (UNIX only) – set the value for RAY_SERVER_PATH variable. It should be the path to the RMS folder on your server. For example:
RAY_SERVER_PATH=/opt/ray_server;
* change the IP addresses in the files located in
path_to_rms/webapps/widget_name/WEB-INF/red5-web.properties
where "path_to_rms" stands for path to your Ray Media Server folder, and "widget_name" stands for "chat", "im" and "video". For example: open
/opt/ray_server/webapps/chat/WEB-INF/red5.properties
for UNIX or
C:\Program Files\RMS\webapps\chat\WEB-INF\red5.properties
(for Windows) and replace the following line:
webapp.virtualHosts=0.0.0.0
with
webapp.virtualHosts=10.10.10.10
You should advise with your hosting provider about your IP address or use "ping your_domain_name" command where "your_domain_name" stands for your real domain name.
Setting permissions for RMS files ¶
* Now you have to add "executable" permissions to all the *.sh files inside RMS directory. You can do it by invoking the following command:
chmod +x *.sh
Make sure your current directory is the RMS folder.
RMS Test launch ¶
* Now you can perform the test of RMS functionality. Invoke command:
./ray.sh
or run the file
ray.exe
(on Windows) under Ray Media Server directory. The expected results may be as follows:
* The server has been launched successfully if there is no error report. You can see the following lines at the end of start up screen:
[INFO] 6413main org.springframework.web.context.ContextLoader.info ) RootWebApplicationContext: initialization completed in 84 ms
[INFO] 6595 main org.mortbay.log.info ) StartedSelectChannelConnector @ 0.0.0.0:5080
[DEBUG] 6596main org.red5.server.Standalone.debug ) Startup done in: 6597 ms
Now you can use BoonEx Red5 Tester to test if your server responds to remote connections. You can not use the above tester if you are installing RMS locally on you computer.
* if you get "NetConnection.Connect.Success", then the server started up successfully and you can proceed to the point 2 below;
* if you get "NetConnection.Connect.Failed", the possible reasons may be:
o the 1935 or 1936 ports are closed on your server
o your server uses firewall which prohibits the access to it through the 1935 port
In both cases you should advise with your hosting provider.
* If your server doesn’t have sufficient RAM or you have no permissions to start RMS, you’ll see an output like this:
Error occurred during initialization of VM
Could not reserve enough space for object heap
Could not create the Java virtual machine.
Here's a possible solution for UNIX-based operating systems only:
* Edit the file ray.sh. Find the line containing this text:
exec $JAVA -Djava.security.manager-Djava.security.policy=conf/red5.policy -cp red5.jar:conf:$CLASSPATHorg.red5.server.Standalone
and replace it with:
exec $JAVA –Xint –Xms8M –Xmx16M -Djava.security.manager -Djava.security.policy=conf/red5.policy -cp red5.jar:conf:$CLASSPATH org.red5.server.Standalone
Try to restart the server now. If there are no errors, this is it! If some still appear, try to increase the numbers up to 16/32 respectively. If this brings no result, you should change your hosting plan or use a superuser (root) account for installation.
RMS running ¶
Now you should cancel the execution of ray.sh or ray.exe and run RMS as a service (background application). You can do it by invoking
./run_daemon.sh
or run the file
run_daemon.exe
(on Windows) which is in Ray Media Server directory. You can now execute the following command on UNIX-based OS to make sure that RMS has started:
ps ax | grep ray
The output should contain a line that looks like this:
18247 pts/0 Sl+ 0:55 /opt/red5new_555/jre1.x/bin/java -Djava.security.manager -Djava.security.policy=conf/red5.policy -cp red5.jar:conf:. org.red5.server.Standalone
If you don't see such a line, check ray.sh and run_daemon.sh for all the required changes (see point 1.5). On Windows you should run Task Manager and look for "javaw.exe" process to make sure the server has been started.
Setting-up RMS on Startup ¶
* Now you should add a task to your server's startup file, so every time your server restarts, RMS could start automatically. On most Linux systems this file is /etc/rc.local. You should input the following lines in it: "cd path_to_rms" and "/path_to_rms/run_daemon.sh", where "path_to_rms" stands for the absolute path to Ray Media Server folder.
For example:
cd /opt/ray_server
/opt/ray_server/run_daemon.sh
Note: on Windows machines you will have to add the following file "C:\Program Files\RMS\run_daemon.exe" to Startup.