From 8d60e1a90397d7580654cb397f9dacf1d5623331 Mon Sep 17 00:00:00 2001 From: paul Date: Mon, 11 Apr 2005 07:58:35 +0000 Subject: 2005-04-11 Paul Jakma * Makefile.am: README.txt to EXTRA_DIST * README.txt: new file, package creation, install, usage notes. --- solaris/ChangeLog | 1 + solaris/Makefile.am | 4 +- solaris/README.txt | 107 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 110 insertions(+), 2 deletions(-) create mode 100644 solaris/README.txt (limited to 'solaris') diff --git a/solaris/ChangeLog b/solaris/ChangeLog index bf91053b..eb5d6795 100644 --- a/solaris/ChangeLog +++ b/solaris/ChangeLog @@ -11,3 +11,4 @@ * depend.*: Solaris 10 dependencies for packages, referenced by prototype files. * .cvsignore: no idea what this is for... + * README.txt: new file, package creation, install, usage notes. diff --git a/solaris/Makefile.am b/solaris/Makefile.am index d0567fac..0fb951ee 100644 --- a/solaris/Makefile.am +++ b/solaris/Makefile.am @@ -1,5 +1,5 @@ # Solaris packages automake file -# $Id: Makefile.am,v 1.1 2005/04/11 07:05:21 paul Exp $ +# $Id: Makefile.am,v 1.2 2005/04/11 07:58:35 paul Exp $ .PHONY: packages @@ -109,7 +109,7 @@ CLEANFILES := $(BUILT_SOURCES) $(pkg_packages) EXTRA_DIST := $(pkg_depends) $(pkg_manifests:%=%.in) $(pkg_prototypes:%=%.in) \ $(pkg_names:%=pkginfo.%.tmpl.in) $(srcdir)/pkginfo.tmpl.in \ - quagga.init.in options.xml r.manifest i.manifest + quagga.init.in options.xml r.manifest i.manifest README.txt pkg-root-install: (cd $(top_builddir) && \ diff --git a/solaris/README.txt b/solaris/README.txt new file mode 100644 index 00000000..86295e0a --- /dev/null +++ b/solaris/README.txt @@ -0,0 +1,107 @@ +To build packages for Solaris 10: + +Requirements: +------------- + +- Development environment including gcc (eg as shipped with Solaris 10) + +- The Package tools from S10 + +- i.manifest and r.manifest scripts as supplied with Solaris Express + in /usr/sadm/install/scripts/ or alternatively from the + download/binaries/solaris/ directory on quagga.net. i.manifest must be at + least version 1.5. You can place these scripts in this directory if you + are using Solaris 10 GA (which does not ship with these scripts). + + +Package creation instructions: +------------------------------ + +1. Configure and build Quagga in the top level build directory as per +normal, eg: + + ./configure --prefix=/usr/local/quagga \ + --localstatedir=/var/run/quagga + --enable-gcc-rdynamic --enable-opaque-lsa --enable-ospf-te \ + --enable-multipath=64 --enable-user=quagga \ + --enable-ospfclient=yes --enable-ospfapi=yes \ + --enable-group=quagga --enable-nssa --enable-opaque-lsa + +You will need /usr/sfw/bin and /usr/ccs/bin in your path. + +2. make install in the top-level build directory, it's a good idea to make +use of DESTDIR to install to an alternate root, eg: + + make DESTDIR=/var/tmp/qroot install + +3. In this directory, run make packages, specifying DESTDIR if appropriate, +eg: + + make DESTDIR=/var/tmp/qroot packages + +This should result in 4 packages being created: + + quagga-libs-...-$ARCH.pkg - QUAGGAlibs + quagga-daemons-...-$ARCH.pkg - QUAGGAdaemons + quagga-doc-...-$ARCH.pkg - QUAGGAdoc + quagga-dev-...-$ARCH.pkg - QUAGGAdev + +QUAGGAlibs and QUAGGAdaemons are needed for daemon runtime. + + +Install and post-install configuration notes: +--------------------------------------------- + +- If you specified a user/group which does not exist per default on Solaris + (eg quagga/quagga) you *must* create these before installing these on a + system. The packages do *not* create the users. + +- The configuration files are not created. You must create the configuration + file yourself, either with your complete desired configuration, or else if + you wish to use the telnet interface for further configuration you must + create them containing at least: + + password whatever + + The user which quagga runs as must have write permissions on this file, no + other user should have read permissions, and you would also have to enable + the telnet interface (see below). + +- Configuration of common options are by way of SMF properties named Quagga, + the defaults should be inline with how you configured Quagga in Step 1 + above, eg: + + Quagga/config_file astring /usr/local/quagga/etc/zebra.conf + Quagga/daemon_name astring zebra + Quagga/group astring quagga + Quagga/pid_file astring /var/run/quagga/zebra.pid + Quagga/stability astring Evolving + Quagga/user astring quagga + Quagga/vty_addr astring 127.1 + Quagga/vty_port integer 0 + + Note that by default the telnet 'vty' interface is disabled - + Quagga/vty_port is set to 0. Other daemon-specific options may be + available, however they are not yet honoured/used (eg ospfd/apiserver on + svc:/network/ospf). + + You can change these properties with the 'svccfg' SMF utility, eg: + + # svccfg + svc:> select svc:/network/zebra + svc:/network/zebra> listprop Quagga/vty_port + Quagga/vty_port integer 0 + svc:/network/zebra> setprop Quagga/vty_port = 2601 + svc:/network/zebra> listprop Quagga/vty_port + Quagga/vty_port integer 2601 + svc:/network/zebra> quit + # svcprop -p Quagga/vty_port network/zebra + 2601 + + As SMF is dependency aware, restarting network/zebra will restart all the + other daemons. + +- These packages are not supported by Sun Microsystems, report bugs via the + usual Quagga channels, ie Bugzilla. Improvements/contributions of course + would be greatly appreciated. + -- cgit v1.2.1