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

   1 <%attr>
   2   title => 'Ports for FreeBSD'
   3 </%attr>
   4
   5 <h2>A suite of OpenXPKI ports for FreeBSD</h2>
   6 <p>
   7 A collection of FreeBSD ports for the OpenXPKI suite - Perl based trustcenter
   8 software for PKI: server and client parts along with deployment tools:
   9 </p>
  10 <ul>
  11 <li>
  12 p5-openxpki: core for server part
  13 </li><li>
  14 p5-openxpki-client: base class for actual clients
  15 </li><li>
  16 p5-openxpki-i18n: internationalization of the user interface
  17 </li><li>
  18 p5-openxpki-client-html-mason: web interface to local OpenXPKI daemon
  19 </li><li>
  20 p5-openxpki-client-scep: set of SCEP tools
  21 </li><li>
  22 p5-openxpki-deployment: set of deployment tools
  23 </li>
  24 </ul>
  25 <p>
  26 Dependencies of OpenXPKI ports ("A &#8594; B" means that port B depends on port A):
  27 </p>
  28 <pre>
  29 p5-openxpki-client  &#8592;  p5-openxpki (server) &#8594;  p5-openxpki-i18n
  30            \ &nbsp;
  31              \       |  p5-openxpki-client-html-mason,
  32                \ &#8594;  |  p5-openxpki-client-scep, p5-openxpki-deployment.
  33 </pre>
  34 <p>
  35 Notes:
  36 </p>
  37 <ul>
  38 <li>
  39 To get a working server it is recommended to install deployment port too.
  40 Do not forget to undergo deployment procedure itself (by hand).
  41 </li><li>
  42 For effective use of deployment,
  43 it is recommended to install html-mason client.
  44 </li><li>
  45 I18n is needed for the English interface as well.
  46 </li>
  47 </ul>
  48
  49 <h2>Ports registered with the FreeBSD ports collection </h2>
  50 <p>
  51 OpenXPKI is included into the distribution of the basic
  52 FreeBSD system as a suite of regular ports under the FreeBSD names
  53 </p><p>
  54              <tt> <a href="<& /lib/url.mas,
  55                        host => 'www.freebsd.org',
  56                        path => '/cgi/ports.cgi?query=openxpki' &>">
  57               security/p5-openxpki*</a> </tt>
  58 </p><p>
  59 These ports embrace all tools of openxpki
  60 (server-side, client-side, deployment, i18n).
  61 </p><p>
  62 You have to undergo subsequent deployment stage by hand.
  63 This will specify the role, which your computer plays in the
  64 PKI infrastructure.
  65 </p><p>
  66 It is very much NOT recommended to copy only ports
  67 <tt>security/p5-openxpki*</tt> onto your computer, if you wish to install them.
  68 These ports depend on dozens of other ports.
  69 Thus it is essential to have the entire port collection
  70 (present on your computer) in a self-consistent state and
  71 in accord with your base system.
  72 </p><p>
  73 Recommended procedure to make use of the ports is:
  74 </p>
  75 <ul>
  76 <li>
  77 Get/upgrade the entire ports collection as described in
  78               <a href="<& /lib/url.mas,
  79                        host => 'www.freebsd.org',
  80                        path => '/doc/en_US.ISO8859-1/books/handbook/ports-using.html' &>">
  81               a FreeBSD Handbook</a>.
  82 </li><li>
  83 <tt>cd /usr/ports/ports-mgmt/portupgrade &amp;&amp; make reinstall clean</tt><br/>
  84 <tt>/usr/local/sbin/portupgrade -NrR security/p5-openxpki-client-html-mason</tt><br/>
  85 <tt>/usr/local/sbin/portupgrade -NrR security/p5-openxpki-deployment</tt><br/>
  86 <tt>/usr/local/sbin/portupgrade -NrR security/p5-openxpki-i18n</tt><br/>
  87 (Appropriate tarballs of openxpki will be fetched automatically.
  88 Alternatively, you can fetch tarballs of openxpki by hand
  89 and place them into <tt>/usr/ports/distfiles/openxpki/</tt>)
  90 </li><li>
  91 Install your favorite database (enable utf-8 support if needed) and web server.
  92 </li><li>
  93 Perform deployment procedure for openxpki in a regular way.
  94 When asked for the name of the &quot;openxpki user&quot; answer &quot;openxpki&quot;,
  95 and do not forget to add a line:
  96 &quot;User openxpki&quot;
  97 to the zone of your OpenXPKI-related (virtual) web server in your Apache configuration file.
  98 </li>
  99 </ul>
 100 <p>
 101 Just in case: FreeBSD employs one and the same port collection
 102 in ALL (stable, current, legacy) versions of FreeBSD.
 103 </p>
 104
 105 <h2>Ports for Last Midnight Snapshot of the OpenXPKI development code</h2>
 106 <p>
 107 Are built nightly by an intellectual script.  Awailable from the
 108 <a href="../lastmidnight/index.html">Last Midnight Snapshot page</a>.
 109 </p>
 110
 111 <h2>Ports for current svn snapshot of the OpenXPKI development code</h2>
 112 <p>
 113 If you are impatient and want to play with more recent snapshots of
 114 openxpki, you may try
 115 </p>
 116 <ul>
 117 <li>
 118 <tt>svn update</tt>,
 119 </li><li>
 120 update your ports collection (see above),
 121 </li><li>
 122 <tt>cd .../trunk/package/freebsd</tt>
 123 </li><li>
 124 run the script
 125 <tt>build-dist-and-update-checksums.sh</tt>.
 126 This will build tarballs and place them into
 127 <tt>.../trunk/package/freebsd/usr/ports/distfiles/openxpki/</tt>.
 128 Then it will also modify files:<br/>
 129 <tt>.../trunk/package/freebsd/usr/ports/security/p5-openxpki*/Makefile</tt>.
 130 Checksums for tarballs will be updated too.
 131 </li><li>
 132 Then for each port run the script
 133 <tt>update-port.sh _name_of_port_</tt>.
 134 This will update file <tt>pkg-plist</tt> related to the port.
 135 </li>
 136 </ul>
 137 <p>
 138 You should end up with updated collection of ports, which are located
 139 inside your svn snapshot:<br/>
 140 <tt>.../trunk/package/freebsd/usr/ports/security/p5-openxpki*</tt>.
 141 </p><p>
 142 Please note, that thus modified ports may still need manual trimming.
 143 Especially if new 3-rd party's dependencies were added to the code.
 144 </p><p>
 145 If you find issues with these FreeBSD ports, please report to the
 146 openxpki-users mailing list.
 147 </p>
 148
 149
 150
 151
 152
 153