Freeside:1.7:Documentation:Self-Service Installation

From Freeside
Revision as of 10:18, 27 February 2008 by Supaplex (talk | contribs) ({{ContextSensitiveHelp}})

Jump to: navigation, search
This page is part of the Freeside Context Sensitive Help. Please review the Editing Guidelines before making modifications to this page.

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

Verify it's really running as freeside. Delete or chmod -x this after you know it's freeside or your-www-group running your cgi.

$ echo '#!/bin/sh
echo -e "Content-Type: text/html\n"
id' > w.cgi ; chmod 755 w.cgi

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.
  • From the back end shell, ssh to the sign up server manually to populate the known hosts, and to verify the new key works.

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