[srm-cvs] CVS Update: - Initial Checkin

Date: Tue Feb 19 16:46:32 CET 2002
User: Peter Petermann
Directory: srm

Log Message:
 [6.66]
 - Initial Checkin
Added files:
           srm/HOWTO (new version: 1.1)

[FILE: /srm/HOWTO]

1) INDEX:

- 1. INDEX
- 2. ABOUT
- 3. FILES
- 4. INSTALLATION
- 4.1 COMPILING
- 4.1.1 COMPILING SRM
- 4.1.2 COMPILING PHP
- 4.1.2.1 COMPILING PHP - SRM SAPI
- 4.1.2.2 COMPILING PHP - SRM EXTENDED
- 5. RUNNING
- 6. TROUBLESHOOTING
- 7. BUG REPORTING

2) ABOUT

        Well, this file is meant to help you installing vulcan-logic srm.
        Because of better Examples, the used config is not identical with the default SRM config.
        While writing this Document i assume that you have compiled PHP & Apache before, and this
        isnt your first install on a unix/linux system. If you dont, please read one or two documents
        explaining install of PHP before.

3) FILES
        In this example we use a very basic install of PHP & SRM, so you just need 3 Files:
        - php-4.1.1.tar.gz
        - srm-0.6.0.tar.gz
        - srm-php-0.6.0.tar.gz

        those 3 files offcourse need to be extracted, easiest way for that is, assuming you have them in
        same directory:
        
                tar -xzf php-4.1.1.tar.gz
                mv srm-php-0.6.0.tar.gz php-4.1.1; cd php-4.1.1; tar -xzf srm-php-0.6.0.tar.gz; cd ..
                tar -xzvf srm-0.6.0.tar.gz

        HINT: if you have all tar.gz files in the same directory you may just copy and paste the 3 lines
        above.

4) INSTALLATION

4.1) COMPILING
        Here you find all steps needed to compile a srmd, PHP as running machine in this srmd and
        ofcourse PHP for accessing SRM

4.1.1) COMPILING SRM
        First change to SRM Source directory ;) Then choose the configure options you want (remember,
        ./configure --help shows 'em all.
        in this Example we choose to use to following configure line:
        
                ./configure --prefix=/srm --enable-auth
        
        (please remember, /srm is not default path for srm. it is just to make it easier for you
        to follow this document.)
        
        after configure, you should make & install srm by doing:
        
                make; make install;
        
        Now edit your srm.ini, (make sure that paths are changed from /usr/local/srm... to /srm...)
        comment "http" module out, it isnt included in spring nights.
        (Hint: if you want to testdrive srm at this moment, comment "php4" module out)
        (2. Hint: if you commented "php4" module out, and you want to go on with this document
        well, uncomment it ,)

4.1.2) COMPILING PHP
        First you should recreate the configure file of PHP, just change into the directory php-4.1.1,
        delete configure script and run buildconf:

        cd php-4.1.1; rm -f configure; ./buildconf
        
        Now doing a:
        ./configure --help |grep srm
        
        should show you some lines, if the lines below are show, everything is fine,
        if not, have a look at the TROUBLESHOOTING section of this file.

                --with-srm-sapi[=DIR] Include SRM-SAPI support
                  --with-srm[=DIR] Include SRM: Script Running Magic (http://www.vl-srm.net/) support

4.1.2.1) COMPILING PHP - SRM SAPI
        Well, first change to the PHP Source directory,
        then we configure PHP as we need it. in this example this are just the essentials
        srm needs to run (and additional the prefix where all those nice files should go ;)
        
        ./configure --with-srm-sapi=/srm --with-srm=/srm --prefix=/srm
        
        now do
        
                make; make install;
        
        again, after that php module for srmd should be in right place,
        now you may start your srmd by changing to /srm/sbin
        and running it (see 5, RUNNING)

4.1.2.2) COMPILING PHP - SRM EXTENDED
        Ok, compiling PHP with SRM extension is real simple,
        just move again to your php source,
        and configure with following options:
                
                ./configure --with-srm=/srm --prefix=/srm/php-extended
        (Ive choosen CGI Build of PHP and a directory that wouldnt change
        anything at your running PHP System, i guess youre able to
        change it to fit your needs)

5) RUNNING

        cd /srm/sbin/; ./srmd -X -L
        (for testing -X -L no bad idea, because you can see what happens then

6) TROUBLESHOOTING
        If srmd doesnt start, try -X -L to see what happens.
        If srmd hangs at startup, check if it still hangs if you comment php module out
                if so, check with which extensions you compiled it, and play arround a bit
                (in special with self-written extension) by not configuring some.. then
                youll find out which of the extensions could cause this trouble)

7) BUG REPORTING
        If you have any Bugs, Suggestions, Ideas:

                srm@lists.vl-srm.net
        
        Please make sure you include as much Details as possible
        in your report.
Received on Tue Feb 19 16:46:14 2002