quick start guide onepass agent for macintosh file...

Quick Start GUIDE

OnePass Agent for Macintosh File System

Published On: 11/19/2013 V10 Service Pack 4A of 61

Quick Start Guide - OnePass Agent for Macintosh File System

System Requirements

Supported Features

License Requirements

Administrator

Overview

Deployment

Configuration

Archive

Recover Data

Web Console

Overview

Deployment

Configuration

Setting Up End-User Search

Verify Web

End-User

Recall Stubs

Restore & Download Data

Table of Contents

Getting Started - Setting Up OnePass Agent

Getting Started - Setting Up End-User Recovery


System Requirements - OnePass Agent for Macintosh File System

The following requirements are for the OnePass Agent for Macintosh File System:

1 GB of minimum disk space is required for installing the software.

5 GB of free disk space is required for job result directory.

3 GB of free disk space is required for log directory.

Microsoft Visual C++

Microsoft Visual C++ 2008 Redistributable Package is automatically installed. Note that Visual C++ 2008 Redistributable Package can co-exist with otherversions of this software.

DISCLAIMER

Minor revisions and/or service packs that are released by application and operating system vendors are supported by our software but may not be individually listed in our System Requirements. We will provide information on any known caveat for the revisions and/or service packs. In some cases, these revisions and/or service packs affect the working of our software. Changes to the behavior of our software resulting from an application or operating system revision/service pack may be beyond our control. The older releases of our software may not support the platforms supported in the current release. However, we will make every effort to correct the behavior in the current or future releases when necessary. Please contact your Software Provider for any problem with a specific application or operating system.

Additional considerations regarding minimum requirements and End of Life policies from application and operating system vendors are also applicable

System Requirements Supported Features License Requirements

Operating System Architecture

MAC OS X Mac OS X v10.8.x

Mac OS X v10.7.x

Mac OS X v10.6.x

Mac OS X v10.5.x

Hard Drive

Miscellaneous


Supported Features - OnePass Agent for Macintosh File System

The following table lists the features that are supported by the OnePass Agent for Macintosh File System:


Feature Sub-Feature Support Comments

Advanced Backup/Archive OptionsData tab - Catalog

Data tab - Verify Synthetic FullJob Retry tab

Media tab - Allow other Schedule to use Media SetMedia tab - Mark Media Full on SuccessMedia tab - Reserve Resources Before ScanMedia tab - Start New Media

Startup tab

VaultTracking tab

Comments

Advanced File System iDataAgent Options

Automatic File System Multi-Streaming

On Demand Data Protection OperationRestore by Jobs

Restore Data Using a Map FileComments

Alerts and Monitoring Global Alerts

Job-Based Alerts*

Comments

Automatic Updates Automatic Updates

Comments

Backup/Archive OptionsDifferential Backup

Full Backup

Incremental Backup

Other Backup TypesSynthetic Full Backup

Comments

Backward Compatibility Version 8

Version 9Comments

BrowseBrowse from Copy Precedence

Browse the Latest Data

Browse Using Filters


Exclude Data Before

Find

Full Backup Transparent BrowseImage BrowseNo Image Browse

Page Size

Specify Browse PathSpecify Browse Time

Subclient Browse

Use MediaAgent

View All Versions

Comments

Clustering Netware cluster

Unix ClusterWindows - Microsoft Cluster (MSCS)Windows - Non-Microsoft ClusterComments

Command Line InterfaceCommand Line Interface

Comments

CommCell Migration CommCell Migration

Comments CommCell Migration supports Browse and Restore and recall of stubs operations. However new backups for existing subclients are not supported.

Content Indexing Offline Content Indexing

Comments

Data Aging Basic Retention Rules

Deleting a Job

Extended Retention RulesRetaining a Job

Unique Data Aging RulesComments

Data Compression Client Compression

Hardware Compression

MediaAgent Compression

Comments

Data Encryption Data Encryption Support

Third-party Command Line Encryption SupportComments

Data MultiplexingMultiplexing

Comments

Deduplication MediaAgent Deduplication

Source Deduplication

Comments


Erase Backup/Archived Data Erase Data by Browsing

Erase StubsComments

Global Filters Global Filters

Comments

Installation Custom Package

Decoupled InstallRemote InstallRestore Only AgentsSilent InstallComments

Installing 32-bit Components on a Microsoft Windows x64 Platform

Install 32-bit On x64

Comments

Job Restart - Data ProtectionNot Restartable

Restarts from the BeginningRestarts from the Beginning of the DatabaseRestarts from the Point-of-Failure

Comments

Job Restart - Data RecoveryNot Restartable

Restarts from the BeginningRestarts from the Beginning of the DatabaseRestarts from the Point-of-Failure

Comments

List Media List Media and Size Associated with Specific Files and/or FoldersList Media Associated with a Specific Backup Set or InstanceList Media Associated with Index

List Media Associated with Specific JobsComments

Multi Instancing Multi Instance

Comments

Optimized Scan Optimized Scan

Pre/Post Processes Pre/Post Process with Data Protection and RecoveryComments

Restore/Recover/Retrieve DestinationsCross-Application Restores (Different Application version)Cross-Platform Restores - Different Operating SystemCross-Platform Restores - Same Operating System - Different VersionIn-place Restore - Same path/ destination - Same ClientOut-of-place Restore - Different path/ destinationOut-of-place Restore - Same path/ destination - Different ClientRestore Data Using a Map FileRestore to Network Drive /NFS-Mounted File SystemComments See Advanced Restore - OnePass Agent for Macintosh

File System iDataAgent

Restore/Recover/Retrieve Options Automatic Detection of Regular Expressions


Additional features are listed below:

Filter Data From Recover Operations

Rename/ Redirect Files on RestoreRestore Data Using Wildcard ExpressionsRestore Data with Pre/Post ProcessesRestore from Copies

Skip Errors and Continue

Use Exact Index

Use MediaAgent

Comments

Restore/Recover/Retrieve Overwrite Options

Overwrite Files

Overwrite if file on media is newer

Restore only if target exists

Unconditional Overwrite

Unconditionally overwrite only if target is a DataArchiver stubCommentsComments Applicable to the Local File System.

Schedule Policy Agent Specific Data Protection Schedule PolicyAll Agent Types Schedule Policy

Comments

Storage Policies Incremental Storage Policy*

Standard Storage Policies

Comments Incremental Storage Policy is not supported for archiving agents.

Standard Storage Policies must be created for archive management.

Subclient Policies SubClient Policy

Comments

Upgrade Netware - Local

Unix/Linux/Macintosh - Local

Unix/Linux/Macintosh - SilentUpgrade from CommCell Console

Windows - LocalWindows - Remote (Push)Windows - SilentComments

User Administration and Security Backup Set/Archive Set

SubclientComments

Activity Control Deconfigure/Reconfigure Components


Auxiliary Copy LanguagesCommCell Console MediaAgentGridStor Scheduling Log Files Snapshot EnginesOperation window VaultTracker IntelliSnap Backup Restore/Recover/Retrieve - Other Options VaultTracker Enterprise Job Restart - Data Collection Cloud Storage


License Requirements - OnePass Agent for Macintosh File System

By default, the agent is installed using an Evaluation license. Once the evaluation period is complete, you need to obtain a permanent license from your Software Provider.

You can choose to use one of the following licensing mechanisms:

Traditional License, based upon products and features in your CommCell.

Capacity License, based on the amount of data you want to protect.

For comprehensive information on licensing, see License Administration.

The following license types are available for the OnePass Agent for Macintosh File System.

If you plan to use capacity licenses, you must obtain one of the following licenses for the CommCell:


Traditional License

AGENT/COMPONENT LICENSE TYPE

File Archiver for Unix File System ArchivingMacintosh File System Server File System

Capacity License

LICENSE TYPE LICENSE

CONSUMPTION

Data Archive Enterprise infrastructure 1 license per CommCell for nTerabytes (TB) of protected data

Data Archive Core infrastructure 1 license per CommCell for nTerabytes (TB) of protected data


Getting Started - OnePass Agent for Macintosh File System

The OnePass Agent for Macintosh File System is integrated with the File System iDataAgent as a method to archive files which have been backed up.

The data gets backed up only once as part of the backup operation and the files that meet the archiving rules are stubbed in place. Stubs point to the data that was already moved as part of the backup.

This integrated agent is able to selectively age off items based on data and stubs that are deleted on the primary storage. This allows you to reclaim space in your secondary storage.

Additionally this agent also provides analysis and reporting of the primary storage.

The OnePass Agent for Macintosh File System offers the following key features:

Simplified Data Management

One-Pass Agent enables you to easily manage the backed up data in your environment, by providing pre-defined archiving rules.

Point-In-Time Recovery

In the event of a serious system failure, such as the breakdown of hardware, software, or operating systems, the solution provides a point-in-time recovery of files at any given time.

Recall Throttling

You can configure the stub recovery parameters, such that, you can set the Maximum Number of Stubs in a Recall Job, Time between recalls and Time to wait after maximum successive recalls limit is reached.

Item Level Retention

You can now specify the time period for which you want to retain the deleted files in the backup cycle. This enables you to restore the deleted files from the latest backup cycle. This will be useful for the OnePass clients where you perform frequent incremental backups.

Recursive Recall

You can recall more than one stubbed file at a given time. For example, if there are nested folders you can recall all the stubs at the parent folder level.

The following chart compares the traditional backup and the archiving agent with the OnePass Agent:

Overview Deployment Configuration Archive Recover

Key Features

Comparison Chart

Key Features OnePass Agent for Macintosh File System

Macintosh File System iDataAgent

Data Backup

Data Archiving

Secondary Storage Space Reclamation using Synthetic Full BackupsStub Restore

Data Restore

Stub Retention

Terminology

Archiving is a process of periodically moving unused or infrequently used data on a host computer to secondary storage, thereby


Archivingreducing the size of data on the primary storage.

StubbingThe stubbing phase starts after the archive phase succeeds. Stubs are placeholders of the original data after it has been moved to the secondary storage. Stubs replace the archived files in the location selected by the user during the archive. However, stubs will only be created if the subclient properties were configured to create them during archive.

Data RecoveryThe archived and moved data can be recovered in any of the following three methods:

Recovery of archived files per file paths provided using the CommCell Console. Browse and Recovery of archived files using the CommCell Console.

Stub RecoveryIf the subclient is configured to create stubs, you can perform a recall operation from any workstation for recovering the stubs. Stubs can be recalled using the StubRecaller/Automator utility.

Persistent RecoveryMultiple stub recoveries are submitted to the Job Controller as one job called a Persistent Recovery job. The job will wait for approximately 5 seconds in order to allow other stub recovery requests being submitted on the same client to be batched into the same job.



The OnePass Agent is integrated with the File System iDataAgent as a method to archive files which have been backed up. Only files which meet a predetermined user defined set of rules become candidates for archiving. Follow the steps given below to install the OnePass Agent.

Install the software on a computer from which you want to backup and archive data.

Follow the steps given below to install the File System iDataAgent on a Macintosh computer.

The computer will be added as a client in the CommCell as soon as the installation completes successfully.

System Requirements

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements.

Download Software Packages

Download the latest software package to perform the install.

1. Open CommCell Console:

Click Start and point to All Programs.

Click HDPS .

Click Backup and Recovery Administrative Console.

2. From the CommCell Browser, click Tools | Add/Remove Software | Install Software.

3. Click Next.


Where to Install

Before You Begin

Installation

The software can be installed using one of the following methods:

Method 1: Remote Install Using CommCell Console

Use this procedure to install remotely on a client computer.

Method 2: Interactive Install

Use this procedure to install the software using the custom installation options.

Method 1: Remote Install Using CommCell Console


4. Select Unix and Linux.

Click Next.

5. Click Manually Select Computers.

Click Next.


6. Enter the fully qualified domain name of the client computer.

For example: mycomputer.mydomain.mycompany.comClick Next.

Do not use space and the following characters when specifying the Host Name:

\|`~!_@#$%^&*()+=<>/?,[]{}:;'"

7. Choose one of the following:

Click Next if you want to use the default cache location

Click Override Software Cache and specify a new location in the Software Cache box and then click Next

The software cache is the location from where the remote install program installs the software. This screen will not appear if the remote cache is not configured. For more information, see Managing Cache - Remote Cache.


8. Specify the User Name and Password that must be used to access the client computer, and then click Next.

9. Click File System.

Click Next.

You can also specify the SUDO user credentials here, provided that the user is an Administrator or a member of the Administrator group with root privileges on that computer.

For steps to add a SUDO user to /etc/sudoers, see Frequently Asked Questions - Install.

Account information is required while performing remote installs for the first time on a client. For subsequent remote installs on that client, click Next without specifying the account information.


10. Select the following:

Select a client group from the available Client Groups, and then click Add.

From the Global Filters list, select one of the following:

Use Cell level Policy to inherit the global filter policy configuration set for the CommCell.

Always use Global Filters to apply the global filters policy to the default subclient regardless of the policy set for the CommCell.

Do not use Global Filters if you plan to define specific filters for the Agent.

From the Storage Policy To Use list, select a storage policy.

Click Next.

If you do not have a Storage Policy, the list will not be displayed. You can create a Storage Policy later using the steps described in the Configuring storage Policy section.

11. Click Next.

If necessary you can select additional options. Click the Help button to get more information on the available options.

This screen will not be displayed if Client Groups are not configured in the CommCell Console. For more information, see Client Computer Groups.


12. Click Next.

If necessary you can select advanced options. Click the Help button to get more information on the available options.

13. Click Next.

If necessary you can select optional settings. Click the Help button to get more information on the available options.


14. Select one of the following:

If firewall configuration is not required, click Next.

If this computer and the CommServe is separated by a firewall, click Configure firewall services.

For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

15. Select Immediate.

Click Next.


16. Click Finish.

17. You can track the progress of the job from the Job Controller window of the CommCell console.

From the Home menu, click Job Controller.

Once the job is complete, view the job details from the Admin Job History.

Right-click the <CommServe>, point to View and then click Admin Job History.

Click Select Install/Upgrade/Remove/Repair Software.

Click OK.

This screen will reflect the components you selected for install, and may look different from the example shown.


You can view the following by right-clicking the job:

Details of the job

Option to Resubmit the job

Events associated with the job

Logs associated with the job

Option to send the Logs associated with the job

Several additional options are available for remotely installing the software from CommCell Console, refer to Install Software from the CommCell Console (Remote Install) for more information.

1. Log on to the client as a valid user. In the terminal window, issue the su - root command to substitute your user identity with that for the root user. Then enter a valid password for the root user.

2. If you are installing the software from the Software Installation Discs, run the following command to mount the CD:

Run the following command from the Software Installation Package or mount point:

Method 2: Interactive Install

mount -t iso9660,udf /dev/cdrom /mnt/cdrom

./cvpkgadd

You can also run this command as a SUDO user with root privileges:


3. The product banner and other information is displayed.

Press Enter.

4. Read the license agreement. Type y and press Enter.

5. Press Enter.

6. The default network interface name of the client computer is displayed if the computer has only one network interface (NIC card), press Enter to accept.

If the computer has multiple network interfaces, enter the interface name that is preferred for communication with the CommServe, and then press Enter.

7. The local name of the client computer is displayed, press Enter to accept.

If necessary you can also enter a new (friendly) name for the client, and then press Enter. This name will be used in the CommCell and will also be displayed in the CommCell Console.

Do not use spaces when specifying a new name for the client.

8. Type the number associated with File System and press Enter.

For steps to add a SUDO user to /etc/sudoers, see Frequently Asked Questions - Install.

./sudo cvpkgadd

Selecting Unix Setup TaskPlease select a setup task you want to perform from the list below:Advanced options provide extra setup features such as creating custom package, recording/replaying user selections and installing External Data Connector software.1) Install data protection agents on this computer2) Advanced options3) Exit this menuYour choice: [1]

The interface names and IP addresses depend on the computer in which the software is installed and may be different from the example shown.

Setting Client/Physical Machine Host NameWe found one network interface available on your machine. We will associate it with the client being installed, and it will also be used by the CommServe to connect to the client. Note that you will be able to additionally customize Datapipe Interface Pairs used for the backup data traffic later in the Data Protection Suite Java GUI.Please check the interface name below, and make corrections if necessary:Client/Physical Machine Host Name: [myclient.company.com]

Setting Client NamePlease specify the client name for this machine.It does not have to be the network host name: you can enter any word here without spaces. The only requirement is that it must be unique on the CommServe.Physical Machine Client name: [myclient]

Selecting Modules to Install.[ ] 1) DLO Protection for Laptops [1002] [CVGxBase][ ] 2) UNIX File System Advanced [1101] [CVGxIDA][ ] 3) CommCell Console [1118] [CVGxGUI][ ] 4) Resource Pack [1130] [CVGxRP][ ] 5) CommNet Browser [1134] [CVGxQGUI]


9. Type d for Done, and press Enter.

10. Press Enter.

11. Verify the default path for software installation.

Press Enter.

If necessary, enter a path to modify the default path and press Enter.

Do not install the software to a mapped network drive

Do not use the following characters when specifying the path:

!@#$%^&*():/?\

It is recommended that you use alphanumeric characters only

12. Verify the default path for log files.

Press Enter.

If necessary, enter a path to modify the default path and press Enter.

Do not use the following characters when specifying the path:

!@#$%^&*():/?\

It is recommended that you use alphanumeric characters only

All the modules installed on the computer will store the log files in this directory.

[a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 2

Selecting Modules to Install.[ ] 1) DLO Protection for Laptops [1002] [CVGxBase][X] 2) UNIX File System Advanced [1101] [CVGxIDA][ ] 3) CommCell Console [1118] [CVGxGUI][ ] 4) Resource Pack [1130] [CVGxRP][ ] 5) CommNet Browser [1134] [CVGxQGUI]

[a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]Enter number(s)/one of "a,n,r,q,d,>,<,?" here: d

Deciding if to Install Agents for Restore OnlyDo you want to install the agents for restore only without consuming licenses?Install Agents for Restore Only? [no]

Preparing Installation DirectoryPlease specify where you want us to install Data Protection Suite binaries.It must be a local directory or NFS and there should be at least 281MB of free space available. All files will be installed in a "hds" subdirectory, so if you enter "/opt", the files will actually be placed into "/opt/hds".Installation Directory: [/opt]

Preparing Log DirectoryPlease specify where you want to keep Data Protection Suite log files.It must be a local directory or NFS share and there should be at least 100MB of free space available. All log files will be created in a "hds/Log_Files" subdirectory, so if you enter "/var/log", the logs will


13. Press Enter.

14. Type the Group name and press Enter.

Press Enter again.

15. Type d for done with the selection and press Enter.

16. If you have enabled per-client certificate on CommServe, type y and press Enter.

Else, press Enter.

actually be placed into "/var/log/hds/Log_Files".Log Directory: [/var/log]

Deciding If to Use a Unix GroupMost of Data Protection Suite processes run with root privileges, but some are launched by databases and inherit database access rights. To make sure that registry and log files can be written to by both kinds of processes we can either make such files world-writeable or we can grant write access only to processes belonging to a particular group, e.g. a "hds" or a "dba" group.We highly recommend now that you create a new user group and enter its name in the next setup screen. If you choose not to assign a dedicated group to Data Protection Suite processes, you will need to specify the access permissions later.If you're planning to backup Oracle DB you should use "dba" group.Would you like to assign a specific group to Software? [yes]

Setting Unix GroupPlease enter the name of the group which will be assigned to all Data Protection Suite files and on behalf of which all Data Protection Suite processes will run.In most of the cases it's a good idea to create a dedicated "hds" group.However, if you're planning to use Oracle iDataAgent or SAP Agent, you should enter Oracle's "dba" group here.Group name: testgrp1REMINDERIf you are planning to install Data Protection Suite Informix, DB2, Sybase or Lotus Notes iDataAgent, please make sure to include Informix, DB2, etc. users into group "testgrp1"..Press <ENTER> to continue...

Setting Access Permissions for Group and Other UsersInstaller will assign full access rights to root user for all installed Data Protection Suite files and its processes.For group and any other users, you can specify the access permissions now.If you did not assign a dedicated group in previous step, make sure you specify sufficient access rights for other users if you are also planning to install Data Protection Suite agents involving third party software protection.[X] 1) Allow read permission to group users[X] 2) Allow write permission to group users[X] 3) Allow execute permission to group users[X] 4) Allow read permission to other users[ ] 5) Allow write permission to other users[X] 6) Allow execute permission to other users[a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]Enter number(s)/one of "a,n,r,q,d,>,<,?" here: d


17. Verify the default number of streams. If necessary, modify the number of streams and press Enter.

18. Type yes to apply the changes; this requires a system reboot immediately after the install.

Press Enter.

If desired, press Enter to save the system configuration file changes to another file and apply them manually later.

19. The default port numbers used for CommCell communication is displayed. If necessary, you can modify the port numbers.

Press Enter.

20. Press Enter.

Specifying If CommServe Per-Client Certificate is EnabledIf you have checked "Force per-client certificate authentication on CommServe" on the CommServe or Proxy, you need to provide installer with a Temp Certificate.This Temp Certificate can be obtained by opening "Certificate Administration Applet" from the Java GUI's Control Panel, clicking "Temp Certificate" button, selecting newly created client in the popped up window and copying/pasting generated certificate to a local file accessible from this installer.Have you enabled per-client certificate authentication on CommServe? [no]

Setting Number of StreamsPlease enter the total number of streams that you plan to run at the same time. We need to make sure that you have enough semaphores and shared memory segments configured in /etc/system.Number of Streams [10]

Deciding If to Modify System Configuration FileWe now need to modify the /etc/sysctl.conf and /boot/loader.conf configuration file on this computer. It is done to make sure that there will be enough shared memory and semaphores available for Data Protection Suite programs.

Please review the changes below, and answer "yes", if you want us to apply them to /etc/sysctl.conf and /boot/loader.conf file. Otherwise the installation will proceed, the changes will saved to some other file, and you will have to apply them manually.

***IMPORTANT*** PLEASE APPLY THE CHANGE AND REBOOT IMMEDIATE AFTER INSTALL.kern.ipc.shmmax=2147479552 (unchanged)kern.ipc.shmall=524287 (unchanged)kern.ipc.shmmin=1 (unchanged)kern.ipc.shmmni=5792 (was:5152)kern.ipc.shmseg=5768 (was:5128)kern.ipc.semmns=93141 (was:92501)kern.ipc.semmni=87381 (unchanged)kern.ipc.semmsl=93141 (was:92501)

Do you want us to apply these changes now? [no] yesChanges saved into /etc/sysctl.conf.gal.tmp.717.

Setting Instance Port Number of cvdEvery instance of Data Protection Suite should use a unique set of network ports to avoid interfering with other instances running on the same machine.The port numbers selected must be from the reserved port number range and have not been registered by another application on this machine.Please enter the port numbers.Port Number for CVD : [8400]


21. Do one of the following:

If firewall configuration is not required, press Enter.

If this computer and the CommServe is separated by a firewall, type Yes and then press Enter.

For firewall options and configuration instructions, see Firewall Configuration.

22. Type the fully qualified domain of the CommServe host name and press Enter.

Do not use space and the following characters when specifying the CommServe Host Name:

\|`~!@#$%^&*()+=<>/?,[]{}:;'"

23. Choose one of the following:

1 - To inherit global filter policy configuration set for the CommCell.

2 - To apply the global filters policy to the default subclient regardless of the policy set for the CommCell.

3 - If you plan to define specific filters for the Agent.

Press Enter.

24. Type the appropriate number to select the Client Group and press Enter.

Setting Instance Port Number of EvMgrCEvery instance of Data Protection Suite should use a unique set of network ports to avoid interfering with other instances running on the same machine.The port numbers selected must be from the reserved port number range and have not been registered by another application on this machine.Please enter the port numbers.Port Number for CVD: 8400Port Number for EvMgrC: [8402]

Deciding If to Configure FirewallYou need to configure firewall settings if there is a firewall between this client and the CommServe.Is there a firewall between this client and the CommServe? [no]

Setting CommServe Host NamePlease specify hostname of the CommServe below. Make sure the hostname is fully qualified, resolvable by the name services configured on this machine.CommServe Host Name: mycommserve.company.com

Selecting How to Set Commcell Level Global FiltersCommcell Level Global Filters are set through Data Protection Suite GUI's Control Panel in order to filter out certain directories or files from backup Commcell-widely.If you turn on the Global filters, they will be effective to the default subclient.There are three options you can choose to set the filters. Please select how to set the Global Filters for the default subclient?1) Use Cell level policy2) Always use Global filters3) Do not use Global filtersYour Choice: [1]

This screen will be displayed only if Client Groups are configured for the CommCell.

Selecting Client Computer GroupsClient Group(s) is currently configured on CommServe mycommserve.company.com. Please choose the group(s) that you want to add this client myclient.company.com to.[ ] 1) Client Grp1


25. Type d for Done, and press Enter.

26. Press Enter.

If you do not have a Storage Policy, the list will not be displayed. You can create a Storage Policy later using the steps described in the Configuring storage Policy section.

If you do not have a Storage Policy created, use the following steps to create a storage policy:

To create a storage policy, you must have configured a library in the CommCell.

If you do not already have a library configured, go to Disk Library Creation.

If you have a library configured, go to Storage Policy Creation.

DISK LIBRARY CREATION:

1. From the CommCell Browser, navigate to Storage Resources, right-click the Libraries, point to Add and then click Disk Library...

Alternatively, you can also navigate to MediaAgents, right-click <MediaAgent>, point to All Tasks | Create Library and then click Disk Library...

2. From the Add Disk Library dialog box, specify the following:

In the Name box, specify name of the disk library.

From the MediaAgent list, select the MediaAgent.

Perform one of the following:

Select Local Path if you wish to specify a local path in the MediaAgent computer.

In the Disk Device box, type the name of the folder in which the disk library must located or click button to select the folder.

Select Network Path, if you wish to specify a network path as the target share.

In the Connect As box, type the user name.

[a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 1

Selecting Client Computer GroupsClient Group(s) is currently configured on CommServe mycommserve.company.com. Please choose the group(s) that you want to add this client myclient.company.com to.[X] 1) Client Grp1[a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]Enter number(s)/one of "a,n,r,q,d,>,<,?" here: d

Deciding if to Configure Storage PolicyWould you like to configure Storage Policy on this client?Configure? [no]

Adjusting modes and permissions of files...done.Starting Data Protection Suite services...done.Thank you for choosing Data Protection Suite.

There seem to be no Storage Policies configured on the CommServe. Before you can run any backups of this IDA, you will need to install a MediaAgent, create a Storage Policy and assign it to all subclients..

Configuring Storage Policy


In the Password and Verify Password box, type the password to access the network share.

In the Folder box, type the mount path or click button to select a mount path.

Click OK.

3. The newly created disk library will be displayed under Libraries node.

Storage Policy Creation

1. From the CommCell Browser, navigate to Policies.

2. Right-click the Storage Policies and then click New Storage Policy.

3. Follow the prompts displayed in the Storage Policy Wizard. The required options are mentioned below:

Select the Storage Policy type as Data Protection and Archiving and click Next.

Enter the name in the Storage Policy Name box and click Next.

From the Library list, click the name of a disk library to which the primary copy should be associated and then click Next.

Ensure that you select a library attached to a MediaAgent operating in the current release.

From the MediaAgent list, click the name of a MediaAgent that will be used to create the primary copy and then click Next.

For the device streams and the retention criteria information, click Next to accept default values.

Select Yes to enable deduplication for the primary copy.

From the MediaAgent list, click the name of the MediaAgent that will be used to host the Deduplication Database (DDB).

In the Location box, type the name of the folder in which the DDB must be located or click the Browse button to select the folder and then click Next.

Review the details and click Finish to create the Storage Policy.

Silent Install

Deploy the software silently on multiple clients.

Additional Installation Methods



Once the File System iDataAgent is installed, the OnePass Agent can be enabled by following these steps.

1. From the CommCell Browser, navigate to Client Computers | <Client>.

Right-click File System, and then click Properties.

Select the Enable for Archiving check box.

2. From the CommCell Browser, navigate to <Client> | File System | defaultBackupSet.

Right-click the defaultBackupSet, point to All Tasks, and then click New Subclient.

3. In the Subclient Properties of <Subclient> dialog box, type the name of the subclient in the Subclient name box.



4. Click the Content tab.

Click Add Paths, and then type the path to the data that you want to backup and archive.

5. Click the Disk Cleanup tab, and then select the Enable Archiving with these rules check box.

To archive your files immediately, set the rules accordingly based on the file access time, modified time, or file size.

Click OK.


6. Click the Storage Device tab.

In the Storage Policy box, select the storage policy.

Click OK.

If you do not have a storage policy created, follow the steps given below to create a Storage Policy.


7. Creating a Storage Policy:

a. Click Create Storage Policy.

b. Follow the prompts displayed in the Storage Policy Wizard. The required options are mentioned below:

i. Select the Storage Policy type as Data Protection and Archiving and click Next.

ii. Enter the name in the Storage Policy Name box and click Next.

iii. From the Library list, click the name of a disk library to which the primary copy should be associated and then click Next.

Ensure that you select a library attached to a MediaAgent operating in the current release.

iv. From the MediaAgent list, click the name of a MediaAgent that will be used to create the primary copy and then click Next.

v. For the device streams and the retention criteria information, click Next to accept default values.

vi. Select Yes to enable deduplication for the primary copy.

vii. From the MediaAgent list, click the name of the MediaAgent that will be used to host the Deduplication database (DDB).

In the Location box, type the name of the folder in which the DDB must be located or click the Browse to select the folder, and then click Next.

viii. Review the details and click Finish to create the Storage Policy.



Once the OnePass Agent is enabled, perform a full backup to archive the backed up files.

The default subclient has the root directory as the subclient content. Therefore a backup and archive job run on the default subclient results in backing up the entire root directory. In order to run a back up and archive of selective data files, run the backup on a user-defined subclient with specific content.

The following section provides step-by-step instructions for performing your first backup.

1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | defaultBackupSet.

Right-click the <Subclient> and click Backup.

2. In the Backup Options for Subclient dialog box, click Incremental.

Click Immediate.

Click OK.

3. You can track the progress of the job from the Job Controller window.


Perform a Backup


4. Once the backup process is completed, archiving rules are applied per volume (mount point) level and files that meet the stubbing rules are stubbed.

Stubs are placeholders of the original data after it has been migrated to the secondary storage.

Stubs replace the backed up files in the location selected by the user during backup.

After stubbing, the block size of the files on the disk reduces to a single block.

Files before stubbing

Files after stubbing

5. Once the job is complete, you can view the details of the job from the backup history. Right-click the subclient, and then click Backup History.

6. In the Backup History Filter for dialog box, click OK.

7. Files that satisfy the archiving rules will be stubbed when a backup is run. To see the files that got stubbed:


From the CommCell Browser, navigate to Client Computers | <Client> | File System | <BackupSet>.

Right-click the <Subclient>,and then click Browse and Restore.

in the Browse and Restore Options dialog box, click View Content.

In the Client Browse window, the files that got stubbed are shown as Stub in the Type column.

What Gets Archived

The OnePass Agent archives the following file systems:

What Does Not Get Archived

The following file types/objects are automatically filtered out of archive operations by the system, and will not be archived.

Sparse files (Example: File Archiver stub files)

Install directory

Job Results directory

Log files directory

/usr system directory

/kernel system directory

/etc system directory

/tmp directory

Files with extensions *.a, *.ksh, *.csh, *.sh, *.lib, and *.so are automatically filtered out of subclient content by default. Similarly, files in the following directories are also skipped from archiving.

/usr/**

/bin/**

/lib/**

/boot/**

/dev/**

/etc/**

/var/**

/tmp/**

/sbin/**

/lib64/**

/opt/**

/sys/**

/kernel/**

/devices/**

/proc/**

Operating System Archived File SystemsMacintosh Hierarchical File System (HFS)

Hierarchical File System plus (HFS+)

The file system should be mounted with extended attribute option for OnePass Agent to function. If extended attribute is not enabled in the mount point, files will be backed up but will not be archived.


/selinux/**

/stand/**

In addition to the above, there are also platform specific files that are automatically filtered from archiving.

Darwin - /**/*.dylib, /**/*.scpt, /Applications/**, /Developer/**, /Library/**, /Network/**, /System/**, /Volumes/**, /private/**



To recover the stubs, the user should be a sudo user and/or part of Galaxy Service Account group.

Follow the steps given below to recall a single stub:

1. Open a Terminal or Console Window, navigate to the <Software_Installation_Directory>\Base directory and type the following:

Where:

<file> is the full path of the file to be recalled.

<instance name> is specified in case there are more than one Data Protection Suite instances installed on the client computer.

StatusOnConsole option can be either Off or On.

If you wish to see the status of successful /failed recalled files on console set this option to On.

If you do not wish to see the status of successful /failed recalled files on console set this option to Off.

2. If the StatusOnConsole is enabled then you will see recall status on the console.

For example:

Use the following procedure to restore deleted files. Deleted stubs that are not yet aged, can also be recovered by performing a Browse and Restore.

1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | defaultBackupSet.

Right-click the <Subclient>, and then click Browse and Restore.


Recover Stubs

/StubRecaller <file> [-instance] <instance name> [-StatusOnConsole] <on / off>[-help]

Successfully recalled file /rpool/TempFil_00006.txt

The output of all the recall jobs can also be verified from the StubRecaller.log. This log is available at /var/log/<Software_Installation_Directory>/Log_Files/StubRecaller.log

Browse and Restore from CommCell Console


2. In the Browse and Restore Options dialog box, click View Content.

3. Select the folder level under the backup set. The entire content in that folder is automatically selected in the right pane.

Click Recover All Selected.

4. In the Restore Options for All Selected Items dialog box, click OK.

If you wish to restore the backed up data which may be stubbed, select Restore data instead of stub.


5. You can monitor the progress of the restore job in the Job Controller window.

6. Once job is complete, you can view the details of the job from the restore history.

Right-click the <Backup Set>, and then clcik View | Restore History.

Click OK.

7. Right-click the job and select View Job Details.


Congratulations - You have successfully completed your first Archive and stub recovery.

If you want to further explore this feature read the Advanced Options section of this documentation.


Getting Started - Web Console

The Web Console is a web-based application that allows end-users to manage their archived data. The console behaves as a self service application allowing you to perform backup, restore, download and other operations.

You can easily access their data using the Web Console from any remote computer that runs a web browser.

The Web Console provides access to a variety of data management operations, as shown in the image below.

The following sections describe the key features provided by the Web Console:

Performing Backup and Restore of your Data

The Web Console allows you to perform the following data management operations:

You can access your client data from the Web Console and set up your own backups. Backup operations can be monitored, and the backed up data can be later searched, downloaded and restored.

You can view, search and download your mailbox items.

You can synchronize your documents, pictures and other files between your computers (e.g., home and work computer) so you have access to your files anytime.

Viewing and Analyzing Web Reports

The Web Console provides access to a number of reports which you can use to monitor different activities occurring in the CommCell.

Downloading Software Packages

The Web Console allows you to download software packages (hosted by the Administrator) from a centralized location in the console.

Managing Virtual Machines

The Web Console provides virtual machines users with the ability to create, manage and recover their own virtual machines.

Overview Deployment Configuration Setting Up End-User Search Verify Web Console

Key Features



Two components are needed to set up your environment:

Web Server

A web service that communicates with the CommServe to provide end-users access to CommCell operations on the web.

Web Console

A web-based application that allows end-users to manage their data, as well as other operations such as reporting, virtual machine management, etcetera.

By default, these components are automatically installed along with the CommServe in a production server where IIS is enabled.

If the CommServe computer did not have IIS enabled or if you want to install the Web Server and Web Console separately, select the setup configuration that meets your needs:

Install Web Server and Web Console in the same Computer

Use this procedure to install the Web Server and Web Console in a dedicated server in which no other CommCell component is installed.

Install Web Server and Web Console on Different Computers

Use this procedure to Install the Web Server on a dedicated server and the Web Console on a computer outside the organization's network.

This procedure will set up the Web Console in a DMZ to provide global access for external users.


Installing the Web Server and Web Console



The following sections describe the configurations required to provide end-users with the ability to access and manage their data from the Web Console or from the mobile application.

Adding an External Domain

To allow users from an external domain to access the Web Console, you need to provide the details to communicate with the Active Directory service provider (such as domain name, hostname of directory server, directory service type, username and password) so that it will be maintained in the Web Server database for authentication purposes.

Adding a new domain controller registers the external domain with the Web Server. Use the steps below to add a domain controller:

1. Ensure that LDAP is configured on the Active Directory (AD) server:

From the AD Server, select Start | Run.

Type ldp on the Run dialog box and click OK.

Click the Connections menu option, and select Connect.

From the Connect dialog box, enter the following information:

Server: Type the name of the external domain server, e.g., computer.domain.com.

Port: Type 636 as the port number for the external domain server.

SSL: Select this checkbox to check for the proper certificate.

Click OK.

When the LDAP is properly configured, the external domain server details will be displayed in the LDP window. Otherwise, an error message will appear indicating that a connection cannot be made using this feature.

2. From the CommCell Browser, expand the Security node, right-click Name Servers | Add New Domain and click Active Directory.


If you have already configured an external domain in the CommCell, ensure that steps 6, 7 and 8 were performed after adding the domain.


3. Enter the domain name in NetBIOS Name box, e.g., mydomain.

Enter the Fully Qualified Domain Name (FQDN), e.g., mydomain.mycompany.com in the Domain Name text box.

Click the Enable SSO check box. This will allow users to automatically log on to the CommCell Console and Web Console.

4. Click Edit to enter the user account information of the domain.

Type Username and Password in Enter User Account Information.

Click OK.


5. Click OK.

6. On the Web Console computer, navigate to the <Software Installation Directory>\WebConsole\WEB-INF\classes directory, open the config.properties file, and locate the SecurityProtocol property. By default, this property is set to 1 for Negotiate (Kerberos).

If Kerberos does not work, change the property to 2 for NTLM and restart the services mentioned in steps 7 and 8. These steps are not needed if the SecurityProtocol property was not changed.

7. Restart the IIS services on the computer where the Web Server is installed, and then do the following:

Click the Start button on the Windows task bar and then click Administrative Tools.

Click Services.

In the Services window, select and right-click IIS Admin Service and click Restart.

Restart Other Services dialog will be displayed, click Yes.

8. Restart the Tomcat service on the computer where the Web Console is installed.

By default, the following users are designated as owners of a client in the CommCell and will also be able to manage the client data using the Web Console:

Active Directory users who are member of the Local Administrators group of the client.

The user account used while registering a new client with the Register Me tool.

The user account used for installing the Laptop Backup package.

You can add other users as owners to a client computer to enable future backup and restore operations through the Web Console.

Use the following steps to include users who are not members of the Administrators group. These steps will add new owners to a client in the Laptop Backup group as example.

Assigning Owner For Client Computers


1. From the CommCell Browser, expand the Client Computer Groups | Laptop Backup.

2. Right-click the <Client> and then click Properties.

3. Select the Security tab.

4. Specify owner in the Client Owner box.

You can specify the Active Directory user accounts or CommCell user accounts.

5. Click OK.

1. From the CommCell Browser, navigate to Security.

Right-click the CommCell User Groups and select New User Group.

2. Enter the following information in the New User Group Properties dialog box:

a. Type the user group name in the Name box.

Setting Up Permissions for End-Users


b. Type a description of the user group in the Description box.

c. Select the options based on the following:

3. Click the Capabilities tab.

Click > to move the selected capabilities to the Assigned Capabilities list box.

Make the following selections based on the type of users in the user group:

IF YOU WANT TO... THEN...allow users to have all available capabilities Select All Capabilitiesallow users to browse across all clients that have been backed up and associated with the user Select All Associationconfigure specific capabilities and associations for this group Proceed to step 3.

FOR... ASSIGN...end users End User Accesscompliance search users Browse

Compliance Search(to restore data) In PlaceRecovery


4. Expand Client Computers node and select the client computers to be browsed.

Click OK.

5. Ensure that the specific external user group in which the user belongs has Group Scope defined as Global on the Active Directory Domain:

a. Navigate to Start | Administrative Tools | Active Directory Users and Computers.

Select Associated Entities at either the client or backup set levels. Subclient level browsing restrictions are not supported for Web Console.


b. Right-click the external group and select Properties.

c. Select Group from Group Scope and click OK.

6. From the CommCell Browser, navigate to Security | Name Servers |<Domain Name>.

Right-click the External Groups and select Add New Group.

7. Click Browse.

Select the <external user group name> in which the user belongs.


8. Select the CommCell User Group to associate with the specified external user group.

Click > to move the selected group to the Associated CommCell Groups.

Click OK.

Ensure that name servers of all the relevant domains (of which emails will be content indexed) are registered in the CommCell before running a content indexing job to avoid the duplicate entries of the users in the refinements and also to avoid the Globally Unique Identifier (GUID) instead of email address in the Custodian refinement.



SKIP THIS PAGE IF YOU DO NOT WISH TO ENABLE CONTENT BASED SEARCHYou can run a content based search on your backed up emails. Setting up the Search Engine will allow you to index highly distributed mails and will enable the end-user to run granular searches on his backed up mails.

Follow the steps given below to setup the Search Engine:

1. Install Search Engine. For details, see Deployment - Search Engine.

2. Configure the Search Engine. for details see, Configuration - Search Engine.

3. Once you have enabled content indexing , it is recommended to run a Content Indexing job. For details, see Content Indexing - Running First Job.




Use the following steps to log into the web console and perform a search and restore operation:

1. Open your web browser and type the Web Console URL in the address bar. The URL should be in the following format:

http://<HostName>:<Port>/webconsole

2. Type your login credentials and click Login to access the Web Console.

3. Click My Data.

4. Under My Data, click the <UNIX_Client>.



5. Click Select Files.

6. Select the file to be restored from the search result and click Download.

7. Click Save to download the file to your local disk.


Recall Data - OnePass Agent for Macintosh File SystemTo recover the stubs the user should be a sudo user and/or part of Galaxy Service Account group.

Follow the steps given below to recall a single stub:

1. Open a Terminal or Console Window, navigate to the <Software_Installation_Directory>\Base directory and type the following:

Where:

<file> is the full path of the file to be recalled.

<instance name> is specified in case there are more than one Data Protection Suite instances installed on the client computer.

StatusOnConsole option can be either Off or On.

If you wish to see the status of successful /failed recalled files on console set this option to On.

If you do not wish to see the status of successful /failed recalled files on console set this option to Off.

2. If the StatusOnConsole is enabled then you will see recall status on the console.

For example:

3. You can track the progress of the job from the Job Controller window.

Multiple stub recoveries are submitted to the Job Controller as one job called a Persistent Recovery job. The default timeout for a persistent recovery job is 24 hours.

4. Once job is complete, you can view the details of the job from the restore history:

Right-click the BackupSet, and then click View | Restore History.

Click OK.

/StubRecaller <file> [-instance] <instance name> [-StatusOnConsole] <on / off>[-help]

Successfully recalled file /rpool/TempFil_00006.txt

The output of all the recall jobs can also be verified from the StubRecaller.log. This log is available at /var/log/<Software_Installation_Directory>/Log_Files/StubRecaller.log


5. Right-click the job, and then click View Job Details.

6. After recovery, stubs are replaced by files in the location specified.

Recovered files:

Stubbed files:


Restore & Download Data - OnePass Agent for Macintosh File System

Restoring Data

Downloading Files and Folders

Restoring/Downloading Previous Versions of a File

Browsing DataFrom a Specific DateFrom a Specific Date Range

Hiding Deleted Data during Browse

Controlling Restore Jobs

Viewing the Details of Recent Restore Jobs

You can restore data or stubs to a different client computer. However, restores to the same or different file server (UNC path) is not supported.

Use the following steps to browse and restore data to a different computer from where it was backed up.

1. From the Web Console, click My Data.

2. Under My Computers, click Restore for the computer containing the data that you want to restore.

You can also click the <Computer Name> to open the computer summary page, and then click Select Files under the Restore section.

3. From the Restore Files page, navigate to the folder containing the data to be restored.

4. Select the check boxes next to the data, and then click Restore to open the Restore Options dialog box.

If your file is content-indexed, clicking on that file will display the preview in the right pane. For grid view display of files, clicking on a file will preview the content in a new window.

5. Clear the Restore to Original Computer check box and select the computer where you want to restore the data from the Destination Computerlist.

6. Click the icon to locate the destination path. From the Select Restore Destination Path dialog box, find the folder and then click Select.

7. Click Restore Now.

To track the progress of the restore job, click the job ID from the top of the page. This will take you to the computer summary page, where you can see the progress in the Current Restore Status box under the Restore section.

You can download one or more of your backed up files and folders to a specific location in your computer. During the download operation, if you select

Table of Contents

Restoring Data

Downloading Files and Folders


multiple files or folders, the data will be compressed and downloaded as a zip file.

Use the following steps to download multiple files as an example:


2. Under My Computers, click Restore for the computer that contains the data that you want to download.

You can also click the <Computer Name> to bring the computer summary page, and then click Select Files under the Restore section.

3. From the Restore Files page, navigate to the folder containing the data to be downloaded.

4. Select the check boxes next to the data and then click the Download button.

5. Click Save to download the data to your computer.

Between backups, the data may undergo modifications. If you want to recover old versions of the backup data, use the following steps to restore or download the previous backup versions of a file.


2. Under My Computers, click Restore for the computer that contains the file that you want to restore.

3. From the Restore Files page, navigate to the folder where the file resides.

4. Click the down-arrow next to the file and then click View Versions.

All versions of the file are displayed. For example, if the file has two version, it will be listed as file (1) and file (2).

By default, the latest backups are displayed when browsing the backup data of a computer in the Web Console. You can browse the data from a specific date or range of dates using the steps described in the sections below:

From a Specific Date

Restoring/Downloading Previous Versions of a File

Browsing Data



2. Under My Computers, click Restore for the computer that contains the data that you want to browse.

3. From the Restore Files page, click Showing latest backups and select Show backups to a specific date.

4. Select the date when the backups you want to see took place and click OK.

The browse window will refresh and show the backups from the date you selected.

From a Specific Date Range



3. From the Restore Files page, click Showing latest backups and select Show backups for a date range.

4. Specify the range of dates which includes the backups that you want to see and click OK.

The browse window will refresh and show the backups from the specified date range.

When data from previous backups has been deleted, you can hide the deleted items from the browse view using the following steps:



3. From the Restore Files page, click Hide Deleted Items.

Jobs can be controlled in a number of ways. You can pause, resume and kill a restore job.

Hiding Deleted Data during Browse

Controlling Restore Jobs


When running a restore from the Web Console, use the following steps to perform a control operation on the running job:

1. After starting the restore operation, click the job ID from the top of the page. This will take you to the computer page.

2. From the Current Restore Status box, select the operation that you want to perform:

Pause

This option temporarily stops the job. The job enters a suspended state, where it can be resumed at a later time.

Resume

If you paused the job, this option returns it to the running state.

Kill

This option terminates the job.

3. Once the operation is performed, the job changes to the selected state.

Use the following steps to view the job details of recent restore operations that ran on a computer:


2. Under My Computers, click the <Computer Name>.

3. Under the Restore section, click Recent Restore Jobs.

A list with all the recent jobs that ran on the computer are shown in a table.

Viewing the Details of Recent Restore Jobs


quick start guide onepass agent for macintosh file...

Documents