Full page writes improvement, code update
Hi,
Here's an update of a code to improve full page writes as proposed in
http://archives.postgresql.org/pgsql-hackers/2007-01/msg01491.php
and
http://archives.postgresql.org/pgsql-patches/2007-01/msg00607.php
Update includes some modification for error handling in archiver and
restoration command.
In the previous threads, I posted several evaluation and shown that we
can keep all the full page writes needed for full XLOG crash recovery,
while compressing archive log size considerably better than gzip, with
less CPU consumption. I've found no further objection for this proposal
but still would like to hear comments/opinions/advices.
Regards;
--
Koichi Suzuki
Attachments:
On Tue, 2007-03-27 at 11:52 +0900, Koichi Suzuki wrote:
Here's an update of a code to improve full page writes as proposed in
http://archives.postgresql.org/pgsql-hackers/2007-01/msg01491.php
and
http://archives.postgresql.org/pgsql-patches/2007-01/msg00607.phpUpdate includes some modification for error handling in archiver and
restoration command.In the previous threads, I posted several evaluation and shown that we
can keep all the full page writes needed for full XLOG crash recovery,
while compressing archive log size considerably better than gzip, with
less CPU consumption. I've found no further objection for this proposal
but still would like to hear comments/opinions/advices.
Koichi-san,
Looks interesting. I like the small amount of code to do this.
A few thoughts:
- Not sure why we need "full_page_compress", why not just mark them
always? That harms noone. (Did someone else ask for that? If so, keep
it)
- OTOH I'd like to see an explicit parameter set during recovery since
you're asking the main recovery path to act differently in case a single
bit is set/unset. If you are using that form of recovery, we should say
so explicitly, to keep everybody else safe.
- I'd rather mark just the nonremovable blocks. But no real difference
- We definitely don't want an normal elog in a XLogInsert critical
section, especially at DEBUG1 level
- diff -c format is easier and the standard
- pg_logarchive and pg_logrestore should be called by a name that
reflects what they actually do. Possibly pg_compresslog and
pg_decompresslog etc.. I've not reviewed those programs, but:
- Not sure why we have to compress away page headers. Touch as little as
you can has always been my thinking with recovery code.
- I'm very uncomfortable with touching the LSN. Maybe I misunderstand?
- Have you thought about how pg_standby would integrate with this
option? Can you please?
- I'll do some docs for this after Freeze, if you'd like. I have some
other changes to make there, so I can do this at the same time.
--
Simon Riggs
EnterpriseDB http://www.enterprisedb.com
Simon;
Thanks a lot for your comments/advices. I'd like to write some feedback.
Simon Riggs wrote:
On Tue, 2007-03-27 at 11:52 +0900, Koichi Suzuki wrote:
Here's an update of a code to improve full page writes as proposed in
http://archives.postgresql.org/pgsql-hackers/2007-01/msg01491.php
and
http://archives.postgresql.org/pgsql-patches/2007-01/msg00607.phpUpdate includes some modification for error handling in archiver and
restoration command.In the previous threads, I posted several evaluation and shown that we
can keep all the full page writes needed for full XLOG crash recovery,
while compressing archive log size considerably better than gzip, with
less CPU consumption. I've found no further objection for this proposal
but still would like to hear comments/opinions/advices.Koichi-san,
Looks interesting. I like the small amount of code to do this.
A few thoughts:
- Not sure why we need "full_page_compress", why not just mark them
always? That harms noone. (Did someone else ask for that? If so, keep
it)
No, no one asked to have a separate option. There'll be no bad
influence to do so. As written below, full page write can be
categolized as follows:
1) Needed for crash recovery: first page update after each checkpoint.
This has to be kept in WAL.
2) Needed for archive recovery: page update between pg_start_backup and
pg_stop_backup. This has to be kept in archive log.
3) For log-shipping slave such as pg_standby: no full page writes will
be needed for this purpose.
My proposal deals with 2). So, if we mark each "full_page_write", I'd
rather mark when this is needed. Still need only one bit because the
case 3) does not need any mark.
- OTOH I'd like to see an explicit parameter set during recovery since
you're asking the main recovery path to act differently in case a single
bit is set/unset. If you are using that form of recovery, we should say
so explicitly, to keep everybody else safe.
Only one thing I had to do is to create "dummy" full page write to
maintain LSNs. Full page writes are omitted in archive log. We have to
LSNs same as those in the original WAL. In this case, recovery has to
read logical log, not "dummy" full page writes. On the other hand, if
both logical log and "real" full page writes are found in a log record,
the recovery has to use "real" full page writes.
- I'd rather mark just the nonremovable blocks. But no real difference
It sound nicer. According to the full page write categories above, we
can mark full page writes as needed in "crash recovery" or "archive
recovery". Please give some feedback to the above full page write
categories.
- We definitely don't want an normal elog in a XLogInsert critical
section, especially at DEBUG1 level
I agree. I'll remove elog calls from critical sections.
- diff -c format is easier and the standard
I'll change the diff option.
- pg_logarchive and pg_logrestore should be called by a name that
reflects what they actually do. Possibly pg_compresslog and
pg_decompresslog etc.. I've not reviewed those programs, but:
I wasn't careful to have command names more based on what to be done.
I'll change the command name.
- Not sure why we have to compress away page headers. Touch as little as
you can has always been my thinking with recovery code.
Eliminating page headers gives compression rate slightly better, a
couple of percents. To make code simpler, I'll drop this compression.
- I'm very uncomfortable with touching the LSN. Maybe I misunderstand?
The reason why we need pg_logarchive (or pg_decompresslog) is to
maintain LSN the same as those in the original WAL. For this purpose,
we need "dummy" full page write. I don't like to touch LSN either and
this is the reason why pg_decompresslog need some extra work,
eliminating many other changes in the recovery.
- Have you thought about how pg_standby would integrate with this
option? Can you please?
Yes I believe so. As pg_standby does not include any chance to meet
partial writes of pages, I believe you can omit all the full page
writes. Of course, as Tom Lange suggested in
http://archives.postgresql.org/pgsql-hackers/2007-02/msg00034.php
removing full page writes can lose a chance to recover from
partial/inconsisitent writes in the crash of pg_standby. In this case,
we have to import a backup and archive logs (with full page writes
during the backup) to recover. (We have to import them when the file
system crashes anyway). If it's okay, I believe
pg_compresslog/pg_decompresslog can be integrated with pg_standby.
Maybe we can work together to include pg_compresslog/pg_decompresslog in
pg_standby.
- I'll do some docs for this after Freeze, if you'd like. I have some
other changes to make there, so I can do this at the same time.
I'll be looking forward to your writings.
Best regards;
--
Koichi Suzuki
On Wed, 2007-03-28 at 10:54 +0900, Koichi Suzuki wrote:
As written below, full page write can be
categolized as follows:1) Needed for crash recovery: first page update after each checkpoint.
This has to be kept in WAL.2) Needed for archive recovery: page update between pg_start_backup and
pg_stop_backup. This has to be kept in archive log.3) For log-shipping slave such as pg_standby: no full page writes will
be needed for this purpose.My proposal deals with 2). So, if we mark each "full_page_write", I'd
rather mark when this is needed. Still need only one bit because the
case 3) does not need any mark.
I'm very happy with this proposal, though I do still have some points in
detailed areas.
If you accept that 1 & 2 are valid goals, then 1 & 3 or 1, 2 & 3 are
also valid goals, ISTM. i.e. you might choose to use full_page_writes on
the primary and yet would like to see optimised data transfer to the
standby server. In that case, you would need the mark.
- Not sure why we need "full_page_compress", why not just mark them
always? That harms noone. (Did someone else ask for that? If so, keep
it)No, no one asked to have a separate option. There'll be no bad
influence to do so. So, if we mark each "full_page_write", I'd
rather mark when this is needed. Still need only one bit because the
case 3) does not need any mark.
OK, different question:
Why would anyone ever set full_page_compress = off?
Why have a parameter that does so little? ISTM this is:
i) one more thing to get wrong
ii) cheaper to mark the block when appropriate than to perform the if()
test each time. That can be done only in the path where backup blocks
are present.
iii) If we mark the blocks every time, it allows us to do an offline WAL
compression. If the blocks aren't marked that option is lost. The bit is
useful information, so we should have it in all cases.
- OTOH I'd like to see an explicit parameter set during recovery since
you're asking the main recovery path to act differently in case a single
bit is set/unset. If you are using that form of recovery, we should say
so explicitly, to keep everybody else safe.Only one thing I had to do is to create "dummy" full page write to
maintain LSNs. Full page writes are omitted in archive log. We have to
LSNs same as those in the original WAL. In this case, recovery has to
read logical log, not "dummy" full page writes. On the other hand, if
both logical log and "real" full page writes are found in a log record,
the recovery has to use "real" full page writes.
I apologise for not understanding your reply, perhaps my original
request was unclear.
In recovery.conf, I'd like to see a parameter such as
dummy_backup_blocks = off (default) | on
to explicitly indicate to the recovery process that backup blocks are
present, yet they are garbage and should be ignored. Having garbage data
within the system is potentially dangerous and I want to be told by the
user that they were expecting that and its OK to ignore that data.
Otherwise I want to throw informative errors. Maybe it seems OK now, but
the next change to the system may have unintended consequences and it
may not be us making the change. "It's OK the Alien will never escape
from the lab" is the starting premise for many good sci-fi horrors and I
want to watch them, not be in one myself. :-)
We can call it other things, of course. e.g.
ignore_dummy_blocks
decompressed_blocks
apply_backup_blocks
Yes I believe so. As pg_standby does not include any chance to meet
partial writes of pages, I believe you can omit all the full page
writes. Of course, as Tom Lange suggested in
http://archives.postgresql.org/pgsql-hackers/2007-02/msg00034.php
removing full page writes can lose a chance to recover from
partial/inconsisitent writes in the crash of pg_standby. In this case,
we have to import a backup and archive logs (with full page writes
during the backup) to recover. (We have to import them when the file
system crashes anyway). If it's okay, I believe
pg_compresslog/pg_decompresslog can be integrated with pg_standby.Maybe we can work together to include pg_compresslog/pg_decompresslog in
pg_standby.
ISTM there are two options.
I think this option is already possible:
1. Allow pg_decompresslog to operate on a file, replacing it with the
expanded form, like gunzip, so we would do this:
restore_command = 'pg_standby %f decomp.tmp && pg_decompresslog
decomp.tmp %p'
though the decomp.tmp file would not get properly initialised or cleaned
up when we finish.
whereas this will take additional work
2. Allow pg_standby to write to stdin, so that we can do this:
restore_command = 'pg_standby %f | pg_decompresslog - %p'
--
Simon Riggs
EnterpriseDB http://www.enterprisedb.com
Hi, Here're some feedback to the comment:
Simon Riggs wrote:
On Wed, 2007-03-28 at 10:54 +0900, Koichi Suzuki wrote:
As written below, full page write can be
categolized as follows:1) Needed for crash recovery: first page update after each checkpoint.
This has to be kept in WAL.2) Needed for archive recovery: page update between pg_start_backup and
pg_stop_backup. This has to be kept in archive log.3) For log-shipping slave such as pg_standby: no full page writes will
be needed for this purpose.My proposal deals with 2). So, if we mark each "full_page_write", I'd
rather mark when this is needed. Still need only one bit because the
case 3) does not need any mark.I'm very happy with this proposal, though I do still have some points in
detailed areas.If you accept that 1 & 2 are valid goals, then 1 & 3 or 1, 2 & 3 are
also valid goals, ISTM. i.e. you might choose to use full_page_writes on
the primary and yet would like to see optimised data transfer to the
standby server. In that case, you would need the mark.
Yes, I need the mark. In my proposal, only unmarked full-page-writes,
which were written as the first update after a checkpoint, are to be
removed offline (pg_compresslog).
- Not sure why we need "full_page_compress", why not just mark them
always? That harms noone. (Did someone else ask for that? If so, keep
it)No, no one asked to have a separate option. There'll be no bad
influence to do so. So, if we mark each "full_page_write", I'd
rather mark when this is needed. Still need only one bit because the
case 3) does not need any mark.OK, different question:
Why would anyone ever set full_page_compress = off?Why have a parameter that does so little? ISTM this is:
i) one more thing to get wrong
ii) cheaper to mark the block when appropriate than to perform the if()
test each time. That can be done only in the path where backup blocks
are present.iii) If we mark the blocks every time, it allows us to do an offline WAL
compression. If the blocks aren't marked that option is lost. The bit is
useful information, so we should have it in all cases.
Not only full-page-writes are written as WAL record. In my proposal,
both full-page-writes and logical log are written in a WAL record, which
will make WAL size slightly bigger (five percent or so). If
full_page_compress = off, only a full-page-write will be written in a
WAL record. I thought someone will not be happy with this size growth.
I agree to make this mandatory if every body is happy with extra logical
log in WAL records with full page writes.
I'd like to have your opinion.
- OTOH I'd like to see an explicit parameter set during recovery since
you're asking the main recovery path to act differently in case a single
bit is set/unset. If you are using that form of recovery, we should say
so explicitly, to keep everybody else safe.Only one thing I had to do is to create "dummy" full page write to
maintain LSNs. Full page writes are omitted in archive log. We have to
LSNs same as those in the original WAL. In this case, recovery has to
read logical log, not "dummy" full page writes. On the other hand, if
both logical log and "real" full page writes are found in a log record,
the recovery has to use "real" full page writes.I apologise for not understanding your reply, perhaps my original
request was unclear.In recovery.conf, I'd like to see a parameter such as
dummy_backup_blocks = off (default) | on
to explicitly indicate to the recovery process that backup blocks are
present, yet they are garbage and should be ignored. Having garbage data
within the system is potentially dangerous and I want to be told by the
user that they were expecting that and its OK to ignore that data.
Otherwise I want to throw informative errors. Maybe it seems OK now, but
the next change to the system may have unintended consequences and it
may not be us making the change. "It's OK the Alien will never escape
from the lab" is the starting premise for many good sci-fi horrors and I
want to watch them, not be in one myself. :-)We can call it other things, of course. e.g.
ignore_dummy_blocks
decompressed_blocks
apply_backup_blocks
So far, we don't need any modification to the recovery and redo
functions. They ignore the dummy and apply logical logs. Also, if
there are both full page writes and logical log, current recovery
selects full page writes to apply.
I agree to introduce this option if 8.3 code introduces any conflict to
the current. Or, we could introduce this option for future safety. Do
you think we should introduce this option?
If this should be introduced now, what we should do is to check this
option when dummy full-page-write appears.
Yes I believe so. As pg_standby does not include any chance to meet
partial writes of pages, I believe you can omit all the full page
writes. Of course, as Tom Lange suggested in
http://archives.postgresql.org/pgsql-hackers/2007-02/msg00034.php
removing full page writes can lose a chance to recover from
partial/inconsisitent writes in the crash of pg_standby. In this case,
we have to import a backup and archive logs (with full page writes
during the backup) to recover. (We have to import them when the file
system crashes anyway). If it's okay, I believe
pg_compresslog/pg_decompresslog can be integrated with pg_standby.Maybe we can work together to include pg_compresslog/pg_decompresslog in
pg_standby.ISTM there are two options.
I think this option is already possible:
1. Allow pg_decompresslog to operate on a file, replacing it with the
expanded form, like gunzip, so we would do this:
restore_command = 'pg_standby %f decomp.tmp && pg_decompresslog
decomp.tmp %p'though the decomp.tmp file would not get properly initialised or cleaned
up when we finish.whereas this will take additional work
2. Allow pg_standby to write to stdin, so that we can do this:
restore_command = 'pg_standby %f | pg_decompresslog - %p'
Both seem to work fine. pg_decompresslog will read entire file at the
beginning and so both two will be equivallent. To make the second
option run quicker, pg_decompresslog needs some modification to read WAL
record one after another.
Anyway, could you try to run pg_standby with pg_compresslog and
pg_decompresslog?
----
Additional recomment on page header removal:
I found that it is not simple to keep page header in the compressed
archive log. Because we eliminate unmarked full page writes and shift
the rest of the WAL file data, it is not simple to keep page header as
the page header in the compressed archive log. It is much simpler to
remove page header as well and rebuild them. I'd like to keep current
implementation in this point.
Any suggestions are welcome.
-------------------
I'll modify the name of the commands and post it hopefully within 20hours.
With Best Regards;
--
Koichi Suzuki
On Thu, 2007-03-29 at 17:50 +0900, Koichi Suzuki wrote:
Not only full-page-writes are written as WAL record. In my proposal,
both full-page-writes and logical log are written in a WAL record, which
will make WAL size slightly bigger (five percent or so). If
full_page_compress = off, only a full-page-write will be written in a
WAL record. I thought someone will not be happy with this size growth.
OK, I see what you're doing now and agree with you that we do need a
parameter. Not sure about the name you've chosen though - it certainly
confused me until you explained.
A parameter called ..._compress indicates to me that it would reduce
something in size whereas what it actually does is increase the size of
WAL slightly. We should have a parameter name that indicates what it
actually does, otherwise some people will choose to use this parameter
even when they are not using archive_command with pg_compresslog.
Some possible names...
additional_wal_info = 'COMPRESS'
add_wal_info
wal_additional_info
wal_auxiliary_info
wal_extra_data
attach_wal_info
...
others?
I've got some ideas for the future for adding additional WAL info for
various purposes, so it might be useful to have a parameter that can
cater for multiple types of additional WAL data. Or maybe we go for
something more specific like
wal_add_compress_info = on
wal_add_XXXX_info ...
In recovery.conf, I'd like to see a parameter such as
dummy_backup_blocks = off (default) | on
to explicitly indicate to the recovery process that backup blocks are
present, yet they are garbage and should be ignored. Having garbage data
within the system is potentially dangerous and I want to be told by the
user that they were expecting that and its OK to ignore that data.
Otherwise I want to throw informative errors. Maybe it seems OK now, but
the next change to the system may have unintended consequences and it
may not be us making the change. "It's OK the Alien will never escape
from the lab" is the starting premise for many good sci-fi horrors and I
want to watch them, not be in one myself. :-)We can call it other things, of course. e.g.
ignore_dummy_blocks
decompressed_blocks
apply_backup_blocksSo far, we don't need any modification to the recovery and redo
functions. They ignore the dummy and apply logical logs. Also, if
there are both full page writes and logical log, current recovery
selects full page writes to apply.I agree to introduce this option if 8.3 code introduces any conflict to
the current. Or, we could introduce this option for future safety. Do
you think we should introduce this option?
Yes. You are skipping a correctness test and that should be by explicit
command only. It's no problem to include that as well, since you are
already having to specify pg_... decompress... but the recovery process
doesn't know whether or not you've done that.
Anyway, could you try to run pg_standby with pg_compresslog and
pg_decompresslog?
After freeze, yes.
----
Additional recomment on page header removal:I found that it is not simple to keep page header in the compressed
archive log. Because we eliminate unmarked full page writes and shift
the rest of the WAL file data, it is not simple to keep page header as
the page header in the compressed archive log. It is much simpler to
remove page header as well and rebuild them. I'd like to keep current
implementation in this point.
OK.
This is a good feature. Thanks for your patience with my comments.
--
Simon Riggs
EnterpriseDB http://www.enterprisedb.com
Simon,
OK, different question:
Why would anyone ever set full_page_compress = off?
The only reason I can see is if compression costs us CPU but gains RAM &
I/O. I can think of a lot of applications ... benchmarks included ...
which are CPU-bound but not RAM or I/O bound. For those applications,
compression is a bad tradeoff.
If, however, CPU used for compression is made up elsewhere through smaller
file processing, then I'd agree that we don't need a switch.
--
--Josh
Josh Berkus
PostgreSQL @ Sun
San Francisco
On Thu, 2007-03-29 at 11:45 -0700, Josh Berkus wrote:
OK, different question:
Why would anyone ever set full_page_compress = off?The only reason I can see is if compression costs us CPU but gains RAM &
I/O. I can think of a lot of applications ... benchmarks included ...
which are CPU-bound but not RAM or I/O bound. For those applications,
compression is a bad tradeoff.If, however, CPU used for compression is made up elsewhere through smaller
file processing, then I'd agree that we don't need a switch.
Koichi-san has explained things for me now.
I misunderstood what the parameter did and reading your post, ISTM you
have as well. I do hope Koichi-san will alter the name to allow
everybody to understand what it does.
--
Simon Riggs
EnterpriseDB http://www.enterprisedb.com
Josh;
I'd like to explain what the term "compression" in my proposal means
again and would like to show the resource consumption comparision with
cp and gzip.
My proposal is to remove unnecessary full page writes (they are needed
in crash recovery from inconsistent or partial writes) when we copy WAL
to archive log and rebuilt them as a dummy when we restore from archive
log. Dummy is needed to maintain LSN. So it is very very different
from general purpose compression such as gzip, although pg_compresslog
compresses archive log as a result.
As to CPU and I/O consumption, I've already evaluated as follows:
1) Collect all the WAL segment.
2) Copy them by different means, cp, pg_compresslog and gzip.
and compared the ellapsed time as well as other resource consumption.
Benchmark: DBT-2
Database size: 120WH (12.3GB)
Total WAL size: 4.2GB (after 60min. run)
Elapsed time:
cp: 120.6sec
gzip: 590.0sec
pg_compresslog: 79.4sec
Resultant archive log size:
cp: 4.2GB
gzip: 2.2GB
pg_compresslog: 0.3GB
Resource consumption:
cp: user: 0.5sec system: 15.8sec idle: 16.9sec I/O wait: 87.7sec
gzip: user: 286.2sec system: 8.6sec idle: 260.5sec I/O wait: 36.0sec
pg_compresslog:
user: 7.9sec system: 5.5sec idle: 37.8sec I/O wait: 28.4sec
Because the resultant log size is considerably smaller than cp or gzip,
pg_compresslog need much less I/O and because the logic is much simpler
than gzip, it does not consume CPU.
The term "compress" may not be appropriate. We may call this "log
optimization" instead.
So I don't see any reason why this (at least optimization "mark" in each
log record) can't be integrated.
Simon Riggs wrote:
On Thu, 2007-03-29 at 11:45 -0700, Josh Berkus wrote:
OK, different question:
Why would anyone ever set full_page_compress = off?The only reason I can see is if compression costs us CPU but gains RAM &
I/O. I can think of a lot of applications ... benchmarks included ...
which are CPU-bound but not RAM or I/O bound. For those applications,
compression is a bad tradeoff.If, however, CPU used for compression is made up elsewhere through smaller
file processing, then I'd agree that we don't need a switch.
As I wrote to Simon's comment, I concern only one thing.
Without a switch, because both full page writes and corresponding
logical log is included in WAL, this will increase WAL size slightly
(maybe about five percent or so). If everybody is happy with this, we
don't need a switch.
Koichi-san has explained things for me now.
I misunderstood what the parameter did and reading your post, ISTM you
have as well. I do hope Koichi-san will alter the name to allow
everybody to understand what it does.
Here're some candidates:
full_page_writes_optimize
full_page_writes_mark: means it marks full_page_write as "needed in
crash recovery", "needed in archive recovery" and so on.
I don't insist these names. It's very helpful if you have any
suggestion to reflect what it really means.
Regards;
--
Koichi Suzuki
Hi,
Here's a patch reflected some of Simon's comments.
1) Removed an elog call in a critical section.
2) Changed the name of the commands, pg_complesslog and pg_decompresslog.
3) Changed diff option to make a patch.
--
Koichi Suzuki
Attachments:
pg_lesslog.tgzapplication/octet-stream; name=pg_lesslog.tgzDownload
� �~�E ��k�Y� �_��"*URb2_RJ%�j��II��W���jJN�f��d�#�Jeu���6<��0Xxv��5�lcac�c��?#w���y�WD�I=��#Rf2n�{����{�wz�I2�����>��}{n�������o��������������;�|sc~x��D�g��~�y�c���gj�����;��g��o���������������o�����_����K�u��p�=� ���������hB�{��c/�fi8 o���������O�g$i5�a�t-N����A����<�;8�o������G�{xa����:���:���Z���>P���U|P
'�����
�e�k8�z�sX���U�K���n���I�^�y��8L���$I�x�M/��~+��]|�H#����h��I��?
��~�O����]��w����.H>���p����7���f��=}�@�_�G}�����cz����4�I@O�|Ar��}\?�"�����=-���� ��F������/F���?�������������F�����WY8�������0��{0�<���o����P[o�9��� P�����Geh+����n<�E�[�����}��g���a�g���l��@�~��(C�8�O�3�������� i���q���������[;7���ln�������k���Q�O��V>.��jT����h�t������V���ln�A�i�SO��g��`�g�����J��/��I
��������� K[�_�!.��hD�4{���^0��k��>�6k�7����[���o��6o�����q�K�F^�����T:i?l����KI���_�W���"�;#o�f�'t���wr�����
��5?.������$��������L=��M�8���i4�.
��:��������_�u������:B�q���=�����6jf7�x9D������<|�.��]19�Y�$&���[[���H*%%�~\���R0J�R2� 0����\hU���jVO���]z6�z�(�V0�WP~�q���Y�d�R��2.F��<��k�������!��c\���62��������}|�9�w(�:��g��d�.~VL����������F,���1�������������D��������}|�o�,[_F���Q0&����D�����H�A������L���)�t�_�S��a����f�zu��xB������A�����N����zs [�����m��+|�a���������xHL�{����������!`!���������N��$8���0���0���o��������w���<�FO�����1��/�����_&af��`=�!���!U#4���u44��[Yp�P����&G@8�prF6�a�P��=.v �!hV�v�������>.��g�+5�����B��J;��4�MBY��j��erD��e
�O��(���6*�l\E�`�%*��?>�+������
^!*Y�
d����l�����^K#3
�~�>��g ����3��c�~��J��8z���������}��g{Z��V������A�,(��e�3�zOZ���N���{_u���*��Q��y���������������B�����:np�\z���7w���c���������^�?g����s�����#� �^ ����m�"+�A� }��mxG�o�_��5��u�F��N�m��oJ+����{��R�����>
&����M �$-��8����S*'/�g� h�%�u����eB���v���b3�����H��c���}�Ie#Q�z,� �C`Q���&�$J=��&U���:����]��~(on��V�[�'���`�t�O`"��{�{���3�1�_ 5���S���a+���(�8l�J>sz��yy����/�4�i�(�}t�ZN�2a��
��
�������?� ��_��?����/�
\E|keHk9���h� ���9������$����I�t������wU|$2/��Y�E�/j"����$�%)��%�hQg�!� �� 1��Q�j�
5��P.C��z �*�"J���G3�1�}E� R��;(����)�nf��l@��oS�B���<����G������J�@4K�/��!)^�6�!�Z6�:��c���������Gv��E�&9�1����=�d ��@�;�d�
^��,I/V ��LO��Z.$,�y%������z�
d����|P���+��`o�]���� 1�1j|�� Br�v��9U�Qu��`"��BS����UQ�:����G�U��O�l���&O5���>W����`Zy���Zj)45��
4j�G�=:���)(w�����~��"K�(�(���Uzz7+�}KL��4��;�&����9���4�n����2<L�q��HQ����g���!O*V�F�8�h�t�xe7�NB�(O9l2�����,D�N�&���;�v)`�A������Y/A ��x�o�-'�m��]�p��PP�������"|�UC�
@�����O�D�UU���<�'S�/aW@4H\���+��H\�c:��Q[�����Q�A�s_��1� �w�h>Of�����Z
�N2x|�1�J�p�1�d,��T/��w�,H�gd��t#?IU%�:�f��P
����=X��
$�x@���
c�������)XH��g��J =��?�����zVL^L4S����%L#@:�`����@���&}����H���:�2?���a���������Z��ch%�2�\1�vz�������7�3��R�����jw� T�uZ������-� �����zZ���S�J��Q4e|�����1��25r�`�v��
��Z�{��U��e2��NR��iL:��'~��P_��l\�Z��7��
��~X���?hp�JmB��G����Q��j3�$#[��~�uf��XeI���dk_���J�/��{�]�jEH�n��a��Zo������Bb��W0�"+R����2H"S5�y@���`��%\#��?$����*�%7�/�H�`�,E�H).L��"�������z,�����;s�z��6�8�?�4��F�Mg�G��L>� o�2��m��lZ�� ��{��3
��I��:�S���$M<�������g;��_(�#��������\�R�L�9���q0I�I%���
���&����rX�F���GF�"d
���h����9!N�I�eV�
�KW��Y-�K��7
b������p��b��>2#�0c��,��t����/��m�y��/��a:�5Z��M? �}�H�1���0����`�f
���E���!<�4%����~t������� t���� ���!���2��#`��F+LA3hG��� ?���0��������vp�K"
�~q���fJ_���uhxYp�#yd2��A���L����{�;��� ���#E^,};n$}(Z�����8���*�7Z�69$4��Q
AH&�3[f�����(
r�ud�y�!�,d(9�<�F����,�x��MF�B�1y)�/�T6f�%ytv�_����
%�n!$pd}C�!��Y$��Q��4���.��S�qS{�G�Z��A4�,�/�03�\#�=
�s���y��Lv[)3UY�� R�l(C,�j������*��to� M��R�/�l������M�J�5�(+[n<����0�,��d%S��@����E3��#<I�7vn!�c%�%�A�������wj[��J��&�.3��h��������[�����Q��������U�z�T�����K�x��jdx���,1[C�#j�o�����"��� 2���z��E�������`7�+,����\����::L@���" _q�4��s=c(]jz(SZ�-88��
�a)�a�����A`�nv��E^q� ��Mrf�M0��&�"�&K��}��,������1@'Q�_vJ������UJ�D��%�����@���i��E(�k��YjC�,���Y�p�����'��\�H�� ~�3��� �(=Rcg��@�A�F�9�Ca����7JgWH���[|���|d��%��S3[ ���pV��}�?�C�LH�>�!����U��8���\�� 6)��?�)�h���Jz�a6�����H���v�5<����V�;q��"0M_���:��p�%�d�f��{�;�N`��R��Q�6�8�Lq:���l�����j&_#c/��x����y��ta���2P6r�����
[J���A�����g-������[���<
�j/U���cXk�f������5<|Cv@���(`F�"����}�-�b��QA�t����L7 ��gX��L��S���j�C[to����%��(`g��md�@S?�~��67�Ib�'��C�����F�?@�����A�;����
x"��"��q�B�rH����Q%K�A�����K�\�dql�"��1y���xZ�~vX����$&b�x�L�������?>:���m�@�v����J������7*�;�+��"P}+2�� ���]�P�D<�$bP�D>Y�ZZ,��J��b�D��4�z�o�����?��������?�����������?���������������^����������������?�������E������O�?����������y�������������_�����y�#������������)����o���JF�����
���/�_�v;n/�
"^��U�.�]�uo[��1y�'��r��C ��.��p�a��v�[���d�%��HgCne7���
i��FM>��t���q��-���j�;�[����r����<����
��6[�ml
�=�������l�n-Vdv����W�,�75�m�S���d7��M�|[`W����};����s���������e(�:j�N���L3Q��
�*g����`�%K�CJ����M ��-Y�|n�5�Q�%��Q]xd-�f�zb9MY*�m3v�K'KC=�K�6�����
�pF��:�D��:d�t'N�WE`�#�A"��z=�J��w����� �r�.��������^��1m:D��Z#�CBe�� �vT=��� ���8x��v�:�v��J��`'I�]7��!Bg���x=�/gC��T���8AU��=�9z�����L�r��]����B���V�V���v_��l9���-�����-��5'%����*Y�H�/)���'���
)ZE�e�-L��.�(�F80������{�,nZ�e��2a:?/�������1j�V�����)(����
2c���t�M�8�S6���&!���2� �y�|�9 uE�0s2>���b>�U;YX����+��s�2r��^�%�K0����=��<�#��9V��&���Y���ere�,�6�e�pq���2�7�^�M��g��te�LK�;_q������yN�B#QG���{�w��.��-,�me��5�H��
���63���a\��2�����I���Vle���3�X.ME�+���)���rS���y�����Y����-���'��#���0�[�O9����p?�2L�]
t�P�<�D��:$���[��!�.�-b^)�*��4F�BE� �2Y���� ���<����T���*8E�� ������U�F���d�\�lRJAXH������������rm-�I�~ 2����KGa�G�*�NeW�������;����G��w������H"i�)����&y���B���Y�fax�rwP�Sa/�3b�3uiqJ+/L�g�K%Y�b~����TSP��V8�#��hO���"���):��E�Lze��t��v��}��� -���T������|g�S+�u�s���p��wU�
�S�9�J���^��sD)�����q���4��;!�$`T3���B"��5*M;�+���]f
x�N�'w�O�\0���,e�ec�Y�f�$�uD� �
�uw-��{e;��h� �����3�ax������������/�/^��o_����������o���?����^�������7�O���������?�����9-��gz(��s��P����m�o����z��{���QA>����� �11R��rI�T�Z�<�����<��N}��*�H/l��2�����o/���fucI>���KM��e������fh2�4����m���(�����vp��������2����`�� h�"�xa8�[,��
e����$����`)���n��F&��P8�E��t��]OB���L��df�hf���ryZf���s�E�f�W����9��y3s��w
6(�yn�#�b�>Lmy�`~�K,* I�����"`5_�iu�YQ��X���
m:�<���{��d|���L��
���mf�/*]��b�]�#Fd�"��'R�y��W�qu��J��h0��aCgX)�JX��A!�:oG����2��%�U5���OI���CN~D��g>^���~���V�K���Q�D���+$����$H�����������EYr�:��������K�|hEqxN�N���yS�e�V�
&I�(H�p�����-���\�������j�Q���0�������;)��= _O���0'bC��|������]7&+��z�c�:v�N����6
R���=
yk�~8����Qxo����.�i�"��,S��?+��sI'�J��n���@N.*�j[
���i�Vj,����B��-#��hT�%�2�2�yF��;�� C�)Ls����| {�&���U���y�Z�Y�w��yJ/z Mr���G)�C�xr�ZV�Mk�nW����3��+��!�b3I�����v�|�c$�l�>���G�i-�>�c�2f2�s8%�6{�.�2S�����>_�he��#du�
q�c��F�eB��s0N�t���:����z�2�X<8���i!U��| �u�}j�tUV�+���I�%�����Py^^�z���K����m��\S�FA�L�N���>�"�Z�DT<u�����H�d��9a��9��������������>�����b~*��4hGQ��R�8#dg��i5��=��N�d������;�!���j�s��d��U�C<�6��=f������X���%���E�Gz-s8I��rl��]ciV0/$�����]��M�k����
�E"�C"��*�A�� �� ��IWRX�LD�������M�R�{���ci���������2����'*A�`�!��3��L��W[�-������N��]�`��^�,�io�U��1�4��1[���Z�E�%�
�e�>L��v����m��sJ}�����
�j�9�_����6.qn�������CHlo,��t6e!�,��X��m�?��,��(��d�D��hmp�J�9:������� �U5�'S�g��?���� ���+>I`�z,�t�a���s��[!��;�x�hM�!�� 01S.'�a�=�w�(��V���������4>��!���s��9�)�lo�*�"sO9�����* �*�d)8���=��]V�@���A���*t��}���F$�W.�@�
4��tn�OL�W��G����h�
��v�e)jc���e����p��'��tVD�=~����QQQ&�I�
�Jb��uS��RHW��� kI+:�g/s�U�B��`2HTMpY,�V���UQ���3�j�5R�A���ZK��� � !;~� ���8������b/�eF�E���P���� �\����x�L���b�h�0S���k��P-��u�P.O�P$]&���~dU���x�>}}�����z�4�I�0�za$"%X7���V�J���C*�N�Df(�~-������Y�\irrI����s��� G����o���i �x�!����iE���N5>���d1������J(v�E�u��rOb���#����{�<����T�^��E���S�����������O��om���6om��R��nlo�|���=~!��k}o-�k��U��_��0�n��g�W����(7z���7`ekccgmskmc�������������x76>��(���]�s{mc{m�s�����wo���s��������7�<��/�=�}���_E�:i>�����yd�T<�\���m�C6J����7�O:��7G{��F���~��ia����F���5#�~���{�adL��9�5��s:���u�}e�(����Nug[p��g�7�,I�G�N���}�n���G!<,`�W����/��3H{�!��6�C�#�[��t�KR�
:��v���H�Dvw,z�M����u��ssS-�{��o�tH�w}��u���i��M7���'VQ�_�RiB�[U�S1/����X��G�<���V���nn����i�?�
NG�qZ��/Fg�E�`D{�.�������������MB����J�-���7�T?��6�����������EW���80Et��P�:����xH����%oGg�B�'��QI��U=�h���TT?�.��&�5i��[[��Q5+�@P�&
���w����d07J�c#����(@��;��s��MH�[�L��4��p(���������vg�k�#6��}9��~`�����Pc��\�����
<�(���n
�fl0'E�S `�9��(p���Fu��}��F�p7�h')���3��)��
����%���,�f`�E �1f���L�k5�v�YW��������@>��*���qr��h���O��3�@'��R��'��<Y�����V�������0�,��/��>���V><f��y���;���;f?�G.�_���}���T&��Q�)c�� �>8�F������M~��S�=�s8�vtY�Z[@~��5��ax\��,��o��u/l�d���C���o6]�� ��kw~)����vh9�������t�� ��'�����a�Q�>�����nt`����/o�j[qdY�>�#b^�`���r�.~/"Q4�������d���H�o|�,J6�G���
��x���B^&�A��7������%9����m�%wzf��W?���u�s���d}&���Y��7��^E���+Z�&j�[�wom���}��Y���`n�����P�ur��/�o-Z/�!�W�t�i;�a�����LH�HvS���j� 9y��O����w��N������[�L��f��n�Y|z���S�uk�������[;����[%q��'���~C�7�y�e���<������TI���i=lW�%�7� gwl��*�����&&b����!1�p��j���U�ST��i�5mgv7<y�5���&h�L���eZ'��0�N�U�@5��>~�8��������u� �<�b
�����.h������"����jwB"�?K�1Z�ig�36��f;����������^������^/��l�Mos�.���W����|-n�y�fu����� ��q�+����HPO��hvvn?%W��������N
��q������o'�%@��
������W+�UjK������]�
4z�}��|�K��@^�[�v�D���������; O�k}���A0�/�����o�m�1� ���z�&��WN�u�b,�@���d����6v���won����C|s�-B�����V
f�x,Y_���=S��
���R?u�:ZuT��1Y��q2=w�*��A�D�1�k���e�J�07#ao�n�4H�����R��P��M��/�yGD7T0��%S`l�rO�1����7�r�?�9h�m D�5h6���kh=����
MU�kTs2(WV6^l4P@B`�z�{��!!��a���������'X����cZ8�c���8�r?�h��Y�7���$@���K�/��k������hs��U��ax�����-�d��m��^�N'Ju� � ��E��*|wS�{s�����n�w����}W�PE/o��7�F�i;�#��d���H+��g�E�����m�������m5�������m������ssk3[��C����1����{�Ayd}sk}k���{,�]M�V*Y/S��up��>�0��lP��',�u`� ��b�E�B��m����|-$�A6Mj����
X@����|{(zL�
Y��t��
��O������1���aH����R�^�lN��P$�ELoB�E�����p[�,@����7�q�]|B�����8��Rf0��������m2,�������T?���'����/�]y�Y(���b�#�����L���`)�4���hg�:�t� ��fo��s���$]d�!`.�����y���V�V�e�����}DQj�oz��N���H�����@���k$�k���*�x�eh#�.�n-}����q������T��*�Om~�z���N�o[S���_[����}�����@@E�h��^��y��T]��q7�H�����Y��k��i��X+)6��<[������������v�k��bA�*4EQ��+�f1��8P9��h����QN�`��Z�f�����(l�w��n$���PO���tCl�X�����L'��{��Z�[5�1�,��fEd��S�����r��5��F�0��\2t�P�A���^�B#K�S��b�gY�}���V?��z_�m������'���
6������h
gk�RX%�K������H
�|[�em>���sq��s`�c�p��D<�&��7)�T8M�9����'�:L�T1����� *2���-�v�E:8�T�9):��C�2G�X��|�"T9��Zt�sA��B�b5��
��+����((<m����3
��G���{�����b?e.�>O�Hw;1�U���0(�=|��=� y!u����r�6kV��j]��K��e
�y�Er�=���Y���:�R����/\(��K�YN����]���{'����Yu1,�B�� %�> J��4�P��`O%Y�Q\3���6���V�����B����u����J��������77�?�������'`eS��7���so���p�k�(�����W���29e&���N)$ LT�qS*z ��$�$��mi\����H����T�X��p��Lf�y���{V�������W����1�JS�H�[�A���EESR�Xi��`w���P)�����[���0�
o#VSZY%��j��vh����'�����&�>|�����o�������z�a����vv�'{��[��!g���o[��w�|{�|{�|{�|����s��Q�~b�B&��i5,�6ev���Gvk�^+�Z����v0$l7~�y�:&}�f���\�c��9A��j���v���*)N�T�s�:�9��Qg>�*��!���Y�Of���9���)�E
T��R���
�Q�$����@��<Xf�c2^' qv���$�2)����@�I���UU������XS.$���qC$ �3���
����'�A�����
����L �v����}����
��g�J �}������?g���y�/v`����xy�������������^��=�!�!�������� �!���������M��������P�,�}���j��'
Z���g��(x�c��)QxBa.�W�����������3L!y������dp})c���TyQ��Q�7V�`��~��y��p�es �#�Y�!~��<�2}�&����Tn��v�v��k^�T��!zAt�ra��4S[F��5����h6F*2�EV�X�����m��c��Xy#u�W8��
���D����lY�]h���?�V��S��,���B%C,Y�U�����
y�
�E�`U�{�_�W?9��L������Uk*��E��VY���[��dZH���K��F�=�4�dv� {F/�g�D���1�����e0�O0,R�i������Y�@��dk��m+6�!���L ����e�g����F%������e����?9M����������?W���7w�����{����N�58��Xp��A�������)w����<�;8�o��T�P��)��sS���c�:m���a���>�Ig�`���[�������p���n��NE?���W�������V�& b��?5�~���������H�o}���s���������~>�<���fm��ym6=G�M��^�RK����@�;mQ���^r���z@�g #�/..j�F�W����������A�:�ic�jH�0���+_����WH�
d��
rI
3A�LG����5��w�X���)~K?�^�V�<