Computer Associates International, Inc.

BrightStor® ARCserve® Backup for Mainframe Linux r11.5 SP1 Readme
D01226-2E


1.0 Welcome

2.0 Operating System Support
2.1 Base Product
2.2 Disk Staging Option

3.0 System Requirements
3.1 Base Product
3.2 Disk Staging Option

4.0 Installation Considerations

5.0 General Considerations

6.0 Known Issues

7.0 Documentation Changes

8.0 Documentation

9.0 Contact Customer Support

10.0 BrightStor ARCserve Backup for Mainframe Linux r11.5 Readme
D01226-1E

11.0 Welcome

12.0 Operating System Support for BrightStor ARCserve Backup r11.5
12.1 Hardware Support

13.0 System Requirements for BrightStor ARCserve Backup r11.5
13.1 Advantage Ingres Database
13.2 Device Driver Support
13.3 Browser Support
13.4 Client Agent for Mainframe Linux

14.0 Installation Considerations for BrightStor ARCserve Backup r11.5

15.0 General Considerations for BrightStor ARCserve Backup r11.5
15.1 Advantage Ingres Database

16.0 Known Issues for BrightStor ARCserve Backup r11.5

17.0 Documentation Changes for BrightStor ARCserve Backup r11.5

18.0 Documentation for BrightStor ARCserve Backup r11.5

19.0 Contact Customer Support


1.0 Welcome

Welcome to BrightStor® ARCserve® Backup for Mainframe Linux r11.5 SP1. This Readme file contains important information to help you with your implementation of the product, including installation considerations, operating system information, known issues, and how to contact Computer Associates Customer Support.

This service pack is cumulative, as is this readme. Information related specifically to this service pack has been identified separately from information originally included in the release of BrightStor ARCserve Backup for Mainframe Linux r11.5. For information included in the release of BrightStor ARCserve Backup for Mainframe Linux r11.5, see the sections following the BrightStor ARCserve Backup for Mainframe Linux r11.5 Readme section.


2.0 Operating System Support

The following sections provide information about operating systems support added for this release.

Note: For information released with BrightStor ARCserve Backup for Mainframe Linux r11.5, see the section Operating System Support for BrightStor ARCserve Backup r11.5.


2.1 Base Product

You can run BrightStor ARCserve Backup for Mainframe Linux on the following operating systems:


2.2 Disk Staging Option

You can run the BrightStor® ARCserve® Backup Disk Staging Option on the following operating systems:


3.0 System Requirements

The following sections provide information about the minimum system requirements for BrightStor ARCserve Backup components added for this release.

Note: For information released with BrightStor ARCserve Backup for Mainframe Linux r11.5, see the section System Requirements for BrightStor ARCserve Backup r11.5.


3.1 Base Product

You must have a minimum of 150 MB free disk space on the / file system and 450 MB free disk space on the BrightStor ARCserve Backup installation file system to install BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1.


3.2 Disk Staging Option

The following sections provide the minimum system requirements for the BrightStor ARCserve Backup Disk Staging Option:


4.0 Installation Considerations

The following sections provide information to consider when installing BrightStor ARCserve Backup.

For information originally released with BrightStor ARCserve Backup for Mainframe Linux r11.5 and included in this release of BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, see the section Installation Considerations for BrightStor ARCserve Backup r11.5.


5.0 General Considerations

Note: For information released with BrightStor ARCserve Backup for Mainframe Linux r11.5, see the section General Considerations for BrightStor ARCserve Backup r11.5.


6.0 Known Issues

The following section provides information about issues known to exist in this release of BrightStor ARCserve Backup.

Note: For information released with BrightStor ARCserve Backup for Mainframe Linux r11.5, see the section Known Issues for BrightStor ARCserve Backup r11.5.


7.0 Documentation Changes

For information about changes to the documentation for BrightStor ARCserve Backup for Mainframe Linux r11.5, see the section Documentation Changes for BrightStor ARCserve Backup r11.5.

The following section provides information about items that have not yet been changed in the product documentation for BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, but that affect the information in that documentation:


8.0 Documentation

Each guide in the documentation set has a unique Document Identification (DID) designation that appears on the title page of the guide. The DID consists of six characters that identify the guide, followed by a hyphen, followed by two characters that identify its edition and the language in which it is written. For example, D01223-2E identifies the second edition of the English version of the BrightStor ARCserve Backup for Mainframe Linux 11.5 Release Summary. If a third edition of this guide is published, the DID is incremented to D01223-3E.

The DID appears on the title page of PDF files. The DID without the hyphen also serves as the eight-character file name for PDF files on the product media and on SupportConnect. The DIDs and file names of the BrightStor ARCserve Backup guides are:

Guide Name DID filename
BrightStor ARCserve Backup for Mainframe Linux Release Summary D01223-2E D012232E.PDF
BrightStor ARCserve Backup for Mainframe Linux Getting Started D01224-2E D012242E.PDF
BrightStor ARCserve Backup for Mainframe Linux Administrator Guide D01225-2E D012252E.PDF
Advantage Ingres Embedded Edition Administrator Guide A00229-1E A002291E.PDF
BrightStor ARCserve Backup Client Agents Guide D01165-2E D011652E.PDF

The DID for this readme file appears on a separate line under the readme title. The DID without the hyphen also serves as the readme file name on SupportConnect.

Note: For information about the documentation released with BrightStor ARCserve Backup for Mainframe Linux r11.5, see the section Documentation for BrightStor ARCserve Backup r11.5.


9.0 Contact Customer Support

For online technical assistance and a complete list of locations, primary service hours, and telephone numbers, contact Customer Support at http://ca.com/support.


10.0 BrightStor ARCserve Backup for Mainframe Linux r11.5 Readme
D01226-1E


11.0 Welcome

The following sections provide information originally released with BrightStor ARCserve Backup for Mainframe Linux r11.5 and included in this release of BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1.


12.0 Operating System Support for BrightStor ARCserve Backup r11.5

Note: For information added to BrightStor ARCserve Backup for Mainframe Linux r11.5 and released with BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, see the section Operating System Support.

You can run BrightStor ARCserve Backup on the following operating systems:


12.1 Hardware Support

BrightStor ARCserve Backup supports the following processors in the Linux distribution:

BrightStor ARCserve Backup supports the following tape devices:


Client Agent for Mainframe Linux

You can install the BrightStor® ARCserve® Backup Client Agent for Mainframe Linux on the following platforms:


13.0 System Requirements for BrightStor ARCserve Backup r11.5

Note: For information added to BrightStor ARCserve Backup for Mainframe Linux r11.5 and released with BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, see the section System Requirements.

The following sections provide the minimum system requirements for BrightStor ARCserve Backup and its agents:

In addition, you must have the following installed on your machine:


13.1 Advantage Ingres Database

The Advantage Ingres® Database requires, at minimum, 1,700 MB total free disk space for all Linux platforms, if you install the following on the same file system:

The BrightStor ARCserve Backup for Mainframe Linux installation script provided on the installation media lets you provide an alternate temporary space if /tmp does not have sufficient space.


13.2 Device Driver Support

BrightStor ARCserve Backup supports z/OS device drivers. The device driver must satisfy the following requirements:


13.3 Browser Support

BrightStor ARCserve Backup supports, at minimum, the following browsers:


13.4 Client Agent for Mainframe Linux

The following are the minimum requirements for the Client Agent for Mainframe Linux:


14.0 Installation Considerations for BrightStor ARCserve Backup r11.5

The following section provides information to consider when installing BrightStor ARCserve Backup.

Note: For information to be considered when installing BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, see the section Installation Considerations.


15.0 General Considerations for BrightStor ARCserve Backup r11.5

The following sections provide general information to consider when using BrightStor ARCserve Backup.

Note: For information to be considered when using BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, see the section General Considerations.


15.1 Advantage Ingres Database

The following sections provide general information relating to the Advantage Ingres database used by BrightStor ARCserve Backup.


Extending the Database

You can extend the BrightStor ARCserve Backup internal database to multiple directory locations to allow for growth, if the underlying file system does not support large files (larger than 2 GB) or does not have enough space. Additionally, you can spread the directory locations across multiple disks to improve performance.

Note: If you use Advantage Ingres Version 2.0, you might need to extend the database to circumvent the 2 GB table size limitation. BrightStor ARCserve Backup uses Advantage Ingres Version 2.6, which does not have this limitation.

You can extend the BrightStor ARCserve Backup database during installation or at a later time. The extend_db utility, located in the $BAB_HOME/bin directory, is called automatically by the setup script or manually by the root user if performed after installation. The amount of information in the database dictates the time required by the utility to run.

At the time of the database upgrade, cadbd must be down and Advantage Ingres must be running.

If you are using Advantage Ingres Version 2.0, you must perform additional steps to complete the database extension. If you extend the database during setup, perform this procedure after installation:

  1. Run access_db, located in the $BAB_HOME/bin directory, to invoke an ASCII graphical interface where you can assign the extended locations to the database. Use terminal type VT100.

    To enter a command in the interface, press the ESC key. To move up, press Ctrl+K; to move down, press Ctrl+J.

  2. Choose Select Databases from the menu from each terminal window to complete the process.

  3. Select the Extend option and perform the following steps:

    1. Select ListChoices.

    2. Select an extended directory using Ctrl+J or Ctrl+K from the list and choose Select from the menu.

      Repeat this step until you have assigned all of the extended directories.

    3. Select Save from the menu.

    4. Select End.

    5. Select Quit to exit.

  4. Run extend_dbf, located under the $BAB_HOME/bin directory, to create the data files in the extended directory.

You must complete these steps before you can run extend_db again.


Advantage Ingres Database Recovery Procedures

To recover the BrightStor ARCserve Backup Advantage Ingres database when Advantage Ingres has stopped working entirely, complete the following steps to reinstall Advantage Ingres and restore the latest data available.

Note: If only the BrightStor ARCserve Backup database stored in Advantage Ingres (cadbase) is affected, see the section Recovering cadbase While Advantage Ingres is Running.

  1. Run the cstop command and the stopingres command to stop all processes.

  2. Remove everything from the Advantage Ingres home directory and all extended locations. For example:
    # rm -rf /disc2/ingresii/ingres
    

    Note: You can obtain Advantage Ingres home information from the INGRES_HOME_PATH variable in $BAB_HOME/config/cadbd.cfg or through the symbolic link $BAB_HOME/dbase/ingres. You can obtain any extended location from $BAB_HOME/dbase/extend_db.log.

  3. Perform the following procedure to reinstall Advantage Ingres to the same location:

    1. Run the following command:
      $BAB_HOME/bin/cadbase_setup
      

    2. Extend the database to the same locations.

    3. Run the following command to complete the installation of Advantage Ingres exactly as it was before the disaster:
      access_db
      

  4. Check $BAB_HOME/logs/databaseBackup.log to find the tape and session information you need to perform data recovery.

  5. Create a directory for the restore (for example, /disc1/cadb-restore) and subdirectories for each session (for example, /disc1/cadb-restore/s1).

    Ensure that you have enough space. Create these directories on the file system that originally contained the Advantage Ingres database to reduce the chances of running out of disk space.

  6. Run cstart and use the Restore Manager to restore all of the data sessions (two or more) and the dump session to your restore directory (for example, /disc1/cadb-restore/s1, /disc1/cadb-restore/s2), rather than their original locations. Use the Restore By Media option. Be sure to use the correct session number.

    If you have multiple extended locations, check BrightStor.log and databaseBackup.log to obtain the correct session numbers and restore to the correct directory. This may not be in the order you expect, but the correct order is very important for successful recovery.

  7. Run cstop and execute the following to stop Advantage Ingres:
    $BAB_HOME/sbin/stopingres
    

  8. Change to user ingres.

  9. Copy the dump files from your restore directory to the Advantage Ingres installation directory. For example, if you restored the dump session to /disc1/cadb-restore/s6:
    # cd /disc1/cadb-restore/s6/ingres/dmp
    # cp –r * /disc1/ingresii/ingres/dmp/
    

  10. Remove all files from the data directories in which the iidbdb database data is stored (for example, II_SYSTEM/ingres/data/default/iidbdb) to allow the files to be restored. For example:
    # cd  /disc1/ingresii/ingres/data/default/iidbdb
    # rm –r *
    

  11. Copy the iidbdb database configuration file from the dmp directory to the data directory. For example:
    # cd /disc1/ingresii/ingres/dmp/default/iidbdb
    # cp  aaaaaaaa.cnf /disc1/ingresii/ingres/data/default/iidbdb
    

    Important! If you do not perform this step, you receive an error when you run the cadbutil utility.

  12. Copy the cadbase database configuration file from the dmp directory to the data directory. This should be done only on the first location (for example, $II_SYSTEM/ingres/data/default/cadbase):
    # cd /disc1/ingresii/ingres/dmp/default/cadbase
    # cp  aaaaaaaa.cnf /disc1/ingresii/ingres/data/default/cadbase
    

  13. Exit user ingres.

  14. As the root user, execute the following to start Advantage Ingres:
    $BAB_HOME/sbin/startingres
    

    Note: If you start Advantage Ingres at this point, some processes do not start and generate error messages. These messages are normal at this point and you can safely ignore them. Press the Enter key or Ctrl+C to exit the error messages.

  15. To recover data, change the user to root and run cadbutil to recover iidbdb, as in the following example:
    cadbutil –r iidbdb –c
    

  16. You are prompted for a directory. Provide the directory containing the restored data for the iidbdb session, as in the following example:
    /disc1/cadb-restore/s3/iidbdb/
    

  17. Ensure that the MergeCat and dbclean processes are not running and run cadbutil to recover cadbase, as in the following example:
    cadbutil –r cadbase –c
    

  18. You are prompted for the directory containing the restored cadbase session, as in the following example:
    /disc1/cadb-restore/s4/cadbase/
    

  19. For extended locations for databases, you are prompted for the sessions one by one. Enter the correct directory.

    You have successfully recovered the Advantage Ingres database.

  20. Run stopingres and run cstart to start BrightStor ARCserve Backup. Alternately, you can run startingres to start only Advantage Ingres.


Recovering cadbase While Advantage Ingres Is Running

If only cadbase (the BrightStor ARCserve Backup database stored in Advantage Ingres) was lost or corrupted and if Advantage Ingres is still running, you do not need to reinstall Advantage Ingres. The following procedure restores the cadbase database:

  1. Run the cstop command to stop all processes.

  2. As user ingres, run the following command to destroy the cadbase database:
    # destroydb cadbase –ucadbase
    

    If the destruction of cadbase is unsuccessful, manually remove all cadbase directories from the Advantage Ingres home and all extended locations and run destroydb again. It should be successful.

    Note: You can obtain Advantage Ingres home information from the INGRES_HOME_PATH variable in $BAB_HOME/config/cadbd.cfg, or through the symbolic link $BAB_HOME/dbase/ingres. You can obtain any extended locations from $BAB_HOME/dbase/extend_db.log.

  3. As the root user, run access_db to delete all the previous extended locations, if necessary. To do so, in the access_db window, enter the location, select the extended location, and enter Delete to delete it.

  4. Run $BAB_HOME/bin/cadbase_setup. You are prompted to specify if you want to extend the database. If, in the previous step, the initial attempt to destroy cadbase was successful, answer No.

    If, in the previous step, the initial attempt to destroy cadbase was unsuccessful, answer Yes, and use the same directory and locations as the extended locations.

  5. Run access_db to assign all extended locations.

  6. Run extend_dbf.

  7. Check $BAB_HOME/logs/databaseBackup.log to find the tape and session information for the backed-up database sessions. This information is needed to perform data recovery.

  8. Create a directory for the restore (for example, /disc1/cadb-restore) and subdirectories for each session (for example, /disc1/cadb-restore/s1).

  9. Ensure that you have enough space. To reduce the chances of running out of disk space, create these directories on the file system that originally contained the Advantage Ingres database.

  10. Run cstart.

  11. Use the Restore Manager to restore all the data sessions and the dump session to your restore directory (for example, /disc1/cadb-restore/s1, /disc1/cadb-restore/s2), rather than to their original locations. Use the Restore By Media option. Be sure to use the correct session number.

  12. If you have multiple extended locations, check BrightStor.log and databaseBackup.log to obtain the correct session numbers and restore to the correct directory. This may not be in the order you expect, but the correct order is very important for successful recovery.

  13. Run cstop.

  14. As user ingres, copy the cadbase dmp files from the restore directory to the Advantage Ingres installation directory. For example, if the dump session is restored to /disc1/cadb-restore/s6:
    # cd /disc1/cadb-restore/s6/ingres/dmp/default
    # cp  –r cadbase /disc1/ingresii/ingres/dmp/default
    

  15. Copy the cadbase database configuration file from the dmp directory to the data directory. Do this only on the first location (for example, $II_SYSTEM/ingres/data/default/cadbase):
    # cd /disc1/ingresii/ingres/dmp/default/cadbase
    # cp  aaaaaaaa.cnf /disc1/ingresii/ingres/data/default/cadbase
    

  16. To recover data, change to user root, verify that the MergeCat and dbclean processes are not running, and run cadbutil to recover cadbase, as in the following example:
    cadbutil –r cadbase –c
    

  17. You are prompted for the directory containing the restored cadbase session, as in the following example:
    /disc1/cadb-restore/s4/cadbase/
    

  18. For extended locations for databases, you are prompted for the sessions one by one. Enter the correct directory.

    You have successfully restored the BrightStor ARCserve Backup database.

  19. Run cstart to start BrightStor ARCserve Backup.


Optimizing the Database

To increase the performance of the FIND operation in the Restore Manager, use the optimizeingres utility. The optimizeingres utility calls the Advantage Ingres optimizedb utility on the more critical tables of the database.

WARNING: If the tables contain large amounts of data, the execution of the optimizeingres utility can take a considerable amount of time.

We strongly recommend that you run a minimum of two backups of all client machines for which the BrightStor ARCserve Backup server is responsible before executing the optimizeingres utility for the first time. This gives Advantage Ingres a basis for the type of data you will normally store in the database and allows the utility to update its own statistics about those tables. You should also use the utility whenever a large number of changes in the database have occurred. Changes that occur in the database include, for example, adding new hosts as clients or expiring tapes. There are no arguments to the optimizeingres utility. For example:

$BAB_HOME/bin/optimizeingres

During the installation or configuration of the Advantage Ingres database, you are asked for the size of the transaction log file. The following general guidelines help you decide what size is best for your environment:


16.0 Known Issues for BrightStor ARCserve Backup r11.5

The following section provides information about issues known to exist in this release of BrightStor ARCserve Backup.

Note: For information about issues known to exist in BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, see the section Known Issues.


17.0 Documentation Changes for BrightStor ARCserve Backup r11.5

Updated guides will be available at http://ca.com/support.

Note: For information about changes to the BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1 documentation, see the section Documentation Changes.

The following section provides information about items that have not yet been changed in the product documentation, but that affect the information in that documentation:


18.0 Documentation for BrightStor ARCserve Backup r11.5

Each guide in the documentation set has a unique Document Identification (DID) designation that appears on the title page of the guide. The DID consists of six characters that identify the guide, followed by a hyphen, followed by two characters that identify its edition and the language in which it is written. For example, D01223-1E identifies the first edition of the English version of the BrightStor ARCserve Backup for Mainframe Linux 11.5 Release Summary. When the second edition of this guide is published, the DID is incremented to D01223-2E.

The DID appears on the title page of PDF files. The DID without the hyphen also serves as the eight-character file name for PDF files on the product media and on SupportConnect. The DIDs and file names of the BrightStor ARCserve Backup guides are:

Guide Name DID filename
BrightStor ARCserve Backup for Mainframe Linux Release Summary D01223-1E D012231E.PDF
BrightStor ARCserve Backup for Mainframe Linux Getting Started D01224-1E D012241E.PDF
BrightStor ARCserve Backup for Mainframe Linux Administrator Guide D01225-1E D012251E.PDF
Advantage Ingres Embedded Edition Administrator Guide A00229-1E A002291E.PDF
BrightStor ARCserve Backup Client Agents Guide D01165-1E D011651E.PDF

The DID for this readme file appears on a separate line under the readme title. The DID without the hyphen also serves as the readme file name on SupportConnect.

Note: For information about the documentation released with BrightStor ARCserve Backup for Mainframe Linux r11.5 SP1, see the section Documentation.


19.0 Contact Customer Support

For online technical assistance and a complete list of locations, primary service hours, and telephone numbers, contact Customer Support at http://ca.com/support.


© 2006 Computer Associates International, Inc. All rights reserved.