From a2b0b3e8500b08a5cf017c85693d9649853f8569 Mon Sep 17 00:00:00 2001 From: ivan Date: Thu, 16 Feb 2006 21:43:02 +0000 Subject: automate more of the initial data adding... --- httemplate/docs/install.html | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 1f80db1..0257275 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -196,17 +196,10 @@ require valid-user 
$ 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: +
  • As the freeside UNIX user, run freeside-setup -d domain.name username to create the database tables and initial data, passing the username of a Freeside user you created above: 
     $ su freeside
-$ 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
-$ cd /path/to/freeside/
-$ bin/populate-msgcat username
+$ freeside-setup -d example.com 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)
  • Now proceed to the initial administration of your installation. -- cgit v1.1 From 6d27649c93f3f83c14611c790281a7b667062fc0 Mon Sep 17 00:00:00 2001 From: ivan Date: Sat, 18 Feb 2006 04:32:57 +0000 Subject: Mason it is --- httemplate/docs/install.html | 39 ++------------------------------------- 1 file changed, 2 insertions(+), 37 deletions(-) (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 0257275..6e366cb 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -52,7 +52,7 @@ Before installing, you need:
  • Net-SSH
  • String-ShellQuote
  • Net-SCP -
  • HTML::Mason (recommended, enables full functionality) or Apache::ASP (deprecated, integrated RT ticketing will not be available) +
  • HTML::Mason
  • Tie-IxHash
  • Time-Duration
  • HTML-Widgets-SelectLayers @@ -123,15 +123,7 @@ $ su
  • 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. - - - - - - - - - - - - -
    Mason (recommended)Apache::ASP (deprecated)
      -
    • Configure Apache: +
    • Configure Apache: 
       PerlModule HTML::Mason
 # your freeside docuemnt root
@@ -145,33 +137,6 @@ require "/usr/local/etc/freeside/handler.pl";
 </Perl>
 </Directory>
      -
      -
    • Configure Apache: -
      -PerlModule Apache::ASP
-# your freeside document root
-<Directory /var/www/freeside>
-<Files ~ (\.cgi|\.html)>
-AddHandler perl-script .cgi .html
-PerlHandler Apache::ASP
-</Files>
-<Perl>
-$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>
-
       -
    - -- cgit v1.1 From 0a632c6bfa376fbcfdf311122669991565877d2b Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 21 Aug 2006 09:47:49 +0000 Subject: we're off to see the wiki, the wonderful wiki of oz --- httemplate/docs/install.html | 173 ------------------------------------------- 1 file changed, 173 deletions(-) delete mode 100644 httemplate/docs/install.html (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html deleted file mode 100644 index 78172e8..0000000 --- a/httemplate/docs/install.html +++ /dev/null @@ -1,173 +0,0 @@ - - Installation - - -

    Installation

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

    -Before installing, you need: - -Install the Freeside distribution: -
      -
    • Add the user and group `freeside' to your system. -
    • Allow the freeside user full access to the freeside database. -
        -
      • with PostgreSQL: - 
        -$ su postgres (pgsql on some distributions)
-$ 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'
-$ 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';
        -
      - -
    • Edit the top-level Makefile: -
        -
      • 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: -
        -
      • with Postgres: - 
        -$ su freeside
-$ createdb -E sql_ascii freeside
        -
      • with MySQL: - 
        -$ mysqladmin -u freeside -p create freeside
        -
      -
    • Build and install the Perl modules: - 
      -$ make perl-modules
-$ su
-# make install-perl-modules
      -
    • Create the necessary configuration files:
      -$ 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. -
    • Configure Apache: -
      -PerlModule HTML::Mason
-# your freeside docuemnt root
-<Directory /var/www/freeside>
-<Files ~ (\.cgi|\.html)>
-AddHandler perl-script .cgi .html
-PerlHandler HTML::Mason
-</Files>
-<Perl>
-require "/usr/local/etc/freeside/handler.pl";
-</Perl>
-</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), add something like the following to your Apache httpd.conf file, adjusting for your actual paths: -
      -#your freeside document root
-<Directory /var/www/freeside>
-AuthName Freeside
-AuthType Basic
-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, not UNIX user accounts. For example, using mod_auth (flat files): -
        -
      • First user: -
        $ su
-# freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
         -
      • Additional users: -
        $ 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) -
    • Create the Freeside system users: -
      $ su
-# freeside-adduser fs_queue
-# freeside-adduser fs_selfservice
      -
    • As the freeside UNIX user, run freeside-setup -d domain.name username to create the database tables and initial data, passing the username of a Freeside user you created above: -
      -$ su freeside
-$ freeside-setup -d example.com 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) -
    • Now proceed to the initial administration of your installation. -
    - -- cgit v1.1