next up previous contents
Next: Subscribers Up: The ByName Service Components Previous: The ByName Service Components   Contents

Subsections

Introduction

ByName and ByNumber services provide a lot of features for the subscriber. Upon the creation of these services for each subscriber (after receiving the confirmation back from the new subscriber), the new e-mail accounts and subscriber's home directory will be created instantly. All the features that he/she selected will be activated on the background, such as web pages and LEAP.

All of these task are run by the bynameNsp script.

Figure 5.1 shows the byname layer. Each of these layers will be explained in detail.

Figure 5.1: ByName Layer
ByName Layer

Model and Terminology

NOTE: to make a more efficient way to create a new subscriber, the fullUpdate of bynameBatchBasic.sh is done in 2 different processes. The first process is the account creation (i.e. acctUpdate). This process have to be created immediately. The second process is the features activation (such as mailUpdate, webUpdtae, leapUpdate, etc.). The second process is run in the background.

Objects Overview:
-----------------
item_bap_ai: bap_ Assigned Info.
             The kind of info that we assigned such as
             number, acctType, selector, initial passwd.

item_bap_sid: bap Subscriber Identity.
             The information about the subs' identity.
             The subs can fill out this param freely.

item_bap_sau: bap_ Subscriber Authentication
             The subscriber is authenticated through
             email, vouch, etc.

item_bap_leap: bap_ LEAP feature information

item_bap_web: bap_ Web Page info (e.g. style)

item_bap_mail: bap_ mail feature info.

item_sa_SubscriberProfiles: the subscriber's profiles.
            This information including login name and subscriber's
            id as well as personal info such as name, address,
            e-mail, phone, etc.  This itemsFile is stored in
            each of subscriber's home dir in his/her NSP dir
            under the name bynameSubscriberProfiles.nsp.

item_LEAPfeatures: config parameters for LEAP feature.
            This parameters include his/her mobile
            device info, CDPD modem type and address.

item_webFeatures: information about subscriber's home website.
            This feature has not been used but will be
            in the future.  It will contain information uch as
            his/her web page flavor (e.g. professional, student,
            etc.).

item_qmailAddr_{acctName}: config parameters for creating
            the email acct.  This support the forwarding
            information and which mbox the incoming message
            will be stored.  General email acctName are:
             - public
             - personal
             - office
             - urgent
            The non-standard email accout can be any name
            requested by the subscriber.  For example:
             - records
             - assistant
             - fax
             - admin

mmaQmail Object Processors and Containers:
------------------------------------------

    bynameBAPs.sh
    bynameBatchBasic.sh
    bynameJetspeedActions.sh
    bynameNspSubscribers.sh
    bynameNspFeatures.sh
    bynameNspJetspeed.sh
    bynameJetspeedHook.sh
    bynameNspLEAPFeatures.sh
    bynameNspMail.sh
    bynameNspMailLists.sh
    bynameNspTo97EMSD.sh
    bynameNspWebServers.sh

At A Glance

Basic byname
------------

    bynameBAPs.sh             -- BAP stands for Byname Account Parameters.
                                 This script will read the itemsFile
                                 for each of the subscriber.
                                 The reason for having this itemsFile is to
                                 be able to use the same information such as
                                 id number, subsSelector, etc. and is most likely
                                 for employee and their relatives.
                                 The itemsFile is stored in a special dir
                                 (e.g. ../nedaPlus/BAP/)
                                 with the following filename convention:
                                 acctTypePrefix.SubsSelector.Last.First.idNumber.BAP
                                 (e.g. sa.1.simpson.lisa.20100.BAP)
                                 The .BAP file contain all the parameters for
                                 that particular subs.  The parameters can contain
                                 the following:
                                   - User profile info
                                     (name,address,phone,email,etc.)
                                   - Features list
                                     (leap,mail,web,etc.)
                                   - Per feature parameters
                                      * LEAP: deviceType, cdpdAddr, modemType, etc.
                                      * Mail: cell phone number for text messaging,
                                        main address, forwarding, etc.
                                      * Web: style (stdent, prof, etc.)

                                 After reading all of those info,
                                 it will be passed to the bynameBatchBasic.sh
                                 and will be processed as usual.

    bynameBatchBasic.sh       -- the intermediate layer for the byname
                                 creation.  This also served as the
                                 bridge from the web world to
                                 the unix world.

    bynameJetspeedActions.sh  -- Called by Jetspeed to create the subscriber's
                                 account from start to finish.
                                 (e.g. setup uid, email, website, LEAP,
                                 sending email confirmation, etc)
                                 by calling other byname script.
                                 This script is an interface between the
                                 Jetspeed and byname tools.
    bynameNspSubscribers.sh   -- Create and update bynameSubscriberProfiles.nsp
                                 saUID.nsp
    bynameNspFeatures.sh      -- Manage all of the byname features in one place.
    bynameNspJetspeed.sh      -- Has been absorbed into and rename
                                 it to bynameJetspeedActions.sh
    bynameJetspeedHook.sh     -- Called by Jetspeed to send out Emails and such
                                 Has been merge to bynameJetspeedActions.sh
    bynameNspLEAPFeatures.sh  -- Creates LEAPfeatures.nsp file for the subscriber
    bynameNspMail.sh          -- Creates/delete/update email account for subscriber.
    bynameNspMailLists.sh     -- Track and control mailing list generation.
    bynameNspTo97EMSD.sh      -- Generate EMSD Config files based on the
                                 content of last/first
    bynameNspWebServers.sh    -- Creates Virtual Web Server Domain entries
                                 and initial webHome


next up previous contents
Next: Subscribers Up: The ByName Service Components Previous: The ByName Service Components   Contents