Chat now with support
Chat with Support

Metalogix Archive Manager for Files 8.1.1 - Administration Guide

About the documentation Enterprise Manager – Common Part
How to manage more Archive Manager servers Restrictions tab Settings tab Scheduler tab Archive tab Post Processing tab Statistics tab System context menu
Other functionality Addendum

Statistics tab

 

This tab was designed to give the administrator fast, reliable and comprehensive information about archived and retrieved files. The number of files, their size as well as space saved on the disc at archiving – all these essential data can be sorted by folder, user and time period. Exporting the statistics to chosen folder is also possible.

 

a-tab

 

As a first step, in the Type down-drop box choose whether you want to generate statistics for Archived or Retrieved files.

 

Then select the statistics specification in the Statistics down-drop box:

 

 

All

-

returns data on saved space and number and size of all archived files

 

Yearly statistics

-

returns data on saved space and number and size of archived files for the chosen sequence of years

 

Monthly statistics

-

returns data on saved space and number and size of archived files for the chosen sequence of months

 

Daily statistics

-

returns data on saved space and number and size of archived files for the chosen sequence of days

 

Hourly statistics

-

returns data on saved space and number and size of archived files for the chosen sequence of hours

 

Additional statistics are available for Archived files (“Archived” is selected in the Type down-drop box):

 

 

User based statistics

-

returns data on saved space and number and size of files archive by the selected user or all users (including jobs)

 

Folder based statistics

-

returns data on saved space and number and size of files archived in the selected folder

 

NOTE: All the above mentioned statistics types DO NOT take into consideration versions of archived files. Only data for the current versions of the archived files are collected. In case of archived files it is possible to get statistics also for their versions. To generate the statistics for versions (not including the actual version) select Archived yearly statistics – versions, Archived Monthly statistics – versions etc.

 

After specifying your desired statistics click the Generate button (ARCHIV~1_img180). Depending on the chosen type of statistics you will be asked to specify the time span for the statistics, user or folder.

 

Example: To set the period for which you want to generate the statistics use the down arrows to open the calendar. Then select the date. You can also simply rewrite the values. Then click OK.

b-period

 

Statistics get displayed in the Results pane.

c-results

 

Click Export (ARCHIV~1_img183) should you wish to export the statistics as an .rpt, .html, PDF or .xls file to your desired location.

System context menu

 

With Archive Manager for Files you may archive/retrieve through system context menus. There are several system context menus, depending on where you click with your right mouse button.

 

If you select several folders and then click with your right-mouse button, the context menu allows you may choose to archive all, archive all recursively (i.e. subfolders included), retrieve all, or retrieve all recursively.

At archiving, the default retention category is used.

 

NOTE: If none of the retention categories (under Settings / General tab) is marked as default, system context menu for archiving/retrieving is not accessible.

 

a

 

If you select several files and then click with your right-mouse button, the following menu opens. You may choose to archive all, or retrieve all.

 

b

 

Select one file and then click with your right-mouse button. You may choose to archive the file if it has not been archived yet (see the screenshot below). If you select an archived file, you can retrieve it via the context menu.

 

c

 

Other functionality

Free Space Checking

In order to prevent free space to get too low on a file server, it is possible to allow retrieving of archived files only under certain conditions. The administrator can define the minimal amount of the free space for which retrieving will be allowed. If the amount of the free space left is smaller than the minimal amount, retrieving will fail.

 

The minimal free space can be defined in figures or percentage for individual disks and UNC paths or it can be set globally as well.

To activate the free space checking functionality, the new key CheckFreeSpace has to be added to registry:

HKEY_LOCAL_MACHINE \ Software \ Metalogix \ fsaPAM \ CheckFreeSpace

Then add a new string value for every disk or UNC path for which you want to check the free space. To check all disks and UNC paths globally, set an asterisk “*” as a Value name.

Syntax:

Value name

Data

Disk name with “:”

or

UNC path starting with “\\”

or

every path will be checked if asterisk “*” is set

Value in

- percentage “%”

- bytes “B”

- kilobytes “KB”

- megabytes “MB”

- gigabytes “GB”

- terabytes “TB”

 

Examples:

Value name

Data

*

20%

C:

30%

D:

300 GB

\\fileserver1

5%

\\fileserver2\data

100 MB

w-other

To apply the changes, all MAMfsa services have to be restarted in Start / Programs / Administrative tools / Services.

 

Size Faking Feature

 

At archiving, Archive Manager for Files transfers an archived file to HSM system, i.e. to the archive. Only a shortcut of few kilobytes remains at the original location of the file and thus Archive Manager saves storage space. However, when using quota management software sometimes it is required that the archived file (i.e. shortcut) be displayed with the size of the original file. This feature has to be set in registry under:

HKEY_LOCAL_MACHINE\SOFTWARE\Metalogix\fsaPAM\SparseGlobal

 

When the SparceGlobal key value is set to:

1 – the shortcut will be displayed with the size of the original file

0 – the shortcut will be displayed with its actual size

NOTE: The shortcut will be also displayed with its actual size, if the key is not present in the registry.

 

To set this feature also for HTML shortcuts, the SparceGlobal key has to be set to value “1” and SparseHTML key has to be set to value “1” as well. As a result also HTML shortcuts will be displayed with the size of the original file.

 

To apply the changes, all MAMfsa services have to be restarted in Start / Programs / Administrative tools / Services.

 

NOTE: As compression is not supported on PSFS, the size faking feature is not supported on PSFS.

 

FIltering for Log Files

 

It is possible to considerably shorten log files accessible in the Enterprise Manager on the Scheduler / Reports tab by not including less important information into them, i.e. log entries for “Already archived” messages will be filtered out.

 

To activate filtering, a new key LogIsArchived has to be added to the registry under

 

HKEY_LOCAL_MACHINE\SOFTWARE\Metalogix\fsaPAM

 

Right-click inside the right pane, choose New > DWORD value and set this new created LogIsArchived key to “0”.

 

 

To apply the changes, all MAMfsa services have to be restarted in Start / Programs / Administrative tools / Services.

 

Addendum

 

Applying product license

 

If you are prompted to apply the license there are two options:

·Archive Manager server has an internet connection (a)

·Archive Manager server has NO internet connection (b)

 

a)If the server has an internet connection, follow the next steps:

 

-Enter your license key and click Next.

-NOTE: If the internet access is filtered out by a proxy on the server, click the Set proxy link to enter the proxy settings.

-The license will be validated and you can continue the installation.

 

x-license

 

b)If the server has NO internet connection, follow the next steps:

 

-Enter your license key.

-Select the Offline activation radio button and click Next.

-Copy the Activation request text from the Activation request text box or save it as a file (click the Save to file link)

-On a machine with internet access open the Activation URL (listed under the Activation Request).

-Paste the Activation Request text you have copied or Browse for the file you have saved and click Activate

-Activation text is generated. Again copy the text or save it as a file

-Back on the Archive Manager server click Next to proceed to the Enter your Activation Response dialog. Paste the Activation text you have copied from the our web page or load the file.

-Click Next, then Finish.

 

NOTE: In case your Archive Manager server has no Internet connection permanently, you will be asked to revalidate your license periodically. It is the same process as described in the part b) above.

 

 

Description of the Archive Manager for Files registry values

 

These values are defining the basic behavior of our product and can be found in the Windows registry under the path:

 

HKEY_LOCAL_MACHINE\SOFTWARE\Metalogix\fsaPAM

 

AllowRemoteDrives

whether the „Storage“ tab is enabled in the manager

DBCommandTimeout

overrides the default timeout for DB command used in handler service (in seconds); values less than 30 will configure the system to use 30s

dbconnectionstring

database connection string

dbconnectionstringADO

database connection string used by the Handler service

dbpassword

encoded database password, machine dependent

dbschema

Archive Manager database schema

dbtype

database type

dbuser

database user, account used when creating database connections

dbversion

Archive Manager database version

DebugOutputFlags

set by the FilePamDbg.exe application, used for gathering debug information

fsaLogDir

base path of the job log files

fsaPamGuardTimer

defines, when the Guard service should restart the other services. Value entered is in minutes after midnight. If set to 0xffffffff, the services won’t be restarted in the night. Recommended to set the value to 0xffffffff

HSMServer

indicates the HSM server

LogFilePathName

the path of the log file used by the Archive Manager core service to store information about current archive and retrieve processes

LogIsArchived

flag, by default set to 1. This registry entry is not created automatically. If set to 0, the job logs will not contain information about files, which were not being archived because they were already shortcuts

MinSizeToShortcutB

defines the minimum size of a file, which can be replaced with a shortcut after archiving

NetAppBackupUsers

defines one domain user for which the screen requests from NetApp will not retrieve the file back to the original location on filer; supported format: <Domain>\<User>

RunServices

tells the Guard service, which other Archive Manager services to start. The value is a bitmask: 1 - Handler service, 2 - Remote server service, 4 - Archiver service. If set to 7, all other services will be started

RemoveExtendedAttribs

If set to 0, files with extended attributes are archived but the shortcut is not created.

If set to1, extended attributes are removed and the original file is archived and replaced by shortcut.

ScriptPath

the path to the database scripts

ShortcutXMLTag

used in the case of kernel type shortcuts (not HTML, NetApp or Celerra), if set to 1, the information stored in the reparse point is written into the content of the shortcut. Recommended to set the value to 1

SparseGlobal

indicates whether the file size faking feature is turned on (1) or off (0) globally for all shortcut types. Some customers using quota management software might have problems with size faking (see “Size faking feature”)

SparseHTML

The same functionality focused just on HTML shortcuts. If set to 1, the HTML shortcuts will have the same logical size of the shortcut as the original file had (see “Size faking feature”)

StartServicesAfter

tells the Guard service, how long to wait before starting the other Archive Manager services. Value defined in milliseconds

StartServicesByGuard

indicates whether the other Archive Manager services should be started by the Guard service

TempDir

directory, where the Handler service stores temporary files which are created during the retrieve process. This registry entry is not created automatically, by default the service user’s temporary directory is used

WebServicePrefix

used when generating HTML shortcuts. Defines the basic URL of the FilePamWebService, which is responsible for auto-retrieving HTML shortcuts

 

Additional notes / Known issues:

Resilient File System (ReFS) is not supported on Windows Server 2012 R2.

 

Related Documents