Release Notes
Product: FileServ® for UNIX® Version 4.4.1
Operating Systems: IRIX® 6.5.6M, 6.5.7M, 6.5.8M, 6.5.9M and 6.5.10M
SPARC™ Solaris™ 7 and 8
Date: October 8, 2001
NOTE:
(1) The operating system must always be run in US_English. (2) FileServ supports the
maintenance (M) version of IRIX 6.5.x, as opposed to the feature (F) version. (3) To
obtain details on supported application server platforms, contact your FileServ sales
representative.
Contents
Page
Topic
Page
Topic
Prerequisites
Before installing FileServ, install the software listed in the table below:
Software
IRIX
Solaris
A valid ANSI C compiler
Perl 5
X
X
-
X
X
X
X
Veritas Vxfs Version 3.3.3 + patch1
®
X
VolServ
FileServ Version 4.4.1—601363 Rev A
Page 1 of 16
Documentation
In addition to the FileServ software, the distribution CD contains the FileServ technical documentation as
®
®
PDF files as well as an Adobe Acrobat Reader. The Reader allows you to view and navigate the
electronic book files yet preserves the page design and graphics from the printed books.
Order Printed Books
To order additional printed books, complete this form and send it to your ADIC Sales Representative:
Version 4.4 Book
Quantity
Version 4.4 Book
Quantity
FileServ Overview, #601341
Installing FileServ, #601342
Command Reference, #601343
Administrative Tasks, #601344
Please print Name:
Company:
Error Messages, #601345
Quick Reference Card, #601346
Complete Set. Contains all 5 books
and one Quick Reference Card.
Address:
Telephone:
Email:
Related Publications
To receive access to the secured site on our home page containing technical product information (Release
request procedure. In return, ADIC will send you instructions and a password.
Supported Drives
FileServ supports the following drives on the specified platforms:
Supported
on IRIX
Supported
on Solaris
Drive Type
Ampex DST 310
Ampex DST 312
See NOTE below.
Yes
No
Fujitsu M8100. Configure this drive as an IBM 3590B1A.
Yes
Yes
Yes
No
HP 2600FX MO
HP 5200EX MO
IBM 3590B1A
Yes
No
Yes
Yes
IBM 3590E1A. Do not configure these drives on an RS-422 port.
IBM 3580 LTO
FileServ Version 4.4.1—601363 Rev A
Page 3 of 16
Supported
on IRIX
Supported
on Solaris
Drive Type
Quantum DLT 4000
Yes
Yes
Quantum DLT 7000. Configure this drive as a DLT 4000.
Quantum DLT 8000. Configure this drive as a DLT 4000.
Sony AIT-1 SDX-300
Sony AIT-2 SDX-500
Yes
Yes
Yes
Yes
Sony GY-10
Sony GY-2120
During initial configuration on VolServ, set these drives up to support
both DTF1 and DTF2 media types.
Storage Technology 4480
Yes
Yes
Storage Technology Timberline 9490-E
Storage Technology 9840
NOTE: To tune the kernel for DST drives, follow the steps below:
Step 1: Login as root.
Step 2: Run systune -i.
Step 3: Enter maxdmasz 513.
Step 4: Enter quit.
Step 5: Reboot the system.
Update sysparm File with Media Capacity
After an initial installation, if you add or change a Sony AIT-2, IBM 3590E1A, Quantum DLT 7000, or
Quantum DLT 8000 drive type, update the system parameters to reflect the new media capacity by
following the steps below:
Step 1.
Step 2.
Log in as root.
Edit the fs_sysparmsfile.
# vi /$FS_HOME/sysparms/fs_sysparms
Step 3.
If you are adding an AIT-2 drive, update the DEF_MED_SPC_AITparameter definition to be as
shown below if you are using 170m tape:
DEF_MED_SPC_AIT=35000000000;
Page 4 of 16
FileServ Version 4.4.1—601363 Rev A
If you are adding an AIT-2 drive, update the DEF_MED_SPC_AITparameter definition to be as
shown below if you are using 230m tape:
DEF_MED_SPC_AIT=50000000000;
If you are adding an 3590E1A drive, update the DEF_MED_SPC_3590 parameter definition to
be as shown below:
DEF_MED_SPC_3590=20000000000;
If you are adding a DLT 7000 drive, update the DEF_MED_SPC_CTIVparameter definition to be
as shown below:
DEF_MED_SPC_CTIV=35000000000;
If you are adding a DLT 8000 drive, update the DEF_MED_SPC_CTIVparameter definition to be
as shown below:
DEF_MED_SPC_CTIV=40000000000;
Step 4.
Save the changes and quit the edit session.
Modify IRIX Kernel for SONY DTF-2 Drive
IRIX only: Update the SGI kernel to be aware of the SONY DTF-2 drive, by following the steps below:
Step 1.
Step 2.
Step 3.
Log in as root.
# su root
Search the scsifile and look for the words “GY-8240.”
# vi /var/sysgen/master.d/scsi
If that text is not found, add the following entry to the file for your drive:
/* SONY GY-8240 drive */
{ SONYGY, TPGY2120, 4, 7, "SONY", "GY-8240", 0, 0, {0, 0, 0, 0},
MTCAN_BSF|MTCAN_BSR|MTCANT_RET|MTCAN_CHKRDY|MTCAN_PREV|
MTCAN_SEEK|MTCAN_APPEND|MTCAN_SILI|MTCAN_VAR|MTCAN_SETSZ|
MTCAN_CHTYPEANY | MTCAN_COMPRESS,
20, 100*60, 10*60, 9*60, 9*60, 16384, 256*1024,
tpsc_default_dens_count, tpsc_default_hwg_dens_names,
tpsc_default_alias_dens_names,
{0}, 0, 0, 0,
0, (u_char *)0 },
FileServ Version 4.4.1—601363 Rev A
Page 5 of 16
Step 4.
Step 5.
Rebuild the kernel.
# autoconfig -f
Reboot the machine.
®
Compatibility with VolServ
FileServ
VolServ
Version 4.4.1
Version 4.4
Version 4.3
Version 4.2
Version 4.1
Version 4.0
Version 5.0
Version 4.1 NOTE: The release numbering scheme has been changed
on VolServ to correlate with the release numbers on FileServ.
Version 3.0
Version 2.3.3
Version 3.5.2
Version 3.5.1
Version 3.5.0
Version 2.3.3
Version 2.3.2
Version 2.3.1
Version 3.4.3
Version 2.3.3
Version 2.3.2
Version 2.3.1
Version 3.4.2
Version 3.4.1
Version 2.3.2
Version 2.3.1
Version 3.4
Version 2.3.1
Page 6 of 16
FileServ Version 4.4.1—601363 Rev A
Operating System Requirements
Patches
NOTE:
ADIC recommends that you install all required Y2K patches for your machine.
Make sure you install all the patches that your vendor recommends for your kernel, operating system,
network, hardware, media, drive type, and storage devices.
Additionally, ADIC requires the patches, filesets, or packages listed below to successfully operate
FileServ. Obtain these patches from the appropriate vendor.
Platform
IRIX 6.5.8f
Patch
Description
SG0004026
Fixes lost read events. Even though the feature release is not officially
supported, if you choose this release you must have this patch.
Solaris 7
Update
Maintenance update.
2107022-04
107587-01
System accounting, (Usr).
Includes nine patches.
Recommended
Patch Cluster
09/02/1999
YEAR 2000 COMPLIANT (CR #237)
When FileServ is running on Y2K-compliant operating systems, including systems with Y2K-compliant
patches, FileServ is Y2K Option 1-compliant. This means that a year is designated as a four-digit number,
for example, 2000. (FileServ has been Y2K-compliant since Version 3.5.)
Operating Issues
fileserv -t -y LEAVES UNWANTED PROCESSES RUNNING (CR #921)
• Running fileserv -t -yunconditionally exits after the number of seconds specified in the
sysparm value configured in the $FS_TERMTIMEOUT_VALUEparameter. After FileServ terminates,
there may be unwanted processes still running. To check for these processes, type the following:
# ps -elf | grep fs_
# ps -elf | grep fsadm
Look for processes that should not be running, and determine which ones need to be terminated.
fsloglevel COMMAND (CR #829)
• The fsloglevelcommand does not affect all log messages. A more reliable method for changing
the logging level is to modify the FS_LOG_LEVELvariable in the $FS_HOME/sysparm/fs_sysparm
file.
FileServ Version 4.4.1—601363 Rev A
Page 7 of 16
fspolicy COMMAND
• Running the fspolicy -w command on a large (greater than 500,000 entries) file system can take
several hours to complete. If the fspolicycommand is unable to store or truncate files, or if the
fspolicycommand is killed or terminates abnormally, run fspolicy-wto rebuild the candidate
files.
GUI PERFORMANCE (CR #296)
• Before running another command in the GUI, select the <Dismiss> button and the remove the Status
Window. Performance problems may occur if this is not done.
Installation and Upgrade Issues
If you are installing FileServ or upgrading an existing FileServ installation, review the following topics to
make sure FileServ is correctly installed. For complete and detailed installation instructions, refer to the
Installing FileServ book.
Topic
Page
Turn off mediadon SGI Platforms
If you install FileServ on an SGI platforms running IRIX 6.5.x, turn off the mediadfor FileServ-managed
storage devices by following the steps below:
Step 1.
Step 2.
Step 3.
Log in as root.
# su root
Edit the mediad.configfile.
# vi /etc/config/mediad.config
Add the following statement for each FileServ-managed storage device:
ignore device device_name
...
ignore device device_name
Page 8 of 16
FileServ Version 4.4.1—601363 Rev A
where:
Option
device_name
Description
Path to the storage device. For example,
/dev/rmt/tps0d6nrv.
Step 4.
Step 5.
Save the changes and quit the edit session.
Stop the mediadprocess.
# mediad -k
Step 6.
Re-start the mediadprocess.
# mediad
Upgrading from FileServ Version 3.4.2 and Later
The Vista Database locking type was modified to use the IP locking mechanism. Therefore, to reinitialize
the transaction activity file, follow the steps below:
Step 1.
Step 2.
Step 3.
Step 4.
Step 5.
Step 6.
Step 7.
Stop FileServ.
Run checkpoint.
Install the latest versions of FileServ.
Run $FS_HOME/util/buildtaf -i.
Execute “D” option.
Quit the program.
Restart FileServ.
Upgrading from FileServ Earlier than Version 3.4.2
Changing to the new Vista Database caused some changes to the database definition (dbd) files in existing
FileServ sites. Therefore, to synchronize the database, follow the steps below:
Step 1.
Step 2.
Step 3.
Step 4.
Stop FileServ.
Run checkDBAllto make sure no errors exist in the FileServ database.
Run checkpoint.
Install the latest version of FileServ.
FileServ Version 4.4.1—601363 Rev A
Page 9 of 16
Step 5.
Change directory to $FS_HOME/internal/fsdband move each file with a .dbdextension to
the same name .dbd.old. There should be one fs1_#.dbdand fs5_#.dbdfile for each file
system managed by FileServ.
cd $FS_HOME/internal/fsdb
mv fileserv2.dbd fileserv2.dbd.old
mv fileserv3.dbd fileserv3.dbd.old
mv fileserv4.dbd fileserv4.dbd.old
mv fs1_4.dbd fs1_4.dbd.old
mv fs5_4.dbd fs5_4.dbd.old
...
Step 6.
Step 7.
Change directory to DDLand modify the fs3.ddl file by changing the 4 “long” references in
mediadir_rec to “a_u32_t”.
If a fs2.ddl.sgifile exists, do the following:
mv fs2.ddl fs2.ddl.old
mv fs2.ddl.sgi fs2.ddl
Step 8.
Step 9.
Run the following commands shown below:
ddlp fs2.ddl
ddlp fs3.ddl
ddlp fs4.ddl
Remove fileserv*.h; move fileserv*.dbd, and change directory:
rm fileserv*.h
mv fileserv*.dbd ..
cd ..
Step 10. Modify the "fs1.ddl" file as follows:
a) Find the "record fileattr_rec {" line
b) Modify the following line from:
char fadmhdl[64]; /* DMIG handle binary data */
to:
char fadmhdl[64][1]; /* DMIG handle binary data */
c) Find the "record dirdb_rec {" line
d) Modify the following line from:
char drdmhdl[64]; /* DMIG handle binary data */
Page 10 of 16
FileServ Version 4.4.1—601363 Rev A
to:
char drdmhdl[64][1]; /* DMIG handle binary data */
Step 11. Get the numbers for both the fileserv5 and fileserv1 databases to be regenerated by using ls
fs1_*.dbd.old. For example, if fs1_4.dbd.oldand fs5_4.dbd.oldare returned the
number is 4. There should be one pair of these files for each file system associated with
FileServ. If the fs5_#.dbd.old file does not exist, make a note and do NOT run the ddlpfor the
fs5.ddl in Step 11 for this number (the fs1_4.dbd should still be run).
Step 12. For each of the numbers obtained above, modify the fs1.ddland fs5.ddlfiles by changing
the number to the current new number. For example, the fs1.ddlfile will have a line similar
to what is shown below:
database fs1_5 {
It should be changed to:
database fs1_4 {
Continue modifying all _5 names to _4(there should be 17 of them for fs1.ddl file and 14
in the fs5.ddl file).
Step 13. Run both ddlp fs1.ddland ddlp fs5.ddlcommands to generate fs1_#.dbd and
fs1_#.dbdfiles. Be sure to skip the fs5_#.dbd files if the corresponding fs5_#.dbd.old file did
not exist in Step 9.
Step 15. Run $FS_HOME/util/buildtaf -i. At the prompt, type D.
Step 16. Start lockmgr: lm_start.
Step 17. Run checkDBAlland validate that no errors exist.
Installing FileServ and AMASS on the Same Platform
Step 1.
If you have FileServ and AMASS on the same platform, start the FileServ processes before
the AMASS processes (CR #1780).
Step 2.
If the autostart scripts are enabled for both FileServ and AMASS, run the FileServ
autostartscript before the AMASS autostartscript. To accomplish this, assign a name to
the FileServ autostartscript so it will start before the AMASS autostartscript. An
example of the FileServ and AMASS autostartscript names in the /etc/rc2.ddirectory is
shown below. In the example, the S95fileservscript will execute before the S99amass
script.
lrwxrwxr-x 1 root sys 25 Jan 16 08:58 S95fileserv -> /etc/init.d/auto_fileserv
lrwxrwxr-x 1 root sys 25 Jan 16 08:58l S99amass -> /etc/init.d/amass
FileServ Version 4.4.1—601363 Rev A
Page 11 of 16
Contents of Version 4.4
OPERATING SYSTEMS
®
• IRIX 6.5.6M, 6.5.7M, 6.5.8M, 6.5.9M and 6.5.10M
• SPARC™ Solaris™ 7 and 8
FIXED PROBLEMS
The following table lists fixed problems:
Operating
System
Problem
Number
Description of Problems Fixed in Version 4.4
All
All
All
All
All
All
All
539
541
543
544
545
546
547
The fsmedcopy command fails for some clustered tapes.
Cannot send a recover command to DTF drives with fs_scsi.
Return codes need to be MRS codes.
Overwrite occurs if clustering is enabled and unexpected EOT is hit.
Changes to decrease memory usage.
Space recalculation is not correct when EOT is hit.
A core dump occurs if open fails for fs_dump.file
Page 12 of 16
FileServ Version 4.4.1—601363 Rev A
Contents of Version 4.3
OPERATING SYSTEMS
®
• IRIX 6.2, 6.5.4M, 6.5.5M, 6.5.6M, and 6.5.10M
• SPARC™ Solaris™ 2.6, 7, and 8
NEW DRIVE SUPPORT
• Additional drives supported by this release of FileServ include the following:
- IBM 3580 LTO - Solaris only until supported by IRIX tpsc device driver
MAXIMUM NUMBER OF TAPE COPIES RAISED(#493)
• The maximum number of tape copies for a file has been raised to four.
FILESTEERING BY DRIVEPOOL(#517)
• The capability to specify which drives are used in making individual tape copies has been added to
the filesteering filesize.config file. This capability allows a user with multiple archives to steer where
different tape copies are made. This can be accomplished by creating different storage drivepools for
each archive and then specifing the drivepool to be used for each copy in the filesize.config file.
FIXED PROBLEMS
- The following table lists fixed problems:
Operating
System
Problem
Number
Description of Problems Fixed in Version 4.3
Install Script - Change default syslog to 5
All
All
393
439
456
486
487
488
489
490
491
492
495
496
497
498
The fs_bld_maplist script fails on upgrade & not run on install
fileserv started as fsadm does not produce cores
Cannot map filesystem due to buffer size
All
Solaris
IRIX
All
Block reservation is lost after mount
File create and immediate rename leaves it unassociated
Fix memory leaks
All
All
fs_dump command can fail if a file is removed while it is running
Fix auto_fileserv to work with root shell of sh
Add a check for DST to verify position
All
IRIX
All
Crtl-C during a fsretrieve while mo is flipping causes crash
DTF/DTF2 fs_sysparm Comment Wrong
All
All
fs_copyman not intializing move requests properly
Memory overwrite in scsi code when using scsi pass through device
All
FileServ Version 4.4.1—601363 Rev A
Page 13 of 16
Operating
System
Problem
Number
Description of Problems Fixed in Version 4.3
Policy will trashcan file if db valid tape != disk
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
499
500
503
504
505
506
508
509
510
511
512
513
514
516
518
519
520
521
524
525
531
532
Checkpoint tar command needs to follow links
Mapping has /fs link hardcoded instead of using $FS_HOME
fs_dump fails if mount point not at root
fsckp script doesn’t handle /mnt/vol05 mntpt
fspolicy not initializing hash lists
Change fs_bld_maplist to space out fs_map_dir
Add logfile to newfslog script
mda2 perf point causes fs_slave core on bmap
A Crtl-C causes fs_map_dir to core
Fix additional memory leaks
For DTF drives check sense for "recover" status and perform auto recover
Update install manual errors
fsup Alias Need To Be Modified for fslock3
During install the fsvsinstall fails with a syntax error
fsmederr man page out of date
Verification of drive type names is incorrect
fsrecover fails - fd leak, mem alignment problems
fs_cron_template needs to be updated
Install Script - Mapping directory not explained
Add check for were perl is installed
Wrong makefile included for api examples
Page 14 of 16
FileServ Version 4.4.1—601363 Rev A
Previous FileServ Releases
For information about previous features and fixes to the base software code, refer to prior “Release
Notes.” These Notes:
• Or, contact your FileServ sales representative.
Scheduled for Retirement
For a detailed list of operating systems and drives scheduled to be removed from future releases, refer to
the list of “Discontinued Devices” available from your FileServ sales representative. Customers should
plan to accommodate changes by the stated discontinued date.
FileServ Version 4.4.1—601363 Rev A
Page 15 of 16
Copyright
2000, 2001 by ADIC, Advanced Digital Information Corporation. All rights reserved. ADIC, AMASS, CentraVision, DataMgr, EMASS, FileServ, and
VolServ are either trademarks or registered trademarks of ADIC. All other brand or product names are trademarks or registered trademarks of their respective
Software publications: [email protected], Technical support: [email protected].
Page 16 of 16
FileServ Version 4.4.1—601363 Rev A
|