Two new articles for review
Giorgos Keramidas
keramida at freebsd.org
Tue Aug 30 11:06:19 UTC 2005
On 2005-08-30 03:18, Murray Stokely <murray at freebsdmall.com> wrote:
> I've committed two new articles to the tree and both could use some
> review and improvement before we announce them to the world. If you
> have time, please take a look and see what improvements you can make :
>
> Argentina.com Case Study :
>
> http://www.freebsd.org/doc/en_US.ISO8859-1/articles/casestudy-argentina.com/
Some proposed fixes attached. Very nice case study :)
%%%
Index: article.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/casestudy-argentina.com/article.sgml,v
retrieving revision 1.1
diff -u -r1.1 article.sgml
--- article.sgml 30 Aug 2005 00:00:25 -0000 1.1
+++ article.sgml 30 Aug 2005 11:04:48 -0000
@@ -38,7 +38,7 @@
<title>Overview</title>
<para>Argentina.Com is an Argentine ISP with a small infrastructure
- of fewer than 15 employees and whose primary source of income
+ of fewer than 15 employees, whose primary source of income
originates in the free dialup business. It began operation in the
year 2000 with barely one server for mail and chat.</para>
@@ -52,8 +52,8 @@
factor of 10 with regard to the mail user base.</para>
<para>Our competitors in the Argentine market of free dialup include
- Fullzero which is owned by the Clarin Media Group, Alternativa
- Gratis, and Tutopia which is funded by IFX and promoted by
+ Fullzero, which is owned by the Clarin Media Group, Alternativa
+ Gratis, and Tutopia, which is funded by IFX and promoted by
Hotmail. Some of these large corporate competitors started their
free dialup business with multi-million dollar investments and
aggressive television and Internet ad campaigns. Argentina.Com
@@ -61,8 +61,9 @@
It has climbed to the fourth position and to an 8% market share
during the last two years thanks to superior quality of service.</para>
- <para>In Argentina and Latin America in general people who don't
- have computers at home go to so called <quote>Locutorios</quote>
+ <para>People who live in Argentina and other parts of Latin America do not
+ always have computers or Internet access at home. As a result, they
+ frequently use one of so called <quote>Locutorios</quote>
(Internet Centers), where for a few pesos they can use a computer
connected to the Internet and usually read and write emails
through popular webmails like Hotmail, Yahoo or
@@ -80,8 +81,8 @@
<para>The main challenge for Argentina.Com is to achieve a dialup
uptime of at least 99.95%, or less than 5 hours yearly
downtime. Due to the high rotation and volatility in this
- business, things have to work correctly so the user doesn't switch
- -voluntarily or not- the dialup provider or the number he calls to
+ business, things have to work correctly so the user does not
+ switch—voluntarily or not—the dialup provider or the number he calls to
connect. The dialup business involves a support structure to deal
with the Telcos about telephony problems and quality of service,
plus a technical structure where latency and packet-loss should be
@@ -104,12 +105,12 @@
made it necessary to design the new system with at least 300M user
disk space, but at a cost lower than 3 US dollars per GB with some
degree of redundancy. Bear in mind that rackmountable hardware is
- hard to find in Argentina, and is between 30 and 40% more
+ hard to find in Argentina, and is between 30 to 40% more
expensive than in the US. Our total budget for equipment
- acquisition in two years was 75,000 USD, which is only a fraction
+ acquisition in two years was $75,000 USD, which is only a fraction
of our direct competitors' investments.</para>
- <para>With regard to the antispam service, it became necessary to
+ <para>As part of our antispam service, it became necessary to
develop a product that could compete with the systems offered by
the big ones. Given the hostile conditions imposed by the
existence of spam (dictionary attacks, spams with high degree of
@@ -117,11 +118,11 @@
it becomes very difficult to achieve an excellent uptime while
repelling attacks. One must also be careful that the user doesn't
lose mails because of false positives in the classification
- strategy, that he doesn't become flooded with spam or spam
- notifications, and dangerous mails don't make it through to his
+ strategy, that he does not become flooded with spam or spam
+ notifications, and dangerous mails do not make it through to his
mailbox. In addition, the technical infrastructure for spam
- classification shouldn't introduce noticeable delays in the
- delivery of mails. Finally, the mail system has to be protected
+ classification should not introduce noticeable delays in the
+ delivery of messages. Finally, the mail system has to be protected
from spammers who might misuse it to send spam.</para>
<para>The opensource paradigm tends to require hiring large teams of
@@ -135,7 +136,6 @@
Computer Science professionals are hard to find, most of them live
and work abroad, while the remaining have stable jobs either at
the government or big companies.</para>
-
</sect1>
<sect1 id="freebsd">
@@ -152,7 +152,7 @@
a Megaraid card, but the disk latency was enormous and the mail
application never really worked.</para>
- <para>The first step depicted towards the "FreeBSD solution"
+ <para>The first step depicted towards the <quote>FreeBSD solution</quote>
consisted in migrating this hardware and commercial software to
FreeBSD 4.8 with Linux emulation.</para>
</sect2>
@@ -179,8 +179,8 @@
double-Xeons and a few double-Opterons to be co-located in the
Datacenters where we have dialup and hosting operation
contracts. All of them run FreeBSD, ranging from 4.8 (there are
- a couple with two years uptime and zero trouble) til currently
- 6.0-BETA2.</para>
+ a couple with two years uptime and zero trouble) to fairly recent
+ versions, like 6.0-BETA2.</para>
<para>The general policy for the operating system is to try to
bring all servers periodically to the stable code branch by
@@ -202,16 +202,15 @@
and making it possible to deal with TTLs between 60 and 600
seconds to have quicker response in case of trouble.</para>
- <para>Second step was to deploy two more boxes of the same class,
- again in different Datacenters, to only deal with Radius and
+ <para>Our second step was to deploy two more boxes of the same class,
+ again in different datacenters, to only deal with Radius and
recursive DNS. The Network Access Servers at the Telcos were
configured to send Radius Authorization and Accounting to those
- servers, and to assign these recursive DNSs to dialup users.</para>
+ servers, and to assign these recursive DNS servers to dialup users.</para>
- <para>The third <quote>golden rule</quote> never to put SMTP
+ <para>The third step was to apply the <quote>golden rule</quote>: never to SMTP
incoming and outgoing in the same servers. We deployed separate
FreeBSD boxes with postfix for incoming and outgoing mail.</para>
-
</sect2>
<sect2 id="freebsd-email">
@@ -238,14 +237,14 @@
defined a few spam levels going from the least to the most
tolerant, each one with cutoff or discard levels. Every email
with a score below the one associated with the selected spam
- tolerance goes to the user's Inbox. Emails between this level
- and the cutoff level go to a user's folder named Spam, and those
+ tolerance goes to the user's <quote>Inbox</quote>. Emails between this level
+ and the cutoff level go to a user's folder named <quote>Spam</quote>, and those
above the cutoff level get discarded because it's a very obvious
spam. For the sake of simplicity, we transparently associated
- the use of the Address Book with the antispam system, so that
+ the use of the <quote>Address Book</quote> with the antispam system, so that
every personal contact gets automatically whitelisted.</para>
- <para>With the introduction of Spamassassin 3.x, the DNS traffic
+ <para>With the introduction of Spamassassin 3.x, the DNS traffic
to query global blacklists grew considerably, so we signed
agreements with SpamCop, Spamhaus and SURBL to install public
mirrors of their databases in our FreeBSD equipment. Thanks to
@@ -256,9 +255,9 @@
soon as we started building a new Cyrus-Imap back-end with MySQL
authentication, we needed to multiplex incoming mail to users in
both old and new maildrop formats. Finally, we managed to
- migrate hundreds of thousands of mailspools to the new Cyrus
- architecture using a great tool named imapsync, which is
- directly installable from ports. We also put perdition, a POP3
+ migrate hundreds of thousands of mailspools to the new Cyrus architecture using a great tool named
+ <filename role="package">mail/imapsync</filename>, which is directly installable from ports. We also put
+ <filename role="package">mail/perdition</filename>, a POP3
and IMAP proxy, in the middle to assure a transparent migration
and distribution of mailboxes across several servers. Briefly,
all information of where a user's maildrop is located resides in
@@ -270,17 +269,17 @@
biggest are Pentium IV with 4G of RAM and 3ware cards in chassis
with 12 hotswappable bays, organized in 3 RAID-5 units of 1
Terabyte each. The 3ware software sends you en email whenever
- the RAID is degraded -mostly because of a failing disk- and lets
+ the RAID is degraded—mostly because of a failing disk—and lets
you rebuild the RAID with everything up and running. We use
- smartmontools in the cases where we have less redundancy, to
+ <filename role="package">sysutils/smartmontools</filename> in the cases where we have less redundancy, to
have immediate alerts of disks with temperature problems or
failing selftests.</para>
<para>As webmail software, we chose a commercial product named
Atmail, which is available with perl sources and utilizes
- mod_perl. Under FreeBSD it's extremely easy to deal with perl
+ <filename role="package">www/mod_perl</filename>. Under FreeBSD it's extremely easy to deal with perl
modules, you don't even need to use the CPAN shell, you just
- have to choose the right port and run "make install". After
+ have to choose the right port and run <quote><literal>make install</literal></quote>. After
several months of integration work, we integrated the
Client-only version of Atmail that talks IMAP with our
back-ends. We had to modify some parts of the code to adapt the
@@ -296,7 +295,7 @@
<para>With the adoption of FreeBSD, there was almost no additional
effort necessary to setup a working Apache, PHP and MySQL
environment in minutes. Even the upgrades from PHP4 to PHP5 were
- painless. The ports system was again extemely useful in these
+ painless. The ports system was again extremely useful in these
cases, and permitted us to do things like compress text and html
contents in Apache with just a few lines of documentation. In
addition, we have experienced excellent performance and
@@ -317,13 +316,11 @@
other fields like hosting for resellers and housing with presence
in three Argentine Datacenters.</para>
- <para>We offer now also corporate dialup for roaming users in
- Argentina and Peru thanks to our presence and contracts with most
+ <para>Now, we also offer corporate dialup for roaming users in
+ Argentina and Peru, thanks to our presence and contracts with most
Telcos. Among our indirect customers, there are major American
companies like Ford, Exxon and Reuters. We now run the free dialup
business in Brazil, Chile, Colombia and Panama as well.</para>
</sect1>
</article>
-
-
%%%
More information about the freebsd-doc
mailing list