1 a.dunfey 1.3.8.1 //%2006////////////////////////////////////////////////////////////////////////
  2                  //
  3                  // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
  4                  // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
  5                  // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
  6                  // IBM Corp.; EMC Corporation, The Open Group.
  7                  // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
  8                  // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
  9                  // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 10                  // EMC Corporation; VERITAS Software Corporation; The Open Group.
 11                  // Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 12                  // EMC Corporation; Symantec Corporation; The Open Group.
 13                  //
 14                  // Permission is hereby granted, free of charge, to any person obtaining a copy
 15                  // of this software and associated documentation files (the "Software"), to
 16                  // deal in the Software without restriction, including without limitation the
 17                  // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 18                  // sell copies of the Software, and to permit persons to whom the Software is
 19                  // furnished to do so, subject to the following conditions:
 20                  // 
 21                  // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
 22 a.dunfey 1.3.8.1 // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
 23                  // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
 24                  // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 25                  // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 26                  // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 27                  // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 28                  // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 29                  //
 30                  //==============================================================================

 31 konrad.r 1.1     Compiling Pegasus to be Linux Standard Base compliant.
 32                  
 33                  
 34                  Author: Konrad Rzeszutek <konradr@us.ibm.com> Jun 29 2004
 35                  
 36                  
 37                  Required software
 38                  -----------------
 39                  
 40                  The following software is required to build lsb-pegasus:
 41                  
 42                  lsbdev-base >= 1.3.4-1
 43                  lsb >= 1.3.0-1
 44                  lsbdev-c++ >= 1.3.4-1
 45                  lsbappchk >=1.3.3-1
 46                  lsbdev-cc >= 1.3.0-1
 47                  lsblibchk >= 1.3.5-1
 48                  gcc >= 3.2.2
 49                  make >= 3.7x
 50                  pam-devel >= 0.75
 51                  openssl >= 0.9.7d
 52 konrad.r 1.1     nALFS >= v020310
 53                  
 54                  Build
 55                  -----------
 56                  
 57                  
 58                   There are two ways of building. The semi-automated way (no 
 59                   environment variables) or the manual method (must set
 60                   environment variables).
 61                  
 62                  
 63                   1). Without environment variables
 64                    

 65 konrad.r 1.2          First time run the ./Configure to set the proper

 66 konrad.r 1.1       paths and platform information. In most cases the script
 67                    will automatically determine the correct paths and configuration.
 68                  
 69                   Note:
 70                    The information is saved in config.status in case you want
 71                    to redo it in the future.
 72                  
 73                    Next start the build process using nALFS. From nALFS README
 74                    file, nALFS is "used for parsing the ALFS profiles (simple 
 75                    XML files) and, following those profiles, do various things 
 76                    (like executing commands), one by one, to (usually) compile some packages."
 77                  
 78                    nALFS webpage is http://www.linuxfromscratch.org/alfs/
 79                  
 80                    To invoke the build process, provide the lsb-pegasus.xml file:
 81                  
 82                    $nALFS -i -v -l rpm/lsb-pegasus.xml
 83                   
 84                    After the compilation is done, to build the RPM binary file:
 85                  
 86                    $rpmbuild -ba rpm/lsb-pegasus.spec
 87 konrad.r 1.1     
 88                    And you are done.
 89                  
 90                  
 91                   2). With environment variables
 92                  
 93                    For more information on each of the environment variables, please
 94                    refer to the README file.
 95                  
 96                    You need to set twelve environment variables: CC, CXX, LSBCC_SHAREDLIBS,
 97                    PEGASUS_PAM_AUTHENTICATION, PEGASUS_USE_PAM_STANDALONE_PROC,

 98 h.sterling 1.3       PEGASUS_HAS_SSL, PEGASUS_USE_RELEASE_DIRS,

 99 konrad.r   1.1       PEGASUS_LSB, PEGASUS_HOME, PEGASUS_ROOT, and PEGASUS_PLATFORM.
100                    
101                      The first two define that a LSB compiler should be used:
102                    
103                        export CC=lsbcc
104                        export CXX=lsbc++
105                    
106                      And LSBCC_SHAREDLIBS tells LSB that OpenPegasus shared
107                      libraries are OK to compile with:
108                    
109                        export LSBCC_SHAREDLIBS=pegcommon:pegconfig:pegrepository:pegcompiler:peggetoopt:pegcliutils
110                    
111                      The next two make OpenPegasus compile with PAM authentication:
112                      
113                        export PEGASUS_PAM_AUTHENTICATION=1
114                        export PEGASUS_USE_PAM_STANDALONE_PROC=1
115                    
116                      ,to support SSL:
117                    
118                        export PEGASUS_HAS_SSL=1
119                    
120 konrad.r   1.1       And very importantly the LSB flag which determines that 
121                      OpenPegasus is compiled against an LSB compliant system:
122                    
123                        export PEGASUS_LSB=1
124                    
125                      Also, two env to determine location of compiled binaries and
126                      the source, respectively:
127                    
128                        export PEGASUS_HOME=`pwd`/BINARIES
129                        export PEGASUS_ROOT=`pwd`
130                    
131                      Lastly, what platform it is compiled on:
132                    
133                         export PEGASUS_PLATFORM=LINUX_IX86_GNU
134                    
135                      When all of those environment variables are set, you can
136                      compile the code, as so:
137                    
138                    
139                       $make
140                       
141 konrad.r   1.1       When the compilation is done, you have to pick the directory
142                      where the binary will be temporarily put to build an RPM. In
143                      the example, we picked the path /home/konrad/MAIN/pkgroot. 
144                    
145                      $make PREFIX=/home/konrad/MAIN/pkgroot/lsb-pegasus/opt/lsb-pegasus \

146 h.sterling 1.3             SYSCONF_PREFIX=/home/konrad/MAIN/pkgroot/lsb-pegasus/etc/ \
147                            LOCAL_STATE_PREFIX=/home/konrad/MAIN/pkgroot/lsb-pegasus/var/opt/lsb-pegasus/ \
148                            DEST_ETC_DIR=/home/konrad/MAIN/pkgroot/lsb-pegasus/etc/opt/lsb-pegasus install

149 konrad.r   1.1       
150                      To build the RPM, you have to change in the rpm/lsb-pegasus.spec  
151                      the BuildRoot path to be what you choose previously.
152                    
153                      Change accordingly, in our case, the BuildRoot will be:
154                      BuildRoot: /home/konrad/MAIN/pkgroot
155                    
156                      Lastly the RPM build process:
157                    
158                      $rpmbuild -b rpm/lsb-pegasus.spec
159                    
160                      And the OpenPegasus LSB compliant package is built.
161