Amanda Work Group Administrations 7 Xx Instructions Manual

							Chapter 10: Using Utilities 201
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
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 
						

							202 Administering [email protected]/DOS
To display message information in 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 du-
plicate. VMBEdit updates the mailboxes that used the deleted tem-
plate 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.  
						

							Chapter 10: Using Utilities 203
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
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 207.
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 
						

							204 Administering [email protected]/DOS
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 single 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
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% 
						

							Chapter 10: Using Utilities 205
NOTE:The /2 is for COM2 and the /4 is for COM4. Use 
COM2 when connecting directly via a null modem ca-
ble. Use COM4 when connecting 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 for-
ward for a string (or 
word)Ctrl+S and the first few letters of the string
To search the file back-
ward for a string (or 
word)Ctrl+R and the first few letters of the string 
						

							206 Administering [email protected]/DOS
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 begin-
ning of the fileCtrl+Home
To move to the end of 
the fileCtrl+End
To move text around, 
first delete using 
Ctrl+K, thenCtrl+Y
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 buffersCtrl+X 2
To return the screen to 
one bufferCtrl+X 1
To save the file with the 
same file nameCtrl+X Ctrl+S
JOVE Commands (Continued)
ActionCommand 
						

							Chapter 10: Using Utilities 207
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 write the file to a dif-
ferent file nameCtrl+X Ctrl+W
To exitCtrl+X Ctrl+C
JOVE Commands (Continued)
ActionCommand 
						

							208 Administering [email protected]/DOS
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 
						

							Chapter 10: Using Utilities 209
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
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]/DOS Version 6.02 Revision A
Voice platform: RH-RDSP
The Stand-alone system is enabled.
Continue, or Quit[C,Q]?C
**********************************************************************
Found installation of [email protected]/DOS Version 6.02 Rev B
This installation was un-installed.
The prior product updated/upgraded was: [email protected]/DOS 6.02 A.
The BUILD.ID for this installation is:
BUILD 6.02 B.06
Number of installation starts found for this product is:
6
The DISCARD program has been run one or more times on this installation!
View the SUMLOG file, or Continue ...[V,C]?C 
						

							210 Administering [email protected]/DOS
**********************************************************************
Found installation of [email protected]/DOS Version 6.02 Rev A
This installation was an update/upgrade.
The prior product updated/upgraded was: [email protected]/DOS 6.01 A.
The files backed up by this installation appear intact; an un-install
should be possible.
The BUILD.ID for this installation is:
BUILD 6.02 A.15
Number of installation starts found for this product is:
3
View the SUMLOG file, or Continue ...[V,C]?C
**********************************************************************
Found installation of [email protected]/DOS Version 6.01 Rev A
This installation was an update/upgrade.
The prior product updated/upgraded was: [email protected]/DOS 6.00 C.
The files backed up by this installation appear intact; an un-install
should be possible.
The BUILD.ID for this installation is:
    -Unknown-
Number of installation starts found for this product is:
3
One or more Un-install events were recorded for this product.
View the SUMLOG file, or Continue ...[V,C]?C
**********************************************************************
Found installation of [email protected]/DOS Version 6.00 Rev C
This installation was an update/upgrade.
The prior product updated/upgraded was: [email protected]/DOS 6.00 B.
The files backed up by this installation appear intact; an un-install
should be possible.
The BUILD.ID for this installation is:
    -Unknown-
Number of installation starts found for this product is:
1
View the SUMLOG file, or Continue ...[V,C]?C
**********************************************************************
Found installation of [email protected]/DOS Version 6.00 Rev B
This installation was an update/upgrade.