Amanda Work Group Norstar Work Place Instructions Manual

							Chapter 9: Using the Administrator Mailbox 83
Resetting the Date and Time
Sometimes Amanda’s system date and time become inaccurate. For example, a time 
change between daylight savings and standard time might have occurred or Amanda’s 
clock might be slightly off.
To reset Amanda’s date and time:
 
      (For login instructions, see “Logging into Amanda” on page 7.)
+  
  +      +     +  enter the date  +     +  enter the time  +     
Enter the date as month-day-year. Use 1 or 2 digits for the month, 2 digits for the day, and 
2 or 4 digits for the year. 
Enter the time as hour-minutes. Use 1 or 2 digits for the hour and 2 digits for the minutes.
If you use 13 through 23 for the hours after  noon, you are not asked whether you meant 
AM or PM. Otherwise, Amanda prompts for a    (for A.M.)  or a   (for P.M.).
For example, to change the date and time to March 4, 1999, at 9:05 
A.M., use:
  (
the month)  +  
  (the day of the month)  +  
 (the year)  +     (to finish the date)  +
  (the hour)  +    (the minutes)  +      (to finish the time)   +      (for 
A.M. when 
                prompted)
Setting Up the Administrator Mailbox from the 
Computer
[email protected] is shipped with mailbox 999 as shown in the following figures. It 
has two functions: it is the System Administrator mailbox and it provides an automatic 
hang up. 
For example, you can use G(999), which translates from the Token Programming 
Language as “Go to mailbox 999 and process it.” Because mailbox 999 has H (for hangup) 
in its Extension field and both Do Not Disturb and Screen Calls? locked OFF, G(999) 
results in a disconnection. For more information about the G() command, see 
“Programming Amanda” in Installing [email protected]
The only recommended change to mailbox 999 is the addition of one or more notification 
records with DISK as their type. In this way, Amanda notifies you when disk space falls 
below a predefined level (the default is 20%). For example, you can be paged or have a 
voice mail message left for you at your personal mailbox. For information about creating a 
notification record, see “Creating a Notification Record and a Notification Template” on 
page 52 and “Creating a Notification Record from an Existing Template” on page 54. See  
						

							84 Administering [email protected]
Installing [email protected] for more information about setting the diskwarn 
configuration option or contact your Amanda Marketing Partner or Solution Provider.
Mailbox 999
Save  Auto  Delete  Notify  Table  Copy  Esc/EXIT  PgDn/NEXT  PgUp/PREVUsers
Mailbox:  999 Comment:  SYSTEM ADMIN Security Code: 999
Extension:  H
Dir Name 1: Dir Name 2:
Basic Options Chains
Maximum Rings:0  (default is 4) Done:
Do Not Disturb:OFFLock:ONRNA:
Screen Calls?OFFLock:ONBusy:
Store Messages?YESMax:180 sec Delay:0
Copy Messages To:Menus
Message Volume:0Guests:-11: 2: 3:
Current Greeting:0Max:45 sec4:5:6:
Busy Message?SYSMax:45 sec7:8:9:
ID Call? NOD/T?  YESName/Ext? YES0:
STATISTICS AREA OMITTED FROM THIS FIGURE 
						

							Chapter 10:
Using Utilities
Backing Up and Restoring Files
The BackRest utility backs up and restores the database, the greetings, and the incoming 
messages of an Amanda system. BackRest automatically detects the number of floppy 
drives in the computer and allows you to use either the A: or B: drive. The number of 
floppies as well as the number of bytes needed for the requested backup is estimated after 
you insert the first floppy. You can add a note (comment) that is displayed when you 
restore files from the floppy disks.
N
OTE:This process can require several floppy disks and can take a long time to 
execute.
Syntax:  backrest
To back up or restore files:
 At the C:\AMANDA> prompt, type:
backrest
The computer displays:
Amanda Backup and Restore Utility Version 1.6
a. Backup Database to drive A:
b. Backup Greeting to drive A:
c. Backup Messages to drive A:
d. Backup All to drive A:
e. Restore from drive A:
f. Quit Backrest
Use the arrow keys to make a selection and press Enter to start the backup or restore 
operation.
Deleting Mailboxes and Mailing Lists
The Amanda Company provides utilities that delete mailboxes and personal mailing lists.
Deleting Mailboxes
The DelUsers utility simplifies the deletion of mailboxes. Use it to delete a single mailbox 
or a range of mailboxes.
Syntax:  delusers mailbox_list 
						

							86 Administering [email protected]
To delete one or more users:
 At the C:\AMANDA> prompt, type:
delusers mailbox_list
where mailbox_list specifies individual mailboxes, a range of mailboxes, or both. Use 
a hyphen (-) to separate the first and last mailboxes in a range. Use a space to separate 
entries in the list. For example:
1000-2000 990-991 3000
Deleting Personal Mailing Lists
The List Del utility deletes the specified personal mailing list from the specified mailbox. 
(System mailing lists are the personal mailing lists for mailbox 999.)
Syntax:  list_del mailbox list_number
For example, deletes List 7 from mailbox 212, type the following at the C:\AMANDA> 
prompt:
list_del 212 7
Displaying Message Information
The MsgList utility displays the quantity, date, time, and type of messages stored for all 
the mailboxes or the specified mailboxes.
Syntax:  msglist [-e] [mailbox_list]
The -e is optional. Use it to print the dates in European format (20/04/95) rather than the 
US format (04/20/95).
The mailbox_list specifies individual mailboxes, a range of mailboxes, or both. Use a 
hyphen (-) to separate the first and last mailboxes in a range. Use a space to separate 
entries in the list. For example:
1000-2000 990-991 3000
To report on all mailboxes:
 Type the following at the C:\AMANDA> prompt:
msglist
To store the information in a file:
Type:
msglist > output_filename
where output_filename is the name or path to another file.
To use the Less utility and display 20 lines at a time:
Type:
msglist | less 
						

							Chapter 10: Using Utilities87
To print the results rather than display or store them:
Type:
msglist > prn 
To display the information for mailbox 200 through mailbox 231:
Type:
msglist 200-231
To display message information in the European format: 
(for mailboxes in the range 200–231 and in the range 300–320)
Type:
msglist -e 200-231 300-320
Validating Notification Templates
The VMBEdit utility checks that:
 Notification templates are valid.
 No two templates are identical except for Title. If it finds duplicates, it keeps the 
first template (unless it has no title) and deletes the duplicate. VMBEdit updates 
the mailboxes that used the deleted template so that they use the template that was 
kept.
 If a template is not being used by any mailbox, VMBEdit asks you whether the 
template should be deleted, listed, or kept as-is.
VMBEdit makes a back up of VMB.DAT (named VMB.BAK) before it checks the 
templates.
N
OTE:Do not run VMBEdit from a batch file because it can ask questions and 
will wait for responses to be input from the keyboard.
Syntax:  vmbedit
Managing Text Files
Amanda provides utilities that allow you to search, edit, and display text files.
Searching Text Files
The Grep utility searches the specified file from beginning to end for the specified string 
of characters. The search is case sensitive, which means that it differentiates between 
upper and lower case letters within the file. Therefore, the searchstring must be typed 
exactly as it appears in the file. The Grep utility displays the lines of the file that contain 
those characters. This is useful when viewing trace files.
Syntax:  grep searchstring filename
To display the results of the search on the screen:
 Type the following at the C:\AMANDA> prompt:
grep searchstring filename 
						

							88 Administering [email protected]
To store the results in a file:
 Type (on one line):
grep search_string input_filename > output_filename 
where output_filename is the name or path to another file.
To print the results rather than display or store them:
Type:
grep searchstring filename > prn 
For additional information on GREP.EXE, read C:\AMANDA\GREP.MAN. See also the 
Less utility, “Displaying Text Files (20 Lines at a Time)” on page 90.
Editing a Text File
The JOVE utility allows you to edit any text file on your Amanda system. For example, 
you might want to edit INSTALL.CFG, TRACE.OUT, AMANDA.LOG, 1001.PBX, 
CONFIG.SYS, and AUTOEXEC.BAT.
Syntax:  jove filename
Examples
The following examples show common uses of the JOVE utility.
To change your Amanda password using JOVE:
1. At the C:\AMANDA> prompt, type:
JOVE INSTALL.CFG
2. To perform a search for the Password configuration option, press Ctrl+S and type the 
first few letters of the word password.
set off_dly 50
set partial_q_ok false
set password AMandA
PBX 1 1001
PBX 2 2001
3. Use the Right Arrow key to move the cursor to the password to be replaced.
4. Type the new password and delete any extra letters.
N
OTE:Passwords are case sensitive. Also, the new password must be in sin-
gle quotes.
5. Save your change by pressing Ctrl+X then Ctrl+S.
6. Exit JOVE by pressing Ctrl+X then Ctrl+C
To activate the HOST program:
1. At the C:\ prompt, type:
JOVE AUTOEXEC.BAT 
						

							Chapter 10: Using Utilities89
2. To perform a search, press Ctrl+S and type the first few letters of the word “HOST”. 
Look for one of the following lines in the AUTOEXEC.BAT: 
rem LH HOST /2 /f /n >> %LOGN%
rem LH HOST /4 >> %LOGN%
N
OTE:The /2 is for COM2 and the /4 is for COM4. Use COM2 when con-
necting directly via a null modem cable. Use COM4 when connect-
ing via a modem. 
The /f is for “fast” to use 14400 bps. You can add /f to the second 
line if your modem is fast.
%LOGN% refers to the environment variable LOGN, which is set in 
the AUTOEXEC.BAT file as:
SET LOGN = C:\BOOTLOG
and logs information in the BOOTLOG file in the root directory.
If you prefer to log information on screen, put a “rem” in front of the 
above line and remove the “rem” from the following line:
REM SET LOGN = CON:
3. Use the arrow keys to position the cursor.
4. Press the Delete key to delete the letters “rem” from the beginning of one of the lines. 
5. Save your change by pressing Ctrl+X then Ctrl+S
6. Exit JOVE by pressing Ctrl+X then Ctrl+C
JOVE Commands
The following is a list of JOVE commands:
JOVE Commands
ActionCommand
To move around Use the arrow keys, Home, End, Page Up, and Page 
Down
To search the file forward for a 
string (or word)Ctrl+S and the first few letters of the string
To search the file backward for a 
string (or word)Ctrl+R and the first few letters of the string
To insert characters Place the cursor at the insertion point and type them
To delete the character above the 
cursorUse the Delete key
To delete an entire lineCtrl+K
To restore a deleted lineCtrl+Y
To move to the beginning of the 
fileCtrl+Home
To move to the end of the fileCtrl+End
To move text around, first delete 
using Ctrl+K, thenCtrl+Y 
						

							90 Administering [email protected]
Displaying Text Files (20 Lines at a Time)
The Less utility displays a text file on the screen, 20 lines at a time. This utility is similar 
to the MORE command in DOS, but with many additional features.
Syntax:  less filename
You can move around in the file:
 Use Page Up and Page Down to scroll through the file
 Use Up Arrow and Down Arrow to move from line to line
 To view an additional line, press Enter
 To view the next 20 lines, press the spacebar or Page Down
 To search forward for a string of characters, type 
/
string
 To search backward for a string of characters, type ?
string
 For Help, press H
 To Quit, press Q
The Less utility is often used with the Grep utility. For instance, if you have a very large 
TRACE.OUT file, and you are interested in only the activity on Port 1, you could filter the 
TRACE file with Grep and then page through the results with Less.
At the C:\AMANDA> prompt, type:
grep ichan_01 trace.out | less
To edit a new fileCtrl+X Ctrl+F
To create a new fileCtrl+X Ctrl+F
To scroll the screen up one lineCtrl+Z
To scroll the screen down one 
lineEsc Z
To switch between edit buffers 
(two files)Ctrl+X B, then Enter
To split the screen into two buff-
ersCtrl+X 2
To return the screen to one bufferCtrl+X 1
To save the file with the same file 
nameCtrl+X Ctrl+S
To write the file to a different file 
nameCtrl+X Ctrl+W
To exitCtrl+X Ctrl+C
JOVE Commands (Continued)
ActionCommand 
						

							Chapter 10: Using Utilities91
To view a file that you are not grepping, such as GREP.MAN, which explains how to use 
the Grep utility, type the following at the C:\AMANDA> prompt:
less grep.man
Displaying the Last n Lines of Text Files
The Tail utility displays the last n lines in a text file, with a default of 10 lines.
Syntax:  tail [-n] filename
To display the last 20 lines of a file:
 Type the following at the C:\AMANDA> prompt:
tail -20 filename
Performing Operations at Shutdown
As Amanda performs an automatic shutdown, she runs the SHUTDOWN.BAT file. For a 
new installation, this file is composed of commented-out DOS commands and does 
nothing. Change it to fit any customized operations, such as defragmenting or backing up 
the hard drive, that you do routinely. SHUTDOWN.BAT contains the following lines:
@ECHO OFF
rem
rem Put your own customized operations for automatic shutdown here.
rem You may run backup jobs, disk defragmentation jobs or other tasks
rem of your own choosing.
rem
rem You may call other batch files from here, but you MUST USE THE CALL
rem command to invoke all other additional batch files, or ELSE YOU WILL
rem NEVER RETURN AND DO THE RESTART.
rem
rem Below are some sample operations to give you ideas.
rem
rem SCANDISK C: /CUSTOM
rem DEFRAG C: /F
rem
rem SCANDISK D: /AUTOFIX /NOSUMMARY
rem XCOPY C:\*.* D:\
rem
rem CD \TAPE
rem TAPE ERASE /Q/N=AMandA 
rem TAPE BACKUP /F=C:\AMANDA\AMANDA.TAG /-C/-P/R/W 
rem
Reviewing Installation History
You can review an Amanda system’s installation history to find out what versions have 
been installed or uninstalled. It shows each Amanda version (starting with 5.45) and its 
installation history on the computer.
Syntax:  history
To display the history of the search using the Less utility:
 Type the following at any prompt:
history | less 
						

							92 Administering [email protected]
Output from the utility looks like the following example. The output ranges from most 
recent to least recent version.
                           EXAMPLE HISTORY DISPLAY
*********************************************************************
The currently installed system is:
[email protected] Version 2.11
Voice platform: BI-SONIC
Continue, or Quit[C,Q]?C
Pressing C to continue will display information about previous updates/upgrades as well 
as uninstalls—if there are any.