Backup3G 5.1/User Guide

From Documentation

Revision as of 04:41, 18 April 2006 Daniels (Talk | contribs) (→What each capability does) ← Previous diff		Current revision Moff (Talk | contribs)
Line 1:		Line 1:
		+	{{altversion|Backup3G|5.1|3.2.6/User_Guide}}
		+
	== Getting Started ==		== Getting Started ==
-	backup3G is a menu-driven application for automating backup, recovery and archiving tasks in an Open Systems data center. This guide is designed to help you use backup3G quickly and efficiently.	+	Backup3G is a menu-driven application for automating backup, recovery and archiving tasks in an Open Systems data center. This guide is designed to help you use backup3G quickly and efficiently.
		+	<br>
	=== About this guide ===		=== About this guide ===
-	This manual is the primary reference for setting up and using backup3G, and is designed to help users and administrators to use backup3G effectively. It can be divided into four sections:	+	This guide is the primary reference for setting up and using backup3G, and is designed to help users and administrators to use backup3G effectively. It can be divided into four sections:
-	:;Preliminary information :an overview of backup3G and how to get started.	+	:;''Preliminary information'': an overview of backup3G and how to get started.
-	:;Planning information: guidance on planning your backup, recovery, and media management strategies.	+	:;''Planning information'': guidance on planning your backup, recovery, and media management strategies.
-	:;Background information: detailed descriptions of backup3G concepts, including backup types and drive and media management issues.	+	:;''Background information'': detailed descriptions of backup3G concepts, including backup types and drive and media management issues.
-	:;Step-by-step instructions: ‘how-to’ topics for setting up, running and monitoring backups: recovering files; and performing related tasks such as adding details of new media and drives.	+	:;''Step-by-step instructions'': ‘how-to’ topics for setting up, running and monitoring backups: recovering files; and performing related tasks such as adding details of new media and drives.
		+	<br>
	=== Who should use this guide ===		=== Who should use this guide ===
		+
	This guide is aimed at:		This guide is aimed at:
-	*managers who need an overview of what backup3G can do	+	*''managers'' who need an overview of what backup3G can do
-	*administrators who need to configure backups and control access to backup3G	+	*''administrators'' who need to configure backups and control access to backup3G
-	*operators who need to know how to run backups, recover files, and handle backup media	+	*''operators'' who need to know how to run backups, recover files, and handle backup media
-	*new backup3G users, who need to understand the basics of using the backup3G modules	+	*''new backup3G users'', who need to understand the basics of using the backup3G modules
-	*auditors who need to understand how backup3G fits in with the organization’s policies and procedures.	+	*''auditors'' who need to understand how backup3G fits in with the organization’s policies and procedures.
		+	<br>
	== For More Information ==		== For More Information ==
		+
	The COSmanager User Guide explains how to install COSmanager products, including backup3G.		The COSmanager User Guide explains how to install COSmanager products, including backup3G.
-	This guide describes how to configure backup3G, how to set up and maintain backups, how to manage media, how to set up and manage drives and load devices, and how to perform backups and recoveries. Technical information about [[COSmanager]] commands can be found in the [[COSmanager]] Reference Guide. This contains manual pages for the Functional Toolset and application-specific commands, including commands used in backup3G. COSmanager promotes a ‘policies and procedures’ approach to system management,
-	including backup and media management. The guides, How to Implement Policy Based Management and a Sample Policy and Procedures Manual, are available without charge from your COSmanager distributor.
		+	This guide describes how to configure backup3G, how to set up and maintain backups, how to manage media, how to set up and manage drives and load devices, and how to perform backups and recoveries.
		+
		+	Technical information about [[COSmanager]] commands can be found in the [[COSmanager]] Reference Guide. This contains manual pages for the Functional Toolset and application-specific commands, including commands used in backup3G.
		+
		+	COSmanager promotes a ‘policies and procedures’ approach to system management, including backup and media management. The guides, How to Implement Policy Based Management and a Sample Policy and Procedures Manual, are available without charge from your COSmanager distributor.
		+
		+	<br>
	== Management Overview ==		== Management Overview ==
-	backup3G facilitates a standard approach to backup and recovery and the management of media in multi-host, multi-vendor UNIX data centers, through:
-	*automation of system management functions
-	*delegation of operations tasks
-	*control over data center operations
-	backup3G encourages sound management practice. For example, electronic labelling of backup media reduces the possibility of inadvertently overwriting good data. This is good practice and backup3G makes it simple to do. All the information required to run comprehensive network backups is packaged in the backup job. There is no requirement for operators to memorize complex scheduling	+	Backup3G facilitates a standard approach to backup and recovery and the management of media in multi-host, multi-vendor UNIX data centers, through:
-	requirements or understand subtle platform-dependent variations in backup commands and devices. The automation of routine backups saves time, frees up resources, and reduces the possibility of human error.	+	*''automation'' of system management functions
		+	*''delegation'' of operations tasks
		+	*''control'' over data center operations
-	== Benefits of backup3G ==	+	Backup3G encourages sound management practice. For example, electronic labelling of backup media reduces the possibility of inadvertently overwriting good data. This is good practice and backup3G makes it simple to do.
-	backup3G provides a secure, policy-based backup and recovery environment for distributed open systems data centers. backup3G is part of the COSmanager family of system administration products.	+
-	=== For Data Center Managers ===	+	All the information required to run comprehensive network backups is packaged in the backup job. There is no requirement for operators to memorize complex scheduling requirements or understand subtle platform-dependent variations in backup commands and devices.
-	backup3G facilitates the implementation of policy-driven backup strategies, providing excellent disaster-recovery capabilities. It provides mainframe-strength backup facilities across mixed platforms and vendors.	+
-	=== For Administrators === backup3G automates routine and repetitive tasks, allowing delegation to less experienced staff; it also promotes efficient and flexible use of drives and load devices across the network.	+	The automation of routine backups saves time, frees up resources, and reduces the possibility of human error.
-	=== For Auditors === backup3G provides easy access to details of current backup procedures and facilitates the analysis of those procedures to see if backups are being carried out correctly and successfully.	+	<br>
		+	=== Benefits of backup3G ===
		+
		+	Backup3G provides a secure, policy-based backup and recovery environment for distributed open systems data centers. backup3G is part of the COSmanager family of system administration products.
		+
		+	''For Data Center Managers'' backup3G facilitates the implementation of policy-driven backup strategies, providing excellent disaster-recovery capabilities. It provides mainframe-strength backup facilities across mixed platforms and vendors.
		+
		+	''For Administrators'' backup3G automates routine and repetitive tasks, allowing delegation to less experienced staff; it also promotes efficient and flexible use of drives and load devices across the network.
		+
		+	''For Auditors'' backup3G provides easy access to details of current backup procedures and facilitates the analysis of those procedures to see if backups are being carried out correctly and successfully.
		+
		+	<br>
		+
		+	== Backup3G Modules ==
-	== backup3G Modules ==
	=== Scheduling and monitoring ===		=== Scheduling and monitoring ===
-	backup3G provides full support for automated and unattended backups. Backup jobs can be run regularly at a set time, or as required. If duty3G is installed, jobs can be defined as duties, with full support for complex scheduling and dependencies.
-	You can monitor the progress of a backup job from when it is submitted or scheduled until it finishes. The Backup Monitor alerts operators when some action is required, such as a manual tape load. Backups can be held temporarily or cancelled, and failed jobs can be restarted from the step that caused the error. Full log files help you to check job status and diagnose any errors and warnings.
		+	Backup3G provides full support for automated and unattended backups. Backup jobs can be run regularly at a set time, or as required. If duty3G is installed, jobs can be defined as duties, with full support for complex scheduling and dependencies.
		+
		+	You can monitor the progress of a backup job from when it is submitted or scheduled until it finishes. The Backup Monitor alerts operators when some action is required, such as a manual tape load.
		+
		+	Backups can be held temporarily or cancelled, and failed jobs can be restarted from the step that caused the error. Full log files help you to check job status and diagnose any errors and warnings.
		+
		+	<br>
	=== Backup configuration ===		=== Backup configuration ===
-	You define backup jobs comprising one or more steps. Each step backs up a data object (filesystem, directory, or database) or performs some related task such as shutting down a database or printing a catalog of the backup. You have fine control over what files are backed up. backup3G supports full or ‘type 0’ backups and incremental (also known as differential) backups. You can specify lists of file names and patterns that are to be backed up or excluded from the backup. Several backup methods are supplied, using standard UNIX backup formats such as cpio, tar, and dump. This means that you recover files manually even if	+	[[Image:backup3G network.png|frame|Figure 1 - Backup network]]
-	backup3G itself is unavailable. You can easily customize these backup methods or add new ones based on your own scripts or third-party software.	+
-	A backup job can write to as many volumes as are required, allowing you to back up any amount of data. Individual steps can be split into several parts for greater efficiency. Files can be backed up from UNIX and Windows hosts to any drive on the network.	+	You define backup jobs comprising one or more steps. Each step backs up a data object (filesystem, directory, or database) or performs some related task such as shutting down a database or printing a catalog of the backup.
		+
		+	You have fine control over what files are backed up. Backup3G supports full or ‘type 0’ backups and incremental (also known as differential) backups. You can specify lists of file names and patterns that are to be backed up or excluded from the backup.
		+
		+	Several backup methods are supplied, using standard UNIX backup formats such as cpio, tar, and dump. This means that you recover files manually even if backup3G itself is unavailable. You can easily customize these backup methods or add new ones based on your own scripts or third-party software.
		+
		+	A backup job can write to as many volumes as are required, allowing you to back up any amount of data. Individual steps can be split into several parts for greater efficiency.
		+
		+	Files can be backed up from UNIX and Windows hosts to any drive on the network.
		+
		+	<br>
	=== Recovery ===		=== Recovery ===
-	Fast recovery from a backup or archive is fully supported. You can recover selected files and directories, or the whole data object. An online index of backed-up files can be created, allowing fast and easy recovery of selected files from large backups. Operators can select files either from the index or by specifying a name or pattern, and be led through the recovery process by	+
		+	Fast recovery from a backup or archive is fully supported. You can recover selected files and directories, or the whole data object.
		+
		+	An online index of backed-up files can be created, allowing fast and easy recovery of selected files from large backups. Operators can select files either from the index or by specifying a name or pattern, and be led through the recovery process by
	backup3G.		backup3G.
		+
		+	<br>
	=== Media management ===		=== Media management ===
-	backup3G contains an integrated media database that supports:	+
		+	Backup3G contains an integrated media database that supports:
	*arbitrary media types (e.g. DLT, SDLT, DAT, Exabyte, LTO, hard disks and CD disks)		*arbitrary media types (e.g. DLT, SDLT, DAT, Exabyte, LTO, hard disks and CD disks)
	*media usage balancing		*media usage balancing
Line 66:		Line 107:
	*predefined reports		*predefined reports
	*searching of media contents and online indexes.		*searching of media contents and online indexes.
		+
		+	<br>
	=== Drive and media library support ===		=== Drive and media library support ===
-	backup3G supports all standard tape drives, from manually-loaded single-slot drives to multiple-drive automated tape libraries. backup3G also supports other types of media drive such as hard disks and CD drives. backup3G keeps a database of information about the capabilities of each drive type, so that backup and recovery jobs can address any particular drive in a device-independent	+
-	way. Backup jobs can be assigned to specified drive or to a ‘drive pool’. At run-time, backup3G chooses the first available drive from the drive pool. backup3G supports a range of auto-loading devices, from tape stackers and jukeboxes to silos and automated tape libraries, through the Tape Library Management add-on module.	+	Backup3G supports all standard tape drives, from manually-loaded single-slot drives to multiple-drive automated tape libraries.
		+
		+	Backup3G also supports other types of media drive such as hard disks and CD drives. Backup3G keeps a database of information about the capabilities of each drive type, so that backup and recovery jobs can address any particular drive in a device-independent
		+	way.
		+
		+	Backup jobs can be assigned to specified drive or to a ‘drive pool’. At run-time, backup3G chooses the first available drive from the drive pool.
		+
		+	Backup3G supports a range of auto-loading devices, from tape stackers and jukeboxes to silos and automated tape libraries, through the Tape Library Management add-on module.
		+
		+	<br>
	=== Access Security ===		=== Access Security ===
-	Fine-grained capability controls allow users to be given limited ‘views’ of backup3G menus, enabling tight control to be maintained over access to all key functions. Each user has one or more roles that allow access to certain menus and options.	+
-	backup3G includes a number of predefined roles, which you can add to and customize. For a list of the default capabilities assigned to each role, see [[Roles and Capabilities]].	+	Fine-grained capability controls allow users to be given limited ‘views’ of backup3G menus, enabling tight control to be maintained over access to all key functions.
		+
		+	Each user has one or more roles that allow access to certain menus and options.
		+	backup3G includes a number of predefined roles, which you can add to and customize. For a list of the default capabilities assigned to each role, see [[COSmanager/User_Guide/COSmanager_Users_and_Access_Controls|Roles and Capabilities]].
		+
		+	<br>
	== Technical Overview ==		== Technical Overview ==
		+
	This topic describes backup3G’s software environment:		This topic describes backup3G’s software environment:
	*licensing		*licensing
Line 85:		Line 143:
	*user interface		*user interface
		+	<br>
	=== Setting Up and Using backup3G ===		=== Setting Up and Using backup3G ===
		+
	To install backup3G, you will need:		To install backup3G, you will need:
	*a distribution containing the [http://downloads.fs.com.au/index.php?prod=BKP backup3G] software		*a distribution containing the [http://downloads.fs.com.au/index.php?prod=BKP backup3G] software
Line 91:		Line 151:
	*a license key		*a license key
-	It is preferable to designate one host as the master backup host, and administer all backup jobs centrally. If you need to submit backups from different hosts it is important not to share drives and media—each backup3G master host must operate independently otherwise drive and media conflicts are likely. Note Detailed planning of your backup policies and procedures should take	+	It is preferable to designate one host as the master backup host, and administer all backup jobs centrally. If you need to submit backups from different hosts it is important not to share drives and media—each backup3G master host must operate independently otherwise drive and media conflicts are likely.
-	place prior to configuring backup3G. Your COSmanager distributor can assist.	+
		+	{{note|Detailed planning of your backup policies and procedures should take place prior to configuring backup3G.}}
		+
		+
		+	'''Licensing'''
-	=== Licensing ===
	COSmanager uses a host-name-based licensing scheme. You supply information for each host on which backup3G and other applications are to be run. Your COSmanager distributor will give you a set of license keys that encode information about which applications can be run on each host, and for how long (that is, whether for a trial period or indefinitely).		COSmanager uses a host-name-based licensing scheme. You supply information for each host on which backup3G and other applications are to be run. Your COSmanager distributor will give you a set of license keys that encode information about which applications can be run on each host, and for how long (that is, whether for a trial period or indefinitely).
-	Caution Do not change the license key or product string. This will invalidate your license.	+	{{caution|Do not change the license key or product string. This will invalidate your license.}}
	You will be prompted to enter the license key and product string during the installation procedure.		You will be prompted to enter the license key and product string during the installation procedure.
-	=== Installation and configuration ===	+
-	This provides an overview of the steps needed to install backup3G, including setting up an initial configuration. For more details, see [[Backup3G/Appendices|Appendix A—Installing and Configuring]].	+	'''Installation and configuration'''
		+
		+	This provides an overview of the steps needed to install backup3G, including setting up an initial configuration. For more details, see [[Backup3G_5.1/User_Guide/Appendix_A_-_Installing_and_Configuring|Appendix A—Installing and Configuring]].
	#If COSmanager is not already installed, you must first install and configure the COSmanager application framework.		#If COSmanager is not already installed, you must first install and configure the COSmanager application framework.
-	#Install backup3G from the distribution tape by running Application > Install from the COSmanager configuration > COSmanager	+	#Install backup3G by running Application > Install from the COSmanager configuration > COSmanager applications window.
-	applications window. You will be prompted for the license key during this step.	+	#This will show a window in which you can enter the path to the Backup3G distribution. We recommend using /tmp for ease of use.
		+	#You will be prompted for the license key during this step.
	#Set up an initial configuration for COSmanager by running a series of configuration tasks from the backup3G configuration menu. Through these tasks you define information about your computing environment and backup procedures.		#Set up an initial configuration for COSmanager by running a series of configuration tasks from the backup3G configuration menu. Through these tasks you define information about your computing environment and backup procedures.
-	=== Starting backup3G ===	+
-	;From the COSmanager button bar (GUI): Select the Backup button. The backup3G button bar is displayed.	+	'''Starting backup3G'''
-	;From the COSmanager main menu (CUI): Select the backup3G option. The backup3G main menu is displayed.	+
-	;From the command line To launch the default version, enter: cos backup	+	''From the COSmanager button bar (GUI)''
-	:To launch a different version, enter: cos backup -v version	+	*Select the Backup button. The backup3G button bar is displayed.
		+	''From the COSmanager main menu (CUI)''
		+	*Select the backup3G option. The backup3G main menu is displayed.
		+	''From the command line''
		+	*To launch the default version, enter: {{icode|cos backup}}
		+	*To launch a different version, enter: {{icode|cos backup -v ''[version]''}}
	=== Roles and Capabilities ===		=== Roles and Capabilities ===
		+
	Each COSmanager user has one or more roles. Each role identifies a responsibility or class of users in your organization, such as Manager or Operator. Within backup3G, roles are defined in terms of the access capabilities they grant. In turn, capabilities determine what menu options and actions a user can perform. Table 1 shows the default capabilities for each role.		Each COSmanager user has one or more roles. Each role identifies a responsibility or class of users in your organization, such as Manager or Operator. Within backup3G, roles are defined in terms of the access capabilities they grant. In turn, capabilities determine what menu options and actions a user can perform. Table 1 shows the default capabilities for each role.
-	==== What each capability does ====	+	Admin System Administrator SeniorOp recover recoverALL
		+	Librarian Media Librarian accessALL drive mark_bad media_mgmt monitor retention scratch
		+	Manager System Manager Admin accessALL maintain scratch
		+	Operator Basic Operator backup control display media_mgmt monitor
		+	SeniorOp Senior Operator Operator chg_params drive mark_bad retention
		+
		+
		+	{| border="1" cellpadding="6" cellspacing="0"
		+	|+'''Table 1 - Capabilities assigned to each backup3G role'''
		+	|-
		+	!Role !!accessALL !!backup !!chg_params !!control !!display !!drive !!mark_bad !!maintain !!media_mgmt !!monitor !!recover !!recoverALL !!retention !!scratch
		+	|- bgcolor="#efefef"
		+	! Manager ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic;
		+	|-
		+	!Admin || ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; || ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||
		+	|- bgcolor="#efefef"
		+	!SeniorOp || ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; ||align="center"|&radic; || ||align="center"|&radic; ||align="center"|&radic; || || ||align="center"|&radic; ||
		+	|-
		+	!Operator || ||align="center"|&radic; || ||align="center"|&radic; ||align="center"|&radic; || || || ||align="center"|&radic; ||align="center"|&radic; || || || ||
		+	|- bgcolor="#efefef"
		+	!Librarian ||align="center"|&radic; || || || || ||align="center"|&radic; ||align="center"|&radic; || ||align="center"|&radic; ||align="center"|&radic; || || ||align="center"|&radic; ||align="center"|&radic;
		+	|}
		+
		+
		+	'''What each capability does'''
		+
		+	{| border="1" cellpadding="6" cellspacing="0"
		+	|+'''Table 2 - backup3G capabilities'''
		+	|-
		+	!accessALL
		+	|Ability to access all media
		+	|-
		+	!backup
		+	|Ability to submit a backup or archive job(s)
		+	|-
		+	!chg_params
		+	|Ability to submit a backup, changing parameters
		+	|-
		+	!control
		+	|Ability to control running jobs (cancel, hold etc)
		+	|-
		+	!display
		+	|Display details of the backup job(s)
		+	|-
		+	!drive
		+	|Ability to perfom drive and load operations
		+	|-
		+	!mark_bad
		+	|Ability to mark media as bad
		+	|-
		+	!maintain
		+	|Maintain backup tables
		+	|-
		+	!media_mgmt
		+	|Ability to manage media, eg: allocate, send offsite
		+	|-
		+	!monitor
		+	|Ability to monitor running jobs
		+	|-
		+	!recover
		+	|Ability to perform recovery
		+	|-
		+	!recoverALL
		+	|Ability to perform recovery to all directories and hosts
		+	|-
		+	!retention
		+	|Ability to change media data retention period
		+	|-
		+	!scratch
		+	|Ability to scratch media
		+	|}
		+
	Many functions, particularly those that modify system files and COSmanager tables, require specific access capabilities. Users who do not have the right capabilities will not be able to access or even view these functions.		Many functions, particularly those that modify system files and COSmanager tables, require specific access capabilities. Users who do not have the right capabilities will not be able to access or even view these functions.
-	{| border="1" cellspacing="0" cellpadding="2"	+
		+
		+	'''Controlling access to options on the backup3G button bar'''
		+
		+	{| border="1" cellpadding="6" cellspacing="0"
		+	!Module
		+	!Command
		+	!Capability Needed
		+	|-
		+	|Archive files
		+	|<tt>menu archive</tt>
		+	|backup
		+	|-
		+	|Schedule or run backups
		+	|<tt>methtool runback</tt>
		+	|backup OR maintain OR display
	|-		|-
-	|Role	+	|Recovery from backups
-	|backup	+	|<tt>methtool msetview</tt>
-	|media_mgmt	+	|backup OR recover
-	|monitor	+
-	|display	+
-	|drive	+
-	|recover	+
-	|recoverALL	+
-	|maintain	+
	|-		|-
-	|Manager	+	|Media management
-	|3	+	|<tt>methtool medview</tt>
-	|3	+	|media_mgmt OR backup OR maintain OR display
-	|3	+
-	|3	+
-	|3	+
-	|3	+
-	|3	+
-	|3	+
	|-		|-
-	|Admin	+	|Removable drive management
-	|3	+	|<tt>methtool drview</tt>
-	|3	+	|backup OR maintain OR display
-	|3	+
-	|3	+
-	|3	+
-	|3	+
-	|	+
-	|	+
	|-		|-
-	|SeniorOp	+	|Stacker management
-	|3	+	|<tt>methtool stacker</tt>
-	|3	+	|backup OR maintain OR display
-	|3	+
-	|3	+
-	|3	+
-	|	+
-	|	+
-	|	+
	|-		|-
-	|Operator	+	|Monitor backup jobs/logfiles
-	|3	+	|<tt>methtool jobstatus</tt>
-	|3	+	|monitor OR backup
-	|3	+
-	|3	+
-	|	+
-	|	+
-	|	+
-	|	+
	|}		|}
-	===== backup3G Capabilities =====
-	;maintain: Modify tables unconditionally. Initially restricted to Manager role.
-	;backup: Perform backup related tasks. This includes archiving and some media management
-	;recover: Perform recovery related tasks. This includes building online indexes from backup jobs and some media management.
-	;recoverALL: Overrides the action of the recovery restrictions. A user with this capability can recover to any directory on any host.
-	;drive: Direct access to drive tasks such as drive operations, and loading and unloading media.
-	;media_mgmt: Media management. User can move media to or from other offsite/onsite locations, and allocate volumes to load devices.
-	;monitor: Keep track of backup, recovery and archive jobs.
-	;display: Read only access to backup3G.
-	=== Controlling access to options on the backup3G button bar ===	+	'''Controlling access to backup3G configuration options'''
-	==== Module Command Capability Needed ====	+
-	Archive files menu archive backup	+	{| border="1" cellpadding="6" cellspacing="0"
-	Schedule or run backups methtool runback backup OR maintain OR display	+	!
-	Recovery from backups methtool msetview backup OR recover	+	!Command
-	Media management methtool medview media_mgmt OR backup OR maintain OR	+	!Capability Needed
-	display	+	|-
-	Removable drive management methtool drive backup OR maintain OR display	+	|Maintain backup jobs
-	Stacker management methtool stacker backup OR maintain OR display	+	|<tt>methtool backview</tt>
-	Monitor backup jobs/logfiles methtool jobstatus monitor OR backup	+	|maintain OR display
-	Getting Started 13	+	|-
-	Controlling access to backup3G configuration options	+	|Maintain drives
-	Customizing user access	+	|<tt>methtool drive</tt>
-	You can change what roles are assigned to a particular user, or change the capabilities	+	|maintain OR display
-	that are assigned to all users with a particular role.	+	|-
-	Note Changes made to a user’s security profile don’t come into effect until	+	|Maintain media libraries
-	the next time the user invokes COSmanager.	+	|<tt>methtool stacker</tt>
-	Software Environment	+	|maintain OR display
-	backup3G is installed under the home directory of the COSmanager account. All	+	|-
-	the files are owned by COSmanager and belong to the COSmanager group,	+	|Maintain backup3G roles
-	except for a handful of database tables that are owned by root.	+	|<tt>methtool appl_cap</tt>
-	Command Capability Needed	+	|maintain OR display
-	Maintain backup jobs methtool backup maintain OR display	+	|-
-	Maintain drives and stackers methtool drive maintain OR display	+	|Maintain backup3G settings
-	Access capabilities methtool appl_cap maintain	+	|<tt>methtool setting</tt>
-	Maintain tables methtool table maintain	+	|maintain OR display
-	Initial configuration methtool confview super	+	|-
-	To change Use	+	|Maintain other tables
-	Roles assigned to a user COSmanager configuration >	+	|<tt>methtool table</tt>
-	Users and privileges >	+	|maintain AND super
-	COSmanager users	+	|}
-	Capabilities assigned to a role backup3G configuration >	+
-	Access capabilities	+
-	14 Getting Started	+	'''Customizing user access'''
-	backup3G’s log files are stored in the backlog directory in the system spool area,	+
-	with the other COSmanager audit trails. COSmanager has a crontab entry to	+	You can change what roles are assigned to a particular user, or change the capabilities that are assigned to all users with a particular role. Note Changes made to a user’s security profile don’t come into effect until the next time the user invokes COSmanager.
-	cycle all its audit trails automatically.	+
-	COSmanager sets a number of variables in the user’s environment when they start	+
-	backup3G. These mostly define directory names and the user’s access capabilities.	+	{| border="1" cellpadding="6" cellspacing="0"
-	You can check your environment by exiting to a shell from within backup3G and	+	!To change
-	running env.	+	!Use
-	Startup procedure	+	|-
-	When you launch backup3G from COSmanager or through the cos backup	+	|Roles assigned to a user
-	command, the startup procedure performs the following steps:	+	|COSmanager configuration > Users and privileges > COSmanager users
-	• check that backup3G has a valid licence	+	|-
-	• check that the current version of the COSmanager framework is at least the	+	|Capabilities assigned to a role
-	minimum version required by this application	+	|backup3G configuration > Tools > Roles
-	• create environment variables describing backup3G’s directory structure: its	+	|}
-	home directory ($APPL_HOME), database directory ($APPL_DB), and	+
-	application path ($APPL_PATH)	+	{{note|Changes made to a user’s security profile don’t come into effect until the next time the user invokes COSmanager.}}
-	• if an application password is required, ask the user to enter it	+
-	• if authentication is required, ask for the user’s password	+	<br>
-	• prepend the application’s directories to the search paths	+
-	• create environment variables for any local roles and capabilities. Along with	+	== Software Environment ==
-	the variables created during COSmanager startup, these determine which	+
-	facilities the user can access in backup3G	+	Backup3G is installed under the home directory of the COSmanager account. All the files are owned by COSmanager and belong to the COSmanager group, except for a handful of database tables that are owned by root.
-	• execute $APPL_HOME/profile to set environment variables specific to	+
-	backup3G	+	Backup3G’s log files are stored in the backlog directory in the system spool area, with the other COSmanager audit trails. COSmanager has a crontab entry to cycle all its audit trails automatically.
-	• display backup3G version information (GUI)	+
-	• display the top-level menu or button bar for this user.	+	COSmanager sets a number of variables in the user’s environment when they start backup3G. These mostly define directory names and the user’s access capabilities. You can check your environment by exiting to a shell from within backup3G and running {{icode|env}}.
-	User Interface	+
-	The user interface to all COSmanager applications is provided through a series of	+	<br>
-	reusable software tools known collectively as The Functional Toolset. Both graphibackup.	+	=== Startup procedure ===
-	Getting Started 15	+
-	cal (GUI) and character (CUI) mode interfaces are provided. As there are only a	+	When you launch backup3G from [[COSmanager]] or through the {{icode|cos backup}} command, the startup procedure performs the following steps:
-	handful of different types of screen, the interface is very easy to learn.	+	*check that backup3G has a valid licence
-	The GUI mode features a Motif-style ‘look and feel’.	+	*check that the current version of the COSmanager framework is at least the minimum version required by this application
-	The GUI mode can also be used from a PC running Windows 3.11, Windows 95, or	+	*create environment variables describing backup3G’s directory structure: its home directory (<tt>$APPL_HOME</tt>), database directory (<tt>$APPL_DB</tt>), and application path (<tt>$APPL_PATH</tt>)
-	Windows NT, without the need for X emulation software.	+	*if an application password is required, ask the user to enter it
-	The CUI mode is intended for users who access COSmanager from a character terminal	+	*if authentication is required, ask for the user’s password
-	or via terminal emulation from a PC. It features a full-screen interface with	+	*prepend the application’s directories to the search paths
-	support for function keys and pop-up windows.	+	*create environment variables for any local roles and capabilities. Along with the variables created during COSmanager startup, these determine which facilities the user can access in backup3G
-	Keyboard traversal in the GUI interface is consistent with the CUI version. This	+	*execute <tt>$APPL_HOME/profile</tt> to set environment variables specific to backup3G
-	allows users to swap between X displays, Windows PCs, and character terminals,	+	*display backup3G version information (GUI)
-	with minimal retraining and without loss of productivity.	+	*display the top-level menu or button bar for this user.
-	The user interface is described in detail in the COSmanager User Guide.	+
-	16 Getting Started	+	<br>
-	Conventions Used	+	=== User Interface ===
-	This manual uses the following conventions:	+
-	This style is used to indicate:	+	The user interface to all COSmanager applications is provided through a series of reusable software tools known collectively as The Functional Toolset. Both graphical (GUI) and character (CUI) mode interfaces are provided. As there are only a handful of different types of screen, the interface is very easy to learn.
-	• text that is displayed on your screen	+
-	• commands that you type in at the keyboard	+	The GUI mode can also be used from a PC running any version of Windows without the need for X emulation software.
-	• the names of fields, directories and files	+
-	• actions assigned to buttons or function keys	+	The CUI mode is intended for users who access COSmanager from a character terminal or via terminal emulation from a PC. It features a full-screen interface with support for function keys and pop-up windows.
-	Examples:	+
-	Enter ‘write secoff ’ in the Command field.	+	Keyboard traversal in the GUI interface is consistent with the CUI version. This allows users to swap between X displays, Windows PCs, and character terminals, with minimal retraining and without loss of productivity.
-	/etc/passwd	+
-	Press Accept to schedule the backup job.	+	The user interface is described in detail in the [[COSmanager/User Guide| COSmanager User Guide]].
-	Cross-references to other chapters or manuals are shown in italics—see Conventions	+
-	Used, page 5 for example. Italics are also used for emphasis.	+
-	Notes contain useful information and reminders that could help you to save time	+
-	and effort. Example:	+
-	Note Searching a large number of indexes can be very slow. Use a start and	+
-	end date to limit the search to a shorter period.	+
-	Cautions warn you about a procedure or action, which, if not done correctly, could	+
-	cause damage to software or loss of data. Example:	+
-	Caution Designating a variable as ‘core’ is an irreversible procedure. Core parameters cannot	+
-	be deleted and the variable cannot be re-designated as non-core from within	+
-	COS/Secure.	+
-	Getting Started 17	+
-	Finding Your Way Around Menus	+
-	Menu options are shown in the form Menu > Menu option. For example	+
-	“Select Users and privileges > COSmanager users” tells you to select	+
-	the COSmanager users option from the Users and privileges menu as shown in Figure 3.	+
-	Figure 3 — Following menu instructions	+
-	This notation also applies to options on consoles or methtools; executing the	+
-	instruction: “Select Maintain > Add” would involve selecting the Add option	+
-	from the Maintain pulldown as illustrated in Figure 4.	+
-	Figure 4 — Using methtool menus	+
-	18 Getting Started	+
-	For More Information	+
-	The COSmanager User Guide explains how to install COSmanager products, including	+
-	backup3G.	+
-	This manual describes how to configure backup3G, how to set up and maintain	+
-	backups, how to manage media, how to set up and manage drives and load devices,	+
-	and how to perform backups and recoveries.	+
-	Technical information about COSmanager commands can be found in the COSmanager	+
-	Reference Guide. This contains manual pages for the Functional Toolset and application-	+
-	specific commands, including commands used in backup3G.	+
-	COSmanager promotes a ‘policies and procedures’ approach to system management,	+
-	including backup and media management. The guides, How to Implement Policy	+
-	Based Management and a Sample Policy and Procedures Manual, are available without	+
-	charge from your COSmanager distributor.	+
	== Where to from here ==		== Where to from here ==
Line 317:		Line 401:
	[[/Drives and Drive Pools|Information on Drives and Drive Pools]]		[[/Drives and Drive Pools|Information on Drives and Drive Pools]]
-	[[/Setting Up Backups]]	+	[[/Setting Up Backups|Setting Up Backup]]
		+
		+	[[/Initiating and Managing Backups|Initiating and Managing Backups]]
		+
		+	[[/Recovering Data|Recovering Data]]
		+
		+	[[/Managing Removable Media|Managing Removable Media]]
		+
		+	[[/Managing Drives|Managing Drives]]
		+
		+	[[/Appendix A - Installing and Configuring|Appendix A - Installing and Configuring]]
-	[[/Initiating and Managing Backups]]	+	[[/Appendix B - Checking Job Status Codes|Appendix B - Checking Job Status Codes]]
-	[[/Recovering Data]]	+	[[/Appendix C - Backup Methods and Drivers|Appendix C - Backup Methods and Drivers]]
-	[[/Managing Removable Media]]	+	[[/Appendix D - Defining Backup Methods|Appendix D - Defining Backup Methods]]
-	[[/Managing Drives]]	+	[[/Glossary|Glossary]]
-	[[/Appendices]]	+	<br>
		+	----
		+	<div style="float:right;">August 2007</div>Copyright © 1990-{{CURRENTYEAR}} Functional Software. All rights reserved.

---

Current revision

This document relates to Backup3G version 5.1. For other versions, please see Backup3G_3.2.6/User_Guide.

Contents 1 Getting Started 1.1 About this guide 1.2 Who should use this guide 2 For More Information 3 Management Overview 3.1 Benefits of backup3G 4 Backup3G Modules 4.1 Scheduling and monitoring 4.2 Backup configuration 4.3 Recovery 4.4 Media management 4.5 Drive and media library support 4.6 Access Security 5 Technical Overview 5.1 Setting Up and Using backup3G 5.2 Roles and Capabilities 6 Software Environment 6.1 Startup procedure 6.2 User Interface 7 Where to from here

Getting Started

Backup3G is a menu-driven application for automating backup, recovery and archiving tasks in an Open Systems data center. This guide is designed to help you use backup3G quickly and efficiently.

About this guide

This guide is the primary reference for setting up and using backup3G, and is designed to help users and administrators to use backup3G effectively. It can be divided into four sections:

Preliminary information

an overview of backup3G and how to get started.

Planning information

guidance on planning your backup, recovery, and media management strategies.

Background information

detailed descriptions of backup3G concepts, including backup types and drive and media management issues.

Step-by-step instructions

‘how-to’ topics for setting up, running and monitoring backups: recovering files; and performing related tasks such as adding details of new media and drives.

Who should use this guide

This guide is aimed at:

• managers who need an overview of what backup3G can do
• administrators who need to configure backups and control access to backup3G
• operators who need to know how to run backups, recover files, and handle backup media
• new backup3G users, who need to understand the basics of using the backup3G modules
• auditors who need to understand how backup3G fits in with the organization’s policies and procedures.

For More Information

The COSmanager User Guide explains how to install COSmanager products, including backup3G.

This guide describes how to configure backup3G, how to set up and maintain backups, how to manage media, how to set up and manage drives and load devices, and how to perform backups and recoveries.

Technical information about COSmanager commands can be found in the COSmanager Reference Guide. This contains manual pages for the Functional Toolset and application-specific commands, including commands used in backup3G.

COSmanager promotes a ‘policies and procedures’ approach to system management, including backup and media management. The guides, How to Implement Policy Based Management and a Sample Policy and Procedures Manual, are available without charge from your COSmanager distributor.

Management Overview

Backup3G facilitates a standard approach to backup and recovery and the management of media in multi-host, multi-vendor UNIX data centers, through:

• automation of system management functions
• delegation of operations tasks
• control over data center operations

Backup3G encourages sound management practice. For example, electronic labelling of backup media reduces the possibility of inadvertently overwriting good data. This is good practice and backup3G makes it simple to do.

All the information required to run comprehensive network backups is packaged in the backup job. There is no requirement for operators to memorize complex scheduling requirements or understand subtle platform-dependent variations in backup commands and devices.

The automation of routine backups saves time, frees up resources, and reduces the possibility of human error.

Benefits of backup3G

Backup3G provides a secure, policy-based backup and recovery environment for distributed open systems data centers. backup3G is part of the COSmanager family of system administration products.

For Data Center Managers backup3G facilitates the implementation of policy-driven backup strategies, providing excellent disaster-recovery capabilities. It provides mainframe-strength backup facilities across mixed platforms and vendors.

For Administrators backup3G automates routine and repetitive tasks, allowing delegation to less experienced staff; it also promotes efficient and flexible use of drives and load devices across the network.

For Auditors backup3G provides easy access to details of current backup procedures and facilitates the analysis of those procedures to see if backups are being carried out correctly and successfully.

Backup3G Modules

Scheduling and monitoring

Backup3G provides full support for automated and unattended backups. Backup jobs can be run regularly at a set time, or as required. If duty3G is installed, jobs can be defined as duties, with full support for complex scheduling and dependencies.

You can monitor the progress of a backup job from when it is submitted or scheduled until it finishes. The Backup Monitor alerts operators when some action is required, such as a manual tape load.

Backups can be held temporarily or cancelled, and failed jobs can be restarted from the step that caused the error. Full log files help you to check job status and diagnose any errors and warnings.

Backup configuration

You define backup jobs comprising one or more steps. Each step backs up a data object (filesystem, directory, or database) or performs some related task such as shutting down a database or printing a catalog of the backup.

You have fine control over what files are backed up. Backup3G supports full or ‘type 0’ backups and incremental (also known as differential) backups. You can specify lists of file names and patterns that are to be backed up or excluded from the backup.

Several backup methods are supplied, using standard UNIX backup formats such as cpio, tar, and dump. This means that you recover files manually even if backup3G itself is unavailable. You can easily customize these backup methods or add new ones based on your own scripts or third-party software.

A backup job can write to as many volumes as are required, allowing you to back up any amount of data. Individual steps can be split into several parts for greater efficiency.

Files can be backed up from UNIX and Windows hosts to any drive on the network.

Recovery

Fast recovery from a backup or archive is fully supported. You can recover selected files and directories, or the whole data object.

An online index of backed-up files can be created, allowing fast and easy recovery of selected files from large backups. Operators can select files either from the index or by specifying a name or pattern, and be led through the recovery process by backup3G.

Media management

Backup3G contains an integrated media database that supports:

• arbitrary media types (e.g. DLT, SDLT, DAT, Exabyte, LTO, hard disks and CD disks)
• media usage balancing
• multiple onsite libraries and offsite storage locations
• flexible retention periods
• media labelling using arbitrary label types, including barcodes
• predefined reports
• searching of media contents and online indexes.

Drive and media library support

Backup3G supports all standard tape drives, from manually-loaded single-slot drives to multiple-drive automated tape libraries.

Backup3G also supports other types of media drive such as hard disks and CD drives. Backup3G keeps a database of information about the capabilities of each drive type, so that backup and recovery jobs can address any particular drive in a device-independent way.

Backup jobs can be assigned to specified drive or to a ‘drive pool’. At run-time, backup3G chooses the first available drive from the drive pool.

Backup3G supports a range of auto-loading devices, from tape stackers and jukeboxes to silos and automated tape libraries, through the Tape Library Management add-on module.

Access Security

Fine-grained capability controls allow users to be given limited ‘views’ of backup3G menus, enabling tight control to be maintained over access to all key functions.

Each user has one or more roles that allow access to certain menus and options. backup3G includes a number of predefined roles, which you can add to and customize. For a list of the default capabilities assigned to each role, see Roles and Capabilities.

Technical Overview

This topic describes backup3G’s software environment:

• licensing
• installation and configuration
• starting backup3G from COSmanager or the command line
• access control
• directories, environment variables, and log files
• startup procedure
• user interface

Setting Up and Using backup3G

To install backup3G, you will need:

• a distribution containing the backup3G software
• an installed copy of the COSmanager application framework
• a license key

It is preferable to designate one host as the master backup host, and administer all backup jobs centrally. If you need to submit backups from different hosts it is important not to share drives and media—each backup3G master host must operate independently otherwise drive and media conflicts are likely.

	Note
	Detailed planning of your backup policies and procedures should take place prior to configuring backup3G.

Licensing

COSmanager uses a host-name-based licensing scheme. You supply information for each host on which backup3G and other applications are to be run. Your COSmanager distributor will give you a set of license keys that encode information about which applications can be run on each host, and for how long (that is, whether for a trial period or indefinitely).

	Caution!
	Do not change the license key or product string. This will invalidate your license.

You will be prompted to enter the license key and product string during the installation procedure.

Installation and configuration

This provides an overview of the steps needed to install backup3G, including setting up an initial configuration. For more details, see Appendix A—Installing and Configuring.

1. If COSmanager is not already installed, you must first install and configure the COSmanager application framework.
2. Install backup3G by running Application > Install from the COSmanager configuration > COSmanager applications window.
3. This will show a window in which you can enter the path to the Backup3G distribution. We recommend using /tmp for ease of use.
4. You will be prompted for the license key during this step.
5. Set up an initial configuration for COSmanager by running a series of configuration tasks from the backup3G configuration menu. Through these tasks you define information about your computing environment and backup procedures.

Starting backup3G

From the COSmanager button bar (GUI)

• Select the Backup button. The backup3G button bar is displayed.

From the COSmanager main menu (CUI)

• Select the backup3G option. The backup3G main menu is displayed.

From the command line

• To launch the default version, enter: cos backup
• To launch a different version, enter: cos backup -v [version]

Roles and Capabilities

Each COSmanager user has one or more roles. Each role identifies a responsibility or class of users in your organization, such as Manager or Operator. Within backup3G, roles are defined in terms of the access capabilities they grant. In turn, capabilities determine what menu options and actions a user can perform. Table 1 shows the default capabilities for each role.

Admin System Administrator SeniorOp recover recoverALL Librarian Media Librarian accessALL drive mark_bad media_mgmt monitor retention scratch Manager System Manager Admin accessALL maintain scratch Operator Basic Operator backup control display media_mgmt monitor SeniorOp Senior Operator Operator chg_params drive mark_bad retention

Table 1 - Capabilities assigned to each backup3G role

Role	accessALL	backup	chg_params	control	display	drive	mark_bad	maintain	media_mgmt	monitor	recover	recoverALL	retention	scratch
Manager	√	√	√	√	√	√	√	√	√	√	√	√	√	√
Admin		√	√	√	√	√	√		√	√	√	√	√
SeniorOp		√	√	√	√	√	√		√	√			√
Operator		√		√	√				√	√
Librarian	√					√	√		√	√			√	√

What each capability does

Table 2 - backup3G capabilities

accessALL	Ability to access all media
backup	Ability to submit a backup or archive job(s)
chg_params	Ability to submit a backup, changing parameters
control	Ability to control running jobs (cancel, hold etc)
display	Display details of the backup job(s)
drive	Ability to perfom drive and load operations
mark_bad	Ability to mark media as bad
maintain	Maintain backup tables
media_mgmt	Ability to manage media, eg: allocate, send offsite
monitor	Ability to monitor running jobs
recover	Ability to perform recovery
recoverALL	Ability to perform recovery to all directories and hosts
retention	Ability to change media data retention period
scratch	Ability to scratch media

Many functions, particularly those that modify system files and COSmanager tables, require specific access capabilities. Users who do not have the right capabilities will not be able to access or even view these functions.

Controlling access to options on the backup3G button bar

Module	Command	Capability Needed
Archive files	menu archive	backup
Schedule or run backups	methtool runback	backup OR maintain OR display
Recovery from backups	methtool msetview	backup OR recover
Media management	methtool medview	media_mgmt OR backup OR maintain OR display
Removable drive management	methtool drview	backup OR maintain OR display
Stacker management	methtool stacker	backup OR maintain OR display
Monitor backup jobs/logfiles	methtool jobstatus	monitor OR backup

Controlling access to backup3G configuration options

	Command	Capability Needed
Maintain backup jobs	methtool backview	maintain OR display
Maintain drives	methtool drive	maintain OR display
Maintain media libraries	methtool stacker	maintain OR display
Maintain backup3G roles	methtool appl_cap	maintain OR display
Maintain backup3G settings	methtool setting	maintain OR display
Maintain other tables	methtool table	maintain AND super

Customizing user access

You can change what roles are assigned to a particular user, or change the capabilities that are assigned to all users with a particular role. Note Changes made to a user’s security profile don’t come into effect until the next time the user invokes COSmanager.

To change	Use
Roles assigned to a user	COSmanager configuration > Users and privileges > COSmanager users
Capabilities assigned to a role	backup3G configuration > Tools > Roles

	Note
	Changes made to a user’s security profile don’t come into effect until the next time the user invokes COSmanager.

Software Environment

Backup3G is installed under the home directory of the COSmanager account. All the files are owned by COSmanager and belong to the COSmanager group, except for a handful of database tables that are owned by root.

Backup3G’s log files are stored in the backlog directory in the system spool area, with the other COSmanager audit trails. COSmanager has a crontab entry to cycle all its audit trails automatically.

COSmanager sets a number of variables in the user’s environment when they start backup3G. These mostly define directory names and the user’s access capabilities. You can check your environment by exiting to a shell from within backup3G and running env .

Startup procedure

When you launch backup3G from COSmanager or through the cos backup command, the startup procedure performs the following steps:

• check that backup3G has a valid licence
• check that the current version of the COSmanager framework is at least the minimum version required by this application
• create environment variables describing backup3G’s directory structure: its home directory ($APPL_HOME), database directory ($APPL_DB), and application path ($APPL_PATH)
• if an application password is required, ask the user to enter it
• if authentication is required, ask for the user’s password
• prepend the application’s directories to the search paths
• create environment variables for any local roles and capabilities. Along with the variables created during COSmanager startup, these determine which facilities the user can access in backup3G
• execute $APPL_HOME/profile to set environment variables specific to backup3G
• display backup3G version information (GUI)
• display the top-level menu or button bar for this user.

User Interface

The user interface to all COSmanager applications is provided through a series of reusable software tools known collectively as The Functional Toolset. Both graphical (GUI) and character (CUI) mode interfaces are provided. As there are only a handful of different types of screen, the interface is very easy to learn.

The GUI mode can also be used from a PC running any version of Windows without the need for X emulation software.

The CUI mode is intended for users who access COSmanager from a character terminal or via terminal emulation from a PC. It features a full-screen interface with support for function keys and pop-up windows.

Keyboard traversal in the GUI interface is consistent with the CUI version. This allows users to swap between X displays, Windows PCs, and character terminals, with minimal retraining and without loss of productivity.

The user interface is described in detail in the COSmanager User Guide.

Where to from here

Information on Backup Jobs

Information on Recovery

Information on Media

Information on Drives and Drive Pools

Setting Up Backup

Initiating and Managing Backups

Recovering Data

Managing Removable Media

Managing Drives

Appendix A - Installing and Configuring

Appendix B - Checking Job Status Codes

Appendix C - Backup Methods and Drivers

Appendix D - Defining Backup Methods

Glossary

---

Copyright © 1990-2024 Functional Software. All rights reserved.