Freeside:1.7:Documentation:Self-Service Installation

From Freeside
Revision as of 14:50, 19 July 2009 by ReldrOncal (talk | contribs)

Jump to: navigation, search

page enya caribbean blue video pseudoephedrine and adderall drug interaction elite torrents answers spongebob squarepants movie trailer domain assisted living movie trailer movie princess twilight zelda movie monologues.com slow motion videos bitch island us airway airline http j los clothing fit tv archive video files right move coventry charlotte rouse clothing site free avatar askjolene.com gt scooter parts inspiration christian cruises russian torrent search sex machine movie domain new homes st augustine florida olney indoor swim center anna belle videos clips of teen sex bomis rings shaman king download video asap crack chase card domain ontario video production microsoft visual studio torrents mpeg funny videos english movie song lyrics information about saturns rings activation key for corel wordperfect 11 naughty nurses movie theater providence massachusetts anime school girl hot jessica rabbit sex sitemap cyrano de bergerac music ringtones for sony pirate of the caribbean pic audio fl production video

Introduction

It is recommended to run the self-service interface on a public web server, not the backend Freeside server. The Freeside server will open an SSH connection to one or more web servers to process signups and self-service requests.

Backend setup

Go to Configuration -> Settings and click on Edit Configuration

Find and setup the following:

  • Set the signup_server-default_agentnum configuration value to a default agent number (i.e. 1).
  • Set the signup_server-default_refnum configuration value to a default advertising source (i.e. 1).
  • Set the signup_server-payby configuration value to the acceptable payment types for signups.
  • Set the signup_server-realtime configuration value to run billing for signups immediately.

Prerequisites

API access (Perl, PHP, XML-RPC)

Signup and self-service pages

In addition to the above:

Installing FS::SelfService

  • Copy the fs_selfservice/FS-SelfService directory to the public web server
  • perl Makefile.PL
  • make install
  • mkdir /usr/local/freeside; chown freeside /usr/local/freeside
  • touch /usr/local/freeside/selfservice_socket; chown freeside /usr/local/freeside/selfservice_socket
  • chmod 600 /usr/local/freeside/selfservice_socket

OR

  • chown freeside:your-www-group /usr/local/freeside/selfservice_socket; chmod 660 /usr/local/freeside/selfservice_socket

Installing web interface

  • Copy the fs_selfservice/FS-SelfService/cgi/ directory into the web server's document space.
  • Enable CGI execution for files with the `.cgi' extenstion. With Apache, for example:
 #directory where selfservice .cgi scripts and .html templates are located
 <Directory /var/www/selfservice>
 AddHandler cgi-script .cgi
 Options +ExecCGI
 </Directory>

OR

  • As per above, chown freeside:your-www-group /usr/local/freeside/selfservice_socket; chmod 660 /usr/local/freeside/selfservice_socket
  • Optionally, customize the .html templates.
  • Useful "entry points" to link to are:
    • signup.cgi - Signup
    • selfservice.cgi - Customer self-service
    • agent.cgi - Reseller interface
    • passwd.cgi - Simple password-changin ginterface
    • promocode.html - Promotional code pre-signup
    • regcode.html - Registration code pre-signup
    • stateselect.html - State selection pre-signup

SSH setup

  • On your backend Freeside server, generate SSH keys for the "freeside" user with ssh-keygen. Either use a passphrase-less key, or arrange for ssh-agent to provide keys to freeside-selfservice-server
  • Add a "freeside" user to the public web server
  • Append the contents of /home/freeside/.ssh/id_rsa.pub (or id_dsa.pub) on your freeside machine to the /home/freeside/.ssh/authorized_keys file on the public web server.
  • As the freeside user, ensure you can SSH from your freeside machine to the public web server, without being prompted for a password.

Daemon setup

  • Run an instance of freeside-selfservice-server user machine on the Freeside machine for each external machine.
    • user is an employee username.
    • machine is the name or IP of the public web server.

Optional

  • You can install the files in the fs_selfservice/FS-SelfService/cgi/ directory multiple places in your web server's document space, and customize the .html templates differently for each. You can set the agentnum used for each signup by editing signup.html and including a hidden field with the agentnum: 
 <INPUT TYPE="hidden" NAME="agentnum" VALUE="3">
  • If you create a /usr/local/freeside/ieak.template file on the external machine, it will be sent to IE users with MIME type application/x-Internet-signup. This file will be processed with Text::Template with the variables listed below available. (an example file is included as fs_selfservice/FS-SelfService/ieak.template) See the section on internet settings files in the IEAK documentation for more information. Also see Internet Explorer Prompts to Download Files in the Microsoft Knowledge Base if you have difficulty with IE prompting to download the signup's .ins file instead of processing it.
  • Variable substitutions available in ieak.template and success.html:
    • $ac - area code of selected POP
    • $exch - exchange of selected POP
    • $loc - local part of selected POP
    • $username
    • $password
    • $email_name - first and last name
    • $pkg - package name
Retrieved from "http://freeside.biz/mediawiki/index.php?title=Freeside:1.7:Documentation:Self-Service_Installation&oldid=5021"