(Page 1 of 1 in this chapter)

Chapter 10

SS7 Software Download

10.1 Sample SS7LOAD Script for Windows NT

10.2 Sample SS7LOAD Script for UnixWare and Solaris Systems

The SS7 distribution CD-ROM contains a sample script, SS7LOAD, for downloading the SS7 software and configuration files to the TX Series board(s) for each operating system. SS7LOAD may be found in the following locations Windows NT: <drive>:\tektx\ss7load.bat UNIX and Solaris: /usr/bin/ss7load
The sample script takes a single parameter, the board number, which is required (Note: on some operating systems this may default to board 1 if omitted). The following example shows the output of SS7LOAD when run on Windows NT. prompt> ss7load 1 CPMODEL V1.0: Copyright 1998, Natural MicroSystems Board #1 is a TX2000 Loading: E.0 TX2000 Kernel (c)1996-1997 Natural MicroSystems, Inc. 2/10/97 Loading: Loading: netmgr Version C.1.0 12/10/97 Loading: console Version C.1.0 12/10/97 Loading: inf Version C.4.0 12/10/97 Loading: mvip Version A.1.0 12/10/97 Loading: t1e1mgr Version A.1.0 12/10/97 Loading: mtp Version B.3.0 01/14/98 mtp2cfg: sample MTP2 configuration application version B.1.0 Jan 14 1998 mtp3cfg: sample MTP3 configuration application version B.3.0 Jan 14 1998
The exact contents of the SS7LOAD scripts varies by operating system, but the basic functions executed by SS7LOAD are as follows (note that the order is significant): A utility program is executed to determine the model number of the board so that the correct operating system kernel may be downloaded. The operating system kernel and related utility software modules are downloaded using the CPLOT loader utility. The MVIP and T1E1MGR tasks are downloaded to the board. These tasks enable use of the MVIP switching and T1/E1 configuration/control APIs. If your system does not use these APIs, these commands may be removed from SS7LOAD. The SS7 MTP layer task (file mtp.lot) is downloaded to the board. This task must be downloaded before any of the other SS7 software layers. This is the only required SS7 module. Any optional SS7 layers which have been manually enabled are downloaded to the board. The MTP2CFG (optional) and MTP3CFG (required) utilities are executed to download the MTP configuration to the MTP task. Again, the MTP layers must be configured before any of the other SS7 layers. Any optional SS7 configuration utilities which have been enabled are executed to download their respective configurations to the appropriate SS7 layer task. Again, the order shown in the SS7LOAD file should be maintained.
By default, the sample SS7LOAD script installed with the SS7 MTP package downloads only the MTP software and configuration to the board. The commands to load and configure the other SS7 software layers (ISUP, TUP, SCCP, and TCAP) are present, but "commented out". Note: If you use any of these optional software layers, you must edit the SS7LOAD script to enable the download and configuration of the applicable layers.
You may also want to modify the script to change the file and/or path names of the SS7 configuration files as you modify the sample configuration files to meet your system needs.
The following examples show the SS7LOAD scripts for Windows NT and Unix systems, respectively.

Windows NT:	`<`drive`>:\tektx\ss7load.bat`
UNIX and Solaris:	`/usr/bin/ss7load`

10.1 Sample SS7LOAD Script for Windows NT

10.2 Sample SS7LOAD Script for UnixWare and Solaris Systems

#
# Reset board, clear driver stats load CPK/OS and related tasks,
# and configure SS7
#
if [ -z "$TX2BASE" ]
then
        TX2BASE=/usr/lib/txn
fi
if [ -z "$CONFIGBASE" ]
then
        CONFIGBASE=/etc/txn
fi
# reset board
cputil -b$1 -R
# clear driver stats
cputil -b$1 -C
#
# get board type
#
BOARDTYPE=\Qcputil -b$1 -i\Q
case $BOARDTYPE in
        TX3000)
                CPK="cpk3000.lo"
                ;;
        TX2000)
                CPK="cpk2000.lo"
                ;;
        *)
                echo "board $1 not available" 
                exit 1
                ;;
esac
#
# load CPK/OS 
#
cplot -c $1 -f $TX2BASE/$CPK -k -u ss7 -a
if [ $? -ne 0 ]
then
    echo "Kernel load failed, exiting $0 script"
    exit 1
fi
#
# load Related tasks
#
cplot -c $1 -f $TX2BASE/nmg.lot -n netmgr -p 5 -a
cplot -c $1 -f $TX2BASE/console.lot -n console -p 2 -a
cplot -c $1 -f $TX2BASE/inf.lot -n inf -p 10  -a
#
# load TDM configuration - note: remove this line if you use
# serial (V.35) ports rather than T1/E1/MVIP
#
cplot -c $1 -f $CONFIGBASE/TDMcp$1.bin -g tdm
#
# load the MVIP and T1/E1 manager tasks to enable use
# of the MVIP and T1/E1 host APIs. Note: if you do not
# use either of these APIs, remove the following two lines
#
cplot -c $1 -f $TX2BASE/mvip.lot -n mvip -p 4 -a
cplot -c $1 -f $TX2BASE/t1e1mgr.lot -n t1e1mgr -p 15 -a
# 
# to enable packet tracing in the ISUP layer, make the following
# command active to load the ETP trace collector on the board
#
#cplot -c $1 -f $TX2BASE/etp.lot -n etp -p 14 -a
#
# MTP2/MTP3 combined task (needed for use of SCCP/ISUP/TCAP)
#
cplot -c $1 -f $TX2BASE/mtp.lot -n mtp -p 10 -a
#
# load SS7 tasks
#
# Remove the comment mark to enable any SS7 layers you are using
#
#cplot -c $1 -f $TX2BASE/sccp.lot -n sccp -p 11 -a
#cplot -c $1 -f $TX2BASE/isup.lot -n isup -p 12 -s 40960 -a
#cplot -c $1 -f $TX2BASE/tcap.lot -n tcap -p 13 -a
#
# ISUP only: Enable the download of the ISUP database required for your configuration.
# cplot -c $1 -f $TX2BASE\itublue.lot -n itublue -p 5 -a
# cplot -c $1 -f $TX2BASE\ituwhite.lot -n ituwhite -p 5 -a
# cplot -c $1 -f $TX2BASE\q767.lot -n q767 -p 5 -a
# cplot -c $1 -f $TX2BASE\ansi88.lot -n ansi88 -p 5 -a
# cplot -c $1 -f $TX2BASE\ansi92.lot -n ansi92 -p 5 -a
# cplot -c $1 -f $TX2BASE\ansi95.lot -n ansi95 -p 5 -a

# Configure SS7
#
# The following sleep is to get around a race condition that occurs when
# task receive messages before the task mount completes.
#
sleep 2
# MTP2 configuration
#
mtp2cfg -b $1 -f $CONFIGBASE/MTP3cp$1.cfg
# MTP3 configuration
#
mtp3cfg -b $1 -f $CONFIGBASE/MTP3cp$1.cfg
#
# Remove the comment mark to enable any SS7 layers you are configuring
#
#sccpcfg -b $1 -f $CONFIGBASE/SCCPcp$1.cfg 
#isupcfg -b $1 -f $CONFIGBASE/ISUPcp$1.cfg 
#tcapcfg -b $1 -f $CONFIGBASE/TCAPcp$1.cfg

(Page 1 of 1 in this chapter)

tech_support@nmss.com