Opensave Agent For Gcos On Xta

Transcript

File and Volume Management REFERENCE 77 A2 00EL 01 DPS7000/XTA NOVASCALE 7000 OpenSave Agent for GCOS on XTA DPS7000/XTA NOVASCALE 7000 OpenSave Agent for GCOS on XTA File and Volume Management March 2006 BULL CEDOC 357 AVENUE PATTON B.P.20845 49008 ANGERS CEDEX 01 FRANCE REFERENCE 77 A2 00EL 01 The following copyright notice protects this book under Copyright laws which prohibit such actions as, but not limited to, copying, distributing, modifying, and making derivative works. Copyright Bull SAS, 2006 Printed in France Suggestions and criticisms concerning the form, content, and presentation of this book are invited. A form is provided at the end of this book for this purpose. To order additional copies of this book or other Bull Technical Publications, you are invited to use the Ordering Form also provided at the end of this book. Trademarks and Acknowledgements We acknowledge the right of proprietors of trademarks mentioned in this book. Intel® and Itanium® are registered trademarks of Intel Corporation. Windows® and Microsoft® software are registered trademarks of Microsoft Corporation. UNIX® is a registered trademark in the United States of America and other countries licensed exclusively through the Open Group. Linux® is a registered trademark of Linus Torvalds. The information in this document is subject to change without notice. Bull will not be liable for errors contained herein, or for incidental or consequential damages in connection with the use of this material. Preface Preface Scope and Objectives This guide is a supplement to the OpenSave Administrator and User Guides. It is essential to read these guides first. The purpose of this document is to act as a guide for using the OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume. Two types of Agent exist. The basic OpenSave Backup Agent for GCOS7 allows to view, backup and restore all types of GCOS7 files on DPS7000 XTA or NS7000 catalogued : - In an auto-attachable catalog or - In the "site.catalog" or - In the "sys.catalog" This document (REV01) describes the second version of this Agent. The complementary OpenSave Backup Agent for GCOS7 Volume allows to view and backup disk volumes, and to restore whole volumes or some files only (CAT or UNCAT, but mono-volume only). On an open system network, files for different systems (Unix, W2K, GCOS7, …) often coexist. With DPS7000 XTA or NS7000, GCOS7 and W2K files coexist on the same machine. These files (or volumes) were previously backed up using different tools and a different cartridge drive was dedicated to each type of backup. 77 A2 00EL iii OpenSave Backup Agent for GCOS7/XTA or NS7000 With OpenSave, the same tool can be used to back up all files (or volumes), using the same cartridge drive. There is a dedicated OpenSave server and specific Agents are installed on the machines whose files (or volumes) are to be backed up. Structure Chapter 1: Architecture This chapter presents the architecture and software components essential to the smooth running of Opensave Backup for GCOS7/XTA or NS7000. Chapter 2: Installing OpenSave This chapter explains how to install OpenSave on a DPS7000 XTA or NS7000 server. Chapter 3: Operability This chapter describes operability through OpenSave's graphical interfaces. Chapter 4: Help with Diagnostics This chapter explains which tools to use and the information to be supplied in order to diagnose problems. Bibliography OpenSave Administrator’s Guide 86 A2 23EM OpenSave User’s Guide 86 A2 24EM INTEROP7 User’s GUIDE 47 A2 91US ASM7 File Migration Administrator’s Guide 47 A2 51 US V7000 Operator’s Guide 47 A2 74US V7000 Configuration and Maintenance Guide 47 A2 77US Data Management Utilities User's Guide 47 A2 34UF File Recovery Facilities User's Guide 47 A2 37UF OpenSave Backup Agent for GCOS7/XTA User's Guide 77 A2 00EL REV00 iv 77 A2 00EL Preface Table of Contents 1. Architecture 1.1 Global Architecture.......................................................................................................... 1-1 1.2 Schematic Showing OpenSave with an Optimized XTA or NS7000 Connection ........... 1-2 1.3 Architecture of the GCOS7/XTA or NS7000 Agent......................................................... 1-3 1.3.1 Introduction ........................................................................................................ 1-3 1.3.2 The ARS Service Job......................................................................................... 1-3 1.3.3 The OpenSave Backup Agents for GCOS7....................................................... 1-4 1.4 Schematic of the GCOS7 Agent on XTA or NS7000 ...................................................... 1-5 1.5 List of Media and Software Components ........................................................................ 1-6 2. Installing OpenSave 2.1 Installations on the OpenSave Server................................................................................ 1 2.2 Installations on the DPS7000 XTA or NS7000 Server ....................................................... 1 3. Operability 3.1 Introduction...................................................................................................................... 3-1 3.2 Viewing Files or Volumes ................................................................................................ 3-2 3.2.1 Special Features of the OpenSave Backup Agent for GCOS7 ......................... 3-2 3.2.2 Special Features of the OpenSave Backup Agent for GCOS7 Volume ............ 3-3 3.3 Backing up Files or Volumes........................................................................................... 3-3 3.3.1 Special Features of the OpenSave Backup Agent for GCOS7 ......................... 3-4 3.3.2 Special Features of the OpenSave Backup Agent for GCOS7 Volume ............ 3-5 3.3.3 Executing a JCL Command ............................................................................... 3-6 3.4 Restoring Files or Volumes ............................................................................................. 3-6 3.4.1 Special Features of the OpenSave Backup Agent for GCOS7 ......................... 3-6 3.4.2 Special Features of the OpenSave Backup Agent for GCOS7 Volume ............ 3-8 77 A2 00EL v OpenSave Backup Agent for GCOS7/XTA or NS7000 4. Help with Diagnostics vi 4.1 What to do if you encounter problems? .......................................................................... 4-1 4.2 Messages sent to the GCOS7 operator console ............................................................ 4-2 4.2.1 OpenSave startup problems .............................................................................. 4-2 4.2.2 Problems Running OpenSave ........................................................................... 4-2 4.2.3 DARS ARS status .............................................................................................. 4-3 4.3 Messages sent to the OpenSave graphic inteface ......................................................... 4-4 4.3.1 GCOS7 return code ........................................................................................... 4-4 4.3.2 Erroneous restore parameters ........................................................................... 4-6 4.4 Tools used to record events ............................................................................................ 4-7 4.4.1 Event Viewer ...................................................................................................... 4-7 4.4.2 Trace Manager................................................................................................... 4-8 77 A2 00EL Preface Table of Graphics Figures Figure 1-1 : Schematic Showing OpenSave with an Optimized XTA or NS7000 Connection .. 1-2 Figure 1-2 : Schematic of the GCOS7 Agent on DPS7000 XTA or NS7000 ............................ 1-5 77 A2 00EL vii OpenSave Backup Agent for GCOS7/XTA or NS7000 viii 77 A2 00EL Architecture 1. Architecture 1.1 Global Architecture OpenSave is a client-server application for networks. OpenSave has several components: • The OpenSave Backup (OSBSRV) server. This must be installed on a server (UNIX or WINDOWS) other than the DPS7000 XTA or NS7000. • One library manager (OSLLIB) for each library to be managed. This must be installed on the machine managing the library (which is generally the OpenSave Backup server). • An Agent. For all file (or volume) backup and restore operations on the target machine, OpenSave calls a program installed on the machine and specializing in the type of files in question. On a DPS7000 XTA or NS7000 server, this program, called “OpenSave Backup Agent for GCOS7” or “OpenSave Backup Agent for GCOS7 Volume” must be installed on the Windows part of DPS7000 XTA or NS7000. • The OpenSave Peripheral Access Service (OSPAS) server. This server interfaces with various peripherals to transfer data. − The OSPAS is installed on the library management machine. A LAN is used to transfer data between the OpenSave Backup Agent for GCOS7 or the OpenSave Backup Agent for GCOS7 Volume and the OSPAS. − For increased performance, the OSPAS may also be installed on the same machine as the OpenSave Backup Agent for GCOS7 or the OpenSave Backup Agent for GCOS7 Volume, i.e. on the DPS7000 XTA or NS7000 server. In this case, data is transferred directly with peripherals connected to the DPS7000 XTA or NS7000 server. • The OpenSave Graphical Interface (XOSB). It may be installed on a local or remote work station. When you start it up, a connection window to the OpenSave server is displayed. 77 A2 00EL 1-1 OpenSave Backup Agent for GCOS7/XTA or NS7000 1.2 Schematic Showing OpenSave with an Optimized XTA or NS7000 Connection DPS7000 XTA or NS7000 server whose data is to be backed up OpenSave Server Library / Drives OSPAS OSLLI OpenSave Backup Agent for GCOS7 OSBSRV Data path XOSB Control path Figure 1-1 : Schematic Showing OpenSave with an Optimized XTA or NS7000 Connection 1-2 77 A2 00EL Architecture 1.3 Architecture of the GCOS7/XTA or NS7000 Agent 1.3.1 Introduction The Agent used to view, backup and restore catalogued GCOS7 files (or volumes) on DPS7000 XTA or NS7000 is a client-server type application. The server is the GCOS7 ARS Service Job modified to support OpenSave, the client is the OpenSave Backup Agent for GCOS7 or the OpenSave Backup Agent for GCOS7 Volume running under Windows. Communication between Windows and GCOS7 is based on the TCP/IP socket protocol in connected mode. This requires the presence of Interop7_basic on the DPS7000 XTA or NS7000 server. 1.3.2 The ARS Service Job ARS is a GCOS7 service job. • ARS starts up automatically when GCOS7 starts up in class S. • It runs under SYSADMIN. • It can be started up and terminated by the following commands: START_ARS (SARS) and TERMINATE_ARS (TARS). • The functionalities of the ARS service job, described in the ASM7 File Migration Administrator’s Guide, remain unchanged. • The ARS service job has been enhanced by two interfaces to meet the needs of OpenSave : • A TCP/IP socket interface that enables it to communicate with the OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume client(s). • An interface with the GCOS7 catalog and the FILSAVE and FILREST (or VOLSAVE, VOLREST and FILREST) utilities. • ARS listens on a port predefined in file etc/services (see section 3.2 Installations on the DPS7000 XTA or NS7000 server). • ARS launches class P Jobs (OPSV) to handle backups or restores of GCOS7 files or volumes. 77 A2 00EL 1-3 OpenSave Backup Agent for GCOS7/XTA or NS7000 1.3.3 The OpenSave Backup Agents for GCOS7 The OpenSave Backup Agent for GCOS7 and the OpenSave Backup Agent for GCOS7 Volume are Windows services. • A DPS7000 XTA or NS7000 server may have several occurrences of these agents. • At least one OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume must be enabled on the DPS7000 XTA or NS7000 server. • It must be connected to an OpenSave server. • The Windows Agent manager lets you view and define the parameters of each Agent (connection, automatic startup). (See the OpenSave Administrator's Guide). • If you want to carry out backup and restore actions in parallel, at least two Agents must be enabled. OpenSave Backup Agent for GCOS7 and OpenSave Backup Agent for GCOS7 Volume can be used simultaneously. The maximum number of agents is six. 1-4 77 A2 00EL Architecture 1.4 Schematic of the GCOS7 Agent on XTA or NS7000 DPS7000 XTA or NS7000 Server GCOS7 W2K ARS OpenSave Backup Agent for GCOS7 Service Job V ACCES TO CATALOG AND TO FILSAVE & FILREST UTILITIES 7 0 0 OPSV : 0 Spawned Data path Control path For OpenSave Backup Agent for GCOS7 Volume, VOLSAVE, VOLREST and FILREST utilities are used instead of FILSAVE and FILREST. Figure 1-2 : Schematic of the GCOS7 Agent on DPS7000 XTA or NS7000 77 A2 00EL 1-5 OpenSave Backup Agent for GCOS7/XTA or NS7000 1.5 List of Media and Software Components The MEDIA required for using the OpenSave Backup Agent for GCOS7 (second version) and OpenSave Backup Agent for GCOS7 Volume are : • An OpenSave CD - version 3.13.4 or above • A V7000 CD - version V4.11 or above • An Interop7 CD • With GCOS7 V10 TS 9920, a GCOS7 CD "GCOS7 OpenSave access to Files and Volumes". This CD will not be necessary with the TS9930 GCOS7 technical update. 1-6 77 A2 00EL Installing OpenSave 2. Installing OpenSave 2.1 Installations on the OpenSave Server • On the OpenSave server, you will need to install the OpenSave Backup (OSBSRV) server, the library manager (OSLLIB) and the peripherals manager (OSPAS). • Identify yourself as "root" for Unix or "administrator" for Windows and follow the installation procedures in the tools directory on the CD shipped by OpenSave (OS_Inst_Server.pdf and OS_Inst_Library.pdf). 2.2 Installations on the DPS7000 XTA or NS7000 Server • On the DPS7000 XTA or NS7000 server, you will need to install the OpenSave Backup Agent for GCOS7 and/or the OpenSave Backup Agent for GCOS7 Volume and maybe also the peripherals manager (OSPAS). • The OpenSave Backup Agent for GCOS7 can only be used if MI UTSD029 is installed on the DPS7000 XTA or NS7000 server. The OpenSave Backup Agent for GCOS7 Volume can only be used if MI UTSD030 is installed on the DPS7000 XTA or NS7000 server. This is checked by the ARS Load Module. • Add ARSServices to the etc/services file. • In directory C:\WINDOWS\system32\drivers\etc edit the services text file and add the following line: ARSServices 7153/tcp #Remote ARS Server • Port 7153 is given as an example. It can be replaced by another number as long as another service is not using it. • Make sure that Interop7 is present on the machine and that the Sockg7_std server has been started up: Start MenuÆProgramsÆV7000ÆInterop7ÆAdministration Servers 77 A2 00EL 1 OpenSave Backup Agent for GCOS7/XTA or NS7000 Select Interop7_Basic. The Sockg7_Std server must be running. • Make sure ARS is running: On a GCOS7 console at S: Type DARS (Display ARS) otherwise start it using the SARS command. • Make sure that the level of Class P multiprogramming is sufficient (depending on the number of OpenSave Backup Agent for GCOS7 and OpenSave Backup Agent for GCOS7 Volume agents that you want to use). On a GCOS7 console at S: Type DLD OPTION = CLASS SELECT=P and modify it with command MDLD if necessary. • Note: If the MI UTSD029 is not present, or if ARSServices has not been placed in the etc/services file, or if Sockg7_std is not running, ARS starts with its old functionalities and without the new ones enabling it to use the OpenSave Backup Agent for GCOS7. • From version 3.11.6.5 (V4C) onwards, OpenSave Backup Agent for GCOS7 is on the OpenSave CD. • Identify yourself as the administrator and use the OpenSave Configurator to install and start the desired services named Backup Agent for GCOS7 and Backup Agent for GCOS7 Volume. • When a new version of V7000 is activated by Version Manager, any OpenSave Backup Agents for GCOS7 or OpenSave Backup Agents for GCOS7 Volume that are active will be stopped and restarted. If none of the OpenSave Backup Agents for GCOS7 nor OpenSave Backup Agents for GCOS7 Volume are active, Version Manager will start up one OpenSave Backup Agent for GCOS7 (or if none one OpenSave Backup Agents for GCOS7 Volume). The others can be started up manually if required. Note: The graphical interface can be installed on a remote client of the OpenSave server (see the OpenSave Administrator’s Guide, reference 86 A2 23EM). 2 77 A2 00EL 3. Operability 3.1 Introduction OpenSave Backup Agent for GCOS7 is used to view, backup and restore all types of GCOS7 files catalogued in an auto-attachable catalog or in the "site.catalog" or in the “sys.catalog”. OpenSave Backup Agent for GCOS7 Volume is used to view and backup disk volumes, and restore either whole volumes or some files only (CAT or UNCAT, but mono-volume only). Files saved by an Agent of a given type cannot be restored by an Agent of the other type. You must ensure that at least one OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume is enabled on the DPS7000 XTA or NS7000 server and that it is connected to an OpenSave server. (See Chapter "Agent-Server Connections" in the OpenSave Administrator's Guide). OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume is used via the intermediary of the OpenSave graphical interface (XOSB). It may be installed on a remote work station. (see Chapter "Getting Started" in the OpenSave Administrator's Guide for a description of the following windows). The main window of the graphical interface has six buttons. The special features of OpenSave Backup Agent for GCOS7 and OpenSave Backup Agent for GCOS7 Volume for the Network Backup settings and Restore buttons are described below. 77 A2 00EL 3-1 OpenSave Backup Agent for GCOS/XTA or NS7000 3.2 Viewing Files or Volumes The Network button displays all the Agents connected to any OpenSave server. (For more details about the icons, see Chapter "Objects and functionality of the graphical interface" in the OpenSave Administrator's Guide). 3.2.1 Special Features of the OpenSave Backup Agent for GCOS7 Using the OpenSave graphical interface, the Agent displays the tree structure of the GCOS7 catalogued file system in a similar way to a Windows browser. In the left window, clicking [+] next to G7-ServerName (V7000) expands: • The left window, to display all the (first level) parent objects contained in the root directory, which is the GCOS7 "site.catalog" and "sys.catalog". • The right window, to display the objects and files contained in this same root directory. The parent objects that are GCOS7 directories are represented by the Directory icon. The parent objects that are GCOS7 generation groups are represented by the Non detailed parent object icon. In the left window, clicking [+] next to the Directory icon expands: • The left window, to display all the (first level) parent objects contained in the directory, which is the GCOS7 directory. • The right window, to display the files contained in this same directory. In the left window, clicking [+] next to the Non detailed parent object icon expands: • The left window, but nothing is displayed under the parent which is a GCOS7 generation group. • The right window, to display the generation files contained in this same "generation group" directory. Files are represented by the File icon. 3-2 77 A2 00EL Operability Right-clicking an object gives information about the object. • The information given about a parent object are its name and type. (type = directory for a GCOS7 directory, type = parent for a GCOS7 generation group). • The information given about a file object are its name, type and the date it was last modified. (type = file for all GCOS7 file types). Note: Clicking the purple arrow located top right displays the tree structure in two panels (as described above), with the parents to the left and the children to the right, or in a single panel with all objects contained in one main window. 3.2.2 Special Features of the OpenSave Backup Agent for GCOS7 Volume Using the OpenSave graphical interface, the Agent displays the list of disk volumes that are for GCOS7 IN, READY and STANDARD. Files contained in these volumes are not shown. 3.3 Backing up Files or Volumes The Backup settings button is used to program backup tasks by defining backup units and the schedule. A backup task is called a Job in the OpenSave graphical interface. A Job may contain one or more backup units (called Save Units). A Save Unit is a selection of files to be backed up. All backup operations and the tracking of backup operations are described in the chapters Defining Backup Tasks and Running Backup Operations in the OpenSave Administrator's Guide. 77 A2 00EL 3-3 OpenSave Backup Agent for GCOS/XTA or NS7000 3.3.1 Special Features of the OpenSave Backup Agent for GCOS7 The Agent can be used to back up all GCOS7 files shown in the view of the GCOS7 file system described above (section 4.2). The Agent uses the GCOS7 FILSAVE utility but data to be backed up is sent to OpenSave that writes it to a tape in a format unique to OpenSave. These tapes can only be used by OpenSave. Interrupted backups Caution!!! Within a Save Unit, if the backup of a particular file is interrupted, none of the backups for this unit will be valid. From the graphical interface, it is very easy to exclude (red icon) the files that pose a problem, in this case they will not be included in the files to be backed up and the Save Unit will be consolidated. The green Square icon in front of a file indicates that the file will be backed up (default option). Clicking this icon changes it to red and excludes the file from the backup. If a file protected by After Journal was backed up before interruption, its last save date recorded in the SYS.JADIR was modified, but does not correspond to a valid backup. It is important to launch a new backup as soon as possible. If the file is lost before this new backup, the situation is similar to what happens, with classical backups, when the tape containing the last backup is nor readable : restart from an older backup is necessary. This leads to a file restoration followed by the use of ROLLFWD utility with the BEGDATE parameter containing the date of the used backup. For more details, see the GCOS7 File Recovery Facilities User's Guide. "BUSY" files Note that the preceding does not apply to files that cannot be backed up because they are being used in a way not compatible with a backup operation (this leads to a "BUSY" return code). These files are not backed up, but the other files in the Save Unit are properly backed up. To back up these "BUSY" files, it is necessary to launch a backup again when there are no more used. 3-4 77 A2 00EL Operability Warm Mode OpenSave's Warm Mode can be used to save a consistent saved image of shareable UFAS and IDS/II files even if here are concurrent modifying processes, by calling the GCOS7 DYNSAVE utility. For other files, use of FILSAVE or DYNSAVE (OpenSave's Warm mode or not) is equivalent (but OpenSave warnings appear with Warm mode). In the Save Unit, select the Advanced tab to modify the Warm mode parameter ("disabled" is the default value). Caution!!! After a restore, a Rollforward using the After Journal is mandatory (for more details, see the "FILSAVE and DYNSAVE" chapter in GCOS7 Data Management Utilities User's Guide). If the GCOS7 After Journal is missing, it will not be possible to apply the After image and the backup will be incoherent. 3.3.2 Special Features of the OpenSave Backup Agent for GCOS7 Volume The Agent can be used to back up disk volumes that are for GCOS7 IN, READY and STANDARD. The Agent uses the GCOS7 VOLSAVE utility but data to be backed up is sent to OpenSave that writes it to a tape in a format unique to OpenSave. These tapes can only be used by OpenSave. OpenSave incremental save functionality cannot be used. Interrupted backups If the backup of a volume is interrupted, there is no partial valid backup. Warm Mode OpenSave's Warm Mode can be used to save a volume without exclusive volume access, by calling the GCOS7 VOLSAVE utility with the DIRTY option. In this way, the save operation can have concurrent file modifications without any system protection and save file integrity is the user's responsibility. 77 A2 00EL 3-5 OpenSave Backup Agent for GCOS/XTA or NS7000 3.3.3 Executing a JCL Command Select the Advanced tab in the Save Unit window to display a window where you can write a command to be executed before or after the backup. This can be any JCL instruction including EXDIR used to run directives. This instruction is included in a class P OPSV_COM job. This job creates a JOR. Note: There is no synchronization between the execution of this command and that of the backup, i.e. the backup does not wait for the end (or even the beginning) of the command's execution to start. Also, selecting the "abort on failure" field is only taken into account if an internal error occurs. Do not forget to set the "Time-out" field to a different value to the 0 default (otherwise the command will have no effect). Any value may be used (the value is ignored as long as it is not 0). 3.4 Restoring Files or Volumes Use the Restore button to run a restore in interactive mode. To access the data you want to restore, you must: • Select a Save Unit from the list. • Select the files (or volumes) to be restored from the backups in this Save Unit. • It is possible to restore a file or volume to a location different to the location from which it was backed up, with a different name, or with a different catalog characteristic. • Restored catalogued files can be only catalogued in an auto-attachable catalog, or in the "site.catalog" or in the "sys.catalog". All restore operations and the tracking of backup operations are described in the chapter Running and Tracking Restore Operations in the OpenSave Administrator's Guide. 3.4.1 Special Features of the OpenSave Backup Agent for GCOS7 The Agent restores GCOS7 files backed up using OpenSave Backup Agent for GCOS7, as described in section 3.3. The Agent uses the GCOS7 FILREST utility but the data to be restored is retrieved via OpenSave. 3-6 77 A2 00EL Operability In the OpenSave graphical interface, you must enter a user name and password to check that you have access rights to perform a restore. The user name is a GCOS7 user, it must be in upper case (e.g. SYSADMIN). It may be associated with a GCOS7 project, in this case it will be in the form NAME!PROJECT. You can specify a new destination for the file you want to restore. But before you must specify the origin. The operations are described in the chapters Choice of origin and Choice of destination in the OpenSave User's Guide. After the origin has been specified, check the Set destination box in the "Restore files from" window and enter the path in the Path field in the following format (apart from this initial "/", the "/" character can be replaced by the "." character) : Do not forget the initial "/", because OpenSave takes the path into account from the first "/". • /DIR1/…/DIRn/FILE1[$CAT With the GCOS7 directory and file names. • /$VOL1…$VOLn/DIR1/FILE1[$CAT | $UNCAT] $CAT or $UNCAT asks for cataloguing or not the restored file in the CGOS7 catalog. If neither $CAT nor $UNCAT is specified, the default value is CAT. If the catalogued restored file does not exist, and for UNCAT files, you must enter the volumes where you want to create this file at the start of the Path field. The maximum number of volumes is 10. The name of the volume must be preceded by the "$" character. You do not need to enter the disk type, as FSA is the only disk on the DPS7000 XTA or NS7000 server. Caution ! It is possible to use OpenSave to recreate a file that had disappeared (or to create a new file). However, if it is the representation of an entire directory that has disappeared (or if you want to create a new directory), you must recreate or create the directories under GCOS7, using the normal catalog management commands, before restoring the file. 77 A2 00EL 3-7 OpenSave Backup Agent for GCOS/XTA or NS7000 • /$$[Volsetname | DFLT]/ DIR1/FILE1[$CAT] You can use VOLSET. At the start of the Path field, the VOLSET name must be preceded by two "$$" characters. $UNCAT is not allowed because GCOS7 does not support VOLSET with UNCAT volumes. • /[$VOL1..$VOLn /]DIR1/../DIRn/GENER*G0001[$CAT | $UNCAT] or /[$VOL1..$VOLn /]DIR1/../DIRn/GENER/GENER*G0001[$CAT | $UNCAT] For a generation file. For compatibility reason, it is possible to insert the name of the "generation group", as if it were a directory, between the last directory and the file name. 3.4.2 Special Features of the OpenSave Backup Agent for GCOS7 Volume The Agent restores GCOS7 disk volumes backed up using OpenSave Backup Agent for GCOS7, as described in section 3.3, or some files only. Clicking [+] next to a volume name shows all files present on this volume (in one click : there is no tree structure). If you want to restore the whole volume, select the volume name (none of the files of the volume can be excluded). If you want to restore some files only, select the file names : you can select files that can be properly restored only (you cannot select parts of multi-volumes files, temporary files, of special files such as VTOC). These files have $CAT or $UNCAT added to their file name. All catalogued mono-volume files are shown with $CAT and can be restored, but files catalogued in a non auto-attachable catalog (different from the "site.catalog" and the "sys.catalog") cannot be restored if a proper new destination is not given. The Agent uses the GCOS7 VOLREST or FILREST utility but the data to be restored is retrieved via OpenSave. In the OpenSave graphical interface, you must enter a user name and password to check that you have access rights to perform a restore. The user name is a GCOS7 user, it must be in upper case (e.g. SYSADMIN). It may be associated with a GCOS7 project, in this case it will be in the form NAME!PROJECT. You can specify a new destination for the volume or file you want to restore. But before you must specify the origin. 3-8 77 A2 00EL Operability The operations are described in the chapters Choice of origin and Choice of destination in the OpenSave User's Guide. After the origin has been specified, check the Set destination box in the "Restore files from" window and enter the path in the Path field in the following format (apart from this initial "/", the "/" character can be replaced by the "." character) : Do not forget the initial "/", because OpenSave takes the path into account from the first "/". • /$VOL1 To restore a whole volume on a volume with a different name. • /DIR1/…/DIRn/FILE1[$CAT | $UNCAT With the GCOS7 directory and file names. $CAT or $UNCAT asks for cataloguing or not the restored file in the CGOS7 catalog. If neither $CAT nor $UNCAT is specified, the default value is CAT. If the destination file is not an existing catalogued file, the volume that contained the saved file is used. • /$VOL1…$VOLn/DIR1/FILE1[$CAT | $UNCAT] If the catalogued restored file does not exist, and for UNCAT files, you can enter the volumes where you want to create this file at the start of the Path field. The maximum number of volumes is 10. For catalogued restored files, if a volume name is specified and if a file with the same name already exists, the request is rejected. No check is performed for UNCAT files. The name of the volume must be preceded by the "$" character. You do not need to enter the disk type, as FSA is the only disk on the DPS7000 XTA or NS7000 server. • /$$[Volsetname | DFLT]/ DIR1/FILE1[$CAT] You can use VOLSET. At the start of the Path field, the VOLSET name must be preceded by two "$$" characters. $UNCAT is not allowed because GCOS7 does not support VOLSET with UNCAT volumes. 77 A2 00EL 3-9 OpenSave Backup Agent for GCOS/XTA or NS7000 • /[$VOL1..$VOLn /]DIR1/../DIRn/GENER*G0001[$CAT | $UNCAT] or /[$VOL1..$VOLn /]DIR1/../DIRn/GENER/GENER*G0001[$CAT | $UNCAT] For a generation file. For compatibility reason, it is possible to insert the name of the "generation group", as if it were a directory, between the last directory and the file name. FORCE and REORG parameters Before the final launching of the restore, when you are asked for user name and password, you can open an "advanced" screen, where you can specify FORCE and/or REORG in the service parameters field. These parameters are for restoration of whole volumes only. There are ignored in the case of restoration of files. FORCE allows to perform restoration even if the volume is not empty. Caution !!! This can lead to the loss of SYSTEM or BKST files : the system can be damaged. No confirmation message is sent if files are found. REORG allows to launch VOLREST with the REORG option, to reorganize and compact the free and allocated space. 3-10 77 A2 00EL 4. Help with Diagnostics 4.1 What to do if you encounter problems? Check that the steps described in section 3.2 Installations on the DPS7000 XTA or NS7000 server have been respected. • If the Sockg7_std is shutdown, you will need to restart it, stop ARS (TARS) and restart ARS (SARS). • If ARS starts up before SM H_SM_DCM is loaded (in the case of a RESTORE/RESTART CLEAN), ARS will not have the functionality required to use OpenSave. In this case you will need to stop and restart ARS. The tools used to diagnose problems are the Windows Event Viewer and the V7000 Trace Manager. These tools are documented in the V7000 Configuration and Maintenance Guide and reserved for Bull Services. In case of problems, contact a BCT: Start MenuÆProgramsÆV7000ÆBull ServicesÆInformation Collector Select all incidents. 77 A2 00EL 4-1 OpenSave Backup Agent for GCOS7/XTA or NS7000 4.2 Messages sent to the GCOS7 operator console Three categories of messages linked to OpenSave problems can be sent to the GCOS7 operator console. 4.2.1 OpenSave startup problems These messages are only issued for a manual startup (SARS). ARS INIT WARNING, H_SM_DCM IS NOT LOADED OPENSAVE G7 FUNCTIONS ARE NOT STARTED The SM H_SM_DCM has not been loaded: ARS starts up without OpenSave functions. ARS INIT WARNING, SOCKET FUNCTION = sss, ERRNO = nnn OPENSAVE G7 FUNCTIONS ARE NOT STARTED The socket sss function could not be executed successfully. The ERRNO nnn value can be used to specify the problem. ARS starts up without OpenSave functions. If the function is SOCKET, it must be that theSockg7_std server is stopped. 4.2.2 Problems Running OpenSave OPENSAVE G7 ERROR : TOO MANY SESSIONS OPENED A new OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume cannot be used because you attempted to launch more than 6 Agents, or termination of a previous Agent was unsuccessful. In the last case, try again ; if it fails again, stop and restart ARS to be able to start all the desired Agents. OPENSAVE G7 ERROR : VOLUME FUNCTIONS NOT ALLOWED An OpenSave Backup Agent for GCOS7 Volume has been installed, and is used, but the UTSD030 MI is not installed on the DPS7000 XTA or NS7000 server. OPENSAVE G7 ERROR eee, SOCKET FUNCTION = sss, ERRNO = nnn 4-2 77 A2 00EL Help with Diagnostics The socket sss function could not be executed successfully. The ERRNO nnn and internal error number eee values can be used to specify the problem. It may be that the OpenSave Backup Agent for GCOS7, the OpenSave Backup Agent for GCOS7 Volume or the Sockg7_std server has stopped. It may be that a restore was launched for a file whose backup had failed (eee=60, ERRNO=0, sss=RECV). OPENSAVE G7 ERROR eee OpenSave cannot run correctly due to a resource problem (semaphore, etc). The eee internal error number can be used to specify the problem. OPENSAVE G7 ERROR : SOCKET FUNCTIONS CLOSED The Sockg7_std server has stopped. 4.2.3 DARS ARS status This message is issued by the DARS command if OpenSave functions could be used, but are not running. OPENSAVE G7 FUNCTIONS ARE NOT STARTED A startup problem or a problem running OpenSave has occurred. 77 A2 00EL 4-3 OpenSave Backup Agent for GCOS7/XTA or NS7000 4.3 Messages sent to the OpenSave graphic inteface Two categories of error messages have been added to the OpenSave graphic interface boxes. 4.3.1 GCOS7 return code When an abnormal GCOS7 return code occurs during a back up or a restore, it appears in the OpenSave box with the return code hexadecimal value and the GCOS7 associated mnemonic. An internal error number is added and can be used to specify the problem. For saves, these messages appear in the SU message box of the Backup report. Some of the most frequent return codes are the following : DFSRD 26,ARDLFBID (err : 87) Volume restoration on a non empty volume without FORCE. Caution !!! The use of FORCE can lead to the loss of SYSTEM or BKST files : the system can be damaged. ARS 20,ARVIOL (err : 29) Creation of a file at root level is reserved to SYSAMIN. ARS 20,ARVIOL (err : 72) The user has not sufficient access rights on the directory. DCTLG 16,ARVIOL (err : 71) The user has not sufficient access rights on the file. DCTLG 37,ARVIOL (err : 77) 4-4 77 A2 00EL Help with Diagnostics The user is not the owner of the restored volume. DCTLG 43,ARVIOL (err : 71) The user has not sufficient access rights on the file. DFASG 41,BUSY (err : 30) File restoration on a file being used. DFASG 50,BUSY (err : 42) File save of a file being used (without use of DYNSAVE). DVMGT 19,BUSY (err : 80) Volume save of a volume where a file is being used (without use of VOLSAVE DIRTY option). or Volume save of an HELD volume. DVMGT 19,BUSY (err : 85) Volume restoration on a volume where a file is being used. ARS 20,CONFLICT (err : 31) A volume name has been given to create a new catalogued file, but a file with the same name already exists. DVMGT 19,DVIDFBID (err : 32) The volume name given to create a file does not exist. ARS 62,NOTDONE (err : 60) 77 A2 00EL 4-5 OpenSave Backup Agent for GCOS7/XTA or NS7000 A restore was launched for a file whose backup had failed. DCTLG 18,OBJUNKN (err : 9) Missing directory (a directory cannot be created in an OpenSave restore). DCTLG 18,OBJUNKN (err : 30) The destination restore file does not exist and no volume name has been given. DVMGT 11,WRONGDV (err : 90) The volume name given to restore a volume does not exist. or Volume restoration of an HELD volume. 4.3.2 Erroneous restore parameters When the user gives erroneous values to the restore parameters, one of the following message can appear. In some cases, a more precise text can be found in the trace file. Invalid Options The only supported option is "unconditional". Invalid service parameters The only supported parameters are FORCE and REORG. They can be used for OpenSave Backup Agent for GCOS7 Volume only. Error canal closed The socket used for data path or control path is closed. 4-6 77 A2 00EL Help with Diagnostics Error path too long The file name length exceeds GCOS7 limit. Error invalid path The file or volume name is not valid. or UNCAT specified without volume name (explicit or default). Error invalid user or password The given user name or password is not valid. 4.4 Tools used to record events 4.4.1 Event Viewer The OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume records 3 types of events in the V7000 Log: • ERROR (icon with red cross): All significant errors sent to OpenSave that prevented the viewing, backup or restore from working correctly. • WARNING (icon with yellow triangle): A problem has occurred while closing a socket. • INFORMATION (icon with a blue "i"): Information from the start and end of a backup or the start and end of a restore. ARS server connection and deconnection information for command transfer. To view the recorded events: Start Computer Management, expand Event Viewer, then select V7000. The events signed V7000_BACKUP (sources) are events recorded by the OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume. 77 A2 00EL 4-7 OpenSave Backup Agent for GCOS7/XTA or NS7000 4.4.2 Trace Manager The OpenSave Backup Agent for GCOS7 traces two types of events in the V7000 Trace: • Error: All significant errors sent to OpenSave that prevented the viewing, backup or restore from working correctly. • Information: All successful actions: Start and end of procedures, start and end of a backup or the start and end of a restore. ARS server connection and deconnection information for command transfer. The processID gives the number of the process that recorded the event. This information is useful if several OpenSave Backup Agent for GCOS7 or OpenSave Backup Agent for GCOS7 Volume were active to handle parallel Save/Restore actions, or to work with the two types of Agents simultaneously. To view the events recorded in the Trace: Start MenuÆProgramsÆV7000ÆBull ServicesÆTrace Manager Select a trace domain, select OPSV domain. Select a trace level, and press the Start trace button. The information is recorded in a text file named V7000_Trace_Domain_OPSV_pid_n.txt pid is the processID number. If several Agents have been launched, there is a text file for each Agent. It can happen that you do not get the trace file at once. In this case stop and restart the OpenSave agents. 4-8 77 A2 00EL Technical publication remarks form Title : DPS7000/XTA NOVASCALE 7000 OpenSave Backup Agent for GCOS7/XTA or NS7000 User's Guide Reference Nº : 77 A2 00EL 01 Date: March 2006 ERRORS IN PUBLICATION SUGGESTIONS FOR IMPROVEMENT TO PUBLICATION Your comments will be promptly investigated by qualified technical personnel and action will be taken as required. If you require a written reply, please include your complete mailing address below. NAME : COMPANY : ADDRESS : Please give this technical publication remarks form to your BULL representative or mail to: Bull - Documentation Dept. 1 Rue de Provence BP 208 38432 ECHIROLLES CEDEX FRANCE [email protected] Date : Technical publications ordering form To order additional publications, please fill in a copy of this form and send it via mail to: BULL CEDOC 357 AVENUE PATTON B.P.20845 49008 ANGERS CEDEX 01 FRANCE CEDOC Reference # _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] _ _ _ _ _ _ _ _ _ [ _ _ ] [ _ _ ] Phone: FAX: E-Mail: +33 (0) 2 41 73 72 66 +33 (0) 2 41 73 70 66 [email protected] Designation Qty : The latest revision will be provided if no revision number is given. NAME: Date: COMPANY: ADDRESS: PHONE: E-MAIL: For Bull Subsidiaries: Identification: For Bull Affiliated Customers: Customer Code: For Bull Internal Customers: Budgetary Section: For Others: Please ask your Bull representative. FAX: BULL CEDOC 357 AVENUE PATTON B.P.20845 49008 ANGERS CEDEX 01 FRANCE REFERENCE 77 A2 00EL 01