(Page 1 of 1 in this chapter)

Chapter 1

Installing the Software

1.1 Introduction
1.2 Before You Begin
1.3 Installing Under Windows NT
1.3.1 Running the Installation Script (Windows NT)
1.3.2 Setting Environment Variables (Windows NT)
1.4 Installing Under OS/2
1.4.1 Running the Installation Script (OS/2)
1.4.2 Setting Environment Variables (OS/2)
1.5 Installing Under UnixWare
1.5.1 Running the Installation Script (UnixWare)
1.5.2 Setting Environment Variables (UnixWare)
1.6 Installing Under SCO OpenServer Release 5.0
1.6.1 Running the Installation Script (SCO OpenServer)
1.6.2 Setting Environment Variables (SCO OpenServer)
1.7 Installing Under Solaris
1.7.1 Running the Installation Script (Solaris)
1.7.2 Setting Environment Variables (Solaris)
1.8 Modifying Your CT Access Configuration File
1.8.1 Sample CT Access Configuration File
1.9 Modifying Your AG Configuration File
1.9.1 Sample AG Configuration File
1.10 Activating NaturalFax Licenses

1.1 Introduction

This chapter lists procedures for installing the NaturalFax software under:

To install NaturalFax on your system:

  1. Install the NaturalFax software, following the procedure for your operating system.

    

  2. Modify the CT Access configuration file to include NaturalFax, as described in Section 1.8.
    

    

  3. Modify the AG configuration file to include NaturalFax, as described in Section 1.9.
    

    

  4. Activate your NaturalFax licenses, as described in Section 1.10.
    




Refer to \nms\nfx\doc\files.txt for a complete list of the files installed with NaturalFax. Refer to \nms\nfx\doc\changes.txt for a list of important notices, documentation errata, and changes from previous releases of NaturalFax.


 







1.2	 Before You Begin





Before you begin installing NaturalFax:


    


  1. Make sure you have already installed the following software packages:
    

      

    • The ADI service, as described in the AG Access Installation Manual.

      

      

    • CT Access 2.0 or higher, as described in the CT Access Installation 
Manual.

      

      

    • Make sure you have removed any earlier version of NaturalFax from your system, as described in Chapter 3.
      

      

    • Make sure the system has at least one of the following Alliance Generation (AG) boards installed, and that the board is operating correctly:
      

        

      • AG-8/80

        

        

      • AG-8/80 DSP

        

        

      • AG-T1

        

        

      • AG-E1

        

        

      • AG-24/30/40/60

        

        

      • AG-T1 v2

        

        

      • AG-E1 v2

        

        

      • AG Quad T

        

        

      • AG Quad E

        

        
Refer to the AG board's Installation and Developer's Manual for details about installing and configuring the hardware. Refer to the AG Runtime Configuration and Developer's Manual for additional information about configuring runtime software for an AG board.
        
 
        

      

      

      

      1.3	 Installing Under Windows NT
      

      


      This section provides instructions for installing NaturalFax under Windows NT versions 3.51 and 4.0. Complete the following steps:
      

        


      1. Install the software.
        

        

      2. Set environment variables.
        

        
Note:  Before installing NaturalFax, ensure that any earlier installation of NaturalFax has been removed by the procedure discussed in Section 3.2.

      


      Refer to \nms\nfx\doc\files.txt for a complete list of the files installed with NaturalFax. Refer to \nms\nfx\doc\changes.txt for a list of important notices, documentation errata, and changes from previous releases of NaturalFax.
      

      

      

      1.3.1	 Running the Installation Script (Windows NT)
      

      


      To install NaturalFax:
      

        


      1. Log on as a member of the Administrators group.
        

        

      2. Insert the NaturalFax installation disk into a floppy disk drive.
        

        

      3. Run the setup program as follows:
        

          

        • For Windows NT 4.0: 

          

          
Choose Run... from the Start menu.
          

        • For Windows NT 3.51: 

          

          
In the Program Manager, from the File menu, choose Run.
          
The Run dialog box appears.
          
 
          

          

        • Enter the following and click OK:
          

          
a:\setup
          
Follow the prompts as appropriate for your system.
          
If the program detects previously installed files that are newer than the versions contained in the package, it asks you whether to install or skip the files in question. Typically, you should not overwrite newer files.
        

        

        

        1.3.2	 Setting Environment Variables (Windows NT)
        

        


        The installation program modifies the following environment variables (unless you specify not to):
        

Note:  Some of these environment variables may have already been added because these variables are also required by other NMS product components.

  NMSLMFDB=c:\nms\licenses.txt
          NFXTEXTFONT=c:\nms\nfx\text.fnt
          NFXHEADERFONT=c:\nms\nfx\header.fnt
        

        The examples shown above use the default installation directory c:\nms. If you specified a different directory during installation, replace the default directory with the path you specified for your system.
        


        The license file defined in NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
        

Note:  If you specify that the installation should not modify the environment variables, you will need to modify the variables yourself, using the Windows NT Control Panel, before running any NaturalFax applications.


        Proceed to Section 1.8 to complete your installation.
        

        

        

        1.4	 Installing Under OS/2
        

        


        This section provides instructions for installing NaturalFax on the OS/2 operating system. Complete the following steps:
        

          


        1. Install the software.
          

          

        2. Set environment variables.
          

        


        Refer to \nms\nfx\doc\files.txt for a complete list of the files installed with NaturalFax. Refer to \nms\nfx\doc\changes.txt for a list of important notices, documentation errata, and changes from previous releases of NaturalFax.
        

        

        

        1.4.1	 Running the Installation Script (OS/2)
        

        


        To install NaturalFax:
        

          


        1. Insert the first NaturalFax installation disk into a floppy disk drive.
          

          

        2. Open an OS/2 command window.
          

          

        3. Make the floppy drive your active drive and enter:
          

          
install
          
Follow the prompts as appropriate for your system.
        

        

        

        1.4.2	 Setting Environment Variables (OS/2)
        

        


        After installation is complete, use a text editor to modify the config.sys file as described in the following steps (replace c: with the destination drive that you selected in the installation).
        

Note:  Some of these environment variables may have already been added because they are also required by other NMS product components.


        Make the following changes to config.sys:
        

          


        1. Create the environment variable NMSLMFDB to specify the license file. For example:
          

          
SET NMSLMFDB=c:\nms\licenses.txt
          
The license file specified by NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
          

        2. Create the environment variable NFXTEXTFONT to specify the text font file. For example:
          

          
SET NFXTEXTFONT=c:\nms\nfx\text.fnt
          

        3. Create the environment variable NFXHEADERFONT to specify the header font file. For example:
          

          
SET NFXHEADERFONT=c:\nms\nfx\header.fnt
          

        4. Save the modified config.sys and exit the editor.
          

          

        5. Shut down and restart your system for the changes to config.sys to take effect.
          

        


        Proceed to Section 1.8 to complete your installation.
        

        

        

        1.5	 Installing Under UnixWare
        

        


        This section provides instructions for installing NaturalFax on the UnixWare operating system. Complete the following steps:
        

          


        1. Install the software.
          

          

        2. Modify the superuser environment.
          

          
Note:  Before installing NaturalFax, ensure that any earlier installation of NaturalFax has been removed by the procedure described in Section 3.3.

        


        Refer to /opt/nms/nfx/doc/files.txt for a complete list of the files installed with NaturalFax. Refer to /opt/nms/nfx/doc/changes.txt for a list of important notices, documentation errata, and changes from previous releases of NaturalFax.
        

        

        

        1.5.1	 Running the Installation Script (UnixWare)
        

        


        To install NaturalFax:
        

          


        1. Log in as root at your shell's command prompt by entering:
          

          
su -
          

        2. Insert the first NaturalFax installation disk into a floppy disk drive.
          

          

        3. Invoke the pkgadd utility by entering:
          

          
pkgadd -d devicename nfx
          
devicename is the name of the floppy disk drive from which you are installing. For example, if you are installing from your first floppy disk drive, at your shell's command prompt enter:
          
pkgadd -d diskette1 nfx
          
pkgadd displays the following prompt:
          
Insert diskette into Floppy Drive 1.
          Type [go] when ready,
          or [q] to quit: (default: go)
          
 
          

          

        4. Press Enter. 
          

          
When the installation program has completed, the following appears:
          
Installation of NaturalFax for UnixWare was successful.
          

        5. Exit the root shell by entering:
          

          
exit
        

        

        

        1.5.2	 Setting Environment Variables (UnixWare)
        

        


        You must add or modify the environment variables NMSLMFDB, NFXTEXTFONT, and NFXHEADERFONT for the user environment in which the NaturalFax application will run. You can run a NaturalFax application from any user environment, including the superuser environment, if the environment variables for that user are properly configured. Make sure that these environment variables are added to the appropriate user environment.
        


        To set the NaturalFax environment variables:
        

Note:  Some of these environment variables may have already been added because these variables are also required by other NMS product components. 

          


        1. Open a Terminal window.
          

          

        2. Log in as the designated user for the NaturalFax application. If you will be running the NaturalFax application from the root user environment, log in as root at your shell's command prompt by entering:
          

          
su -
          

        3. Enter the password when prompted.
          

          

        4. With a text editor, open the shell script file executed by the user's login shell as part of the login sequence.
          

          
 
          

          
For the Bourne or Korn shell, edit the /.profile file to modify the following environment variables:
            

          

        5. Create the environment variable NMSLMFDB to specify the license file. For example:
          

          
NMSLMFDB=/var/opt/nms/licenses.txt
          export NMSLMFDB
          
The license file specified by NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
          

        6. Create the environment variable NFXTEXTFONT to specify the text font file. For example:
          

          
NFXTEXTFONT=/opt/nms/nfx/text.fnt
          export NFXTEXTFONT
          

        7. Create the environment variable NFXHEADERFONT to specify the header font file. For example:
          

          
NFXHEADERFONT=/opt/nms/nfx/header.fnt
          export NFXHEADERFONT  
          
For the C shell, edit the /.login file to modify the following environment variables:
          

        8. Create the environment variable NMSLMFDB to specify the license file. For example:
          

          
setenv NMSLMFDB /var/opt/nms/licenses.txt
          
The license file specified by NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
          

        9. Create the environment variable NFXTEXTFONT to specify the text font file. For example:
          

          
setenv NFXTEXTFONT /opt/nms/nfx/text.fnt
          
 
          

          

        10. Create the environment variable NFXHEADERFONT to specify the header font file. For example:
          

          
setenv NFXHEADERFONT /opt/nms/nfx/header.fnt  
        


      4. Save the modified shell script file and exit the text editor.
        

        

      5. For the changes to the user's environment parameters to take effect in every open UNIX window in which that user is logged in, log out and then log back in as the designated user.
        

        

        

        Proceed to Section 1.8 to complete your installation.
        

        6. 

        

        1.6	 Installing Under SCO OpenServer Release 5.0
        

        


        This section provides instructions for installing NaturalFax software for SCO OpenServer Release 5. Complete the following steps:
        

          


        1. Install the software.
          

          

        2. Modify the superuser environment.
          

          
Note:  Before installing NaturalFax, ensure that any earlier installation of NaturalFax has been removed by the procedure described in Section 3.4.

        


        Refer to /opt/nms/nfx/doc/files.txt for a complete list of the files installed with NaturalFax. Refer to /opt/nms/nfx/doc/changes.txt for a list of important notices, documentation errata, and changes from previous releases of NaturalFax.
        

        

        

        1.6.1	 Running the Installation Script (SCO OpenServer)
        

        


        To install NaturalFax:
        

          


        1. Log in as root at your shell's command prompt by entering:
          

          
su -
          

        2. Insert the first NaturalFax installation disk into a floppy disk drive.
          

          

        3. Invoke the pkgadd utility by entering the following:
          

          
pkgadd -d devicename nfx
          
devicename is the name of the floppy disk drive from which you are installing. For example, if you are installing from your first floppy disk drive, at your shell's command prompt enter:
          
pkgadd -d /dev/rdsk/f03h nfx
          

        4. Follow the prompts as they appear.
          

          
When the installation has completed, the following message appears:
          
Installation of <nfx> was successful.
          

        5. Exit the root shell by entering:
          

          
exit
        

        

        

        1.6.2	 Setting Environment Variables (SCO OpenServer)
        

        


        You must add or modify the environment variables NMSLMFDB, NFXTEXTFONT, and NFXHEADERFONT for the user environment in which the NaturalFax application will run. You can run a NaturalFax application from any user environment, including the superuser environment, if the environment variables for that user are properly configured. Make sure that these environment variables are added to the appropriate user environment.
        


        To set the NaturalFax environment variables:
        

Note:  Some of these environment variables may have already been added because these variables are also required by other NMS product components.

          


        1. Open a Terminal window.
          

          

        2. Log in as the designated user for the NaturalFax application. If you will run the NaturalFax application from the root user environment, log in as root at your shell's command prompt by entering:
          

          
su -
          

        3. Enter the password when prompted.
          

          

        4. With a text editor, open the shell script file executed by the user's login shell as part of the login sequence.
          

          
For the Bourne or Korn shell, edit the /.profile file to add the following environment variables:
            

          

        5. Create the environment variable NMSLMFDB to specify the license file. For example:
          

          
NMSLMFDB=/var/opt/nms/licenses.txt
          export NMSLMFDB
          
The license file specified by NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
          
 
          

          

        6. Create the environment variable NFXTEXTFONT to specify the text font file. For example:
          

          
NFXTEXTFONT=/opt/nms/nfx/text.fnt
          export NFXTEXTFONT
          

        7. Create the environment variable NFXHEADERFONT to specify the header font file. For example:
          

          
NFXHEADERFONT=/opt/nms/nfx/header.fnt
          export NFXHEADERFONT  
          
For the C shell, edit the /.login file to add the following environment variables:
          

        8. Create the environment variable NMSLMFDB to specify the license file. For example:
          

          
setenv NMSLMFDB /var/opt/nms/licenses.txt
          
The license file specified by NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
          

        9. Create the environment variable NFXTEXTFONT to specify the text font file. For example:
          

          
setenv NFXTEXTFONT /opt/nms/nfx/text.fnt
          

        10. Create the environment variable NFXHEADERFONT to specify the header font file. For example:
          

          
setenv NFXHEADERFONT /opt/nms/nfx/header.fnt  
        


      6. Save the modified shell script file and exit the text editor.
        

        

      7. For the changes to the user's environment parameters to take effect in every open UNIX window in which that user is logged in, log out and then log back in as the designated user.
        

        

        

        Proceed to Section 1.8 to complete your installation.
        

        8. 

        

        1.7	 Installing Under Solaris
        

        


        This section provides instructions for installing NaturalFax on the Solaris operating system. Complete the following steps:
        

          


        1. Install the software.
          

          

        2. Modify the superuser environment.
          

          
Note:  Before installing NaturalFax, ensure that any earlier installation of NaturalFax has been removed by the procedure in Section 3.5.

        


        Refer to /opt/nms/nfx/doc/files.txt for a complete list of the files installed with NaturalFax. Refer to /opt/nms/nfx/doc/changes.txt for a list of important notices, documentation errata, and changes from previous releases of NaturalFax.
        

        

        

        1.7.1	 Running the Installation Script (Solaris)
        

        


        To install NaturalFax:
        

          


        1. Log in as root at your shell's command prompt by entering:
          

          
su -
          

        2. Insert the first NaturalFax installation disk into a floppy disk drive.
          

          

        3. Make sure the vold process is not running.
          

          
Note:  In order to use the diskette device, the vold process must be killed before performing installation from the command line.


        4. Invoke the pkgadd utility by entering the following:
          

          
pkgadd -d devicename nfx
          
devicename is the name of the floppy disk drive from which you are installing. For example, if you are installing from your first floppy disk drive, at your shell's command prompt enter:
          
pkgadd -d diskette1 nfx
          
 
          

          
pkgadd displays the following prompt:
          
Insert diskette into Floppy Drive 1.
          Type [go] when ready,
          or [q] to quit
          or [e] to eject: (default: go)
          

        5. Enter go.
          

          
When the installation program has completed, the following appears:
          
Installation of NaturalFax for Solaris was successful.
          

        6. Exit the root shell by entering:
          

          
exit
        

        

        

        1.7.2	 Setting Environment Variables (Solaris)
        

        


        You must add or modify the environment variables NMSLMFDB, NFXTEXTFONT, and NFXHEADERFONT for the user environment in which the NaturalFax application will run. You can run a NaturalFax application from any user environment, including the superuser environment, if the environment variables for that user are properly configured. Make sure that these environment variables are added to the appropriate user environment.
        


        To set the NaturalFax environment variables:
        

Note:  Some of these environment variables may have already been added because these variables are also required by other NMS product components.

          


        1. Open a Terminal window.
          

          

        2. Log in as the designated user for the NaturalFax application. If you will be running the NaturalFax application from the root user environment, log in as root at your shell's command prompt by entering:
          

          
su - 
          

        3. Enter the password when prompted.
          

          
 
          

          

        4. With your text editor, open the shell script file executed by the user's login shell as part of the login sequence.
          

          
For the Bourne or Korn shell, edit the /.profile file to add the following environment variables:
            

          

        5. Create the environment variable NMSLMFDB to specify the license file. For example:
          

          
NMSLMFDB=/var/opt/nms/licenses.txt
          export NMSLMFDB
          
The license file specified by NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
          

        6. Create the environment variable NFXTEXTFONT to specify the text font file. For example:
          

          
NFXTEXTFONT=/opt/nms/nfx/text.fnt
          export NFXTEXTFONT
          

        7. Create the environment variable NFXHEADERFONT to specify the header font file. For example:
          

          
NFXHEADERFONT=/opt/nms/nfx/header.fnt
          export NFXHEADERFONT  
          
For the C shell, edit the /.login file to add the following environment variables:
          

        8. Create the environment variable NMSLMFDB to specify the license file. For example:
          

          
setenv NMSLMFDB /var/opt/nms/licenses.txt
          
The license file specified by NMSLMFDB contains your NaturalFax password. The password specifies the number of fax operations allowed in your system. See Section 1.10 for details on activating your NaturalFax licenses.
          
 
          

          

        9. Create the environment variable NFXTEXTFONT to specify the text font file. For example:
          

          
setenv NFXTEXTFONT /opt/nms/nfx/text.fnt
          

        10. Create the environment variable NFXHEADERFONT to specify the header font file. For example:
          

          
setenv NFXHEADERFONT /opt/nms/nfx/header.fnt  
        


      8. Save the modified shell script file and exit the text editor.
        

        

      9. For the changes to the user's environment parameters to take effect in every open UNIX window in which that user is logged in, log out and then log back in as the designated user.
        

        

        

        Proceed to Section 1.8 to complete your installation.
        

        10. 

        

        1.8	 Modifying Your CT Access Configuration File
        

        


        The CT Access configuration file, typically called cta.cfg, is used by the CT Access process daemon (ctdaemon). If you will be using ctdaemon as part of your application environment, you must define all CT Access services that the application will use by specifying the service and service manager names in the CT Access configuration file. 
        


        Modify the cta.cfg file if:
        

        

        You can develop and run a NaturalFax application without using ctdaemon. If you do not use ctdaemon, you must make sure that the application's CT Access services and service managers are explicitly defined in your application code. For more information about ctdaemon and the CT Access development environment, see the CT Access Developer's Reference Manual.
        


        A NaturalFax application will use the following services:
        

  

        


        
 This service...
        

        		
 With this service manager...
        

        		
 Provides the...
        


        
 NFX
        

        		
 NFXMGR
        

        		
 NaturalFax API 
        


        
 FAX
        

        		
 FAXMGR
        

        		
 Group 3 fax protocol (ITU T.30)
        


        
 FXM
        

        		
 ADIMGR
        

        		
 interface to the hardware for sending or receiving a fax 
        


        
 ADI
        

        		
 ADIMGR
        

        		
 CT Access call control API
        



        


        

        

        

        


        The default cta.cfg file includes the ADI service. Modify the file to add the NFX, FAX, and FXM services. The cta.cfg file is located in the following directories:
        


          Windows NT and OS/2 :   c:\nms\ctaccess\cfg
          UNIX:    /opt/nms/ctaccess/cfg
        

 
        


        A sample CT Access configuration file, which includes the NaturalFax services, is installed with the NaturalFax software. The sample file is located in the following directories:
        


          Windows NT and OS/2:    c:\nms\nfx\demos
          UNIX:    /opt/nms/nfx/demos
        

        

        

        1.8.1	 Sample CT Access Configuration File
        

        


        For details about the CT Access configuration file, see the CT Access Developer's Reference Manual. The following code excerpt is an example of a CT Access configuration file that includes NaturalFax and its services:
        

        #---------------------------------------------------------------
        # cta.cfg
        #
        # This is an example file loaded by the CT Access daemon process
        #---------------------------------------------------------------

        #---------------------------------------------------------------
        # CT Access System Configuration (ctasys)
        # Valid options are:
        #     Service = name, dll
        #    TraceMask = mask
        #---------------------------------------------------------------
        [ctasys]
        Service = adi, adimgr
        Service = vce, vcemgr
        Service = swi, swimgr
        Service = fxm, adimgr          # add this line for NaturalFax
        Service = nfx, nfxmgr          # add this line for NaturalFax
        Service = fax, faxmgr          # add this line for NaturalFax

        TraceMask = 0
        TraceFile = cta.log        
#--------------------------------------------------------------
        # CT Access Default Parameter Changes (ctapar)
        # Valid syntax:
        #    service{.x}.catagory.field = value
        #--------------------------------------------------------------
        [ctapar]
        

        

        

        1.9	 Modifying Your AG Configuration File
        

        


        You must modify your AG configuration file, typically called ag.cfg, to run the NaturalFax software. agmon uses the AG configuration file to load and initialize all AG boards in your system.
        


        To use NaturalFax in your system, the AG configuration file must:
        

        

        Refer to the NaturalFax Developer's Reference Manual for further information on fax performance and AG configuration files.
        


        Refer to the AG Runtime Configuration and Developer's Manual for further information on AG configuration file syntax, AG configuration file keywords, and agmon.
        


        Use the sample AG configuration files provided with NaturalFax as models. The following table shows the sample configuration files for each AG board that supports NaturalFax. The files are located in the following directories:
        


          Windows NT and OS/2:    c:\nms\ag\cfg
          UNIX:    /opt/nms/ag/cfg
        

  

        


        
 AG board
        

        		
 File Name
        

        		
 Description
        


        
 AG-8/80
        

        		
 ag8fax.cfg
        

 ag8faxa.cfg
        

        		
 mu-law fax transmit and receive configuration file 
        

 A-law fax transmit and receive configuration file 
        


        
 AG-T1
        

        		
 agt1fax.cfg
        

        		
 mu-law fax transmit and receive configuration file
        


        
 AG-E1
        

        		
 age1fax.cfg
        

 age1fxtx.cfg
        

        		
 A-law fax transmit and receive configuration file 
        

 A-law fax transmit configuration file 
        


        
 AG-T1 v2
        

        		
 agt1fax.cfg
        

        		
 mu-law fax transmit and receive configuration file
        


        
 AG-E1 v2
        

        		
 age1fax.cfg
        

 age1fxtx.cfg
        

        		
 A-law fax transmit and receive configuration file 
        

 A-law fax transmit configuration file 
        


        
 AG-24+
        

        		
 ag24fax.cfg
        

 ag24faxa.cfg
        

        		
 mu-law fax transmit and receive configuration file
        

 A-law fax transmit and receive configuration file
        


        
 AG-30
        

        		
 ag30fax.cfg
        

 ag30faxa.cfg
        

        		
 mu-law fax transmit and receive configuration file 
        

 A-law fax transmit and receive configuration file
        


        
 AG-48
        

        		
 ag48fax.cfg
        

 ag48faxa.cfg
        

 ag48fxtx.cfg
        

 ag48fxta.cfg
        

        		
 mu-law fax transmit and receive configuration file 
        

 A-law fax transmit and receive configuration file
        

 mu-law fax transmit configuration file
        

 A-law fax transmit configuration file
        


        
 AG-60
        

        		
 ag60fax.cfg
        

 ag60faxa.cfg
        

 ag60fxtx.cfg
        

 ag60fxta.cfg
        

        		
 mu-law fax transmit and receive configuration file 
        

 A-law fax transmit and receive configuration file
        

 mu-law fax transmit configuration file
        

 A-law fax transmit configuration file
        


        
 AG Quad T
        

        		
 agqtfax.cfg
        

        		
 mu-law fax transmit and receive configuration file 
        


        
 AG Quad E
        

        		
 agqefax.cfg 
        

        		
 A-law fax transmit and receive configuration file
        



        


        

        

        

        

 
        


        To modify the ag.cfg file:
        

          


        1. Use a text editor to open the appropriate sample AG configuration file and your ag.cfg file.
          

          
The Common section appears at the top of the sample configuration files. 
          

        2. Locate the lines in the sample configuration file marked with the comment:
          

          
# Add these lines for NaturalFax. 
          

        3. Copy these lines to the Common section of ag.cfg.
          

          

        4. Copy the lines beginning with the keyword Taskprocessor from the sample configuration file to the Board section for each AG board that will run NaturalFax.
          

          

        5. Copy the line RunModule = fax.leo into the Board section for each AG board that will run NaturalFax.
          

          

        6. Save the changes to the ag.cfg file and exit the text editor.
          

          

        7. Run agmon to configure and initialize the AG board(s) as specified in the ag.cfg file.
          

          
 
          

        

        

        

        1.9.1	 Sample AG Configuration File
        

        


        The following sample configuration file sets up an AG-8/80 board for NaturalFax:
        

        #########################################################################
        #         
# ag8fax.cfg
#      --- Alliance Generation Configuration --
#
# Sample configuration file for AG-8/80 with NaturalFax
#########################################################################
#
#---------- COMMON section --------
[AGBOARD]
Interrupt = 12
# Uncomment the appropriate Trunk Control Protocol(s)
TCP = nocc.tcp           # "no call control" protocol
TCP = lps0.tcp           # Loop start protocol
# Uncomment the appropriate DSP functions
DSPFile = voice.dsp
DSPFile = signal.dsp
DSPFile = dtmf.dsp
DSPFile = callp.dsp
DSPFile = tone.dsp
DSPFile = echo.dsp

#########################################################################
# 
# To use NaturalFax with an existing AG-8/80 configuration file, add the 
# following "DSPFile" lines to the "AGBOARD" section of the file. 
# 
#########################################################################
#
# Begin NaturalFax overlays
DSPFile = m4x_tx.dsp           # ADD THIS LINE
DSPFile = m4x_17.dsp           # ADD THIS LINE
DSPFile = m4r_samp.dsp         # ADD THIS LINE
DSPFile = m4r_baud.dsp         # ADD THIS LINE
DSPFile = m4x_300.dsp          # ADD THIS LINE
DSPFile = m4r_300.dsp          # ADD THIS LINE
DSPFile = m4r_hdlc.dsp         # ADD THIS LINE
# End NaturalFax overlays
IdleCode = MU-LAW
#--------- BOARDS section ----------

#########################################################################
        # 
        # To use NaturalFax with an existing AG-8/80 configuration file, merge 
        # the "Taskprocessor" lines into the existing configuration file. 
        # 
        #########################################################################
        #

        Board 0

        ### This portion should already be in your configuration file.  Do not
        ### change these lines in your configuration file.

        RunFile    = sysan.run
        RunModule = fax.leo 
        Address    = 2C0
        ClockRef   = OSC
        EnableMVIP = NO

        ### These lines assign NaturalFax overlays to task processors on the AG
        ### board.  Merge these "TaskProcessor" lines into each "Board" entry in
        ### the configuration file corresponding to an AG-8/80 on which NaturalFax
        ### is to run.

        Taskprocessor 0 = m4r_baud.dsp, m4x_tx.dsp, m4r_300.dsp, m4x_300.dsp,
        voice.dsp, callp.dsp, tone.dsp, -300
        Taskprocessor 1 = m4r_samp.dsp, m4r_hdlc.dsp, dtmf.dsp, echo.dsp, signal.dsp,
        m4x_17.dsp, -300
        End Board

        # -------------------------------
        

        

        

        1.10	 Activating NaturalFax Licenses
        

        


        NaturalFax licenses are controlled with security software which is keyed from a password. Before you can use your NaturalFax software, you must activate your licenses by specifying your password in the license configuration file.
        


        Your password specifies the number of active fax operations allowed on your system. An active fax session will fail if you have not set up a license configuration file with the correct password. Although the password is generated based on the serial number of one of the AG boards in your system, NaturalFax can run on any AG board in your system that is running NaturalFax firmware.
        


        The license configuration file is specified by the NMSLMFDB environment variable (e.g., c:\nms\licenses.txt). Passwords are thirteen (13) characters long and may contain letters A through Z and/or digits from 0 to 9. Passwords are case insensitive. Your password is provided by Natural MicroSystems. 
        


        To obtain a password, call NMS Developer Support with the following information:
        

        

        To activate your NaturalFax licenses:
        

          


        1. Use a text editor to create or edit the license configuration file (as specified by the NMSLMFDB environment variable.
          

          

        2. Add your password to the file. If you have more than one password (including passwords for other Natural Media products), put each password on a separate line in the file.
          

          

        3. Save your changes to the license configuration file.
          

        

        

        


        
 
    (Page 1 of 1 in this chapter)
        


        
 



        
tech_support@nmss.com

        

Copyright © 1998, Natural MicroSystems, Inc.   All rights
reserved.