No commit message specified.
authornmatavka <nmatavka@web>
Sun, 12 Jan 2014 16:16:59 +0000 (16:16 +0000)
committerCharlie Root <root@leaf.dragonflybsd.org>
Sun, 12 Jan 2014 16:16:59 +0000 (16:16 +0000)
docs/howtos/HowToDPorts/index.mdwn

index fab044a..98a512d 100644 (file)
@@ -40,38 +40,83 @@ Note that this step is unnecessary for any newly installed release from DragonFl
 
 ## Configuring pkgng
 
-Information previously contained in here worked for older versions of pkg, but as pkgng has undergone some changes, so too have the configurations.
+Older versions of pkgng saved their configuration at /usr/local/etc/pkg.conf; this file made reference to a PACKAGESITE.  pkgng will still work based on this file, but will output errors:
 
-Previously, /usr/local/etc/pkg.conf was used and reference to a PACKAGESITE was made.  pkgng will still work, but a warning will pop up.
+    # pkg update
+    pkg: PACKAGESITE in pkg.conf is deprecated. Please create a repository configuration file
+    Updating repository catalogue
+    pkg: Warning: use of http:// URL scheme with SRV records is deprecated: switch to pkg+http://
 
-# pkg update
-pkg: PACKAGESITE in pkg.conf is deprecated. Please create a repository configuration file
-Updating repository catalogue
-pkg: Warning: use of http:// URL scheme with SRV records is deprecated: switch to pkg+http://
+Listen to the errors: hash out the packagesite line, save the file, and move on.  This can be done with vi:
 
-Listen to the errors: hash out the packagesite line, save the file, and move on.
+    # vi /usr/local/etc/pkg.conf
 
-Go to /usr/local/etc/pkg/repos/
+There will be two lines in the file like this:
 
-You should see something like this with an ls
+    # Default Dports package server (California)
+    PACKAGESITE: http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST
 
-df-latest.conf.sample   df-releases.conf.sample
+Hash out the offending line:
 
-cp or mv one of them to be .conf
+    # Default Dports package server (California)
+    # PACKAGESITE: http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST
 
-edit the one you choose and make the following changes. (I edited the latest version)
+Note that, as of time of writing, there are two working package repositories:
 
-Avalon: {
-        url             : pkg+http://mirror-master.dragonflybsd.org/dports/${ABI}/L\
-ATEST,
-        mirror_type     : SRV,
-        signature_type  : NONE,
-        pubkey          : NONE,
-        fingerprints    : /usr/share/fingerprints,
+    # Default Dports package server (California)
+    # PACKAGESITE: http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST
+    
+    # European mirrors
+    [...]
+    #PACKAGESITE: http://dfly.schlundtech.de/dports/${ABI}/LATEST
+
+Test their performance---we will be using the fastest one.  This may, or may not, be the one closest to you (the California site for the New World, the German site for the Old World).
+
+    # ping schlundtech.de
+    PING schlundtech.de (85.236.36.90): 56 data bytes
+    64 bytes from 85.236.36.90: icmp_seq=0 ttl=49 time=101.433 ms
+    64 bytes from 85.236.36.90: icmp_seq=1 ttl=49 time=59.177 ms
+    64 bytes from 85.236.36.90: icmp_seq=2 ttl=49 time=79.550 ms
+    64 bytes from 85.236.36.90: icmp_seq=3 ttl=49 time=88.268 ms
+    64 bytes from 85.236.36.90: icmp_seq=4 ttl=49 time=120.060 ms
+    [...]
+    --- schlundtech.de ping statistics ---
+    20 packets transmitted, 19 packets received, 5.0% packet loss
+    round-trip min/avg/max/stddev = 49.555/96.064/186.662/33.559 ms
+    # ping mirror-master.dragonflybsd.org
+    PING avalon.dragonflybsd.org (199.233.90.72): 56 data bytes
+    64 bytes from 199.233.90.72: icmp_seq=0 ttl=47 time=208.013 ms
+    64 bytes from 199.233.90.72: icmp_seq=1 ttl=47 time=256.441 ms
+    64 bytes from 199.233.90.72: icmp_seq=2 ttl=47 time=281.436 ms
+    64 bytes from 199.233.90.72: icmp_seq=3 ttl=47 time=281.103 ms
+    64 bytes from 199.233.90.72: icmp_seq=4 ttl=47 time=285.440 ms
+    [...]
+    --- avalon.dragonflybsd.org ping statistics ---
+    19 packets transmitted, 19 packets received, 0.0% packet loss
+    round-trip min/avg/max/stddev = 208.013/264.017/334.180/31.549 ms
+
+Now, navigate to `/usr/local/etc/pkg/repos/` and rename one of the configuration file samples you find there.  Edit the one you renamed:
+
+    # cd /usr/local/etc/pkg/repos/
+    # ls
+    df-latest.conf.sample      df-releases.conf.sample
+    # cp -v df-latest.conf.sample df-latest.conf
+    df-latest.conf.sample -> df-latest.conf
+    # chmod -v 644 df-latest.conf
+    df-latest.conf
+    # vim df-latest.conf
+
+Enable whichever server was faster (Avalon is American, SchlundTech is German):
+
+    Avalon: {
+        url             : http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST,
+        [...]
+        enabled         : no
+    }
+    SchlundTech: {
+        url             : http://dfly.schlundtech.de/dports/${ABI}/LATEST,
         enabled         : yes
-}
-
-Depending on when and how you installed and/or upgraded, you may have to chmod 644 the file first to be able to edit it.
+    }
 
 ## Basic pkgng Operations