Moving towards a first release

This commit is contained in:
reatmon 2002-08-04 03:58:25 +00:00
parent 0873d73726
commit aa2f5c1723
4 changed files with 408 additions and 210 deletions

View File

@ -1,3 +1,4 @@
*.html
Makefile
build
env_setup

View File

@ -160,102 +160,121 @@
<section id='c2sfarmdream'>
<title>The Dream</title>
<para>
The first thing that we can do is to split out
the c2s from the server and make it a seperate
process/component. Once that is done, we can
replicate the c2s processes over multiple
machines. Each one would connect back to the
main server running the JSM and everything
should work just fine.
</para>
<para>Pros:</para>
<itemizedlist>
<listitem>
<para>Easy to setup right now.</para>
</listitem>
</itemizedlist>
<para>Cons:</para>
<itemizedlist>
<listitem>
<para>
Round Robin will not provide true load
balancing since there is no mechanism in
place to check how many connections a
server has when it forwards a new connection
to it the next time it comes up in the
Round Robin.
</para>
</listitem>
</itemizedlist>
</section>
<section id='c2sfarmreality'>
<title>The Reality</title>
<para>
This is doable right now. The 1.5 version of
jabberd has sought to break all of the pieces
out into seperate processes. This was not
done for farming specifically, but we will not
complain since the jadc2s component can handle
upwards of 10k users. (The 1.4.x series c2s
could only handle ~1024).
</para>
<para>
Currently there is a forked version of jadc2s
that works with the 1.4.2 server. It is located
in the jabberd14 CVS repository on JabberStudio.
The following example is running with two jadc2s
boxes, and one central jabberd box. To set this
up do the following:
</para>
<orderedlist>
<listitem>
<para>
The first thing that we can do is to split out
the c2s from the server and make it a seperate
process/component. Once that is done, we can
replicate the c2s processes over multiple
machines. Each one would connect back to the
main server running the JSM and everything
should work just fine.
</para>
<figure>
<title>c2s Farming Diagram</title>
<mediaobject>
<imageobject>
<imagedata fileref="c2s-round-robin.ps" format="PS" />
</imageobject>
<imageobject>
<imagedata fileref="c2s-round-robin.jpeg" format="JPG" />
</imageobject>
<textobject>
<phrase>Diagram of c2s using Round Robin for Farming.</phrase>
</textobject>
</mediaobject>
</figure>
<para>Pros:</para>
<itemizedlist>
<listitem>
<para>Easy to setup right now.</para>
</listitem>
</itemizedlist>
<para>Cons:</para>
<itemizedlist>
<listitem>
<para>
Round Robin will not provide true load
balancing since there is no mechanism in
place to check how many connections a
server has when it forwards a new connection
to it the next time it comes up in the
Round Robin.
</para>
</listitem>
</itemizedlist>
</section>
<section id='c2sfarmreality'>
<title>The Reality</title>
<para>
This is doable right now. The 1.5 version of
jabberd has sought to break all of the pieces
out into seperate processes. This was not
done for farming specifically, but we will not
complain since the jadc2s component can handle
upwards of 10k users. (The 1.4.x series c2s
could only handle ~1024).
</para>
<para>
Currently there is a forked version of jadc2s
that works with the 1.4.2 server. It is located
in the jabberd14 CVS repository on JabberStudio.
The following example is running with two jadc2s
boxes, and one central jabberd box. To set this
up do the following:
</para>
<orderedlist>
<listitem>
<para>
Get all of the
<ulink url='http://jabberd.jabberstudio.org/'>source code for jabberd14</ulink>.
Build the server, configure/make.
</para>
</listitem>
<listitem>
<para>
Get the
<ulink url='http://download.jabber.org/contrib/xdb_sql-1.2.tar.gz'>source</ulink>
for xdb_sql from
<ulink url='http://www.IDEALX.org'>IDEALX</ulink>
, build it, and setup the jabber.xml to use it.
</para>
<note>
<para>
Get all of the
<ulink url='http://jabberd.jabberstudio.org/'>source code for jabberd14</ulink>.
Build the server, configure/make.
This is a very important step. xdb_file,
the default xdb that comes with jabberd,
is limited to open file descriptors too.
You can play the same shell games that we
are going to play with jadc2s later, but
if you want a server that can handle
millions or users, then you need something
other than xdb_file. Enter xdb_sql, which
only uses one file descriptor to connect
to the mysql server.
</para>
</listitem>
<listitem>
<para>
Get the
<ulink url='http://download.jabber.org/contrib/xdb_sql-1.2.tar.gz'>source</ulink>
for xdb_sql from
<ulink url='http://www.IDEALX.org'>IDEALX</ulink>
, build it, and setup the jabber.xml to use it.
</para>
<note>
<para>
This is a very important step. xdb_file,
the default xdb that comes with jabberd,
is limited to open file descriptors too.
You can play the same shell games that we
are going to play with jadc2s later, but
if you want a server that can handle
millions or users, then you need something
other than xdb_file. Enter xdb_sql, which
only uses one file descriptor to connect
to the mysql server.
</para>
</note>
<para>
XXX Add Link, or docs for doing this.
</para>
</listitem>
<listitem>
<para>
Build jadc2s and distribute the binaries
to the boxes where they will run.
</para>
</listitem>
<listitem>
<para>
Setup the main jabberd to accept the jadc2s
component connections. In the jabber.xml
config file, add the following XML:
</para>
<screen>
</note>
<para>
For more information on how to configure
xdb_sql, please see the README that is
distributed in the release.
</para>
</listitem>
<listitem>
<para>
Build jadc2s and distribute the binaries
to the boxes where they will run.
</para>
</listitem>
<listitem>
<para>
Setup the main jabberd to accept the jadc2s
component connections. In the jabber.xml
config file, add the following XML:
</para>
<screen>
&lt;service id="jadc2s-1"&gt;
&lt;accept&gt;
&lt;ip/&gt;
@ -271,131 +290,192 @@
&lt;secret&gt;secret&lt;/secret&gt;
&lt;/accept&gt;
&lt;/service&gt;
</screen>
<para>
Now you can run the main jabberd and get it
listening for the jadc2s to connect to
it.
</para>
</listitem>
<listitem>
<para>
Configure the jadc2s.xml on each box to
connect to the SM, where to listen, etc...
</para>
<screen>
&lt;!-- session manager configuration --&gt;
&lt;sm&gt;
&lt;!-- host and port of the SM --&gt;
&lt;host&gt;localhost&lt;/host&gt;
&lt;port&gt;5111&lt;/port&gt;
&lt;!-- shared secret, for authenticating us --&gt;
&lt;secret&gt;secret&lt;/secret&gt;
&lt;!-- our ID, for authenticating us to the sm --&gt;
&lt;id&gt;jadc2s&lt;/id&gt;
&lt;!-- how many times to try to connect to the sm (default: 5) --&gt;
&lt;retries&gt;5&lt;/retries&gt;
&lt;/sm&gt;
&lt;!-- local network settings --&gt;
&lt;local&gt;
&lt;!-- who we identify ourselves as. This should correspond to the --&gt;
&lt;!-- ID (host) that the session manager thinks it is. --&gt;
&lt;id&gt;localhost&lt;/id&gt;
&lt;!-- IP address to bind to (default: 0.0.0.0) --&gt;
&lt;!-- &lt;ip&gt;0.0.0.0&lt;/ip&gt; --&gt;
&lt;!-- port to bind to (default: 5222) --&gt;
&lt;port&gt;5222&lt;/port&gt;
&lt;!-- SSL configuration --&gt;
&lt;!-- Specify the port to listen on, and the key file to use for --&gt;
&lt;!-- the certificate. --&gt;
&lt;!-- &lt;port/&gt; (default: 5223) --&gt;
&lt;!-- &lt;pemfile/&gt; (default: ./server.pem) --&gt;
&lt;!--
&lt;ssl&gt;
&lt;port&gt;5223&lt;/port&gt;
&lt;pemfile&gt;./server.pem&lt;/pemfile&gt;
&lt;/ssl&gt;
--&gt;
&lt;/local&gt;
</screen>
<para>
For more information on how to configure
jadc2s, please see the README in the jadc2s
source directory.
</para>
</listitem>
<listitem>
<para>
Open a shell where you can change file
system parameters (root usually) and execute
the following command:
</para>
<informalexample>
<screen format="linespecific">
<prompt moreinfo="none">bash$</prompt> <command>echo "24000" > /proc/sys/fs/file-max</command>
</screen>
<para>
Now you can run the main jabberd and get it
listening for the jadc2s to connect to
it.
</para>
</listitem>
<listitem>
<para>
Configure the jadc2s.xml on each box to
connect to the SM, where to listen, etc...
XXX More info here.
</para>
</listitem>
<listitem>
<para>
Open a shell where you can change file
system parameters (root usually) and execute
the following command:
</para>
<informalexample>
<screen format="linespecific">
<prompt moreinfo="none">bash$</prompt> <command>echo "24000" > /proc/sys/fs/file-max</command>
</screen>
</informalexample>
<para>
This bumps the upper bound on the
number of allowed file descriptors
that can be open at one time.
</para>
</listitem>
<listitem>
<para>
Set the limit for the shell you are in
to use more than the default 1024 file
descriptors.
</para>
<informalexample>
<screen format="linespecific">
<prompt moreinfo="none">bash$</prompt> <command>ulimit -n 11000</command>
</screen>
</informalexample>
</listitem>
<listitem>
<para>
Tell jadc2s how many file descriptors it
is allowed to use:
</para>
<para>XXX config example here</para>
<para>
It is important that the number you pick is
a prime number. To make it easy to find the
prime you want you can visit this page
<ulink url='http://www.utm.edu/research/primes/lists/small/10000.txt'>http://www.utm.edu/research/primes/lists/small/10000.txt</ulink>.
</para>
</listitem>
</orderedlist>
</section>
</informalexample>
<para>
This bumps the upper bound on the
number of allowed file descriptors
that can be open at one time.
</para>
</listitem>
<listitem>
<para>
Set the limit for the shell you are in
to use more than the default 1024 file
descriptors.
</para>
<informalexample>
<screen format="linespecific">
<prompt moreinfo="none">bash$</prompt> <command>ulimit -n 11000</command>
</screen>
</informalexample>
</listitem>
<listitem>
<para>
Tell jadc2s how many file descriptors it
is allowed to use:
</para>
<screen>
&lt;!-- maximum number of file descriptors. Should be a prime --&gt;
&lt;!-- number. At least four will be used by jadc2s itself, --&gt;
&lt;!-- usually around six or seven (default: 1023) --&gt;
&lt;!-- For a list of prime numbers: --&gt;
&lt;!-- http://www.utm.edu/research/primes/lists/small/10000.txt --&gt;
&lt;max_fds&gt;10007&lt;/max_fds&gt;
</screen>
<para>
It is important that the number you pick is
a prime number. To make it easy to find the
prime you want you can visit this page
<ulink url='http://www.utm.edu/research/primes/lists/small/10000.txt'>http://www.utm.edu/research/primes/lists/small/10000.txt</ulink>.
</para>
</listitem>
<listitem>
<para>
All that's left is to run the server, and the
jadc2s processes. Everything should work fine.
If it doesn't, then PLEASE tell me at
<email>reatmon@jabber.org</email> so that I can
fix this document.
</para>
</listitem>
</orderedlist>
</section>
</section>
</section>
<section id='redirection'>
<title>Connection Redirection</title>
<section id='redirection'>
<title>Connection Redirection</title>
<section id='redirectiondream'>
<title>The Dream</title>
<para>
Now that we have the c2s processes distributed
across machines, we need to get them to work
together. We need two things, the ability to
communicate how many connections a c2s has to
the others, and the ability to know who the
others are.
</para>
<para>
[22:21] Jer: well, the "protocol" could just be
an auth error of 3xx for redirect w/ the ip/port
to connect to
</para>
<para>
Maybe we need to talk about the router layer sooner...
</para>
<para>Pros:</para>
<itemizedlist>
<listitem>
<para>Load balances nicely.</para>
</listitem>
</itemizedlist>
<para>Cons:</para>
<itemizedlist>
<listitem>
<para>
Requires client support for connection
redirection. This is not hard to do,
it is just not part of any client right
now.
</para>
</listitem>
</itemizedlist>
</section>
<section id='redirectiondream'>
<title>The Dream</title>
<para>
Now that we have the c2s processes distributed
across machines, we need to get them to work
together. We need two things, the ability to
communicate how many connections a c2s has to
the others, and the ability to know who the
others are.
</para>
<para>
[22:21] Jer: well, the "protocol" could just be
an auth error of 3xx for redirect w/ the ip/port
to connect to
</para>
<para>
Maybe we need to talk about the router layer sooner...
</para>
<para>Pros:</para>
<itemizedlist>
<listitem>
<para>Load balances nicely.</para>
</listitem>
</itemizedlist>
<para>Cons:</para>
<itemizedlist>
<listitem>
<para>
Requires client support for connection
redirection. This is not hard to do,
it is just not part of any client right
now.
</para>
</listitem>
</itemizedlist>
</section>
</section>
<section id='routerlayer'>
<title>Router Layer</title>
<section id='routerlayer'>
<title>Router Layer</title>
<section id='routerlayerdream'>
<title>The Dream</title>
<para>
</para>
<para>Pros:</para>
<itemizedlist>
<listitem>
<para>
</para>
</listitem>
</itemizedlist>
<para>Cons:</para>
<itemizedlist>
<listitem>
<para>
</para>
</listitem>
</itemizedlist>
</section>
<section id='routerlayerdream'>
<title>The Dream</title>
<para>
</para>
<para>Pros:</para>
<itemizedlist>
<listitem>
<para>
</para>
</listitem>
</itemizedlist>
<para>Cons:</para>
<itemizedlist>
<listitem>
<para>
</para>
</listitem>
</itemizedlist>
</section>
</section>
<section id='jsmdb'>
<title>Moving JSM State data into a DB</title>

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.2 KiB

View File

@ -0,0 +1,117 @@
%!PS-Adobe-3.0
%%Creator: GIMP PostScript file plugin V 1.11 by Peter Kirchgessner
%%Title: /home/reatmon/devel/howtos/Jabber-Server-Farming-HOWTO/c2s-round-robin.ps
%%CreationDate: Sat Aug 3 17:51:11 2002
%%DocumentData: Clean7Bit
%%LanguageLevel: 2
%%Pages: 1
%%BoundingBox: 14 14 208 313
%%EndComments
%%BeginProlog
% Use own dictionary to avoid conflicts
10 dict begin
%%EndProlog
%%Page: 1 1
% Translate for offset
14.173228 14.173228 translate
% Translate to begin of first scanline
0.000000 298.067893 translate
193.043971 -298.067893 scale
% Image geometry
193 298 8
% Transformation matrix
[ 193 0 0 298 0 0 ]
currentfile /ASCII85Decode filter /RunLengthDecode filter
%%BeginData: 6479 ASCII Bytes
image
JcEOcJcEOcJcEOcJcEOcJcEOc`W*FJ`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W#o<
])Ma1`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W#o<
li6qa#QFf(!!*'!!8IMR!6+uWrr<&crr<&us8N*!rr<&hrr<&`rr<&<s2G!<!:Bdd!;uj!!<<'!
nc&Rhl2L_``W*pW!!)Ed!!)ip%flV0!<<'!!<<'!!<3'!s8E#`rr<&<s2G!<!:Bdd!;ZX,!<<'!
rrE*!!<<'!!<3'!rrD<`!!("<`W#o<mJd.dq>UQts8N*!r;clt"p"]'!<<'!l2L_``W*pW!!)Ed
!!)rs#QXo)!<<'!rrDus"p"]'!<<'!l2L_``W*pW!!)Bc!!*#u!!*#u&HMk2!<3'!rrE*!!<<'!
s8N)`rr<&<s2G!<!:0[a!<3#q!!N<%!<<)u!!WB&!<3$!lMgha`W*pW!!'V1!!("<`W#o<])Ma1
`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W#o<])Ma1
`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W*FJ`W)\4rrAbmUAt5nU&UkerrAbmUAt5n
U&UkerrAbmUAt5nU&UkerrAbmUAt5nU&UkerrAbmUAt5nU&UkerrAbmUAt5nU&UkerrAbmUAt5n
U&UkerrAbmUAt5nU&UkerrAbmUAt5nU&UkerrAbmUAt5nU&UkerrAbmUAt5nU&UkerrAbmUAt5n
U&UkerrAbmVZ6>iVZ3LmpAh)jV>p;jV>m@kq#I8kV#U8kV#R4iquEMlU]:5lU]7(grW&\mUAt2m
UApqe!!&_m_>h:N_>hCP!!'h7!!'n9_uB]:^Ae05_uI[T!!'\3!!'t;`W#o<])Ma1`W*pW!!'V1
!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1
!!("<`W#o<lMp_]rr;uurr;rts8W#tkl1V_`W*pW!!)9`!!)ut!!*#u!!)ut!s&B$!<2uu!9jF_
!6+uWrr<&`rr<&srr`?%rr<&urrW9$rrD-[!!("<`W#o<l2L_`r;R$&s8N*!!<<'!rr2rujo5;\
`W*pW!!)9`!!)rs#QXo)!<<'!rrE#trrD6^!!("<`W#o<l2L_`r;R$&s8N*!rrE'!qu6Wrkl1V_
`W*pW!!)9`!!)rs!s&B$!<3#u!;lcr!9jF_!6+uWrr<&`rr<&trr<&urr<&trrW9$rrE&u!!)6_
!!("<`W#o<lMp_]rr;rtrr3$"s8W#tkPkM^`W*pW!!'V1!!("<`W#o<])Ma1`W*pW!!'V1!!("<
`W#o<])Ma1`W*pW!!'V1!!("<`W#o<rr;lrl2Ub`rVucqq>^Hpqu6WrpAY*m`W*pW!!)ut!!*#u
!!)9`!!)rs!!*#u!!)ip!!)Kf!!("<`W#o<rVlitrr2rul2L_`r;Q`srr2ruq>UEpn,E@f`W*pW
!!)ut!!*#u!!*#urW)uurr<<(!!*$!!<3&us8N'"rrDus!!*#u!!*#urW)uu$ip;-!<<'!!<3$!
rrDrr!!("<`W#o<rVufrrr2rurr3T2s8N*!rrE*!!!*$!rrE*!!!)rsr;cis!!*#u%flV0!<<'!
s8N*!rr<'!!;uis!6+uWrr<&trrW9$rrE&u!!*#u%KQP/!<<'!s8N*!rrE'!rr2rur;Qj!s8N)u
rr<&urrN3#!<3!)!<<'!s8N*!rrDus!!("<`W#o<rVls"s8N)urr<&ursf&/rrE*!!<<'!s8N*!
!<2uu!;uj!!<<'!rr2rurr3$"rrE&u#lt#*!<<'!s8N)srr<&<s2G!<!<)ot!<3!#!<<'!rr3H.
s8N*!rrE*!!<<'!rrE&u!!)rs!!*#u!s&B$!<3!"!<3&urs8]*rrE*!!<<'!r;Q`s`W*pW!!*#u
rW)rtrr<'!rW)osq>^Wt!!*&s!<3#t!<3#u!!*&u!<3#t!<<)r!!<0#!<)ot!6+uWrr<&1rr<&<
s2G!<!4r11!6+uWrr<&1rr<&<s2G!<!4r11!6+uWrr<&1rr<&<s2G!<!4r11!6+uWrr<&1rr<&<
s2G!<!4r11!6+uWrr<&1rr<&<s2G!<!4r11!6+uVrr<&3rr<&;s24j:!5AI5!5niRrr<&7rr<&9
s2"`N!5\]Is8E"Ts1JC2!/UZgs8E"Rs1\O4!/CNgs8E"Ps1n[6!/1Bgs8E"Ns2+g8!.t6gs8E"L
s2=s:!.k.Ms2G$;!.k1Ms2P*<!.k1Ls2Y0=!.k1Ks2b6>!.k1Js2k<?!.k1Is2tB@!.k1Hs3(HA
!.k1Gs31NB!.k1Fs3:TC!.k1Es3puJ!<)rs!.k1Ds3q#J!<<)u!.k1Cs4%)F!.k1Bs4%)G!.k1A
s4%)G!.k1As4./F!.k1Bs4./E!.k1Cs4./D!.k1Ds475H!.k1@s475L!.k1<s6'FW!6G38!6G38
!9aCJs8;rms8;rEs8;rms8;rEs8;rms8;r`s6]jd!:^$g!7_&K!:^$g!7_&K!:^$g!:BgSrr<&c
rr<&Mrr<&crr<&Mrr<&crr<&es7$'g!:'Ua!8@JQ!:'Ua!8@JQ!:'Ua!:^$Yrr<&]rr<&Srr<&]
rr<&Srr<&]rr<&hs7?9j!9F1[!9!nW!9F1[!9!nW!9F1[!;$6_rr<&Wrr<&Yrr<&Wrr<&Yrr<&W
rr<&ks7QBl!8d_U!9F.[!8d_U!9F.[!8d_U!;6Bbrr<&Urr<&[rr<&Urr<&[rr<&Urr<&ls7ZHm
!8RSS!9X:]!8RSS!9X:]!8RSS!;?Herr<&Qrr<&_rr<&Qrr<&_rr<&Qrr<&ns7cNn!8@GQ!9jF_
!8@GQ!9jF_!8@GQ!;HNgrr<&Orr<&arr<&Orr<&arr<&Orr<&os7uZp!7q/M!:9^c!7q/M!:9^c
!7q/M!;ZZjrr<&Mrr<&crr<&Mrr<&crr<&Mrr<&ps8)`q!7_#K!:Kje!7_#K!:Kje!7_#K!;c`l
rr<&Krr<&err<&Krr<&err<&Krr<&qs8)`q!7_#K!:Kje!7_#K!:Kje!7_#K!;c`lrr<&js8E#j
rr<&jrr<&err<&is8E#ms82lirr<&err<&is8E#ks8E!!rrDfn!!)lqqu6WroD\djrr2rup&>!l
o)A[inG`Igo)A[irr2rup\t3nrr2rup&>!lnG`Igo)A[irr2rup\t3nrr;uupAY*mqu?Qn!!)Kf
!!)`m!W`6#oD\djnG`Igmf*7ep\t3nrr2rup&>!lnG`Igmf*7eq#:<or;Q`spAY*mqu?Qn!!)cn
rW)lr!W`9#rW)iq!W`6#oD\djnG`IgpAb*lr;Qfus8W&ur;Q`srr2rup&>!lnG`IgpAb*lr;Qfu
s8W&urVlitnG`Igqu?Qn!!)fo!s&B$!;uj#!<3'!rrDrr!s&B$!;-9k!:^!g!;HKq!<<'!r;Qp#
rrE*!!;ulp!;6?l!:^!g!;HKq!<<'!r;Qp#rrE*!!<)ot!:^!g!;lfnrr<&orr<&qrr`?%rr<&p
s8;rirr<&grr<&nrr<&qrr`?%rr<&qrr<&trr<&mrr<&grr<&nrr<&qrr`?%rr<&rrr<&grr<&r
s82fr!;QQo!;lcr!;uls!;uis!<)ot!;6?l!:^!g!;HKn!;lcr!;uls!;uis!<)ot!;?Em!:^!g
!;HKn!;lcr!;uls!<)ot!;uis!;?Em!;lfnrr<&orsf&/rrE*!!<<'!rrE*!!;uis!<)ot!;6?l
!:^!g!;HL'!<<'!s8N*!rrE'!s8N)srr<&trr<&mrr<&grr<&nrsf&/rrE*!!<<'!rrE*!!;uis
!<2uu!;6?l!;lfnrr<&ns8N*!s82iss8E#rs8E#us8E#lrr<&grr<&ms8N*!s82iss8E#rs8)fh
rr<&grr<&ms8N*!s82iss8E#ps8E#jrr<&rs82fr!7LlI!:^!g!7LlI!:^!g!7LlI!;lfmrr<&K
rr<&err<&Krr<&err<&Krr<&qs8)`q!7_#K!:Kje!7_#K!:Kje!7_#K!;c`lrr<&Krr<&err<&K
rr<&err<&Krr<&qs8)`q!7_#K!:Kje!7_#K!:Kje!7_#K!;c`krr<&Mrr<&crr<&Mrr<&crr<&M
rr<&ps7uZp!7q/M!:9^c!7q/M!:9^c!7q/M!;ZZirr<&Orr<&arr<&Orr<&arr<&Orr<&os7cNn
!8@GQ!9jF_!8@GQ!9jF_!8@GQ!;HNfrr<&Qrr<&_rr<&Qrr<&_rr<&Qrr<&ns7ZHm!8RSS!9X:]
!8RSS!9X:]!8RSS!;?Hcrr<&Urr<&[rr<&Urr<&[rr<&Urr<&ls7QBl!8d_U!9F.[!8d_U!9F.[
!8d_U!;6Barr<&Wrr<&Yrr<&Wrr<&Yrr<&Wrr<&ks7?9j!9F1[!9!nW!9F1[!9!nW!9F1[!;$6\
rr<&]rr<&trr<&Xrr<&]rr<&Ss8N)^rr<&hs7$'g!:'Ua!;ulr!94%Y!:'Ua!8RVQ!:'Ua!:^$V
rr<&crr<&qs82lVrr<&crr<&Ss82itrrDEc!!)HemJm1dnGiLgq>^9kj8],ZnGiLgh#I6Os8W*!
nGiLgmJlMPr;cWmr;cQkq#KITr;cWmr;bXQq#LBnr;cWmr;c0`kPt;Wo)JIbi;`QPgAgpJq#C*h
kPrm.q#K1L!!(OKq>f(Gci<hAgAh0QeGoCGec3qpr;bONrW(IJqZ,1HcN!eBgAh*Of)P^L!<<#u
ec3qprrE*!rrCjSquG@KrW)rtrrCULao;>@h#I6Og&M$Oci;,errCpUq>f4KrrC@EaT)8?huEKP
g].9Rc2Yia!!(sWp]0+LrW(4Ca8c/>iW&WPhZ*QTbl>]_rrCsVrrCdQrW(.A`W#o<huE]Vg].6Q
b5]H\rrD!WrrCgRrrC1@`;fi;iW&oXh#IBSaT'0X!!)!XrrCmTrW(%>_uK`:irB#YhZ*QTa8a$V
rrD*ZrrCsVrW't<_>aK8j8],ZhuE]V`W*dSrrD-[rrD!WrrC";_#OE7jo>>\iW&lW`;dUP!!)-\
rrD'YrW'k9^]4<6k5YG]j8])Y_Z.@MrrD6^rrD*ZrrBn8^&J'4kPtP^jT#5[_#M+JrrD9_rrD0\
rW'b6]`8!3l2Ub`k5YD\^]1qG!!)9`rrD6^rW'\4]Dqm2lMpkakPtP^^&P\DrrDBbrrD9_rrB_3
\c2X0li6tbl2U__]`5PBrrDEcrrD?arW'S1\GuR/nc/:_nGiIf])T8>!!)NgpAja`rW'M/\,ZI.
nc/@anGiLg\Gs#;rrDThq#KsbrrBP.[Jp4,nc/Fcnc/Rg\,Wl9rrDThquH9erW'D,[/^.+s8W*!
pAb$jp&G$l!<<#u[K!T5!<E0!!;6Bk!;-<h!4;d4s82lis8E#js8;r(s0Vh'!;-9k!;-<f!4Dj7
s7u`js7cThs7lZ's0r%&!<)rr!;QTm!;ull!4W!9s7lZps8N)gs8N)us7u`'s0Mb&!!3*"m/I(d
s8)f&s0;V%!:'U^!3uR-s8N)_s8N)&s0;V(!9F1[!3uR0rr<&Wrr<&)s0M_*!8d_U!42^3rr<&U
rr<&*s0Ve+!8RSS!4;d6rr<&Qrr<&,s0_k,!8@GQ!4Dj8rr<&Orr<&-s0r".!7q/M!4W!;rr<&M
rr<&.s1&(/!7_#K!4`'=rr<&Krr<&/s1&(/!7_#K!4`'=rr<&ls8E#us8;ots8E#rs8E#krr<&/
s1/.0!;$3m!<<'!rr3*$s8N'!r;ZcsoD\dj\c95?!!)Wj!s&B$!;lct!<3&urrN3#!;$3j!4i-?
rr<&jrr<&urr<&srrN3#!<3!"!<3&jrr<&0s1/.0!;$3j!<)rt!<3!(!<<'!rrE*!!;$3j!4i-?
rr<&jrr<&rrsJi,rrE*!!<3'!rrDZj!!'S0\c2X0oD\djqu7$(s8N*!rrE'!s8N)jrr<&0s1/.0
!;6?q!<3'!rrE&u!s&B$!<2uu!<2uu!;$3j!4i-?rr<&ls8N)us8;rts8E#urrN3#s8E#jrr<&0
s1/.0!7LlI!4i->rr<&Krr<&/s1&(/!7_#K!4`'=rr<&Krr<&/s1&(/!7_#K!4`'<rr<&Mrr<&.
s0r".!7q/M!4W!:rr<&Orr<&-s0_k,!8@GQ!4Dj7rr<&Qrr<&,s0Ve+!8RSS!4;d4rr<&Urr<&*
s0M_*!8d_U!42^2rr<&Wrr<&)s0;V(!9F1[!3uR-rr<&]rr<&&s/uD%!:'Ua!3Z@'rr<&crr<&#
s/Z2"!:^$g!3?.!s8;rms8;qss/#bj!2]^Hs1nYcs1nYcs1nYcs1nYcs1nYcs1nYcs1nYcs1nYc
s1nYcs1nYb~>
%%EndData
showpage
%%Trailer
end
%%EOF