Amiga ISO Collection/AmigaUtilCD1.iso/Fax/AVMN199D.LHA/avminstall/docs/installation

Text File | 1995-12-03 | 16.5 KB | 420 lines

 This file documents how to set up avmNfax.  Please read it carefully.
 After installing, please read the full documentation (avm.doc
 or avm.guide).  Then read Registration or Registration.guide to
 get some information on what the Unregistered version can do
 and how to get yourself registered.

 If you are upgrading from a previous version of avmNfax, you need
 to go through these steps again.  The AVM-Install script will detect
 whether you have previously installed avmNfax and will be able
 to save your previous configuration (if you want to).
 WARNING:  If you do choose to keep your current setup, I recommend
 that you look in avm:Defaults/LineLink144e.StandardConfig (if you
 have a LineLink), avm:Defaults/Zyxel612.StandardConfig (if you have
 a ZyXEL with a ROM version greater than or equal to 6.12), or
 avm:Defaults/Any.StandardConfig for all other modem types.  In
 particular, look at the *end* of the file to see if there are new
 things that I added that are user-settable.  Also go through the
 History file to see if I added any new flags for your modem's type.

 If you have a fax-modem only, you may skip certain steps that
 I've marked as skippable.

 1.  Hardware setup

  Plug your modem into the serial port.  I highly recommend getting
  a cable which has the required 7 wires.

  Determine what type of modem you have.  To do this, open up
  a terminal program (Terminus, Termite, Term, JR Comm, Baud Bandit,
  vt100, ATalk III, etc.).  Then, type in the following commands
  followed by a <Return>:

  AT+FCLASS=8
                ; If this returns OK, then you have a ZyXEL or Dolphin.

  AT#VS4
                ; If this does NOT return an ERROR, then you probably
                  have a LineLink.
  AT#CLS=8
                ; If this returns OK, then you have a Rockwell compatible
                  voice modem.  Someone says this returns OK on a ZyXEL
                  too...but ZyXELs are not Rockwell compatible.

  If any of the tests above works for you, then you have something that
  is most likely supported by the voicemail portion of this package.
  Great!

  If none of these commands work, then you may have a fax modem.
  To determine what "class" it supports, type in the following:

  AT+FCLASS=1
                ; If this returns OK, then you have a Class 1
                  fax modem.
  AT+FCLASS=2
                ; If this returns OK, then you have a Class 2
                  fax modem.
  AT+FCLASS=2.0
                ; If this returns OK, then you have a Class 2.0
                  fax modem.

  Currently, EFax (the included fax software) only supports Class 1
  and Class 2 fax modems.  Class 2.0 is not yet supported.

  a. If you have a voice-capable modem,

     If you have a Rockwell based modem that has a connector for
     a telephone at the back of the modem, connect your telephone
     there.

     If you have a Zyxel Elite (2864), connect your telephone to
     the back of the modem.

     Otherwise, you will need to connect your telephone to some sort
     of splitter.  The telephone should be connected in *parallel*
     with the modem.  It should not be connected to the back of the
     modem!  Another possibility is to hook it up to an extension
     in your house.  To test whether the telephone and the modem
     are hooked up as required by AVM, call up some BBS in your area.
     Once you are connected, pick up the telephone.  If you hear the
     modem noises, then your setup is OK.

  b. If you have a fax-modem,

     You can plug a telephone to the back of the modem or on
     a separate extension.  It does not matter.

 2.  Install MUI 2.3 or greater and ensure that it works by trying
     out one of the MUI demos.  If you cannot get one of the demos
     to work, you can be sure that AVM won't work either.

     Note that when installing MUI, you need to use the MUI-Install
     icon.  You cannot just copy the muimaster.library to LIBS:.
     That will not work.  Typical errors if you mis-install MUI include
     "Bad window object" and "Can't find muimaster.library" messages
     when trying to run one of the MUI-based applications in
     avmNfax.

     I cannot over-emphasize the requirement that you install MUI
     correctly.

 3.  Make sure that ARexx is running.  To do this, type in the
     following into a Shell:

     sys:rexxc/rx "say hello"

     If "HELLO" is printed, ARexx is running.  If not, you need to
     run the ARexx server by typing the following into a Shell:

     rexxmast > NIL:

     I recommend that you add the previous line (rexxmast ...) to
     s:startup-sequence or s:user-startup.

 4.  Unarchive the main avmNfax archive in some temporary directory.
     To do this, you normally do the following from a Shell:

     lha x avmNfax?.??.lha

     where ?.?? should be replaced with the version you're
     trying to install.

     This step will create a directory called AVMInstall in the
     directory that you were "in" at the time you executed
     this command.

     My installation procedure will copy files to the final destination.

     I normally unarchive the main archive in RAM:.  However, if you
     do not have a lot of RAM, then any place on your hard drive
     is fine.

 5.  Double-click on the AVM-Install icon from the WorkBench.  This
     will give you a lot of options.  Answer the questions as best
     as you can.

     This step will copy the necessary files from the temporary
     directory (where you unarchived the avmNfax archive) to the
     final directory and add the necessary ASSIGNs to your user-startup
     file (you should *always* Proceed when asked if you want to
     add the necessary ASSIGNs to the user-startup file).  You will
     also be able to choose what type of modem you have, what type
     of digitizer, and the method by which you want to be informed
     of new calls, among other things.

     Note:  Fax-modem owners should check if their modem is listed
     as one of the options.  If it is, then someone else has the same
     modem that you have and was able to make it work with EFax.
     By using the configuration that was sent to me, you should be
     able to get your modem working with EFax.  If it is not listed,
     you should still be able to get EFax working with your modem
     by choosing Class 2 or Class 1 (if your fax modem supports both
     Class 2 and Class 1, try Class 2 first).

 6.  Configure AVM.  To perform this step, click on the icon called
     startAVM in the directory that you just installed avmNfax.
     A window called "AVM UserInterface" will open.  Go to the
     Configure menu and select "Servers".  Another window will open
     up called "Choose Server".  Click on the Configure button at the
     bottom of the window.  Another window called "Configure Server"
     should open up.  Make sure that the gadget at the top of this
     window is called Common.

     a.  Set up the serial port parameters

       Edit the field called Serial Port and change it
       from serial.device to the name of the device your
       modem is hooked up to.  You should also change the
       Unit Number if it is not 0.

     b.  Set up the ring parameters

       Adjust the number of rings that you want AVM to wait for
       before answering the phone if there are messages in some
       of the mailboxes.

       Adjust the number of rings that you want AVM to wait for
       before answering the phone if there are no messages in
       any of the mailboxes.

     c.  Set up the fax parameters

       Cycle the gadget at the top of the Configure Server window
       until it says "Fax".

       Enter your Fax ID in the field called Fax ID.  Do this if
       you use either EFax or TrapFax.  For other fax programs
       such as GPFax, use those programs to set the Fax ID.

     Once you have made the necessary changes, click on the Save
     button at the bottom of the Configure Server window.  Wait
     10 seconds, and then reboot your Amiga.

 7.  Required fax setup if you are not going to use EFax.

     To use GPFax with AVM, follow these steps to configure
     GPFax:

       g1. Make sure that the Shared flag is enabled in the
           Environment window of GPFax.

       g2. Edit the Answer.gpf script and remove the lines
           which have 'viewlast' in them (the last two ones in
           the version I have).

       g3. If you have a ZyXEL modem, the Modem Init string of GPFax
           should be:

           AATE0V1X4&K3&C1&D2S0=0

       g4. If you have a LineLink modem, the Modem Init string GPFax
           should be:

           AATE0V1X4&K3&C1&D2&R0S0=0

       g5. If you have any other modem, try the one for the ZyXEL
           modem first.  Then try the one for the LineLink modem.

       g6. Edit avm:StandardConfig.  Add the following line to the
           end of that file:

           sys:rexxc/rxset AVMFaxProgram GPFax

           Save the file after making this change.

       NOTE:  GPFax should not be running before you start AVM.

     To use TrapFax with AVM, follow these steps to configure
     TrapFax and AVM:

       t1. Note!  This step may not be necessary -- try using TrapFax
           without doing this step first.

           Make sure that you install the OwnDevUnit library.

           Open up the Configure Server window as you did in Step
           6.  Edit the Common settings by cycling through the gadget
           at the top of the Configure Server window.  Enable
           the checkbox called Use OwnDevUnit.  Click on the Save
           button at the bottom of the Configure Server window,
           wait 10 seconds, then reboot you Amiga.

       t2. Edit avm:StandardConfig.  Add the following line to the
           end of that file:

           sys:rexxc/rxset AVMFaxProgram TrapFax

           Save the file after making this change.

 8.  Start up AVM by double clicking on the startAVM icon.  Or,
     type in "execute avm:startAVM" from some Shell.  Two programs
     should start up:  the AVM UserInterface, and the AVM Server.
     The AVM Server is the program that communicates with the modem.
     It is required for proper operation of AVM.  This is the only
     program that is required if you want your Amiga to answer
     the phone, act as a voicemail machine, do faxes, etc.  The
     AVM UserInterface allows you to access your voice and fax
     messages.

 9.  Skip this step if you have a fax modem only.

     Skip this step if you already have an old version of avmNfax
     installed.

     Record your voice prompts.  To do this, go to the Configure
     menu and select the Voice Prompts menu item.  Alternatively,
     you can download the optional voice files.

  a. Simple answering machine

     If you want a really simple answering machine, you only
     need to record the following files:

      o  intro1
      o  intro2
      o  intro3
      o  MailboxGreeting
      o  MailboxCaller
      o  SkipFaxMaintenance
      o  BeingForwarded
      o  AnnounceForward
      o  AnnounceAgain
      o  Goodbye

     The "intro" files are played first (depending on the time of day)
     After one of the "intro" files is played, the caller is put into
     the "Anonymous" mailbox, which plays "MailboxGreeting", at which
     point the caller can send a fax or wait for the beep to leave
     a message.  It is entirely up to you on what message you want
     to tell him.  Maybe you could say something like "Hi, this is
     Al's answering machine.  Press 2 to send a fax or wait for the
     beep and leave your message.  When you're done leaving your
     message, press 1.".  If the caller presses 1, then he will be
     allowed to do other things like leave another message.

     Note that when I mean a "simple answering machine", I really
     mean simple.  You will not be able to call your system to
     retrieve your messages or do any remote maintenance.
     For that, you will have to record many more voice files.

     If you got the optional voice files, you will probably only
     want to re-record the following voice file:

      o  MailboxGreeting

  b. Three mailbox system

     If you are running AVM as the three mailbox system, you need
     to record the following files:

      o  intro1
      o  intro2
      o  intro3
      o  MailboxGreeting
      o  MailboxCaller
      o  SkipFaxMaintenance
      o  BeingForwarded
      o  AnnounceForward
      o  AnnounceAgain
      o  Goodbye
      o  InitialMessage
      o  level0

     "InitialMessage" tells the caller to press 1 to enter the
     voicemail system.  If he does press 1, "level0" then asks
     the caller to press a number depending on who they may leave
     messages or faxes for.  Unless your names happen to be Al and
     Dory, you will need to re-record this message :)  Also, you
     really should record "level0".

     With this minimal set of voice files, you will not be able
     to retrieve your messages from the outside or do any
     maintenance from the outside.  For that, you will have to
     record many more voice files.

     If you got the optional voice files, then will probably only
     want to re-record the following voice files:

      o  MailboxGreeting
      o  level0

 10. Skip this step if you have a fax-modem only.

     Test things out.

     Test 1:  Pick up the phone, dial a 1 digit number on the
     telephone (this should get rid of the dial tone), the press
     the icon that looks like a tape recorder (it is the icon to
     the right of the mouth).  Talk into the handset for a few
     seconds then click on the button that looks like an
     exclamation point.  You should be able to play the message
     that got created in the Manual mailbox.

     Test 2:  Pick up your phone, wait a few minutes until
     the phone company gives up and makes your phone line go silent,
     then click on the icon that looks like a mouth.  This will
     instruct AVM to pick up the phone and process it as though
     you got a call.  Try leaving a message.  Then wait for AVM to
     hang up.  Then click on the mouth icon again and try to retrieve
     your message using the touch tone keys (do this only if you
     recorded all of the necessary voice prompts).

     NOTE:  On some phone systems, this will not work.  It depends
     on the phone company.

 11. To run AVM automatically when your computer reboots or is powered
     on, you can drag and drop the startAVM icon into your
     WBStartup drawer.

 12. The file called StandardConfig in the AVMSuite2 directory should
     be edited to your preferences.  In particular, when you first install
     AVM, it defaults to acting like a simple answering machine.  If you
     want to try out the multi-mailbox system, you will need to add
     something to this file.  There are also other parameters in this
     file that you can change to alter the way AVM and its ARexx
     scripts work.  See the section "Configuring with RXSET or SETENV"
     in the avm.doc or avm.guide file to see what the different lines
     in this file means.  NOTE!  You will need to quit all the AVM
     programs and restart AVM using startAVM in order for your new
     configuration to take effect.

     Here are some of the things you can set:

       o The BBS that you want run when a caller presses 5
       o The Fax program that you want run when caller presses 2
       o The font and font size that is used when you print out text
         through the fax printer-driver
       o Whether to use a user-recorded beep
       o Whether to do pre-conversion
       o The date and time format that will be displayed in LogViews,
         SchedulerViews, or the Scheduler
       o and so on...

 13. Skip this step if you have a fax-modem only.

     If you got the archive avmNfaxProg?.??.lha (this is the Programmer
     and its associated "source" files -- make sure you have the same
     version as the main avmNfax archive), do the following from a Shell:

       cd avm:
       lha x avmNfaxprog?.??.lha

     where ?.?? is the version that you got.  You may want to backup
     your source files first though, in case you made some modifications.

 14. Erase the directory that was created when you unarchived the
     main avmNfax archive.  You do not need that directory anymore
     since the installation program copied the stuff to the final
     destination.

 15. ATTENTION!  avmNfax 2.xx will install in a different directory
     than 1.xx.  In particular, it will install in a directory called
     AVMSuite2 instead of the old directory called AVMSuite.  After
     installing 2.xx, you should copy the keyfiles and the voice files
     into the new directory:

       copy work:AVMSuite/owner.cfg work:AVMSuite2
       copy work:AVMSuite/#?key work:AVMSuite2
       copy work:AVMSuite/voices work:AVMSuite2/voices