next up previous contents
Next: Plugs for IMP Up: ByName Web Service Previous: ByName Functionality Specification   Contents

Subsections

External Hooks

OSMT - byNameNspJetspeed

Within this section, we'll explain in detail the process that are performed by the bynameJetspeedActions.sh. The bynameJetspeedActions.sh calling other external script to do the job.

There would be 2 kinds of actions: create a new a account and remove account.

Create a New Account

There are three ways to create a new byname account:

  1. From the web (my,byname.net)
  2. Batch entries (with bynameBatchBasics.sh)
  3. Byname Account Parameters (BAP) file

Creating new account for byname is traditionally done through the web. When the new subscriber fill out all the information and click the ``Create New Account'' button, the bynameJetspeedActions.sh with the -i enroll is executed.

ACCOUNT PROCESSING -- Create New Account
========================================
The outcome:
------------
   Step 1:
      - assign new subscriber's selector 
      - assign new subscriber's ID
      - create subscriber's home dir
   Step 2:
      - generate subscriber's profile in
        <subsHomeDir>/NSP/bynameSubscriberProfiles.nsp
      - create a bynumber symlink

External hooks:
---------------
   Both steps are performed by calling bynameNspSubscribers.sh 
   with -i addNewSubs.

   - assign new subscriber's selector
     First check to see if the subs is already in by calling
     bynameLib.sh's function: SubsIsAlreadyIn.
     If subs is exist then exit otherwise the selector is assigned.

   - assign new subscriber's ID
     The ``opUidAssignments.sh -s uid_subscriber -a checkForNextUserID''
     is called to get the next new subs id.

   - create subscriber's home dir
     Now that we got bot SubsSelector and new SubsId, we are ready to
     create a new subs acct by calling opAcctUsers.sh.

   - generate subscriber's profile
     There will be 2 new files in <subsHomeDir>/NSP dir:
     bynameSubscriberProfiles.nsp and saUID.nsp.

   - create a bynumber symlink

FEATURE SAVE
============

After done with ACCOUNT PROCESSING, all the extra byname features
will be generated.  At this time, there is only one feature available:
LEAP features.

The creation of LEAP feature was done by calling bynameNspLEAPFeatures.sh
with -a generateNewNetL3ItemsFile.

Mail out 1
==========

The mail out 1 is the mail verification sent out to the future
subscriber.  They need to reply to this email in order for us
to activate the account.  This mail verification is sent out
only if it's done through a normal procedure (through the web).
In this case the parameter genMode is empty.

If the genMode is specified and the value is ``batch''
then mail verification is not necessary.

FEATURE ACTIVATE
================
After the new subs verify the account, all the features are activated.
This include creating the subs public web domain and all the mail creation.

The public web domain is created by bynameNspWebServers.sh with
-a createSubsWebDomain.  This process is run with remote shell
through ssh to the public web server.

The mail creation is created with bynameNspMail.sh with -i acctAdd

Mail Out 2
==========
Mail Confirmation is sent out to new subscriber which include
all the information of his/her new byname account.

Delete an Existing Account

Deleting an account is done through steps: delete subscriber's public web domain, delete all byname emails, and deleteing his/her home dir and the username form /etc/passwd.