www.openxpki.org/trunk/htdocs/download/freebsd.html

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
   4   <head>
   5     <title>OpenXPKI Project - Ports for FreeBSD</title>
   6 <link rel="stylesheet" title="default" href="../css/openxpki.css" type="text/css" />
   7 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   8
   9
  10   </head>
  11   <body>
  12     <div id="page">
  13
  14       <div id="header">
  15         <a href="..">
  16   <img src="../images/openxpki_logo.png"
  17      alt="OpenXPKI Project"/>
  18 </a>
  19
  20       </div> <!-- header -->
  21
  22       <div id="navi">
  23         <div class="menu">
  24                   <div class="menu_item"><a href="..">Home</a></div>
  25         <div class="menu_item"><a href="../secadvs/index.html">Security Advisories</a></div>
  26         <div class="menu_item"><a href="../news/index.html">News</a></div>
  27         <div class="menu_item"><a href="../docs/index.html">Documentation</a></div>
  28         <div class="menu_item"><a href="../support/index.html">Support</a></div>
  29         <div class="menu_item"><a href="index.html">Download</a></div>
  30         <div class="menu_item"><a href="http://wiki.openxpki.org">Wiki</a></div>
  31         <div class="menu_item"><a href="../resources/index.html">Resources</a></div>
  32         <div class="menu_item"><a href="../foundation/index.html">Foundation</a></div>
  33         <div class="menu_item"><a href="../legacy/index.html">OpenCA Support</a></div>
  34         <div class="w3c">
  35           <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=150124&amp;type=1" width="88" height="31" alt="SourceForge.net Logo" /></a>
  36         </div>
  37         <div class="w3c">
  38           <a href="http://validator.w3.org/check?uri=http://www.openxpki.org/download/freebsd.html"><img class="noborder" src="../images/valid-xhtml10.png" alt="Valid XHTML 1.0!" height="31" width="88" /></a>
  39         </div>
  40         <div class="w3c">
  41           <a href="http://www.masonhq.com/"><img class="noborder" src="../images/built-with-white1.png" alt="Built with Mason" height="31" width="88" /></a>
  42         </div>
  43
  44
  45         </div> <!-- menu -->
  46       </div> <!-- navi -->
  47
  48       <div id="content">
  49
  50 <h2>A suite of OpenXPKI ports for FreeBSD</h2>
  51 <p>
  52 A collection of FreeBSD ports for the OpenXPKI suite - Perl based trustcenter
  53 software for PKI: server and client parts along with deployment tools:
  54 </p>
  55 <ul>
  56 <li>
  57 p5-openxpki: core for server part
  58 </li><li>
  59 p5-openxpki-client: base class for actual clients
  60 </li><li>
  61 p5-openxpki-i18n: internationalization of the user interface
  62 </li><li>
  63 p5-openxpki-client-html-mason: web interface to local OpenXPKI daemon
  64 </li><li>
  65 p5-openxpki-client-scep: set of SCEP tools
  66 </li><li>
  67 p5-openxpki-deployment: set of deployment tools
  68 </li>
  69 </ul>
  70 <p>
  71 Dependencies of OpenXPKI ports ("A &#8594; B" means that port B depends on port A):
  72 </p>
  73 <pre>
  74 p5-openxpki-client  &#8592;  p5-openxpki (server) &#8594;  p5-openxpki-i18n
  75            \ &nbsp;
  76              \       |  p5-openxpki-client-html-mason,
  77                \ &#8594;  |  p5-openxpki-client-scep, p5-openxpki-deployment.
  78 </pre>
  79 <p>
  80 Notes:
  81 </p>
  82 <ul>
  83 <li>
  84 To get a working server it is recommended to install deployment port too.
  85 Do not forget to undergo deployment procedure itself (by hand).
  86 </li><li>
  87 For effective use of deployment,
  88 it is recommended to install html-mason client.
  89 </li><li>
  90 I18n is needed for the English interface as well.
  91 </li>
  92 </ul>
  93
  94 <h2>Ports registered with the FreeBSD ports collection </h2>
  95 <p>
  96 OpenXPKI is included into the distribution of the basic
  97 FreeBSD system as a suite of regular ports under the FreeBSD names
  98 </p><p>
  99              <tt> <a href="http://www.freebsd.org/cgi/ports.cgi?query=openxpki">
 100               security/p5-openxpki*</a> </tt>
 101 </p><p>
 102 These ports embrace all tools of openxpki
 103 (server-side, client-side, deployment, i18n).
 104 </p><p>
 105 You have to undergo subsequent deployment stage by hand.
 106 This will specify the role, which your computer plays in the
 107 PKI infrastructure.
 108 </p><p>
 109 It is very much NOT recommended to copy only ports
 110 <tt>security/p5-openxpki*</tt> onto your computer, if you wish to install them.
 111 These ports depend on dozens of other ports.
 112 Thus it is essential to have the entire port collection
 113 (present on your computer) in a self-consistent state and
 114 in accord with your base system.
 115 </p><p>
 116 Recommended procedure to make use of the ports is:
 117 </p>
 118 <ul>
 119 <li>
 120 Get/upgrade the entire ports collection as described in
 121               <a href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html">
 122               a FreeBSD Handbook</a>.
 123 </li><li>
 124 <tt>cd /usr/ports/ports-mgmt/portupgrade &amp;&amp; make reinstall clean</tt><br/>
 125 <tt>/usr/local/sbin/portupgrade -NrR security/p5-openxpki-client-html-mason</tt><br/>
 126 <tt>/usr/local/sbin/portupgrade -NrR security/p5-openxpki-deployment</tt><br/>
 127 <tt>/usr/local/sbin/portupgrade -NrR security/p5-openxpki-i18n</tt><br/>
 128 (Appropriate tarballs of openxpki will be fetched automatically.
 129 Alternatively, you can fetch tarballs of openxpki by hand
 130 and place them into <tt>/usr/ports/distfiles/openxpki/</tt>)
 131 </li><li>
 132 Install your favorite database (enable utf-8 support if needed) and web server.
 133 </li><li>
 134 Perform deployment procedure for openxpki in a regular way.
 135 When asked for the name of the &quot;openxpki user&quot; answer &quot;openxpki&quot;,
 136 and do not forget to add a line:
 137 &quot;User openxpki&quot;
 138 to the zone of your OpenXPKI-related (virtual) web server in your Apache configuration file.
 139 </li>
 140 </ul>
 141 <p>
 142 Just in case: FreeBSD employs one and the same port collection
 143 in ALL (stable, current, legacy) versions of FreeBSD.
 144 </p>
 145
 146 <h2>Ports for Last Midnight Snapshot of the OpenXPKI development code</h2>
 147 <p>
 148 Are built nightly by an intellectual script.  Awailable from the
 149 <a href="../lastmidnight/index.html">Last Midnight Snapshot page</a>.
 150 </p>
 151
 152 <h2>Ports for current svn snapshot of the OpenXPKI development code</h2>
 153 <p>
 154 If you are impatient and want to play with more recent snapshots of
 155 openxpki, you may try
 156 </p>
 157 <ul>
 158 <li>
 159 <tt>svn update</tt>,
 160 </li><li>
 161 update your ports collection (see above),
 162 </li><li>
 163 <tt>cd .../trunk/package/freebsd</tt>
 164 </li><li>
 165 run the script
 166 <tt>build-dist-and-update-checksums.sh</tt>.
 167 This will build tarballs and place them into
 168 <tt>.../trunk/package/freebsd/usr/ports/distfiles/openxpki/</tt>.
 169 Then it will also modify files:<br/>
 170 <tt>.../trunk/package/freebsd/usr/ports/security/p5-openxpki*/Makefile</tt>.
 171 Checksums for tarballs will be updated too.
 172 </li><li>
 173 Then for each port run the script
 174 <tt>update-port.sh _name_of_port_</tt>.
 175 This will update file <tt>pkg-plist</tt> related to the port.
 176 </li>
 177 </ul>
 178 <p>
 179 You should end up with updated collection of ports, which are located
 180 inside your svn snapshot:<br/>
 181 <tt>.../trunk/package/freebsd/usr/ports/security/p5-openxpki*</tt>.
 182 </p><p>
 183 Please note, that thus modified ports may still need manual trimming.
 184 Especially if new 3-rd party's dependencies were added to the code.
 185 </p><p>
 186 If you find issues with these FreeBSD ports, please report to the
 187 openxpki-users mailing list.
 188 </p>
 189
 190
 191
 192
 193
 194
 195       </div> <!-- content -->
 196
 197       <div id="footer">
 198         Last modified by alech on Thu Aug 14 13:16:07 UTC 2008
 199  (based on rev. 1090). &copy; 2005 - 2007  OpenXPKI Foundation
 200
 201
 202       </div> <!-- footer -->
 203
 204     </div> <!-- page -->
 205   </body>
 206 </html>
 207
 208