4.5.1 Obtaining the Ports Collection:

- move the CVSup Method to top and Sysinstall Method to bottom
- suggest people to not use Sysinstall method unless they got no Internet
  access
- add the Portsnap Method, adapted from the Appendix section on the Portsnap
This commit is contained in:
Pav Lucistnik 2005-12-27 01:57:43 +00:00
parent 3cdfcc8e70
commit 3c9d3e5f3f
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=26707

View file

@ -587,76 +587,13 @@ docbook =
follow these instructions to obtain the ports
collection:</para>
<procedure>
<title>Sysinstall Method</title>
<para>This method involves using
<application>sysinstall</application> again to manually
install the Ports Collection.</para>
<step>
<para>As <username>root</username>, run
<command>sysinstall</command>
(<command>/stand/sysinstall</command> in &os;
versions older than 5.2) as shown below:</para>
<screen>&prompt.root; <userinput>sysinstall</userinput></screen>
</step>
<step>
<para>Scroll down and select <guimenuitem>Configure</guimenuitem>,
press <keycap>Enter</keycap>.</para>
</step>
<step>
<para>Scroll down and select
<guimenuitem>Distributions</guimenuitem>, press
<keycap>Enter</keycap>.</para>
</step>
<step>
<para>Scroll down to <guimenuitem>ports</guimenuitem>, press
<keycap>Space</keycap>.</para>
</step>
<step>
<para>Scroll up to <guimenuitem>Exit</guimenuitem>, press
<keycap>Enter</keycap>.</para>
</step>
<step>
<para>Select your desired installation media, such as CDROM,
FTP, and so on.</para>
</step>
<step>
<para>Scroll up to <guimenuitem>Exit</guimenuitem> and press
<keycap>Enter</keycap>.</para>
</step>
<step>
<para>Press <keycap>X</keycap> to exit
<application>sysinstall</application>.</para>
</step>
</procedure>
<para>The alternative method to obtain and keep your ports
collection up to date is by using
<application>CVSup</application>. Look at the ports
<application>CVSup</application> file,
<filename>/usr/share/examples/cvsup/ports-supfile</filename>.
See <link linkend="cvsup">Using CVSup</link> (<xref
linkend="cvsup">) for more information on using
<application>CVSup</application> and this file.</para>
<procedure>
<title>CVSup Method</title>
<para>This is a quick method for getting the Ports Collection
using <application>CVSup</application>. If you want to keep
your ports tree up to date, or learn more about
<application>CVSup</application>, read the previously
mentioned sections.</para>
<para>This is a quick method for getting and keeping your copy of the
Ports Collection up to date using <application>CVSup</application>.
If you want to learn more about <application>CVSup</application>, see
<link linkend="cvsup">Using CVSup</link>.</para>
<step>
<para>Install the <filename
@ -725,6 +662,107 @@ docbook =
actually rebuilding the ports for your own system.</para>
</step>
</procedure>
<procedure>
<title>Portsnap Method</title>
<para>&man.portsnap.8; is an alternative system for distributing the
Ports Collection. It was first included in &os;&nbsp;6.0. On older
systems, you can install it from <filename
role="package">sysutils/portsnap</filename> port:</para>
<screen>&prompt.root; <userinput>pkg_add -r portsnap</userinput></screen>
<para>Please refer to <link linkend="portsnap">Using Portsnap</link>
for a detailed description of all <application>Portsnap</application>
features.</para>
<step>
<para>Create an empty directory <filename
role="directory">/usr/ports</filename> if it does not exists.</para>
<screen>&prompt.root; <userinput>mkdir /usr/ports</userinput></screen>
</step>
<step>
<para>Download a compressed snapshot of the Ports Collection into
<filename role="directory">/var/db/portsnap</filename>. You can
disconnect from the Internet after this step, if you wish.</para>
<screen>&prompt.root; <userinput>portsnap fetch</userinput></screen>
</step>
<step>
<para>If you are running <application>Portsnap</application> for the
first time, extract the snapshot into <filename
role="directory">/usr/ports</filename>:
</para>
<screen>&prompt.root; <userinput>portsnap extract</userinput></screen>
<para>If you already have a populated <filename
role="directory">/usr/ports</filename> and you are just updating,
run the following command instead:</para>
<screen>&prompt.root; <userinput>portsnap update</userinput></screen>
</step>
</procedure>
<procedure>
<title>Sysinstall Method</title>
<para>This method involves using <application>sysinstall</application>
to install the Ports Collection from the installation media. Note
that the old copy of Ports Collection from the date of the release
will be installed. If you have Internet access, you should always
use one of the methods mentioned above.</para>
<step>
<para>As <username>root</username>, run
<command>sysinstall</command>
(<command>/stand/sysinstall</command> in &os;
versions older than 5.2) as shown below:</para>
<screen>&prompt.root; <userinput>sysinstall</userinput></screen>
</step>
<step>
<para>Scroll down and select <guimenuitem>Configure</guimenuitem>,
press <keycap>Enter</keycap>.</para>
</step>
<step>
<para>Scroll down and select
<guimenuitem>Distributions</guimenuitem>, press
<keycap>Enter</keycap>.</para>
</step>
<step>
<para>Scroll down to <guimenuitem>ports</guimenuitem>, press
<keycap>Space</keycap>.</para>
</step>
<step>
<para>Scroll up to <guimenuitem>Exit</guimenuitem>, press
<keycap>Enter</keycap>.</para>
</step>
<step>
<para>Select your desired installation media, such as CDROM,
FTP, and so on.</para>
</step>
<step>
<para>Scroll up to <guimenuitem>Exit</guimenuitem> and press
<keycap>Enter</keycap>.</para>
</step>
<step>
<para>Press <keycap>X</keycap> to exit
<application>sysinstall</application>.</para>
</step>
</procedure>
</sect2>
<sect2 id="ports-skeleton">