flagflag  If you want to see English page, please click "English" Button at Left.
Page Top

Outline anchor.png

  • sl_relay is a Packet Relay Server for Second Life running on Linux. It is aimed at connecting to Second Life Servers from a PC through a firewall such as might be found in a university.
  • sl_relay relays communication (UDP,HTTP/HTTPS) between the SIM Server and the Second Life viewer.
  • Note: it not only relays but also scans inside each packet. Thus when the content of a packet (URL, IP address and port number) indicate another SIM is involved, a new relay process for that SIM can be started.
  • sl_cache can be used with sl_relay to provide a texture data cache.
  • When caching UDP packets (sl_cache), the sequence number of each UDP packet is rewritten to prevent contradictions.
  • It is also possible to limit access to particular SIMs by using sl_relay with the Information Server (sl_info).
  • sl_relay is part of sl_proxy.
  • The current version is 1.10.1 (4 Oct. '11)
Page Top

Outline of Functions. anchor.png

  1. You can execute Second Life from a PC with private IP address behind a firewall.
  2. You can specifiy the port number for firewall access.
  3. Access to sl_relay can be controlled.
  4. Full HTTPS access between Viewer and Relay Server is possible. (default is HTTP)
  5. MusicURL and MediaURL(High 23) is supported. However, it is recommended that a Web proxy be used.
  6. External Web Proxy (e.g. squid) connection is supported. Moreover, an internal Web Proxy function is included.
  7. OpenSim is supported. (Test version)
  8. sl_cache connection is supported. (sl_cache is the texture cache server for sl_relay.)
  9. When sl_cache is down or response is too slow, sl_relay automatically disconnects from the cache server after short delay.
  10. Access to Second Life SIMs can be controlled, by Avatar, viewer machine IP or at the global SIM level through the use of white lists with sl_info.
Page Top

Annoyances or Bugs. anchor.png

  1. You might see the same message two or more times in IM or chat. The cause is unknown, sorry.
  2. A stress test of sl_relay has not been carried out.
Page Top

Configuration anchor.png

  • The default configuration file is /usr/local/etc/sl_proxy/sl_relay.conf.
  • It is also possible to specify an alternate configuration file using the -f option of sl_relay.
  • Because the configuration file is read before sl_relay does the switch to the effective user, exec user should be able to be read.
  • The setting of each item is described in the configuration file. Empty lines or lines starting with # are not read.
Page Top

Items anchor.png

Page Top
Communication port with SIM Server anchor.png
Page Top
Communication port with Viewer anchor.png
Page Top
Control port of Relay Controller anchor.png
Page Top

Execute Options anchor.png

sl_relay  [-s server_name[:port]] [-p port] [-f config_file] [-u user_name]
          [-i interface_address]
          [-pid pid_file] [-l [log_file]] [-v syslog_level]
          [-cs [cache_server:port]] [-cg] [-cp]
          [-is [info_server:port]] [-wf]
          [-vs [voice_relay_server:port]]
          [-as] [-aca] [-ano]
          [-xp [web_proxy_server:porti]] [-ip [port]] [-ipx [port]] [-mm]
          [-ver version]
          [-d] [-x] [-xt] [-xu] [-xuf]
          [--version] [--help] [-h]

-s   : specify login server of Second Life. default is login.agni.lindenlab.com:443
-p   : port number that Viewer connects. default is 8100.
-f   : configuration file. default is /usr/local/etc/sl_proxy/sl_relay.conf
-u   : specify effective user.
-i   : specify Viewer side network interface IP address. 
      if your server has two or more network interfaces,
       you need to use this option.
-pid : specify pid file.
-l   : specify log file. default is /var/sl_proxy/sl_relay.log
-v   : level of syslog. default is LOG_INFO (7).

-cs  : specify sl_cache cache server. default is localhost:8200
-cg  : only get cache data. do not save data.
-cp  : only save cache data. do not get data.
-is  : specify sl_info infomation server. default is localhost:8086
-wf  : The access limitation to SIM by the white list is done in cooperation with sl_info.
-vs  : specify sl_voice_relay server. default is localhost:8088
-as  : use HTTPS between Viewer and Relay Server.
-aca : confirms Second Life Server by using C:\Program Files\SecondLife\app_settings\CA.pem
-ano : no HTTPS communication. Do not use, usually. It is for OpenSim olny. (Experimental option)
-xp  : specify external web proxy server.
-ip  : use internal web proxy function with full access mode. 
       excute internal web proxy process. port number can be specified.
-ipx : use internal web proxy function with restricted mode. 
      excute internal web proxy process.  port number can be specified.
-mm  : relay MusicURL and MediaURL(High 23). If it is possible, to use web proxy function of viewer.
-ver : rewrite Viewer version. 
       Please use this temporarily only when you cannot immediately install new Viewer.
       It is dangerous to use this lasting long, and never do it!!
-d   : debug mode. display debug information
-x   : TCP(HTTP/HTTPS) packets are saved at working directory and UDP packet headers are printed.
-xt  : TCP(HTTP/HTTPS) packets are saved at working directory.
-xu  : UDP packet headers are printed.
-xuf : UDP packet is full dumped.
--version  : display Version information.
--help, -h : display this Help messages.
Page Top

Processes anchor.png

Page Top

Relationship between Processes anchor.png

www.nsl.tuis.ac.jp_xpwiki, SIZE:720x540(33.4KB)

Page Top

Transformation of UDP and HTTP/HTTPS Packets anchor.png

www.nsl.tuis.ac.jp_xpwiki, SIZE:720x540(33.4KB)

  • [Proxy Process] is Relay Process
  • [Control Process] is Relay Controller

トップ   凍結 差分 バックアップ 複製 名前変更 リロード   新規 ページ一覧 単語検索 最終更新   ヘルプ   最終更新のRSS 1.0 最終更新のRSS 2.0 最終更新のRSS Atom
Counter: 4941, today: 1, yesterday: 1
最終更新: 2011-10-04 (火) 16:21:27 (JST) (4620d) by iseki

サイト内 検索





サブ メニュー


前月2024年 5月翌月
1 2 3 4
5 6 7 8 9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31


78 人のユーザが現在オンラインです。 (4 人のユーザが xpwiki を参照しています。)

登録ユーザ: 0
ゲスト: 78



今日 : 4693469346934693
昨日 : 3958395839583958
総計 : 2370493623704936237049362370493623704936237049362370493623704936
Powered by XOOPS Cube 2.1© 2001-2006 XOOPS Cube Project
Design by XoopsDesign.com