From 51984ac3d3da3006809c6866fdecd4ad83610731 Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 30 Jul 2001 07:36:04 +0000 Subject: templates!!! --- httemplate/docs/install.html | 121 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 httemplate/docs/install.html (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html new file mode 100644 index 000000000..d61dc9dfa --- /dev/null +++ b/httemplate/docs/install.html @@ -0,0 +1,121 @@ + + Installation + + +

Installation

+Before installing, you need: + +Install the Freeside distribution: + + + + + + + + + +
Apache::ASPMason
    +
  • Run make aspdocs +
  • Copy aspdocs/ to your web server's document space. +
  • Create a Global directory, such as /usr/local/etc/freeside/asp-global/ +
  • Copy htetc/global.asa to the Global directory. +
  • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example: +
    +<Directory /usr/local/apache/htdocs/freeside-asp>
    +<Files ~ (\.cgi)>
    +AddHandler perl-script .cgi
    +PerlHandler Apache::ASP
    +</Files>
    +<Perl>
    +$MLDBM::RemoveTaint = 1;
    +</Perl>
    +PerlSetVar Global /usr/local/etc/freeside/asp-global/
    +</Directory>
    +
    +
    +
  • Run make masondocs +
  • Copy masondocs/ to your web server's document space. +
  • Copy htetc/handler.pl to your web server's configuration directory. +
  • Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/mason-data +
  • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example: +
    +<Directory /usr/local/apache/htdocs/freeside-mason>
    +<Files ~ (\.cgi)>
    +AddHandler perl-script .cgi
    +PerlHandler HTML::Mason
    +</Files>
    +<Perl>
    +require "/usr/local/apache/conf/handler.pl";
    +</Perl>
    +</Directory>
    +
    +
+ + -- cgit v1.2.1 From 8c8e1e437e684c54dfbd846fb0997b30f4993131 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 4 Sep 2001 09:55:02 +0000 Subject: better installation instructions --- httemplate/docs/install.html | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index d61dc9dfa..f62ac4cf9 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -49,7 +49,7 @@ Install the Freeside distribution:
  • with MySQL:
    $ mysqladmin -u root password 'set_a_root_database_password'
     $ mysql -u root -p
     mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* TO freeside@localhost IDENTIFIED BY 'set_a_freeside_database_password';
    -
  • with PostgreSQL +
  • with PostgreSQL
  • Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
  • Unpack the tarball:
    gunzip -c fs-x.y.z.tar.gz | tar xvf -
    @@ -60,11 +60,6 @@ $ perl Makefile.PL $ make $ su # make install UNINST=1 -
  • Copy or link fs-x.y.z/htdocs to your web server's document space.
    mkdir /usr/local/apache/htdocs/freeside
    -cp -r fs-x.y.z/htdocs/* /usr/local/apache/htdocs/freeside
    or
    ln -s /full/path/to/fs-x.y.z/htdocs /usr/local/apache/htdocs/freeside
    -
  • Restrict access to this web interface. (with Apache) -
  • Enable CGI execution for files with the `.cgi' extension. (with Apache) -
  • Set ownership and permissions for the web interface. The web interface needs to run as the freeside user - there are several ways to do this.
  • You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user. @@ -112,6 +107,7 @@ require "/usr/local/apache/conf/handler.pl";
      +
    • Restrict access to this web interface. (with Apache)
    • Create the necessary configuration files.
    • Create the `/usr/local/etc/freeside/counters.datasrc', and `/usr/local/etc/freeside/export.datasrc' directories for each datasrc (owned by the freeside user). -- cgit v1.2.1 From 34e22e18b050b9a507433d24eb7a896ce2182afd Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 6 Sep 2001 21:43:19 +0000 Subject: no more pg RADIUS silliness --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index f62ac4cf9..1529c648e 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -9,7 +9,7 @@ Before installing, you need:
    • mod_perl
    • SSH
    • Perl Don't enable experimental features like threads or the PerlIO abstraction layer. -
    • A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. (see the PostgreSQL notes) MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB. +
    • A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB.
    • Perl modules (CPAN will query, download and build perl modules automatically)
      • Array-PrintCols -- cgit v1.2.1 From f5266a4d07d116efd732f433d0f4f3a47b143a7d Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 11 Sep 2001 00:08:18 +0000 Subject: faster (cached) fuzzy searches prelim. job queues! fixed part_svc editing --- httemplate/docs/install.html | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 1529c648e..4bf7b44ea 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -109,9 +109,11 @@ require "/usr/local/apache/conf/handler.pl";
        • Restrict access to this web interface. (with Apache)
        • Create the necessary configuration files. -
        • Create the `/usr/local/etc/freeside/counters.datasrc', and +
        • Create the `/usr/local/etc/freeside/counters.datasrc', + `/usr/local/etc/freeside/cache.datasrc', and `/usr/local/etc/freeside/export.datasrc' directories for each datasrc (owned by the freeside user).
        • As the freeside user, run bin/fs-setup to create the database tables. +
        • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup.
        • Now proceed to the initial administration of your installation.
        -- cgit v1.2.1 From 04ac51dff5dd29a1c674168f5d3396acbb158dbc Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 12 Sep 2001 15:54:25 +0000 Subject: mason warnings --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 4bf7b44ea..c99a0f911 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -87,6 +87,7 @@ PerlSetVar Global /usr/local/etc/freeside/asp-global/
        +
      • NOTE: Mason support is still a bit buggy in the 1.4.0 prereleases. This will be fixed before 1.4.0. You have been warned.
      • Run make masondocs
      • Copy masondocs/ to your web server's document space.
      • Copy htetc/handler.pl to your web server's configuration directory. -- cgit v1.2.1 From 1477de361665cd03cb00bebac39a730d00398064 Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 28 Sep 2001 04:33:33 +0000 Subject: ssh recommendations --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index c99a0f911..069bdaf2e 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -7,7 +7,7 @@ Before installing, you need:
        • A web server, such as Apache-SSL or Apache
        • mod_perl -
        • SSH +
        • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
        • Perl Don't enable experimental features like threads or the PerlIO abstraction layer.
        • A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB.
        • Perl modules (CPAN will query, download and build perl modules automatically) -- cgit v1.2.1 From 2e1ca65dcfcf6a8ef41a10e15e3d20200ffc871a Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 9 Oct 2001 13:16:01 +0000 Subject: update mysql links --- httemplate/docs/install.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 069bdaf2e..53eb8f856 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -46,12 +46,12 @@ Install the Freeside distribution:
        • Add the user `freeside' to your system.
        • Allow the freeside user full access to the freeside database.
            -
          • with MySQL:
            $ mysqladmin -u root password 'set_a_root_database_password'
            +      
          • with MySQL:
            $ mysqladmin -u root password 'set_a_root_database_password'
             $ mysql -u root -p
             mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* TO freeside@localhost IDENTIFIED BY 'set_a_freeside_database_password';
          • with PostgreSQL
          -
        • Add the freeside database to your database engine. (with MySQL) (with PostgreSQL) +
        • Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
        • Unpack the tarball:
          gunzip -c fs-x.y.z.tar.gz | tar xvf -
        • Build and install the Perl libraries:
          -- 
          cgit v1.2.1
          
          
          From 4bbf90e800406ff75a5fed09ba5cd71293cda542 Mon Sep 17 00:00:00 2001
          From: ivan 
          Date: Tue, 9 Oct 2001 23:10:17 +0000
          Subject: add `unsuspendauto' config file: enable the automatic unsuspension of
           suspended packages when a customer's balance due changes from positive to
           zero or negative as the result of a payment or credit
          
          add cust_pkg.manual_flag to disable this behaviour per customer package (no UI
          to set this yet)
          ---
           httemplate/docs/install.html | 2 +-
           1 file changed, 1 insertion(+), 1 deletion(-)
          
          (limited to 'httemplate/docs/install.html')
          
          diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
          index 53eb8f856..44644dc91 100644
          --- a/httemplate/docs/install.html
          +++ b/httemplate/docs/install.html
          @@ -51,7 +51,7 @@ $ mysql -u root -p
           mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* TO freeside@localhost IDENTIFIED BY 'set_a_freeside_database_password';
        • with PostgreSQL
        -
      • Add the freeside database to your database engine. (with MySQL) (with PostgreSQL) +
      • Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
      • Unpack the tarball:
        gunzip -c fs-x.y.z.tar.gz | tar xvf -
      • Build and install the Perl libraries:
        -- 
        cgit v1.2.1
        
        
        From 68a1b014aea963c2c94316fa34ec9a5dd135d102 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Tue, 23 Oct 2001 18:57:45 +0000
        Subject: document how to set MySQL with BDB default tables
        
        ---
         httemplate/docs/install.html | 4 ++--
         1 file changed, 2 insertions(+), 2 deletions(-)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index 44644dc91..6861a173e 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -7,9 +7,9 @@ Before installing, you need:
         
        • A web server, such as Apache-SSL or Apache
        • mod_perl -
        • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.) +
        • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
        • Perl Don't enable experimental features like threads or the PerlIO abstraction layer. -
        • A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB. +
        • A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB, and set it as the default table type using the --default-table-type=BDB mysqld command-line option or by setting default-table-type=DBD in the my.cnf option file.
        • Perl modules (CPAN will query, download and build perl modules automatically)
          • Array-PrintCols -- cgit v1.2.1 From e6b57805f6b3e76448ab9b6d280f2c53bc1410f3 Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 24 Oct 2001 15:29:31 +0000 Subject: preliminary web config editor new config files: username-ampersand, passwordmax fs-setup updates get rid of old and crufty and unused registries/ config foo documentation updates --- httemplate/docs/install.html | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 6861a173e..c26c9a701 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -9,7 +9,11 @@ Before installing, you need:
          • mod_perl
          • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
          • Perl Don't enable experimental features like threads or the PerlIO abstraction layer. -
          • A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB, and set it as the default table type using the --default-table-type=BDB mysqld command-line option or by setting default-table-type=DBD in the my.cnf option file. +
          • A transactional database engine supported by Perl's DBI. +
          • Perl modules (CPAN will query, download and build perl modules automatically)
            • Array-PrintCols -- cgit v1.2.1 From 68d4bb2e760eb96a05753ad0abac78921edb47e1 Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 29 Oct 2001 20:54:22 +0000 Subject: doc typo --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index c26c9a701..63c39d682 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -12,7 +12,7 @@ Before installing, you need:
            • A transactional database engine supported by Perl's DBI.
            • Perl modules (CPAN will query, download and build perl modules automatically)
                -- cgit v1.2.1 From 399377be683d60fd80690504103b809885b27903 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 30 Oct 2001 10:20:32 +0000 Subject: setup/config updates. getting easier... --- httemplate/docs/install.html | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 63c39d682..3a14fa779 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -38,6 +38,7 @@ Before installing, you need:
              • Text-Template
              • DBI
              • DBD for your database engine +
              • DBIx-DataSource
              • DBIx-DBSchema
              • Net-SSH
              • String-ShellQuote @@ -112,7 +113,16 @@ require "/usr/local/apache/conf/handler.pl";
                  -
                • Restrict access to this web interface. (with Apache) +
                • Restrict access to this web interface. (with Apache). For example, to configure user authentication with flat files: +
                  +<Directory /usr/local/apache/htdocs/freeside-asp>
                  +PerlSetVar Global /usr/local/etc/freeside/asp-global/
                  +AuthName Freeside
                  +AuthType Basic
                  +AuthUserFile /usr/local/etc/apache/htpasswd
                  +require valid-user
                  +</Directory>
                  +
                • Create the necessary configuration files.
                • Create the `/usr/local/etc/freeside/counters.datasrc', `/usr/local/etc/freeside/cache.datasrc', and -- cgit v1.2.1 From edda09a317f5dfef05fb8906f28531ec6f4b0927 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 30 Oct 2001 11:47:54 +0000 Subject: whew more install docs and automation --- httemplate/docs/install.html | 57 +++++++++++++++++++++++++++++++------------- 1 file changed, 41 insertions(+), 16 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 3a14fa779..f2db59f88 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -51,20 +51,35 @@ Install the Freeside distribution:
                • Add the user `freeside' to your system.
                • Allow the freeside user full access to the freeside database.
                    -
                  • with MySQL:
                    $ mysqladmin -u root password 'set_a_root_database_password'
                    +      
                  • with PostgreSQL: +
                    +$ su freeside
                    +$ createuser -P freeside
                    +
                  • with MySQL: +
                    +$ mysqladmin -u root password 'set_a_root_database_password'
                     $ mysql -u root -p
                     mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* TO freeside@localhost IDENTIFIED BY 'set_a_freeside_database_password';
                    -
                  • with PostgreSQL
                  -
                • Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
                • Unpack the tarball:
                  gunzip -c fs-x.y.z.tar.gz | tar xvf -
                  +
                • Edit the top-level Makefile: +
                    +
                  • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source. +
                  • Set DB_ADMIN_PASSWORD to the freeside database user's password. +
                  +
                • Add the freeside database to your database engine: +
                  +$ su
                  +# make create-database
                • Build and install the Perl libraries:
                  -$ cd FS/
                  -$ perl Makefile.PL
                  -$ make
                  +$ make perl-modules
                  +$ su
                  +# make install-perl-modules
                  +
                • Create the necessary configuration files:
                   $ su
                  -# make install UNINST=1
                  +# make create-config +
      • You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user.
      @@ -113,22 +128,32 @@ require "/usr/local/apache/conf/handler.pl";
        -
      • Restrict access to this web interface. (with Apache). For example, to configure user authentication with flat files: -
        +
      • Restrict access to this web interface - see the Apache documentation on user authentication. For example, to configure user authentication with mod_auth (flat files): +
         <Directory /usr/local/apache/htdocs/freeside-asp>
         PerlSetVar Global /usr/local/etc/freeside/asp-global/
         AuthName Freeside
         AuthType Basic
        -AuthUserFile /usr/local/etc/apache/htpasswd
        +AuthUserFile /usr/local/etc/freeside/htpasswd
         require valid-user
         </Directory>
         
        -
      • Create the necessary configuration files. -
      • Create the `/usr/local/etc/freeside/counters.datasrc', - `/usr/local/etc/freeside/cache.datasrc', and - `/usr/local/etc/freeside/export.datasrc' directories for each datasrc (owned by the freeside user). -
      • As the freeside user, run bin/fs-setup to create the database tables. -
      • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup. +
      • Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication; they're not UNIX user accounts. For example, using mod_auth (flat files): +
          +
        • First user: +
          $ su
          +$ freeside-adduser -h /usr/local/etc/freeside/htpasswd -c /usr/local/etc/freeside/secrets username
          +
        • Additional users: +
          $ su
          +$ freeside-adduser -h /usr/local/etc/freeside/htpasswd /usr/local/etc/freeside/secrets username
          +
        + (using other auth types, add each user to your Apache authentication yand then run: freeside-adduser /usr/local/etc/freeside/secrets username +
      • As the freeside UNIX user, run bin/fs-setup username to create the database tables, passing the username of a Freeside user you created above: +
        +$ su freeside
        +$ bin/fs-setup username
        +
        +
      • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup.
      • Now proceed to the initial administration of your installation.
      -- cgit v1.2.1 From b934dd05b09dd3d7c72d1fc18b4f600fb3b86430 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 30 Oct 2001 12:35:39 +0000 Subject: makefile typo --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index f2db59f88..1d6022ba3 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -138,7 +138,7 @@ AuthUserFile /usr/local/etc/freeside/htpasswd require valid-user </Directory> -
    • Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication; they're not UNIX user accounts. For example, using mod_auth (flat files): +
    • Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication, not UNIX user accounts. For example, using mod_auth (flat files):
      • First user:
        $ su
        -- 
        cgit v1.2.1
        
        
        From a8989c556a7a1951a0b34942c6289f26395859d7 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Tue, 30 Oct 2001 13:47:07 +0000
        Subject: `make create-config' installs default config (conf dir update)
         freeside-adduser uses default secrets file
        
        ---
         httemplate/docs/install.html | 6 +++---
         1 file changed, 3 insertions(+), 3 deletions(-)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index 1d6022ba3..b5df9b1cc 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -142,12 +142,12 @@ require valid-user
             
        • First user:
          $ su
          -$ freeside-adduser -h /usr/local/etc/freeside/htpasswd -c /usr/local/etc/freeside/secrets username
          +$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
      • Additional users:
        $ su
        -$ freeside-adduser -h /usr/local/etc/freeside/htpasswd /usr/local/etc/freeside/secrets username
        +$ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
      - (using other auth types, add each user to your Apache authentication yand then run: freeside-adduser /usr/local/etc/freeside/secrets username + (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username
    • As the freeside UNIX user, run bin/fs-setup username to create the database tables, passing the username of a Freeside user you created above:
       $ su freeside
      -- 
      cgit v1.2.1
      
      
      From 160db3d20070241532162f8fa257e2ae4dd1f611 Mon Sep 17 00:00:00 2001
      From: ivan 
      Date: Tue, 30 Oct 2001 14:28:05 +0000
      Subject: docu
      
      ---
       httemplate/docs/install.html | 2 +-
       1 file changed, 1 insertion(+), 1 deletion(-)
      
      (limited to 'httemplate/docs/install.html')
      
      diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
      index b5df9b1cc..efc1eb6bc 100644
      --- a/httemplate/docs/install.html
      +++ b/httemplate/docs/install.html
      @@ -71,7 +71,7 @@ mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* T
           
       $ su
       # make create-database
      -
    • Build and install the Perl libraries: +
    • Build and install the Perl modules:
       $ make perl-modules
       $ su
      -- 
      cgit v1.2.1
      
      
      From 3c95656e1308b5ebf155191badac19000f0e5b9f Mon Sep 17 00:00:00 2001
      From: ivan 
      Date: Mon, 5 Nov 2001 18:23:53 +0000
      Subject: doc
      
      ---
       httemplate/docs/install.html | 2 +-
       1 file changed, 1 insertion(+), 1 deletion(-)
      
      (limited to 'httemplate/docs/install.html')
      
      diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
      index efc1eb6bc..20d6e1456 100644
      --- a/httemplate/docs/install.html
      +++ b/httemplate/docs/install.html
      @@ -53,7 +53,7 @@ Install the Freeside distribution:
           
      • with PostgreSQL:
        -$ su freeside
        +$ su postgres
         $ createuser -P freeside
      • with MySQL:
        -- 
        cgit v1.2.1
        
        
        From 70fa760135ca13a320a627d01e139f9ddb4d8689 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Fri, 9 Nov 2001 18:26:22 +0000
        Subject: Pg7 dependancy
        
        ---
         httemplate/docs/install.html | 2 +-
         1 file changed, 1 insertion(+), 1 deletion(-)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index 20d6e1456..60f549edb 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -11,7 +11,7 @@ Before installing, you need:
           
      • Perl Don't enable experimental features like threads or the PerlIO abstraction layer.
      • A transactional database engine supported by Perl's DBI.
      • Perl modules (CPAN will query, download and build perl modules automatically) -- cgit v1.2.1 From 03dcc6e0f48fae0b892dbd36229884e684b94049 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 11 Dec 2001 10:38:56 +0000 Subject: radiusprepend config file for export add Archive::Tar to docs --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 60f549edb..0bf2c1616 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -36,6 +36,7 @@ Before installing, you need:
      • FreezeThaw
      • String-Approx
      • Text-Template +
      • Archive-Tar
      • DBI
      • DBD for your database engine
      • DBIx-DataSource -- cgit v1.2.1 From 381ea36d912fe0aec54918c03f3a88eacab64460 Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 22 Dec 2001 02:41:39 +0000 Subject: doco on creating database manually --- httemplate/docs/install.html | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 0bf2c1616..8d5785f50 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -72,6 +72,13 @@ mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* T
         $ su
         # make create-database
        + (or manually, with Postgres:) +
        +$ su freeside
        +$ createdb freeside
        + (with MySQL:) +
        +$ mysqladmin -u freeside -p create freeside 
      • Build and install the Perl modules:
         $ make perl-modules
        -- 
        cgit v1.2.1
        
        
        From fee9bc7edcdd27e7a4e47bc313d05c66cd900073 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Wed, 26 Dec 2001 23:59:33 +0000
        Subject: doc
        
        ---
         httemplate/docs/install.html | 1 +
         1 file changed, 1 insertion(+)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index 8d5785f50..5e36d14a6 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -111,6 +111,7 @@ PerlHandler Apache::ASP
         $MLDBM::RemoveTaint = 1;
         </Perl>
         PerlSetVar Global /usr/local/etc/freeside/asp-global/
        +PerlSetVar Debug 2
         </Directory>
         
      -- cgit v1.2.1 From 6991d4986df7fb3a6c7c49b5ae1b3713e87a16c4 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 29 Jan 2002 16:33:16 +0000 Subject: - web interface for hourly account charges! (FS::cust_pkg, FS::cust_svc and FS::svc_acct seconds_since methods) - Makefile target to regenerate HTML manpages on install - FS.pm doc update - $FS::Record::Debug now dumps all SQL - new FS::cust_main methods: ->cancel, ->invoicing_list_addpost - start of a billing event web interface - cust_pay::upgrade_replace doesn't error out if history includes overapplied payments --- httemplate/docs/install.html | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 5e36d14a6..20bb168df 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -32,6 +32,7 @@ Before installing, you need:
    • MailTools
    • TimeDate
    • DateManip +
    • Time-Duration
    • File-CounterFile
    • FreezeThaw
    • String-Approx @@ -45,6 +46,7 @@ Before installing, you need:
    • String-ShellQuote
    • Net-SCP
    • Apache::ASP or HTML::Mason +
    • Tie-IxHash
    Install the Freeside distribution: @@ -151,10 +153,10 @@ require valid-user
    • First user:
      $ su
      -$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
      +$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
    • Additional users:
      $ su
      -$ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
      +$ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
    (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username
  • As the freeside UNIX user, run bin/fs-setup username to create the database tables, passing the username of a Freeside user you created above: -- cgit v1.2.1 From 1fd6d8cf5d7854860ef4fd10ed89828e0c04ec39 Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 30 Jan 2002 14:18:09 +0000 Subject: remove use Module; and $cgi = new CGI; &cgisuidsetup(); from all templates. should work better under Mason. --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 20bb168df..564dccaba 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -68,7 +68,7 @@ mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* T
  • Edit the top-level Makefile:
    • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source. -
    • Set DB_ADMIN_PASSWORD to the freeside database user's password. +
    • Set DB_PASSWORD to the freeside database user's password.
  • Add the freeside database to your database engine:
    -- 
    cgit v1.2.1
    
    
    From 8cbba53b09bb5b09355316b7ff8948500c3b4b76 Mon Sep 17 00:00:00 2001
    From: ivan 
    Date: Mon, 4 Feb 2002 16:44:48 +0000
    Subject: billing events!
    
    ---
     httemplate/docs/install.html | 1 -
     1 file changed, 1 deletion(-)
    
    (limited to 'httemplate/docs/install.html')
    
    diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
    index 564dccaba..e719645a4 100644
    --- a/httemplate/docs/install.html
    +++ b/httemplate/docs/install.html
    @@ -118,7 +118,6 @@ PerlSetVar Debug 2
     
    Install the Freeside distribution: -- cgit v1.2.1 From 65f2a86b2c239782f209b481744915f858530598 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 5 Feb 2002 09:46:07 +0000 Subject: doc --- httemplate/docs/install.html | 1 - 1 file changed, 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 749c4c77b..1edd4b16c 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -32,7 +32,6 @@ Before installing, you need:
  • MailTools
  • TimeDate
  • DateManip -
  • Time-Duration
  • File-CounterFile
  • FreezeThaw
  • String-Approx -- cgit v1.2.1 From e963a04493d15ac3e714a2cb95a28fe90a6239d9 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 5 Feb 2002 18:04:33 +0000 Subject: doc --- httemplate/docs/install.html | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 1edd4b16c..2a208c016 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -101,7 +101,10 @@ $ su
  • Run make aspdocs
  • Copy aspdocs/ to your web server's document space.
  • Create a Global directory, such as /usr/local/etc/freeside/asp-global/ -
  • Copy htetc/global.asa to the Global directory. +
  • Copy htetc/global.asa to the Global directory: +
    +cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
    +
  • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example:
     <Directory /usr/local/apache/htdocs/freeside-asp>
    -- 
    cgit v1.2.1
    
    
    From 30f31aae2dee3bdbec04f107e9d8cbb96442852e Mon Sep 17 00:00:00 2001
    From: ivan 
    Date: Tue, 5 Feb 2002 18:24:13 +0000
    Subject:   for commands; confusing otherwise
    
    ---
     httemplate/docs/install.html | 10 +++++-----
     1 file changed, 5 insertions(+), 5 deletions(-)
    
    (limited to 'httemplate/docs/install.html')
    
    diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
    index 2a208c016..35caa0023 100644
    --- a/httemplate/docs/install.html
    +++ b/httemplate/docs/install.html
    @@ -103,11 +103,11 @@ $ su
           
  • Create a Global directory, such as /usr/local/etc/freeside/asp-global/
  • Copy htetc/global.asa to the Global directory:
    -cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
    +cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
     
  • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example:
    -<Directory /usr/local/apache/htdocs/freeside-asp>
    +<Directory /usr/local/apache/htdocs/freeside-asp>
     <Files ~ (\.cgi)>
     AddHandler perl-script .cgi
     PerlHandler Apache::ASP
    @@ -115,7 +115,7 @@ PerlHandler Apache::ASP
     <Perl>
     $MLDBM::RemoveTaint = 1;
     </Perl>
    -PerlSetVar Global /usr/local/etc/freeside/asp-global/
    +PerlSetVar Global /usr/local/etc/freeside/asp-global/
     PerlSetVar Debug 2
     </Directory>
     
    @@ -127,13 +127,13 @@ PerlSetVar Debug 2
  • Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/mason-data
  • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example:
    -<Directory /usr/local/apache/htdocs/freeside-mason>
    +<Directory /usr/local/apache/htdocs/freeside-mason>
     <Files ~ (\.cgi)>
     AddHandler perl-script .cgi
     PerlHandler HTML::Mason
     </Files>
     <Perl>
    -require "/usr/local/apache/conf/handler.pl";
    +require "/usr/local/apache/conf/handler.pl";
     </Perl>
     </Directory>
     
    -- cgit v1.2.1 From d815064689e78291069209fb4610f905449dcee6 Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 6 Feb 2002 15:49:04 +0000 Subject: documentation building Makefile patch --- httemplate/docs/install.html | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 35caa0023..0f3796c6c 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -57,7 +57,12 @@ Install the Freeside distribution:
  • with PostgreSQL:
     $ su postgres
    -$ createuser -P freeside
    +$ createuser -P freeside +Enter password for user "freeside": +Enter it again: +Shall the new user be allowed to create databases? (y/n) y +Shall the new user be allowed to create more new users? (y/n) n +CREATE USER
  • with MySQL:
     $ mysqladmin -u root password 'set_a_root_database_password'
    -- 
    cgit v1.2.1
    
    
    From d7a1a7154a401edfbc4844721c08cb6f483d59b7 Mon Sep 17 00:00:00 2001
    From: ivan 
    Date: Sat, 16 Feb 2002 07:27:52 +0000
    Subject: install warnings about mysql
    
    ---
     httemplate/docs/install.html | 5 ++++-
     1 file changed, 4 insertions(+), 1 deletion(-)
    
    (limited to 'httemplate/docs/install.html')
    
    diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
    index 0f3796c6c..b739af02c 100644
    --- a/httemplate/docs/install.html
    +++ b/httemplate/docs/install.html
    @@ -12,7 +12,10 @@ Before installing, you need:
       
  • A transactional database engine supported by Perl's DBI.
  • Perl modules (CPAN will query, download and build perl modules automatically)
      -- cgit v1.2.1 From 968f75993d7ec66d743bd5ab5e43d1d46556c27c Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 18 Feb 2002 01:26:07 +0000 Subject: rsync docs --- httemplate/docs/install.html | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index b739af02c..315ad8f50 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -5,10 +5,11 @@

      Installation

      Before installing, you need:
        -
      • A web server, such as Apache-SSL or Apache -
      • mod_perl -
      • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
      • Perl Don't enable experimental features like threads or the PerlIO abstraction layer. +
      • Apache (mod_ssl or Apache-SSL highly recommended) +
      • mod_perl +
      • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.) +
      • rsync
      • A transactional database engine supported by Perl's DBI.
        • PostgreSQL (v7 or higher) is recommended. @@ -72,7 +73,7 @@ $ mysqladmin -u root password 'set_a_root_database_password' $ mysql -u root -p mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* TO freeside@localhost IDENTIFIED BY 'set_a_freeside_database_password';
  • -
  • Unpack the tarball:
    gunzip -c fs-x.y.z.tar.gz | tar xvf -
    +
  • Edit the top-level Makefile:
    • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source. -- cgit v1.2.1 From 47bc56487b4aebf3e415767a053dc049fe4a28d4 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 19 Feb 2002 23:43:54 +0000 Subject: set EVERYTHING=1 for your own mod_perl compile --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 315ad8f50..d8d02c1e7 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -7,7 +7,7 @@ Before installing, you need:
      • Perl Don't enable experimental features like threads or the PerlIO abstraction layer.
      • Apache (mod_ssl or Apache-SSL highly recommended) -
      • mod_perl +
      • mod_perl (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
      • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
      • rsync
      • A transactional database engine supported by Perl's DBI. -- cgit v1.2.1 From c82f33db5954253c96790918b7274566ac9182af Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 23 Feb 2002 02:02:36 +0000 Subject: UI work on main menu, remove Archive::Tar from docs --- httemplate/docs/install.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index d8d02c1e7..b2d735d12 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -14,7 +14,7 @@ Before installing, you need:
        • PostgreSQL (v7 or higher) is recommended.
        • MySQL does not work at this time. - The following information is provided for developers who wish to contribute MySQL support: See tickets #300 and #334 in the bug-tracking system. + The following information is provided for developers who wish to contribute MySQL support: See ticket #300 in the bug-tracking system. MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB, and set it as the default table type using the --default-table-type=BDB mysqld command-line option or by setting default-table-type=BDB in the my.cnf option file.
        @@ -40,7 +40,6 @@ Before installing, you need:
      • FreezeThaw
      • String-Approx
      • Text-Template -
      • Archive-Tar
      • DBI
      • DBD for your database engine (DBD::Pg for PostgreSQL, DBD::mysql for MySQL)
      • DBIx-DataSource -- cgit v1.2.1 From dac484e8356be5b235cacebe83059b7eb6588c13 Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 3 Mar 2002 23:46:45 +0000 Subject: docu --- httemplate/docs/install.html | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index b2d735d12..d7c014f4d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -98,7 +98,7 @@ $ su $ su # make create-config -
      • You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user. +
      • Run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user.
      @@ -108,7 +108,11 @@ $ su -- cgit v1.2.1 From d384acea721092aebd4ffd972a2c3a80208e80ae Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 28 Feb 2004 22:43:18 +0000 Subject: Apache::ASP 2.55 required --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index c223394e9..ed306f2d3 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -140,6 +140,7 @@ $MLDBM::RemoveTaint = 1; </Perl> PerlSetVar Global /usr/local/etc/freeside/asp-global/ PerlSetVar Debug 2 +PerlSetVar RequestBinaryRead Off </Directory> -- cgit v1.2.1 From 72a65ceaa28155e8c1c3c1328dd76587b35e089a Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 17 Mar 2004 21:47:56 +0000 Subject: proper self-service login supporting plaintext, crypt and MD5 passwords --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index ed306f2d3..0217c9085 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -56,6 +56,7 @@ Before installing, you need:
    • NetAddr-IP
    • Chart +
    • Crypt::PasswdMD5
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 84d15a339737bd783b764c7f0d371084c2158ce7 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 23 Mar 2004 03:29:40 +0000 Subject: includes with Apache::ASP --- httemplate/docs/install.html | 3 +++ 1 file changed, 3 insertions(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 0217c9085..5f2ca4ca6 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -131,6 +131,7 @@ cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
    • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example:
       PerlModule Apache::ASP
      +# your freeside document root
       <Directory /usr/local/apache/htdocs/freeside-asp>
       <Files ~ (\.cgi|\.html)>
       SetHandler perl-script
      @@ -142,6 +143,8 @@ $MLDBM::RemoveTaint = 1;
       PerlSetVar Global /usr/local/etc/freeside/asp-global/
       PerlSetVar Debug 2
       PerlSetVar RequestBinaryRead Off
      +# your freeside document root
      +PerlSetVar IncludesDir /usr/local/apache/htdocs/freeside-asp
       </Directory>
       
      -- cgit v1.2.1 From a5651d5945c790b0d3fee0cd5082269a21adc6ee Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 5 Apr 2004 09:08:39 +0000 Subject: add whois functionality internally instead of linking to geektools --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 5f2ca4ca6..41aacc51b 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -30,7 +30,7 @@ Before installing, you need:
    • HTML-Parser
    • libnet
    • Locale-Codes -
    • Net-Whois +
    • Net-Whois-Raw
    • libwww-perl
    • Business-CreditCard -- cgit v1.2.1 From a8c68c9a3f346c49756956b51fa37a37ef795979 Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 22 Apr 2004 07:27:35 +0000 Subject: minor doc updates --- httemplate/docs/install.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 41aacc51b..9da2de37f 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -134,7 +134,7 @@ PerlModule Apache::ASP # your freeside document root <Directory /usr/local/apache/htdocs/freeside-asp> <Files ~ (\.cgi|\.html)> -SetHandler perl-script +AddHandler perl-script .cgi .html PerlHandler Apache::ASP </Files> <Perl> @@ -162,8 +162,8 @@ PerlSetVar IncludesDir /usr/local/apache/htdocs/freeside-asp
       PerlModule HTML::Mason
       <Directory /usr/local/apache/htdocs/freeside-mason>
      -<Files ~ (\.cgi|.html)>
      -SetHandler perl-script
      +<Files ~ (\.cgi|\.html)>
      +AddHandler perl-script .cgi .html
       PerlHandler HTML::Mason
       </Files>
       <Perl>
      -- 
      cgit v1.2.1
      
      
      From 2a7c870a444759b248b273483bf50a433ed8c490 Mon Sep 17 00:00:00 2001
      From: ivan 
      Date: Wed, 9 Jun 2004 07:17:30 +0000
      Subject: explicitly specify Apache httpd.conf.  fear.
      
      ---
       httemplate/docs/install.html | 6 +++---
       1 file changed, 3 insertions(+), 3 deletions(-)
      
      (limited to 'httemplate/docs/install.html')
      
      diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
      index 9da2de37f..df353eb9d 100644
      --- a/httemplate/docs/install.html
      +++ b/httemplate/docs/install.html
      @@ -128,7 +128,7 @@ chown freeside /usr/local/etc/freeside/asp-global/
       
       cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
       
      -
    • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example: +
    • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
       PerlModule Apache::ASP
       # your freeside document root
      @@ -158,7 +158,7 @@ PerlSetVar IncludesDir /usr/local/apache/htdocs/freeside-asp
               
    • set an appropriate data_dir, such as /usr/local/etc/freeside/masondata -
    • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example: +
    • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
       PerlModule HTML::Mason
       <Directory /usr/local/apache/htdocs/freeside-mason>
      @@ -175,7 +175,7 @@ require "/usr/local/etc/freeside/handler.pl";
         
      • Run make aspdocs
      • Copy aspdocs/ to your web server's document space. -
      • Create a Global directory, such as /usr/local/etc/freeside/asp-global/ +
      • Create a Global directory, such as /usr/local/etc/freeside/asp-global/: +
        +mkdir /usr/local/etc/freeside/asp-global/
        +chown freeside /usr/local/etc/freeside/asp-global/
        +
      • Copy htetc/global.asa to the Global directory:
         cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
        -- 
        cgit v1.2.1
        
        
        From f96adaf19c0097ef8c9d6f29a5541b75381cc05d Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Tue, 12 Mar 2002 15:33:22 +0000
        Subject: abstract stupid HTML layer trick out to HTML::Widgets::SelectLayers
        
        ---
         httemplate/docs/install.html | 1 +
         1 file changed, 1 insertion(+)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index d7c014f4d..1a4942bc9 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -50,6 +50,7 @@ Before installing, you need:
               
      • Apache::ASP or HTML::Mason
      • Tie-IxHash
      • Time-Duration +
      • HTML-Widgets-SelectLayers
      Install the Freeside distribution: -- cgit v1.2.1 From 92badebcb286260d7861bd09a2450eea18c4259e Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 5 Apr 2002 00:42:21 +0000 Subject: Checkin of disparate changes from working on the road: - generic SQL query - move exports out to their own files - small cleanup of selfadmin server --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 1a4942bc9..4370d9153 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -24,6 +24,7 @@ Before installing, you need:
    • Term-Query (make test broken; install manually)
    • MIME-Base64
    • Digest-MD5 +
    • MD5
    • URI
    • HTML-Tagset
    • HTML-Parser -- cgit v1.2.1 From 8fc4118f1f055195d280b3250b39a3b5fcdf13dc Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 6 Apr 2002 20:37:38 +0000 Subject: big signup server cleanups. uses Storable for network protocol now. - makes Bugs 384 & 385 easier - closes: Bug#382 --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 4370d9153..2ad75b15e 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -52,6 +52,7 @@ Before installing, you need:
    • Tie-IxHash
    • Time-Duration
    • HTML-Widgets-SelectLayers +
    • Storable Install the Freeside distribution: -- cgit v1.2.1 From 44e3eff0aa6e7bdb7f4ecd9ee1ddf141e1b68af3 Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 7 Apr 2002 05:56:09 +0000 Subject: working message catalogs (not used for enough yet) - almost (but not quite) closes Bug#385 - still have to catalog the backend things triggered by signup server. --- httemplate/docs/install.html | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 2ad75b15e..4870c7db7 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -180,6 +180,11 @@ $ freeside-adduser -h /usr/local/etc
       $ su freeside
       $ bin/fs-setup username
      +
      +
    • As the freeside UNIX user, run bin/populate-msgcat username to populate the message catalog, passing the username of a Freeside user you created above: +
      +$ su freeside
      +$ bin/populate-msgcat username
       
    • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup.
    • Now proceed to the initial administration of your installation. -- cgit v1.2.1 From c3256336de26feda8ad6c7e51b039249e147a30f Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 9 May 2002 15:14:21 +0000 Subject: attempt to avoid people installing and asking for help with MySQL despite the VERY FUCKING CLEAR instructions that it isn't supported. --- httemplate/docs/install.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 4870c7db7..5c13ac10d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -13,10 +13,9 @@ Before installing, you need:
    • A transactional database engine supported by Perl's DBI.
      • PostgreSQL (v7 or higher) is recommended. -
      • MySQL does not work at this time. - The following information is provided for developers who wish to contribute MySQL support: See ticket #300 in the bug-tracking system. +
      • MySQL is NOT supported at this time. If you are a developer who wishes to contribute MySQL support, see the MySQL notes. - MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB, and set it as the default table type using the --default-table-type=BDB mysqld command-line option or by setting default-table-type=BDB in the my.cnf option file. +
    • Perl modules (CPAN will query, download and build perl modules automatically) Install the Freeside distribution: -- cgit v1.2.1 From eb7c552dd8290d6b33a4e026c5dc21ebf01105cf Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 15 May 2002 13:24:26 +0000 Subject: queue dependancies --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 5c13ac10d..26fa34dd1 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -186,7 +186,7 @@ $ bin/fs-setup username $ su freeside $ bin/populate-msgcat username -
    • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup. +
    • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or, edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your system, and run make install-init.
    • Now proceed to the initial administration of your installation. -- cgit v1.2.1 From 88ad98c9bc5150a130c6df53132760152aa6a437 Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 17 May 2002 13:51:50 +0000 Subject: tyop --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 26fa34dd1..355721821 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -52,7 +52,7 @@ Before installing, you need:
    • Time-Duration
    • HTML-Widgets-SelectLayers
    • Storable -
    • Apache::DBI (optional but recommended for better webinterface performance) +
    • Apache::DBI (optional but recommended for better webinterface performance) Install the Freeside distribution: -- cgit v1.2.1 From abc9411d7d7c54cf5c888e57c0aaf629a7d0c70a Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 4 Jun 2002 17:37:36 +0000 Subject: small doc patch from baloo@gimpgirl.org --- httemplate/docs/install.html | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 355721821..beb9a47d7 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -176,14 +176,16 @@ $ freeside-adduser -c -h /usr/local/ $ freeside-adduser -h /usr/local/etc/freeside/htpasswd username (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username -
    • As the freeside UNIX user, run bin/fs-setup username to create the database tables, passing the username of a Freeside user you created above: +
    • As the freeside UNIX user, run bin/fs-setup username (in the untar'ed freeside directory) to create the database tables, passing the username of a Freeside user you created above:
       $ su freeside
      +$ cd /path/to/freeside-1.4.0/
       $ bin/fs-setup username
       
      -
    • As the freeside UNIX user, run bin/populate-msgcat username to populate the message catalog, passing the username of a Freeside user you created above: +
    • As the freeside UNIX user, run bin/populate-msgcat username (in the untar'ed freeside directory) to populate the message catalog, passing the username of a Freeside user you created above:
       $ su freeside
      +$ cd /path/to/freeside-1.4.0/
       $ bin/populate-msgcat username
       
    • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or, edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your system, and run make install-init. -- cgit v1.2.1 From de0898ba517025f865f80b351440f77a422d5bad Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 14 Jun 2002 02:52:36 +0000 Subject: mysql support! --- httemplate/docs/install.html | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index beb9a47d7..56cee80e5 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -13,9 +13,8 @@ Before installing, you need:
    • A transactional database engine supported by Perl's DBI.
      • PostgreSQL (v7 or higher) is recommended. -
      • MySQL is NOT supported at this time. If you are a developer who wishes to contribute MySQL support, see the MySQL notes. - - +
      • MySQL has been reported to work. + MySQL's default MyISAM and ISAM table types are not supported. If you want to use MySQL, you must use one of the new transaction-safe table types such as BDB or InnoDB, and set it as the default table type when running fs-setup using the --default-table-type=BDB or --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=BDB or --default-table-type=InnoDB in the my.cnf option file.
    • Perl modules (CPAN will query, download and build perl modules automatically)
        @@ -188,7 +187,7 @@ $ su freeside $ cd /path/to/freeside-1.4.0/ $ bin/populate-msgcat username -
      • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or, edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your system, and run make install-init. +
      • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your system, and run make install-init)
      • Now proceed to the initial administration of your installation.
      -- cgit v1.2.1 From 5bfc7cd4f5aac2905119ba076a23df1f13b58f7b Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 20 Jun 2002 22:31:46 +0000 Subject: doc --- httemplate/docs/install.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 56cee80e5..1f271e6d2 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -10,7 +10,7 @@ Before installing, you need:
    • mod_perl (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
    • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
    • rsync -
    • A transactional database engine supported by Perl's DBI. +
    • A transactional database engine supported by Perl's DBI.
      • PostgreSQL (v7 or higher) is recommended.
      • MySQL has been reported to work. @@ -77,7 +77,7 @@ mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* T
      • Edit the top-level Makefile:
          -
        • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source. +
        • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source.
        • Set DB_PASSWORD to the freeside database user's password.
      • Add the freeside database to your database engine: -- cgit v1.2.1 From 26a45c49727ef4505a2f1875aa7dd04be9bbdceb Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 2 Jul 2002 10:01:00 +0000 Subject: freeside group --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 1f271e6d2..db2141619 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -56,7 +56,7 @@ Before installing, you need:
      Install the Freeside distribution:
        -
      • Add the user `freeside' to your system. +
      • Add the user and group `freeside' to your system.
      • Allow the freeside user full access to the freeside database.
        • with PostgreSQL: -- cgit v1.2.1 From 0b8f79a88503618bca0e18d02aeebdbb1e3b47ba Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 6 Jul 2002 12:53:22 +0000 Subject: new! improved! now even more idiot-proof! --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index db2141619..c593c956b 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -187,7 +187,7 @@ $ su freeside $ cd /path/to/freeside-1.4.0/ $ bin/populate-msgcat username -
        • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your system, and run make install-init) +
        • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your systemand QUEUED_USER with the username of a Freeside user you created above, and run make install-init)
        • Now proceed to the initial administration of your installation.
        -- cgit v1.2.1 From e8f33bb58dd26e2db301cc65144d269b877eac59 Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 8 Jul 2002 08:39:49 +0000 Subject: new and improved instructions! now even more idiot proof! --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index c593c956b..800ee01c6 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -14,7 +14,7 @@ Before installing, you need:
      • Perl modules (CPAN will query, download and build perl modules automatically)
          -- cgit v1.2.1 From 6fb47adef49450c1fb237251aae911b0825e6869 Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 14 Jul 2002 00:28:23 +0000 Subject: no mason 1.1x yet :( --- httemplate/docs/install.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 800ee01c6..e8e80baf6 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -46,7 +46,7 @@ Before installing, you need:
        • Net-SSH
        • String-ShellQuote
        • Net-SCP -
        • Apache::ASP or HTML::Mason +
        • Apache::ASP or HTML::Mason (use version 1.0x - Freeside is not yet compatible with version 1.1x)
        • Tie-IxHash
        • Time-Duration
        • HTML-Widgets-SelectLayers @@ -135,6 +135,7 @@ PerlSetVar Debug 2
      • +
      • (use version 1.0x - Freeside is not yet compatible with version 1.1x)
      • Run make masondocs
      • Copy masondocs/ to your web server's document space.
      • Copy htetc/handler.pl to your web server's configuration directory. -- cgit v1.2.1 From 5b78ae987febe0f160c06d0592c4b4920e5fe010 Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 22 Jul 2002 10:41:21 +0000 Subject: no mysql in 1.4.0 release. hopefully 1.4.1 --- httemplate/docs/install.html | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index e8e80baf6..3c96814da 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -13,8 +13,9 @@ Before installing, you need:
      • A transactional database engine supported by Perl's DBI.
        • PostgreSQL (v7 or higher) is recommended. -
        • MySQL has been reported to work. - MySQL's default MyISAM and ISAM table types are not supported. If you want to use MySQL, you must use one of the new transaction-safe table types such as BDB or InnoDB, and set it as the default table type using the --default-table-type=BDB or --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=BDB or default-table-type=InnoDB in the my.cnf option file. +
        • MySQL versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. +
      • Perl modules (CPAN will query, download and build perl modules automatically)
      @@ -68,16 +70,17 @@ Enter it again: Shall the new user be allowed to create databases? (y/n) y Shall the new user be allowed to create more new users? (y/n) n CREATE USER -
    • with MySQL: +
    • Edit the top-level Makefile:
        -
      • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source. +
      • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL. See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source.
      • Set DB_PASSWORD to the freeside database user's password.
    • Add the freeside database to your database engine: @@ -88,9 +91,10 @@ $ su
       $ su freeside
       $ createdb freeside
      - (with MySQL:) +
    • Build and install the Perl modules:
       $ make perl-modules
      -- 
      cgit v1.2.1
      
      
      From cff1c159f7c895fc0dd39754d762e90d283888a7 Mon Sep 17 00:00:00 2001
      From: ivan 
      Date: Fri, 26 Jul 2002 01:31:53 +0000
      Subject: tyop
      
      ---
       httemplate/docs/install.html | 2 +-
       1 file changed, 1 insertion(+), 1 deletion(-)
      
      (limited to 'httemplate/docs/install.html')
      
      diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
      index 3c96814da..cf3f6d555 100644
      --- a/httemplate/docs/install.html
      +++ b/httemplate/docs/install.html
      @@ -13,7 +13,7 @@ Before installing, you need:
         
    • A transactional database engine supported by Perl's DBI.
      • PostgreSQL (v7 or higher) is recommended. -
      • MySQL versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. +
      • MySQL versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list.
      -- cgit v1.2.1 From e87b9a0b4b7eab8e258b7fac7cb6182ee0f6c7ea Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 26 Jul 2002 01:38:29 +0000 Subject: tyop --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index cf3f6d555..262088716 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -41,7 +41,7 @@ Before installing, you need:
    • String-Approx
    • Text-Template
    • DBI -
    • DBD for your database engine (DBD::Pg for PostgreSQL +
    • DBD for your database engine (DBD::Pg for PostgreSQL)
    • DBIx-DataSource
    • DBIx-DBSchema
    • Net-SSH -- cgit v1.2.1 From 030438c9cb1c12ccb79130979ef0922097b4311a Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 3 Aug 2002 00:39:31 +0000 Subject: remove some extra modules from install doc --- httemplate/docs/install.html | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 262088716..75f039dd1 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -19,11 +19,11 @@ Before installing, you need:
    • Perl modules (CPAN will query, download and build perl modules automatically) -- cgit v1.2.1 From 5dc522149a7ad8363ce46f8ff6b3133b2d3d3cdf Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 20 Sep 2002 12:04:17 +0000 Subject: doc NetAddr::IP dependancy --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 75f039dd1..e6f6f59de 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -53,6 +53,7 @@ Before installing, you need:
    • HTML-Widgets-SelectLayers
    • Storable +
    • NetAddr-IP
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From eb0d04842631ae16247c6246cc6a1d8896169ff9 Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 20 Sep 2002 12:50:30 +0000 Subject: move from bin/fs-setup to FS/bin/freeside-setup --- httemplate/docs/install.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index e6f6f59de..e6f4edbbc 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -181,12 +181,12 @@ $ freeside-adduser -c -h /usr/local/ $ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
    • (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username -
    • As the freeside UNIX user, run bin/fs-setup username (in the untar'ed freeside directory) to create the database tables, passing the username of a Freeside user you created above: +
    • As the freeside UNIX user, run freeside--setup username (in the untar'ed freeside directory) to create the database tables, passing the username of a Freeside user you created above:
       $ su freeside
      -$ cd /path/to/freeside-1.4.0/
      -$ bin/fs-setup username
      +$ freeside-setup username
       
      + Alternately, use the -s option to enable shipping addresses: freeside-setup -s username
    • As the freeside UNIX user, run bin/populate-msgcat username (in the untar'ed freeside directory) to populate the message catalog, passing the username of a Freeside user you created above:
       $ su freeside
      -- 
      cgit v1.2.1
      
      
      From 25fdab941288302f1aa8063d4e237f62876c59b8 Mon Sep 17 00:00:00 2001
      From: ivan 
      Date: Wed, 25 Sep 2002 09:11:13 +0000
      Subject: doc
      
      ---
       httemplate/docs/install.html | 9 ++++-----
       1 file changed, 4 insertions(+), 5 deletions(-)
      
      (limited to 'httemplate/docs/install.html')
      
      diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
      index e6f4edbbc..3d19e4d35 100644
      --- a/httemplate/docs/install.html
      +++ b/httemplate/docs/install.html
      @@ -64,7 +64,7 @@ Install the Freeside distribution:
           
      • with PostgreSQL:
        -$ su postgres
        +$ su postgres (pgsql on some distributions)
         $ createuser -P freeside
         Enter password for user "freeside": 
         Enter it again: 
        @@ -81,7 +81,7 @@ mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* T
         
           
      • Edit the top-level Makefile:
      • Add the freeside database to your database engine: @@ -164,7 +164,6 @@ require "/usr/local/apache/conf/handler.pl";
      • Restrict access to this web interface - see the Apache documentation on user authentication. For example, to configure user authentication with mod_auth (flat files):
         <Directory /usr/local/apache/htdocs/freeside-asp>
        -PerlSetVar Global /usr/local/etc/freeside/asp-global/
         AuthName Freeside
         AuthType Basic
         AuthUserFile /usr/local/etc/freeside/htpasswd
        @@ -181,7 +180,7 @@ $ freeside-adduser -c -h /usr/local/
         $ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
      (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username -
    • As the freeside UNIX user, run freeside--setup username (in the untar'ed freeside directory) to create the database tables, passing the username of a Freeside user you created above: +
    • As the freeside UNIX user, run freeside-setup username to create the database tables, passing the username of a Freeside user you created above:
       $ su freeside
       $ freeside-setup username
      @@ -190,7 +189,7 @@ $ freeside-setup username
         
    • As the freeside UNIX user, run bin/populate-msgcat username (in the untar'ed freeside directory) to populate the message catalog, passing the username of a Freeside user you created above:
       $ su freeside
      -$ cd /path/to/freeside-1.4.0/
      +$ cd /path/to/freeside/
       $ bin/populate-msgcat username
       
    • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your systemand QUEUED_USER with the username of a Freeside user you created above, and run make install-init) -- cgit v1.2.1 From c4d2226e0cc4bdd6d9f689b061b5f4f5b9609b0b Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 4 Oct 2002 12:57:06 +0000 Subject: working on the road: - easier "change package" link for changing one package to another - sqlradius export now compatible with Pg - indices on phone numbers - install instructions specify Pg 7.1 (at least until ILIKE thing is changed) - searching on phone number fragments --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 3d19e4d35..3c48a746f 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -12,7 +12,7 @@ Before installing, you need:
    • rsync
    • A transactional database engine supported by Perl's DBI.
        -
      • PostgreSQL (v7 or higher) is recommended. +
      • PostgreSQL is recommended (v7.1.x or later, not 7.0.x).
      • MySQL versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. -- cgit v1.2.1 From f2b66016c409270f51b8b76c4c61e7886f363366 Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 13 Oct 2002 06:49:27 +0000 Subject: don't use ILIKE (7.1-ism) anymore --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 3c48a746f..100a3cc64 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -12,7 +12,7 @@ Before installing, you need:
      • rsync
      • A transactional database engine supported by Perl's DBI.
          -
        • PostgreSQL is recommended (v7.1.x or later, not 7.0.x). +
        • PostgreSQL is recommended (v7or later).
        • MySQL versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. -- cgit v1.2.1 From 2f1f5c47edd9df2af61d104b512b9a1be12c3ad1 Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 9 Dec 2002 10:54:24 +0000 Subject: doc --- httemplate/docs/install.html | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 100a3cc64..d22915176 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -114,7 +114,10 @@ $ su
      • Run make aspdocs -
      • Copy aspdocs/ to your web server's document space. +
      • Copy aspdocs/ to your web server's document space: +
        +cp aspdocs /usr/local/apache/htdocs/freeside-asp
        +
      • Create a Global directory, such as /usr/local/etc/freeside/asp-global/:
         mkdir /usr/local/etc/freeside/asp-global/
        -- 
        cgit v1.2.1
        
        
        From 8f6bfc01809119b3c7e90b1418650ea4a329cf49 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Tue, 17 Dec 2002 06:36:40 +0000
        Subject: add PerlModule commands to install instructions
        
        ---
         httemplate/docs/install.html | 2 ++
         1 file changed, 2 insertions(+)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index d22915176..36b8ae0e7 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -129,6 +129,7 @@ cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
         
      • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example:
        +PerlModule Apache::ASP
         <Directory /usr/local/apache/htdocs/freeside-asp>
         <Files ~ (\.cgi)>
         AddHandler perl-script .cgi
        @@ -150,6 +151,7 @@ PerlSetVar Debug 2
               
      • Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/mason-data
      • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example:
        +PerlModule HTML::Mason
         <Directory /usr/local/apache/htdocs/freeside-mason>
         <Files ~ (\.cgi)>
         AddHandler perl-script .cgi
        -- 
        cgit v1.2.1
        
        
        From 66729728e57c13e44eaac51dc8deaf37e47b7530 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Tue, 4 Feb 2003 22:04:31 +0000
        Subject: 1.5-specific fixes
        
        ---
         httemplate/docs/install.html | 1 +
         1 file changed, 1 insertion(+)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index 36b8ae0e7..51dce4da5 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -54,6 +54,7 @@ Before installing, you need:
               
      • Storable
      • NetAddr-IP +
      • Chart
      • Apache::DBI (optional but recommended for better webinterface performance)
      -- cgit v1.2.1 From 60527016538d1794227983d99ce3b77c8fcd7426 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 22 Apr 2003 04:39:40 +0000 Subject: - mysql 4.1 is available; update documentation - remove last vestiges of 1.3-style qmail/vpopmail exports from svc_domain and svc_forward; add appropriate exports (closes: Bug#299) --- httemplate/docs/install.html | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 51dce4da5..ed419a1ca 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -13,9 +13,9 @@ Before installing, you need:
    • A transactional database engine supported by Perl's DBI.
      • PostgreSQL is recommended (v7or later). -
      • MySQL versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. - +
      • MySQL MINIMUM VERSION 4.1 is untested but may work. Versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. + + MySQL's default MyISAM and ISAM table types are not supported. If you want to use MySQL, you must use one of the new transaction-safe table types such as BDB or InnoDB, and set it as the default table type using the --default-table-type=BDB or --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=BDB or default-table-type=InnoDB in the my.cnf option file.
    • Perl modules (CPAN will query, download and build perl modules automatically)
    • Edit the top-level Makefile:
        -
      • Set DATASOURCE to your DBI data source, for example, DBI:Pg:dbname=freeside for PostgresSQL. See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source. +
      • Set DATASOURCE to your DBI data source, for example, DBI:Pg:dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source.
      • Set DB_PASSWORD to the freeside database user's password.
    • Add the freeside database to your database engine: @@ -93,10 +92,9 @@ $ su
       $ su freeside
       $ createdb freeside
      -
    • Build and install the Perl modules:
       $ make perl-modules
      -- 
      cgit v1.2.1
      
      
      From 344596452274c17c2c60bf2b002c9358cbd510a3 Mon Sep 17 00:00:00 2001
      From: ivan 
      Date: Wed, 23 Apr 2003 23:12:57 +0000
      Subject: compatible with mason 1.1!  closes: bug#492
      
      ---
       httemplate/docs/install.html | 9 ++++-----
       1 file changed, 4 insertions(+), 5 deletions(-)
      
      (limited to 'httemplate/docs/install.html')
      
      diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
      index ed419a1ca..533decb7b 100644
      --- a/httemplate/docs/install.html
      +++ b/httemplate/docs/install.html
      @@ -47,7 +47,7 @@ Before installing, you need:
             
    • Net-SSH
    • String-ShellQuote
    • Net-SCP -
    • Apache::ASP or HTML::Mason (use version 1.0x - Freeside is not yet compatible with version 1.1x) +
    • Apache::ASP or HTML::Mason
    • Tie-IxHash
    • Time-Duration
    • HTML-Widgets-SelectLayers @@ -143,11 +143,10 @@ PerlSetVar Debug 2
      • -
      • (use version 1.0x - Freeside is not yet compatible with version 1.1x)
      • Run make masondocs
      • Copy masondocs/ to your web server's document space. -
      • Copy htetc/handler.pl to your web server's configuration directory. -
      • Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/mason-data +
      • Copy htetc/handler.pl to an appropriate directory (use htetc/handler.pl-1.0x for Mason versions before 1.10). +
      • Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/masondata
      • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example:
         PerlModule HTML::Mason
        @@ -157,7 +156,7 @@ AddHandler perl-script .cgi
         PerlHandler HTML::Mason
         </Files>
         <Perl>
        -require "/usr/local/apache/conf/handler.pl";
        +require "/usr/local/etc/freeside/handler.pl";
         </Perl>
         </Directory>
         
        -- cgit v1.2.1 From 9bdd5507fab070864ecc3ebacd1f8c7f8a0b9b3c Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 9 Jun 2003 00:59:21 +0000 Subject: documentation update from "Jesse D. Guardiani" , thanks --- httemplate/docs/install.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 533decb7b..54614ccb3 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -144,9 +144,14 @@ PerlSetVar Debug 2
      • Run make masondocs -
      • Copy masondocs/ to your web server's document space. -
      • Copy htetc/handler.pl to an appropriate directory (use htetc/handler.pl-1.0x for Mason versions before 1.10). -
      • Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/masondata +
      • Copy masondocs/ to your web server's document space. (For example: /usr/local/apache/htdocs/freeside-mason) +
      • Copy htetc/handler.pl to /usr/local/etc/freeside (use htetc/handler.pl-1.0x for Mason versions before 1.10). +
      • Edit handler.pl and: +
          +
        • set an appropriate comp_root, such as /usr/local/apache/htdocs/freeside-mason +
        • set an appropriate data_dir, such as /usr/local/etc/freeside/masondata +
        +
      • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example:
         PerlModule HTML::Mason
        -- 
        cgit v1.2.1
        
        
        From abf5c5442afce5198f6289840791c96f58254e85 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Thu, 7 Aug 2003 12:47:27 +0000
        Subject: - switch to mason by default - minimum mason version 1.1 (and doc) -
         evaluate .html files with mason/asp - turn on profiling with mason like with
         Apache::ASP (redirects not working) - (start of) includes
        
        ---
         httemplate/docs/install.html | 10 +++++-----
         1 file changed, 5 insertions(+), 5 deletions(-)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index 54614ccb3..463575c53 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -130,8 +130,8 @@ cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
         
         PerlModule Apache::ASP
         <Directory /usr/local/apache/htdocs/freeside-asp>
        -<Files ~ (\.cgi)>
        -AddHandler perl-script .cgi
        +<Files ~ (\.cgi|\.html)>
        +SetHandler perl-script
         PerlHandler Apache::ASP
         </Files>
         <Perl>
        @@ -145,7 +145,7 @@ PerlSetVar Debug 2
             
      • Run make masondocs
      • Copy masondocs/ to your web server's document space. (For example: /usr/local/apache/htdocs/freeside-mason) -
      • Copy htetc/handler.pl to /usr/local/etc/freeside (use htetc/handler.pl-1.0x for Mason versions before 1.10). +
      • Copy htetc/handler.pl to /usr/local/etc/freeside
      • Edit handler.pl and:
        • set an appropriate comp_root, such as /usr/local/apache/htdocs/freeside-mason @@ -156,8 +156,8 @@ PerlSetVar Debug 2
           PerlModule HTML::Mason
           <Directory /usr/local/apache/htdocs/freeside-mason>
          -<Files ~ (\.cgi)>
          -AddHandler perl-script .cgi
          +<Files ~ (\.cgi|.html)>
          +SetHandler perl-script
           PerlHandler HTML::Mason
           </Files>
           <Perl>
          -- 
          cgit v1.2.1
          
          
          From 04980f381a8de1e935193102b0e924bf7a3f944d Mon Sep 17 00:00:00 2001
          From: ivan 
          Date: Thu, 9 Oct 2003 11:05:21 +0000
          Subject: don't install on a public server!
          
          ---
           httemplate/docs/install.html | 1 +
           1 file changed, 1 insertion(+)
          
          (limited to 'httemplate/docs/install.html')
          
          diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
          index 463575c53..4d3a63958 100644
          --- a/httemplate/docs/install.html
          +++ b/httemplate/docs/install.html
          @@ -3,6 +3,7 @@
           
           
           

          Installation

          +Note: Install Freeside on a firewalled, private server, not a public (web, RADIUS, etc.) server.

          Before installing, you need:
          • Perl Don't enable experimental features like threads or the PerlIO abstraction layer. -- cgit v1.2.1 From 23e2dbc925c01f035984b3a7f3dccfa5ff7c4ccf Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 19 Oct 2003 18:08:36 +0000 Subject: fix CPAN link --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 4d3a63958..1355a113c 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -18,7 +18,7 @@ Before installing, you need: MySQL's default MyISAM and ISAM table types are not supported. If you want to use MySQL, you must use one of the new transaction-safe table types such as BDB or InnoDB, and set it as the default table type using the --default-table-type=BDB or --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=BDB or default-table-type=InnoDB in the my.cnf option file.
          -
        • Perl modules (CPAN will query, download and build perl modules automatically) +
        • Perl modules (CPAN will query, download and build perl modules automatically)
            -- cgit v1.2.1 From f628692253d949e00918e0d4ebc0fab89b657055 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 18 Nov 2003 11:17:12 +0000 Subject: remove thread/PerlIO warning - standard in 5.8.x and working fine --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 1355a113c..266708b1e 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -6,7 +6,7 @@ Note: Install Freeside on a firewalled, private server, not a public (web, RADIUS, etc.) server.

            Before installing, you need:
              -
            • Perl Don't enable experimental features like threads or the PerlIO abstraction layer. +
            • Perl
            • Apache (mod_ssl or Apache-SSL highly recommended)
            • mod_perl (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
            • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.) -- cgit v1.2.1 From e386fc15be6edadc7068dcb3e48fc81e37b3774b Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 25 Feb 2004 03:50:08 +0000 Subject: formatting --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 266708b1e..c223394e9 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -139,7 +139,7 @@ PerlHandler Apache::ASP $MLDBM::RemoveTaint = 1; </Perl> PerlSetVar Global /usr/local/etc/freeside/asp-global/ -PerlSetVar Debug 2 +PerlSetVar Debug 2 </Directory>
        -
      • Restrict access to this web interface - see the Apache documentation on user authentication. For example, to configure user authentication with mod_auth (flat files): +
      • Restrict access to this web interface - see the Apache documentation on user authentication. For example, to configure user authentication with mod_auth (flat files), add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
         <Directory /usr/local/apache/htdocs/freeside-asp>
         AuthName Freeside
        -- 
        cgit v1.2.1
        
        
        From 5d154e4e153a66c2349ee0c6ca942fa017bfb139 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Fri, 18 Jun 2004 10:07:57 +0000
        Subject: recommend HTML::Mason
        
        ---
         httemplate/docs/install.html | 2 +-
         1 file changed, 1 insertion(+), 1 deletion(-)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index df353eb9d..d4507a2a5 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -48,7 +48,7 @@ Before installing, you need:
               
      • Net-SSH
      • String-ShellQuote
      • Net-SCP -
      • Apache::ASP or HTML::Mason +
      • HTML::Mason (recommended, enables full functionality) or Apache::ASP (deprecated, integrated RT ticketing will not be available)
      • Tie-IxHash
      • Time-Duration
      • HTML-Widgets-SelectLayers -- cgit v1.2.1 From a496b337f8a6946cd100e4daea9f2692536ea9ce Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 7 Nov 2004 22:58:21 +0000 Subject: update install documentation for 1.5 HTML::Mason or Apache::ASP install --- httemplate/docs/install.html | 45 +++++++++++++------------------------------- 1 file changed, 13 insertions(+), 32 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index d4507a2a5..c95b41f5d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -107,32 +107,20 @@ $ su # make create-config
      • Run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user. +
      • Edit the Makefile and set TEMPLATE to asp or mason. Also set FREESIDE_DOCUMENT_ROOT. +
      • Run make install-docs.
      - -
      Apache::ASPMason
        -
      • Run make aspdocs -
      • Copy aspdocs/ to your web server's document space: -
        -cp aspdocs /usr/local/apache/htdocs/freeside-asp
        -
        -
      • Create a Global directory, such as /usr/local/etc/freeside/asp-global/: -
        -mkdir /usr/local/etc/freeside/asp-global/
        -chown freeside /usr/local/etc/freeside/asp-global/
        -
        -
      • Copy htetc/global.asa to the Global directory: -
        -cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
        -
        -
      • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths: +
        +
      • Configure Apache:
         PerlModule Apache::ASP
         # your freeside document root
        -<Directory /usr/local/apache/htdocs/freeside-asp>
        +<Directory /var/www/freeside>
         <Files ~ (\.cgi|\.html)>
         AddHandler perl-script .cgi .html
         PerlHandler Apache::ASP
        @@ -144,24 +132,16 @@ PerlSetVar Global /usr/local/etc/freeside/asp-global/
         PerlSetVar Debug 2
         PerlSetVar RequestBinaryRead Off
         # your freeside document root
        -PerlSetVar IncludesDir /usr/local/apache/htdocs/freeside-asp
        +PerlSetVar IncludesDir /var/www/freeside
         </Directory>
         
        -
      • Run make masondocs -
      • Copy masondocs/ to your web server's document space. (For example: /usr/local/apache/htdocs/freeside-mason) -
      • Copy htetc/handler.pl to /usr/local/etc/freeside -
      • Edit handler.pl and: -
          -
        • set an appropriate comp_root, such as /usr/local/apache/htdocs/freeside-mason -
        • set an appropriate data_dir, such as /usr/local/etc/freeside/masondata -
        - -
      • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths: +
        +
      • Configure Apache:
         PerlModule HTML::Mason
        -<Directory /usr/local/apache/htdocs/freeside-mason>
        +# your freeside docuemnt root
        +<Directory /var/www/freeside>
         <Files ~ (\.cgi|\.html)>
         AddHandler perl-script .cgi .html
         PerlHandler HTML::Mason
        @@ -177,7 +157,8 @@ require "/usr/local/etc/freeside/handler.pl";
         
        • Restrict access to this web interface - see the Apache documentation on user authentication. For example, to configure user authentication with mod_auth (flat files), add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
          -<Directory /usr/local/apache/htdocs/freeside-asp>
          +#your freeside document root
          +<Directory /var/www/freeside>
           AuthName Freeside
           AuthType Basic
           AuthUserFile /usr/local/etc/freeside/htpasswd
          @@ -193,7 +174,7 @@ $ freeside-adduser -c -h /usr/local/
           
          $ su
           $ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
        - (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username + (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username)
      • As the freeside UNIX user, run freeside-setup username to create the database tables, passing the username of a Freeside user you created above:
         $ su freeside
        -- 
        cgit v1.2.1
        
        
        From 46fb556fc165207a8a63c20a87f03a530279fdc0 Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Sat, 11 Dec 2004 22:50:34 +0000
        Subject: update install doc
        
        ---
         httemplate/docs/install.html | 23 +++++++++++------------
         1 file changed, 11 insertions(+), 12 deletions(-)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index c95b41f5d..016184950 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -6,7 +6,7 @@
         Note: Install Freeside on a firewalled, private server, not a public (web, RADIUS, etc.) server.

        Before installing, you need:
          -
        • Perl +
        • Perl, minimum version 5.005_03. (5.8.3 for the integrated RT ticketing)
        • Apache (mod_ssl or Apache-SSL highly recommended)
        • mod_perl (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
        • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.) @@ -14,9 +14,9 @@ Before installing, you need:
        • A transactional database engine supported by Perl's DBI.
          • PostgreSQL is recommended (v7or later). -
          • MySQL MINIMUM VERSION 4.1 is untested but may work. Versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. +
          • MySQL MINIMUM VERSION 4.1 is untested but may work. Versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. - MySQL's default MyISAM and ISAM table types are not supported. If you want to use MySQL, you must use one of the new transaction-safe table types such as BDB or InnoDB, and set it as the default table type using the --default-table-type=BDB or --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=BDB or default-table-type=InnoDB in the my.cnf option file. + MySQL's default MyISAM and ISAM table types are not supported. You must use one of the new transaction-safe table types such as InnoDB. Set it as the default table type using the --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=InnoDB in the my.cnf option file.
        • Perl modules (CPAN will query, download and build perl modules automatically)
        • Add the freeside database to your database engine: -
          -$ su
          -# make create-database
          - (or manually, with Postgres:) -
          +    
            +
          • with Postgres: +
             $ su freeside
            -$ createdb freeside
            - (with MySQL:) -
            +$ createdb -E sql_ascii freeside
            +
          • with MySQL: +
             $ mysqladmin -u freeside -p create freeside 
            +
        • Build and install the Perl modules:
           $ make perl-modules
          -- 
          cgit v1.2.1
          
          
          From 3485c34d9374892c3e4d6a56c7dd5f47f480f024 Mon Sep 17 00:00:00 2001
          From: ivan 
          Date: Sat, 18 Dec 2004 23:32:00 +0000
          Subject: add info about teTeX and Ghostscript
          
          ---
           httemplate/docs/install.html | 1 +
           1 file changed, 1 insertion(+)
          
          (limited to 'httemplate/docs/install.html')
          
          diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
          index 016184950..86e2a6b8c 100644
          --- a/httemplate/docs/install.html
          +++ b/httemplate/docs/install.html
          @@ -11,6 +11,7 @@ Before installing, you need:
             
        • mod_perl (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
        • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
        • rsync +
        • Optional, enables typeset invoices: teTeX and Ghostscript (included with most distributions).
        • A transactional database engine supported by Perl's DBI.
          • PostgreSQL is recommended (v7or later). -- cgit v1.2.1 From 6cf964d0dc008621fb30fd2da28e2c44f29c6364 Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 27 Jan 2005 10:21:18 +0000 Subject: DHTML progress bar for glacial rate adding and editing, closes: Bug#1100 --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 86e2a6b8c..898eb9ef8 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -58,6 +58,7 @@ Before installing, you need:
          • NetAddr-IP
          • Chart
          • Crypt::PasswdMD5 +
          • JavaScript::RPC (JavaScript::RPC::Server::CGI)
          • Apache::DBI (optional but recommended for better webinterface performance)
        -- cgit v1.2.1 From 55a68e4aabe10db4d9c3ab1bb8befd2f9f4b9008 Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 29 Jan 2005 12:34:12 +0000 Subject: registration codes --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 898eb9ef8..a880d9104 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -59,6 +59,7 @@ Before installing, you need:
      • Chart
      • Crypt::PasswdMD5
      • JavaScript::RPC (JavaScript::RPC::Server::CGI) +
      • Apache::DBI (optional but recommended for better webinterface performance)
      -- cgit v1.2.1 From fc9e97f6cab72de473288470c0681534caf25ea5 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 8 Feb 2005 20:22:46 +0000 Subject: make self-service session cache module configurable, start framework for in-database session cache --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index a880d9104..51c700bf8 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -54,7 +54,7 @@ Before installing, you need:
    • Time-Duration
    • HTML-Widgets-SelectLayers
    • Storable - +
    • Cache::Cache
    • NetAddr-IP
    • Chart
    • Crypt::PasswdMD5 -- cgit v1.2.1 From 41a036e2d95b39e28eecc624203024e27b3f539b Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 23 Feb 2005 06:43:30 +0000 Subject: update docs wrt mysql support --- httemplate/docs/install.html | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 51c700bf8..e77714729 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -14,10 +14,12 @@ Before installing, you need:
    • Optional, enables typeset invoices: teTeX and Ghostscript (included with most distributions).
    • A transactional database engine supported by Perl's DBI.
        -
      • PostgreSQL is recommended (v7or later). -
      • MySQL MINIMUM VERSION 4.1 is untested but may work. Versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. - - MySQL's default MyISAM and ISAM table types are not supported. You must use one of the new transaction-safe table types such as InnoDB. Set it as the default table type using the --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=InnoDB in the my.cnf option file. +
      • PostgreSQL is recommended (v7.2 or later). +
      • MySQL is not currently supported. Developers intersted in maintaining the MySQL port are welcome to ask on the -devel mailing list. +
    • Perl modules (CPAN will query, download and build perl modules automatically)
        -- cgit v1.2.1 From d9649d434ba0955cd079d70e885b9f33f5ad85b5 Mon Sep 17 00:00:00 2001 From: khoff Date: Wed, 2 Mar 2005 21:00:59 +0000 Subject: Initial version of the xmlrpc interface for freeside. --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index e77714729..1632fb38d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -61,6 +61,7 @@ Before installing, you need:
      • Chart
      • Crypt::PasswdMD5
      • JavaScript::RPC (JavaScript::RPC::Server::CGI) +
      • Frontier::RPC
      • Apache::DBI (optional but recommended for better webinterface performance)
      -- cgit v1.2.1 From 34647c32b50ce3b8ee1b6d3d7aef4ba9d0297bdb Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 6 Mar 2005 03:04:29 +0000 Subject: add Excel and CSV download of templated reports and clean up their HTML formatting, closes; Bug#520, Bug#1107 --- httemplate/docs/install.html | 2 ++ 1 file changed, 2 insertions(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 1632fb38d..4a89ab3ba 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -62,6 +62,8 @@ Before installing, you need:
    • Crypt::PasswdMD5
    • JavaScript::RPC (JavaScript::RPC::Server::CGI)
    • Frontier::RPC +
    • Text::CSV_XS +
    • Spreadsheet::WriteExcel
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 24cf1de1156932c50a8d0d7bcab5f1fd163a35c0 Mon Sep 17 00:00:00 2001 From: ivan Date: Wed, 9 Mar 2005 08:18:57 +0000 Subject: preliminary RT docs --- httemplate/docs/install.html | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 4a89ab3ba..b7802b90f 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -119,46 +119,49 @@ $ su - + + + +
      Apache::ASPMasonMason (recommended)Apache::ASP (deprecated)
      • Configure Apache:
        -PerlModule Apache::ASP
        -# your freeside document root
        +PerlModule HTML::Mason
        +# your freeside docuemnt root
         <Directory /var/www/freeside>
         <Files ~ (\.cgi|\.html)>
         AddHandler perl-script .cgi .html
        -PerlHandler Apache::ASP
        +PerlHandler HTML::Mason
         </Files>
         <Perl>
        -$MLDBM::RemoveTaint = 1;
        +require "/usr/local/etc/freeside/handler.pl";
         </Perl>
        -PerlSetVar Global /usr/local/etc/freeside/asp-global/
        -PerlSetVar Debug 2
        -PerlSetVar RequestBinaryRead Off
        -# your freeside document root
        -PerlSetVar IncludesDir /var/www/freeside
         </Directory>
         
      • Configure Apache:
        -PerlModule HTML::Mason
        -# your freeside docuemnt root
        +PerlModule Apache::ASP
        +# your freeside document root
         <Directory /var/www/freeside>
         <Files ~ (\.cgi|\.html)>
         AddHandler perl-script .cgi .html
        -PerlHandler HTML::Mason
        +PerlHandler Apache::ASP
         </Files>
         <Perl>
        -require "/usr/local/etc/freeside/handler.pl";
        +$MLDBM::RemoveTaint = 1;
         </Perl>
        +PerlSetVar Global /usr/local/etc/freeside/asp-global/
        +PerlSetVar Debug 2
        +PerlSetVar RequestBinaryRead Off
        +# your freeside document root
        +PerlSetVar IncludesDir /var/www/freeside
         </Directory>
         
      Install the Freeside distribution: -- cgit v1.2.1 From 494d3290ee8d145acb6f009e2f53f4ed4de7a0ea Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 10 Mar 2005 15:18:20 +0000 Subject: add Frontier::RPC to docs too --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 52d992dbc..9c7b6d205 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -65,6 +65,7 @@ Before installing, you need:
    • Text::CSV_XS
    • Spreadsheet::WriteExcel
    • IO-stringy (IO::Scalar) +
    • Frontier::RPC
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 1dd109e19aec5adc6da8e744b665247a91038c9a Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 10 Mar 2005 15:33:31 +0000 Subject: arg --- httemplate/docs/install.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 9c7b6d205..f55ce6452 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -65,7 +65,7 @@ Before installing, you need:
    • Text::CSV_XS
    • Spreadsheet::WriteExcel
    • IO-stringy (IO::Scalar) -
    • Frontier::RPC +
    • Frontier::RPC (Frontier::RPC2)
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 821c540a2d41f633b1a4e1cd8bda82b8b2ff60de Mon Sep 17 00:00:00 2001 From: khoff Date: Thu, 17 Mar 2005 21:41:36 +0000 Subject: Added options invoice_email_pdf and invoice_email_pdf_note. invoice_email_pdf - Attach PDF invoice to emailed plain text invoices. invoice_email_pdf_note - Replace plain text invoice with this note, when attaching a PDF. --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index f55ce6452..eaebcde2b 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -66,6 +66,7 @@ Before installing, you need:
    • Spreadsheet::WriteExcel
    • IO-stringy (IO::Scalar)
    • Frontier::RPC (Frontier::RPC2) +
    • MIME::Entity (MIME-tools)
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 18c025613fa052cf4ba8d484f1296cc2a1719a24 Mon Sep 17 00:00:00 2001 From: khoff Date: Mon, 21 Mar 2005 22:13:39 +0000 Subject: Added support for FAX invoice destinations using a HylaFAX server. Faxing plain text invoices is not supported. --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index eaebcde2b..10c51e77d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -68,6 +68,7 @@ Before installing, you need:
    • Frontier::RPC (Frontier::RPC2)
    • MIME::Entity (MIME-tools) +
    • Fax::Hylafax::Client (Required if using FAX invoice destinations
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 59dffd575f6871ae0cf42589bff1e88458a2e475 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 19 Apr 2005 09:48:39 +0000 Subject: did another upgrade, fixed up the instructions --- httemplate/docs/install.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 10c51e77d..d742ddb11 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -60,13 +60,14 @@ Before installing, you need:
    • NetAddr-IP
    • Chart
    • Crypt::PasswdMD5 +
    • Locale::SubCountry
    • JavaScript::RPC (JavaScript::RPC::Server::CGI)
    • Frontier::RPC
    • Text::CSV_XS
    • Spreadsheet::WriteExcel
    • IO-stringy (IO::Scalar)
    • Frontier::RPC (Frontier::RPC2) -
    • MIME::Entity (MIME-tools) +
    • MIME::Entity (MIME-tools)
    • Fax::Hylafax::Client (Required if using FAX invoice destinations
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 98b27a8125febbd5c6710f26dbd7ebe8dd459d52 Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 4 Aug 2005 08:39:19 +0000 Subject: add IPC::Run3 and instructions for adding fs_queue and fs_selfservice users to install docs --- httemplate/docs/install.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index d742ddb11..72b1214ec 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -14,7 +14,7 @@ Before installing, you need:
    • Optional, enables typeset invoices: teTeX and Ghostscript (included with most distributions).
    • A transactional database engine supported by Perl's DBI.
        -
      • PostgreSQL is recommended (v7.2 or later). +
      • PostgreSQL is recommended (v7.2 or later, 7.4 or later recommended).
      • MySQL is not currently supported. Developers intersted in maintaining MySQL support are welcome to ask on the -devel mailing list; many things work, but MySQL support needs a maintainer to update it for recent (and future) changes.
      • Fax::Hylafax::Client (Required if using FAX invoice destinations
      • Apache::DBI (optional but recommended for better webinterface performance) @@ -184,12 +185,16 @@ require valid-user (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username) +
      • Create the Freeside system users: +
        $ su
        +% freeside-adduser fs_queue
        +% freeside-adduser fs_selfservice
      • As the freeside UNIX user, run freeside-setup username to create the database tables, passing the username of a Freeside user you created above:
         $ su freeside
        -- 
        cgit v1.2.1
        
        
        From 76161f1a2ae0f96470bed4089b00eff5abb16cff Mon Sep 17 00:00:00 2001
        From: ivan 
        Date: Sun, 25 Sep 2005 08:13:36 +0000
        Subject: get rid of JSRS iframe foo for progress bar, use XMLHTTPRequest
         instead.  really should have done that in the first place.  JSON will wait
         until another day...
        
        ---
         httemplate/docs/install.html | 1 -
         1 file changed, 1 deletion(-)
        
        (limited to 'httemplate/docs/install.html')
        
        diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
        index 72b1214ec..d89ea3f04 100644
        --- a/httemplate/docs/install.html
        +++ b/httemplate/docs/install.html
        @@ -61,7 +61,6 @@ Before installing, you need:
               
      • Chart
      • Crypt::PasswdMD5
      • Locale::SubCountry -
      • JavaScript::RPC (JavaScript::RPC::Server::CGI)
      • Frontier::RPC
      • Text::CSV_XS
      • Spreadsheet::WriteExcel -- cgit v1.2.1 From 90cdac3ff61ad57b42d2fc4743ad53f7c537e6fe Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 2 Oct 2005 14:04:05 +0000 Subject: fix leading % causing Mason to barf --- httemplate/docs/install.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index d89ea3f04..39d3abb2d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -184,16 +184,16 @@ require valid-user
      • Additional users:
        $ su
        -% freeside-adduser -h /usr/local/etc/freeside/htpasswd username
        +# freeside-adduser -h /usr/local/etc/freeside/htpasswd username
      (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username)
    • Create the Freeside system users:
      $ su
      -% freeside-adduser fs_queue
      -% freeside-adduser fs_selfservice
      +# freeside-adduser fs_queue +# freeside-adduser fs_selfservice
    • As the freeside UNIX user, run freeside-setup username to create the database tables, passing the username of a Freeside user you created above:
       $ su freeside
      -- 
      cgit v1.2.1
      
      
      From 33dd0516644a865c0d664bd0eeb956ba318d7650 Mon Sep 17 00:00:00 2001
      From: ivan 
      Date: Wed, 9 Nov 2005 20:48:44 +0000
      Subject: closing paren
      
      ---
       httemplate/docs/install.html | 2 +-
       1 file changed, 1 insertion(+), 1 deletion(-)
      
      (limited to 'httemplate/docs/install.html')
      
      diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
      index 39d3abb2d..3d7dc8488 100644
      --- a/httemplate/docs/install.html
      +++ b/httemplate/docs/install.html
      @@ -69,7 +69,7 @@ Before installing, you need:
             
    • MIME::Entity (MIME-tools)
    • IPC::Run3 -
    • Fax::Hylafax::Client (Required if using FAX invoice destinations +
    • Fax::Hylafax::Client (Required if using FAX invoice destinations)
    • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1 From 1263bd3776e1481ef8d166286abbce17de75f5f5 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 22 Nov 2005 09:13:58 +0000 Subject: correct common misconception RIGHT THERE in the docs --- httemplate/docs/install.html | 1 + 1 file changed, 1 insertion(+) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 3d7dc8488..0e3ed364b 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -21,6 +21,7 @@ Before installing, you need: MySQL's default MyISAM and ISAM table types are not supported. You must use one of the new transaction-safe table types such as InnoDB. Set it as the default table type using the --default-table-type=InnoDB mysqld command-line option or by setting default-table-type=InnoDB in the my.cnf option file. --> + Note: the above only applies to the database used by the Freeside software itself. Freeside can integrate with RADIUS and other servers running MySQL or any other DBI-supported database.
    • Perl modules (CPAN will query, download and build perl modules automatically)
      • Fax::Hylafax::Client (Required if using FAX invoice destinations)
      • Apache::DBI (optional but recommended for better webinterface performance) -- cgit v1.2.1