From owner-svn-doc-all@FreeBSD.ORG Tue Sep 18 09:15:09 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2497D106566B; Tue, 18 Sep 2012 09:15:09 +0000 (UTC) (envelope-from ebrandi@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 0EBFF8FC19; Tue, 18 Sep 2012 09:15:09 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q8I9F93k061852; Tue, 18 Sep 2012 09:15:09 GMT (envelope-from ebrandi@svn.freebsd.org) Received: (from ebrandi@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q8I9F86X061848; Tue, 18 Sep 2012 09:15:08 GMT (envelope-from ebrandi@svn.freebsd.org) Message-Id: <201209180915.q8I9F86X061848@svn.freebsd.org> From: Edson Brandi Date: Tue, 18 Sep 2012 09:15:08 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r39577 - in head/pt_BR.ISO8859-1/articles: . hubs X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Sep 2012 09:15:09 -0000 Author: ebrandi Date: Tue Sep 18 09:15:08 2012 New Revision: 39577 URL: http://svn.freebsd.org/changeset/doc/39577 Log: - Add new Brazilian Portuguese translation of the Mirroring FreeBSD article Obtained from: The FreeBSD Brazilian Portuguese Documentation Project (http://doc.fug.com.br) Approved by: gabor (mentor) Added: head/pt_BR.ISO8859-1/articles/hubs/ head/pt_BR.ISO8859-1/articles/hubs/Makefile (contents, props changed) head/pt_BR.ISO8859-1/articles/hubs/article.sgml (contents, props changed) Modified: head/pt_BR.ISO8859-1/articles/Makefile Modified: head/pt_BR.ISO8859-1/articles/Makefile ============================================================================== --- head/pt_BR.ISO8859-1/articles/Makefile Mon Sep 17 21:11:48 2012 (r39576) +++ head/pt_BR.ISO8859-1/articles/Makefile Tue Sep 18 09:15:08 2012 (r39577) @@ -13,6 +13,7 @@ SUBDIR+= contributing SUBDIR+= contributing-ports SUBDIR+= explaining-bsd SUBDIR+= freebsd-questions +SUBDIR+= hubs SUBDIR+= linux-users SUBDIR+= new-users SUBDIR+= problem-reports Added: head/pt_BR.ISO8859-1/articles/hubs/Makefile ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/pt_BR.ISO8859-1/articles/hubs/Makefile Tue Sep 18 09:15:08 2012 (r39577) @@ -0,0 +1,22 @@ +# +# The FreeBSD Documentation Project +# The FreeBSD Brazilian Portuguese Documentation Project +# +# $FreeBSD$ +# +# Original revision: r38826 +# +# Article: Mirroring FreeBSD + +DOC?= article + +FORMATS?= html html-split +WITH_ARTICLE_TOC?= YES + +INSTALL_COMPRESSED?=gz +INSTALL_ONLY_COMPRESSED?= + +SRCS= article.sgml + +DOC_PREFIX?= ${.CURDIR}/../../.. +.include "${DOC_PREFIX}/share/mk/doc.project.mk" Added: head/pt_BR.ISO8859-1/articles/hubs/article.sgml ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/pt_BR.ISO8859-1/articles/hubs/article.sgml Tue Sep 18 09:15:08 2012 (r39577) @@ -0,0 +1,1369 @@ + + + %entities; +]> + + + +
+ + Espelhando o FreeBSD + + + Jun + Kuriyama + +
kuriyama@FreeBSD.org
+ + + + Valentino + Vaschetto + +
logo@FreeBSD.org
+ + + + Daniel + Lang + +
dl@leo.org
+ + + + Ken + Smith + +
kensmith@FreeBSD.org
+ + + + + + &tm-attrib.freebsd; + &tm-attrib.cvsup; + &tm-attrib.general; + + + $FreeBSD$ + + $FreeBSD$ + + + Este artigo aborda a configuração de um site espelho + destinado à distribuição do FreeBSD e tem como público alvo + os administradores destes sites. Este é um trabalho em + andamento. + + + + + Neste momento nós não estamos aceitando + novos sites espelho. + + + + Informações de Contato + + Os coordenadores do sistema de sites espelho podem ser + contatados por email no endereço + mirror-admin@FreeBSD.org. Também existe a + &a.hubs;. + + + + Requisitos para espelhar o FreeBSD + + + Espaço em disco + + Espaço em disco é um dos requisitos mais + importantes. Dependendo do conjunto de releases, de + arquiteturas e do grau de cobertura que você deseja que + seu site espelho tenha, uma enorme quantia de espaço em + disco pode ser consumida. Também tenha em mente que os sites + oficiais provavelmente precisam estar + completos. O repositório CVS e as páginas web devem + ser sempre espelhados de forma completa. Também + observe que os números mencionados neste artigo estão + refletindo o estado atual + (&rel2.current;-RELEASE/&rel.current;-RELEASE). + Desenvolvimentos futuros e novas releases apenas irão + aumentar o espaço requerido. Certifique-se de manter + algum espaço extra (entre 10 e 20%) disponível, em + relação as estimativas abaixo, apenas por + segurança. Aqui estão algumas estimativas + aproximadas: + + + + + Distribuição FTP completa: 1.0 TB + + + Repositório CVS: 5.4 GB + + + Deltas CTM: 3.2 GB + + + Páginas Web: 463 MB + + + + O uso atual de espaço em disco pela + distribuição FTP pode ser encontrada em + ftp://ftp.FreeBSD.org/pub/FreeBSD/dir.sizes. + + + + + Conectividade de rede e largura de banda + + É claro que você precisa estar conectado à + Internet. A largura de banda que será + necessária dependerá do uso previsto para o seu + site espelho. Se você só quer espelhar algumas + partes do FreeBSD para uso local no seu Site/Intranet, a + demanda pode ser muito menor do que se você quiser + tornar os arquivos disponíveis publicamente. Se + você pretende se tornar um site espelho oficial, a + largura de banda necessária será ainda maior. + Desta forma, nós só podemos dar estimativas + grosseiras em relação a este item: + + + + Site local, sem acesso público: basicamente + nenhum, mas um link menor que 2 Mbps pode tornar o + processo de sincronismo muito lento. + + + + Site público não oficial: um link de + 34 Mbps é provavelmente um bom ponto de + partida. + + + + Site oficial: recomenda-se um link de no + mínimo 100 Mbps, e o seu servidor deverá + estar conectado o mais próximo possível + do seu roteador de borda. + + + + + + Requisitos de sistema, CPU e Memória RAM + + O dimensionamento destes itens depende do número + esperado de clientes simultâneos, o que é + determinado pela política de uso do servidor. Estes + requisitos também são afetados pelo tipo de + serviço que você deseja oferecer. + Serviços básicos de FTP ou HTTP podem não + necessitar de uma grande quantidade de recursos. Mas fique + atento se você for disponibilizar os serviços de + CVSup, rsync ou mesmo de AnonCVS. Estes serviços podem + ter um enorme impacto nos requisitos de CPU e de + memória. Especialmente o rsync, o qual é + considerado um devorador de memória, e o CVSup + certamente consome um pouco da CPU. No caso do AnonCVS pode + ser interessante configurar um sistemas de arquivos residente + em memória (MFS) de no mínimo 300 MB, desta + forma você precisa considerar este consumo quando + avaliar a quantidade de memória requerida. A seguir você + irá encontrar alguns exemplos, os quais visam apenas + lhe dar uma idéia por alto das necessidades. + + Para um site de visitação moderada o qual + ofereça o serviço de + Rsync, você pode considerar + uma CPU entre 800 MHz e 1 GHz, e pelo menos 512 MB de + memória RAM. Esta é provavelmente a + configuração mínima para um site espelho + oficial. + + Para um site de visitação frequente, + você definitivamente vai precisar de mais memória + RAM (considere 2 GB como um bom ponto de partida) e + possivelmente de mais poder de processamento (CPU), o que + pode significar que você precisará ir para um + sistema multiprocessado (SMP). + + Você também pode considerar o uso de um + subsistema de discos rápidos. As + operações em um repositório CVS + necessitam de um subsistema de discos rápido (o uso de + RAID é altamente desejável). Uma controladora + SCSI que possua cache dedicado também pode melhorar a + velocidade uma vez que a maioria destes serviços + incorre na realização de um grande número + de pequenas modificações no disco. + + + + Serviços para oferecer + + Todo site espelho é obrigado a disponibilizar um + conjunto de serviços básicos. Em + adição a estes serviços + obrigatórios, existe um grande número de + serviços opcionais os quais o administrador do servidor + pode optar por oferecer. Esta sessão irá + detalhar quais serviços você pode oferecer, bem + como implementá-los. + + + FTP (necessário para o conjunto de arquivos + do FTP) + + Este é um dos serviços mais básicos, e ele é + requerido em todos os sites espelhos que oferecem + acesso público às distribuições + via FTP. O acesso ao FTP deve ser anônimo, e não + é permitido o uso de nenhum controle nas taxas de + upload/download (o que seria uma coisa ridícula de + qualquer maneira). Não é necessário + ter o upload de arquivos habilitado (e isso + nunca deve ser permitido na área + onde os arquivos do FreeBSD são mantidos). Os + arquivos do FreeBSD devem ficar disponíveis sob o + caminho /pub/FreeBSD. + + Existem diversos softwares disponíveis os quais + podem ser configurados para operar como um servidor de FTP + anônimo. Por exemplo (em ordem + alfabética). + + + /usr/libexec/ftpd: Este + é o servidor de FTP nativo do FreeBSD. + Certifique-se de ler o &man.ftpd.8;. + + + ftp/ncftpd: Um + pacote comercial, gratuito para uso com fins + educacionais. + + + ftp/oftpd: Um + servidor de FTP desenvolvido tendo a segurança + como seu foco principal. + + + ftp/proftpd: + Um servidor FTP modular e muito + flexível. + + + ftp/pure-ftpd: + Outro servidor de FTP desenvolvido tendo a + segurança em mente. + + + ftp/twoftpd: + Mais um servidor desenvolvido com foco em + segurança. + + + ftp/vsftpd: + Um ftpd muito seguro. + + + ftp/wu-ftpd: + O ftpd da universidade de Washington. Ele se tornou + impopular, por causa da enorme quantidade de problemas + de segurança que foram descobertos nele. Se + você optar por utilizar este software, + certifique-se de mantê-lo atualizado. + + + + O ftpd nativo do FreeBSD, o + proftpd, o + wu-ftpd e talvez o + ncftpd são alguns dos + servidores de FTP mais comumente utilizados. Os demais + não possuem uma grande base de usuários + entre os sites espelhos. Um item a ser considerado + é que você pode precisar de flexibilidade + para controlar quantas conexões simultâneas + serão permitidas no servidor, limitando desta forma + o consumo do seu link IP e dos demais recursos do + sistema. + + + + Rsync (opcional para o conjunto de arquivos + do FTP) + + O Rsync é muitas vezes + oferecido para acesso ao conteúdo da área de + FTP de um site espelho do FreeBSD, desta forma outros sites + espelhos podem utilizar o seu sistema como fonte para se + espelhar. O protocolo do rsync é diferente do FTP em + muitos aspectos. Ele é muito mais amigável em + relação ao consumo de banda IP, uma vez que + quando um arquivo é alterado ao invés de + transferí-lo por completo novamente, ele transfere + apenas as diferenças entre as duas versões do + arquivo. O Rsync requer uma + grande quantidade de memória para cada + instância. A quantidade de memória alocada + depende do tamanho do modulo sincronizado em termos do + número de diretórios e de arquivos. O + Rsync pode utilizar o + rsh e o ssh (que agora + é padrão) para transporte dos dados, ou + então utilizar o seu próprio protocolo para + acesso stand-alone (este é o método preferido + para um servidor público de + Rsync). Obrigatoriedade de + autenticação, limites ao número de + conexões simultâneas e outras restrições + podem ser aplicadas. Há apenas um pacote de software + disponível para se implementar um servidor de + Rsync: + + + + net/rsync + + + + + HTTP (necessário para as páginas web, + opcional para o conjunto de arquivos do FTP) + + Se você deseja disponibilizar as páginas + web do FreeBSD, você vai precisar instalar um + servidor web. Opcionalmente você poderá oferecer + acesso a sua árvore de FTP via HTTP. A escolha do + software do servidor web é uma escolha do + administrador do site espelho. As opções + mais populares são: + + + www/apache22: + O Apache é o + servidor web mais amplamente utilizado na internet. + Ele é usado extensivamente pelo projeto + FreeBSD. + + + + www/thttpd: + Se você for servir uma grande quantidade de + conteúdo estático, você pode + constatar que o uso de uma aplicação + como o thttpd é mais eficiente do que o uso do + Apache. Ele está + otimizado para operar sob a máxima performance + no FreeBSD. + + + + www/boa: + O Boa é uma outra + alternativa ao thttpd e ao + Apache. Ele deve prover + uma performance consideravelmente melhor que a do + Apache para conteúdos puramente + estáticos. Ele não possui, pelo menos + até o momento em que esse artigo está + sendo escrito, o mesmo conjunto de + otimizações para o ambiente FreeBSD que + encontramos disponíveis no + thttpd. + + + + + + CVSup (desejado para repositórios CVS) + + O CVSup é um meio + muito eficiente de distribuição de arquivos. + Ele trabalha de forma semelhante ao + rsync, mas foi especialmente + projetado para uso com repositórios CVS. Se + você deseja disponibilizar o repositório CVS do + FreeBSD, você deve considerar seriamente fazê-lo + via CVSup. É + possível oferecer acesso a um repositório CVS + via AnonCVS, FTP, + rsync ou HTTP, mas as pessoas + vão se beneficiar muito mais de um acesso via + CVSup. O + CVSup foi desenvolvido pelo + &a.jdp;. É um pouco complicado instalá-lo em + uma plataforma diferente do FreeBSD, uma vez que ele foi + escrito em Modula-3 e consequentemente necessita de um + ambiente Modula-3 disponível. O John Polstra preparou + uma versão simplificada do M3 a qual é + suficiente para executar o CVSup, + e que pode ser facilmente instalada. Consulte Ezm3 + para maiores detalhes. Os ports relacionados + são: + + + + net/cvsup: + O port nativo do CVSup (cliente e servidor) o qual + requer a instalalação do lang/ezm3. + + + net/cvsup-mirror: + O kit de espelhamento do CVSup, o qual requer o + net/cvsup-without-gui, e que + o configura para atuar no espelhamento dos + serviços. Alguns administradores podem preferir + utilizar uma forma diferente de configurar um site + espelho. + + + + Existem alguns outros, como o net/cvsup-without-gui o qual + você pode desejar olhar. Se você preferir um + pacote binário, compilado estaticamente, de uma + olhada aqui. + Esta página continua mencionando o erro SG1, o qual + esteve presente no CVSup. Talvez + o John venha a criar no futuro um site genérico para + download de binários estáticos para + várias plataformas. + + É possível utilizar o + CVSup para disponibilizar + qualquer tipo de arquivo, e não apenas + repositórios CVS, mas a configuração + pode ser complexa. O CVSup + é conhecido por consumir um pouco de CPU tanto no + servidor quanto no cliente, uma vez que ele precisa comparar + muitos arquivos. + + + + AnonCVS (Opcional para reposittórios + CVS) + + Se você possui o repositório CVS, + você pode desejar disponibilizá-lo via cvs + anônimo. Um pequeno aviso antes: Não existe + muita demanda para este tipo de acesso, ele requer alguma + experiência, e você precisa saber o que + está fazendo. + + Geralmente há duas formas de se acessar um + repositório CVS remotamente: via + pserver ou via ssh + (nós não consideramos o + rsh). Para acesso anônimo, o uso + do pserver é bastante adequado, + mas alguns optam por também oferecer acesso via + ssh. Existe um wrapper + customizado no repositório CVS, para ser utilizado + como shell para uma conta anônima de ssh. Ele faz um + chroot, e portanto requer que o repositório CVS + esteja disponível no diretório home do + usuário anônimo. Isto pode não ser + possível para todos os sites. Se você for + oferecer apenas acesso via pserver, + esta restrição não se aplica, mas + você pode ficar sujeito a um risco maior de + segurança. Você não precisa instalar + nenhum software especial, uma vez que o &man.cvs.1; vem por + padrão na instalação básica do + FreeBSD. Você precisa habilitar o acesso + através do inetd, para isto basta + adicionar uma entrada ao seu + /etc/inetd.conf semelhante a + esta: + + +cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --allow-root=/home/ncvs pserver + + + Consulte o manual para detalhes das + opções. Consulte também a + página de info do CVS sobre + formas adicionais de certificar-se de que o acesso ao + repositório está configurado apenas para + leitura. Recomenda-se que você crie uma conta + não privilegiada, preferencialmente chamada + anoncvs. + Você também precisa criar um arquivo + passwd no seu + /home/ncvs/CVSROOT e atribuir um + password (em branco ou anoncvs) para acesso deste + usuário ao CVS. O diretório + /anoncvstmp é um sistema de + arquivo baseado em memória que tem um + propósito especial. Ele não é + obrigatório mas seu uso é recomendado, uma + vez que o &man.cvs.1; cria uma estrutura de + diretórios ocultos no seu /tmp + a qual não é utilizada depois da + operação, mas que deixa as coisas + dramaticamente lentas se forem necessárias + operações reais de escrita e leitura para o + disco. Aqui está um exemplo de configuração no + /etc/fstab, de como configurar um + MFS: + + +/dev/da0s1b /anoncvstmp mfs rw,-s=786432,-b=4096,-f=512,-i=560,-c=3,-m=0,nosuid 0 0 + + + Esta é (naturalmente) uma sintaxe otimizada ao + máximo, e foi sugerida pelo &a.jdp;. + + + + + + Como espelhar o FreeBSD + + Ok, agora você conhece os requisitos e sabe como oferecer + os serviços, mas não sabe como começar. :-) + Esta sessão explica como realizar realmente o + espelhamento de várias partes do FreeBSD, que ferramentas + utilizar e a partir de onde espelhar. + + + FTP + A área de FTP representa o maior volume de dados a + serem espelhados. Ele inclui os conjuntos de + distribuição os quais são + requeridos para as instalações via rede, os + ramos (branches) do sistema dos quais se + tira snapshots a partir da árvore de código + fonte, as imagens ISO para gravar CDs de + instalação do sistema, um sistema de arquivos + vivo, a árvore do ports, os distifiles (código + fonte necessários para compilar o ports) e uma + quantidade enorme de pacotes. Tudo, é claro, para as + várias versões do FreeBSD, e para as + várias arquiteturas. + + + Espelhando com FTP + + Você pode utilizar um aplicativo de espelhamento + de FTP para obter os arquivos. Alguns dos mais utilizados + são: + + ftp/mirror + ftp/ftpmirror + ftp/emirror + ftp/spegla + ftp/omi + ftp/wget + + + O ftp/mirror era + muito popular, mas parece ter alguns inconvenientes, como + ele está escrito em &man.perl.1; ele possui alguns + problemas reais para espelhar grandes diretórios + como os de um site espelho do FreeBSD. Existem rumores de + que a versão atual corrigiu isso ao permitir que + seja especificado um algoritmo diferente para comparar a + estrutura de diretórios. + + Em geral o FTP não é muito bom para + tarefas de espelhamento. Ele transfere o arquivo inteiro + se o mesmo for alterado, e não cria um fluxo + único de dados do qual ele se beneficiaria no caso + de ocorrer uma grande janela de congestionamento TCP. + + + + Espelhando com o Rsync + + A melhor forma de espelhar a área FTP é + através do uso do rsync. + Você pode instalar o port net/rsync e então + utilizá-lo para sincronizar com o seu servidor de + upstream. O + rsync já foi mencionado na + . Uma vez que a + disponibilização de acesso via + rsync não é + obrigatória, o seu site preferido de + upstream pode não disponibilizá-lo. + Você pode precisar gastar algum tempo procurando até + encontrar um servidor que permita o acesso via + rsync. + + + Uma vez que o número de clientes + rsync gera um impacto + significativo no servidor, muitos administradores + definem limites para o número de acessos + simultâneos aos seus servidores. Você deve + consultar o responsável pelo servidor de + upstream que você está + utilizando, sobre as regras do servidor, e sobre a + possibilidade dele abrir uma exceção para o seu + servidor (uma vez que você é um site + espelho). + + + A linha de comando para espelhar o FreeBSD será + parecida com esta: + + &prompt.user; rsync -vaz --delete ftp4.de.FreeBSD.org::FreeBSD/ /pub/FreeBSD/ + + + Consulte a documentação do + rsync, a qual está + disponível em http://rsync.samba.org/, + para conhecer as várias opções que + podem ser utilizadas com o + rsync. Se você + sincronizar o módulo inteiro (ao contrário + de apenas alguns subdiretórios), esteja ciente de + que o módulo-diretório (normalmente + "FreeBSD") não será criado, de forma que + você não deve omitir o diretório alvo. + Além disso, você pode desejar criar um script + de trabalho para ser executado pelo &man.cron.8;, para + automatizar o processo de espelhamento. + + + + Espelhando com o CVSup + + Alguns sites, incluindo o ftp-master.FreeBSD.org + oferecem acesso via CVSup para + espelhamento do conteúdo da área de FTP. + Você precisa instalar um cliente + CVSup, preferencialmente a partir + do port net/cvsup. + (consulte também a ). Abaixo você encontra um + exemplo de arquivo supfile pronto para + uso com o + ftp-master.FreeBSD.org: + + + # + # FreeBSD archive supfile from master server + # + *default host=ftp-master.FreeBSD.org + *default base=/usr + *default prefix=/pub + #*default release=all + *default delete use-rel-suffix + *default umask=002 + + # If your network link is a T1 or faster, comment out the following line. + #*default compress + + FreeBSD-archive release=all preserve + + + Ao que parece o CVSup + seria a melhor opção para espelhar os arquivos em + termos eficiência, mas infelizmente ele só + está disponível em alguns poucos + sites. + + + Por favor, consulte a documentação do + CVSup, como por exemplo a + &man.cvsup.1; e considere o uso da opção + . Esta opção reduz as + operações de leitura e escrita para o seu + disco rígido, assumindo que as + informações gravadas sobre cada arquivo + estão corretas. + + + + + Espelhando o repositório CVS + + Existem várias formas de se espelhar o + repositório CVS. O CVSup + é o método mais comum. + + + Usando o CVSup + + O CVSup foi descrito com + algum detalhe na e na + . + + É muito fácil configurar um site espelho + com o CVSup. Basta instalar o + port net/cvsup-mirror + para que você tenha todos os programas + necessários instalados, e para que todas as + informações necessárias para a + configuração do site espelho sejam + coletadas. + + + Por favor não se esqueça de avaliar a + sugestão mencionada na nota acima + + + + + Utilizando outros métodos + + A utilização de outros métodos que + não o CVSup geralmente + não é recomendada. De qualquer forma, + nós vamos descrevê-los rapidamente aqui. Uma + vez que a maioria dos sites oferece o repositório + CVS como parte da área de FTP, sob o caminho + /pub/FreeBSD/development/FreeBSD-CVS, + os seguintes métodos podem ser utilizados: + + + + FTP + + + Rsync + + + HTTP + + + + + O AnonCVS não pode ser + utilizado para espelhar o repositório CVS, uma + vez que o CVS não permite que você acesse o + próprio repositório em si (arquivos ",v"), + permitindo o acesso somente as versões limpas dos + módulos. + + + + + + Espelhando as páginas WWW + + A melhor forma é realizar um check + out da distribuição www do + servidor de CVS. Se você tem um mirror local do + repositório CVS, isto será tão simples + quanto executar: + + &prompt.user; cvs -d /home/ncvs co www + + e agendar uma tarefa no cron, + que execute periodicamente o comando + cvs up -d -P, imediatamente + após a execução do processo que atualiza + o seu repositório. É claro que os arquivos + precisam ser colocados em um diretório disponível para + acesso público via WWW. A instalação e + configuração de um servidor web não + serão abordadas neste artigo. + + Se você não tem um repositório local, + você pode utilizar o CVSup + para manter uma cópia atualizada das + páginas www. Um supfile de exemplo para esta tarefa + pode ser encontrado em + /usr/share/examples/cvsup/www-supfile, o + qual irá se parecer com isto: + + + # + # WWW module supfile for FreeBSD + # + *default host=cvsup3.de.FreeBSD.org + *default base=/usr + *default prefix=/usr/local + *default release=cvs tag=. + *default delete use-rel-suffix + + # If your network link is a T1 or faster, comment out the following line. + *default compress + + # This collection retrieves the www/ tree of the FreeBSD repository + www + + + A utilização do ftp/wget ou de outras ferramentas + de espelhamento web (web-mirror) + não é recomendado. + + + Espelhando a documentação do FreeBSD + + Uma vez que a documentação é referenciada em diversas + páginas web, é recomendado que você também espelhe a + documentação do FreeBSD. No entanto, isto não é tão + trivial quanto o espelhamento das páginas www + isoladamente. + + Em primeiro lugar, você deve obter os fontes da + documentação, e recomendamos que você faça isso + preferencialmente via CVSup. + Aqui está um exemplo de supfile para esta tarefa: + + + # + # FreeBSD documentation supfile + # + *default host=cvsup3.de.FreeBSD.org + *default base=/usr + *default prefix=/usr/share + *default release=cvs tag=. + *default delete use-rel-suffix + + # If your network link is a T1 or faster, comment out the following line. + #*default compress + + # This will retrieve the entire doc branch of the FreeBSD repository. + # This includes the handbook, FAQ, and translations thereof. + doc-all + + + Então você precisará instalar alguns + ports. Mas você está com sorte pois existe um + meta-port, o textproc/docproj, para fazer o + trabalho por você. Você precisa configurar + algumas variáveis de ambiente, como por exemplo + SGML_CATALOG_FILES. Também de uma + olhada no seu /etc/make.conf + (faça uma cópia do + /usr/share/examples/etc/make.conf se + você não possuir um), e verifique a + variável DOC_LANG. Agora + você provavelmente já está pronto para + executar o comando make dentro do + diretório com os fontes da documentação + (/usr/share/doc por padrão) para + construí-la. De novo, você precisa tornar os arquivos + acessíveis através do seu servidor web, certificando-se de + que os links apontam para o local correto. + + + A construção da documentação, assim como as diversas + tarefas associadas ao processo, estão documentadas + no &os; Documentation + Project Primer. Por favor, leia este documento, + especialmente se você está tendo problemas + para construir a documentação. + + + + + + Com que frequência devo espelhar? + + Todo site espelho deve ser atualizado regularmente. + Você certamente irá precisar de alguns scripts + para automatizar este processo de atualização + com a ajuda do &man.cron.8;. Uma vez que praticamente cada + administrador implementa este procedimento do seu + próprio jeito, nós não temos como fornecer + instruções específicas de como proceder. + O processo poderia ser resumido em: + + + + Coloque o comando para executar a sua + aplicação de espelhamento em um script. O + uso de um script simples em /bin/sh + é recomendado. + + + Adicione alguns redirecionamentos para arquivo das + mensagens dos programas, de forma que possa usar o mesmo + com a finalidade de diagnóstico de problemas. + + + Teste se o seu script funciona. Verifique o arquivo de + log. + + + Utilize o &man.crontab.1; para adicionar o script ao + &man.crontab.5; do usuário apropriado. O qual deve + ser um usuário diferente do usuário sob o + qual o servidor de FTP é executado, desta forma + não será permitido o acesso via FTP + anônimo aos arquivos presentes na área de FTP, + os quais não possuam permissões que + possibilitem a leitura por todos os demais usuários. + Isto é utilizado para a fase de stage + das novas distribuições — garantindo + que todos os sites espelhos oficiais possuam todos os + arquivos necessários de uma + distribuição, no dia em que a mesma é + liberada. + + + + Aqui estão alguns exemplos da periodicidade + recomendada para atualização de um site + espelho: + + + + Conjunto de arquivos do FTP: diária + + + Repositório CVS: horária + + + Páginas WWW: diária + + + + + + + De onde espelhar + + Esta é uma questão importante. Portanto, esta + seção irá gastar algum esforço para + explicá-la. Vamos dizer isso várias vezes: em + nenhuma circunstância você deve espelhar a partir do + ftp.FreeBSD.org. + + + Algumas palavras sobre a + organização + + Os sites espelhos são organizados por país. + Todos os sites espelhos oficiais possuem uma entrada de DNS no + formato ftpN.CC.FreeBSD.org. No + qual CC (i.e. código do *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***