The words you are searching are inside this book. To get more targeted content, please make full-text search by clicking here.
Discover the best professional documents and content resources in AnyFlip Document Base.
Search
Published by msauro, 2017-05-04 14:05:26

RichCopy4

RichCopy4

RichCopy 4.0
Welcome to the high performance and optimized file copy world :-)

RichCopy is designed to help people who copy huge number of files between storage devices directly or
indirectly over the network by accelerating copy performance and shorten the time people has to spend for file
copy operation. This acceleration has been realized by improving network and storage device utilization with
technology used for server services.
This new version has improved copy performance from its previous version by optimizing all processes
involved. It has actually improved about 10% from RichCopy version 3.5 which already much faster than any
other file copy tools.
Developed by Ken Tamaru (Kenzaburo Tamaru)
http://blogs.technet.com/ken

Table of Contents
Overview
New Features
Main user interface
Menu
File
Action
Edit
View
Help
Copy options
Overview
Process control
Attributes, Errors
Filter - Include

Filter - Exclude
Others
Toolbar
Console
Status bar
Command options

RichCopy 4.0

What RichCopy does

RichCopy realize high file copy performance by executing multiple copy tasks simultaneously. For example,
filtering and comparison engine decide a file should be copied or not while directory search engine enumerate
files and directories in source, and file copy engine copies files while filtering and comparison engine evaluating
each files and directories. Each task are executed asynchronously, and each task distributes its task to multiple
threads. This contributes to minimize the time that a task wait the result of another task. This is the logic of
RichCopy and how to get the high performance. Thus the configuration such as cache size, access method (use
system cache or not), serialize physical drive access or not and number of threads directly impacts to the copy
performance. In order to get best performance between targeted source and destination, those parameters have
to be carefully reviewed and configured. Default setting is configured not to minimize the system resource. The
other word, it is not high performance configuration. Please change the configuration based on your needs and
network and hardware performance.

When to use...

If you often copy many files over low bandwidth or high latency network, RichCopy will be help you relief from
your stress an accelerate your daily business. RichCopy remove the issue of low bandwidth and high latency by
executing multiple tasks simultaneously and shorten the wait ACK from target machine. There was a cast that
RichCopy 8 times faster than XCOPY. Of course it is faster than RoboCopy with more features.

RichCopy 4.0 - New Features and Changes

What's new

RichCopy version 1.0 was written as simple Windows dialog based application. Version 2.0 and 3.x were based
on COM technology, and it supported IDispatch interface for automation needs; however IDispatch interface /
automation support did not satisfy the needs of RichCopy users, but most GUI and command line. Users wants
more something handy. RichCopy Version 4.0 is designed as single executable file for portability with more
features business.

Feature Description
Improved copy performance
RichCopy version 2.0 ~ 3.5 are already much faster than any other copy
Profile based copy option tools, but RichCopy version 4.0 is faster than its early versions.
RichCopy version 4.0 can cover all areas where file and directories need
to be copied over the network with true based performance and
features.

Earlier versions support only single state copy options. User had to
change the configuration when network condition is very different from
previous. RichCopy version 4.0 now supports profiled based copy
options. User can create profile with any name and store different setting
to each profile. User can easily switch configuration by choosing profile

Multiple source from drop down list box.
Increased supported copy threads
Detail file / directory filtering RichCopy version 4.0 now supports multiple sources while earlier
Full command line support versions and other copy tools support only one to one coy operation. For
Optimized copy method example, you do not need to run multiple copy process when source
directory is different. Now you just need to specified multiple sources
that need to be copied to destination directory.

Most of tools support up to 64 per thread. This limitation comes from
known WIN32 thread management API. RichCopy version 4.0 does not
have such limitation with sufficient original thread management
mechanism as long as system resource allows. For example, you could
run more than 256 threads.

Earlier version could not filter files and directory with date/time such as
creation date/time, last write date/time and last access date/time.
RichCopy version 4.0 can filter files and directories with any date/time
stamp with 'earlier" and 'later' conditions and 'copy' and 'not to copy'
conditions.

All features available on GUI are also available from command option
line. Also Option property displays command line parameters of current
configuration, thus user can generate command parameters by setting
copy options on property dialog.

These days, RichCopy is used against varied storage devices.
RichCopy now supports following options.

System cache v.s. Self-cache for device direct access
Multiple access v.s. Serialized access for not optimized and slow device

RichCopy 4.0

Definitions

File A collection of information that is stored on a computer under a single name. A file can be a text
document, a picture, a program, and so on. Files typically have a three-letter file name
Tags extension that helps to indicate the type (for example, picture files are often saved in JPEG
Desktop format and have the file name extension .jpg. Rich Copy has .rcx.)
Icon
A custom file property that you create to help find and organized your files.

The work area on a computer screen that simulates the top of an actual desk. You can arrange
icons on the desktop, such as the Recycle Bin and shortcuts to programs, files, folders, and
various types of documents, just as you would arrange real objects on top of a desk.

A small picture that represents a file, folder, program, or other object or function.

RichCopy 4.0
File menu commands

The File menu offers the following commands:

New Creates a new copy option profile.
Open Opens an existing copy option file.
Close Closes an opened copy option profile.
Save Saves an opened copy option using the same file name.
Save As Saves an opened copy option to a specified file name.
Recent Profiles Open recently save copy option files.
Exit Exits RichCopy.

RichCopy 4.0 - Copy

Create a new copy option profile

You can create new files in any program and give each of them a meaningful name to help you organize your work. In most programs, the File menu is where
you open, save, and create new files. In case of RichCopy you create copy option profile and reset to default.

1. Click the File menu in the program you are using, and then click New If you can create more than one kind of file in the program, you might also need to
select an item, such as a template, from a list.

2. When you are finished working with the new file, click the File menu, and then click Save As to name the file and save it on your computer.

Tips

Depending on the type of file you are using, you might be able to add file properties—such as tags, author names, and ratings—either at the time that
you save the file or by using the Details pane. This will make it easier to find the file the next time you need it.
To create a new file on the desktop or in an open folder, right-click a blank area, point to New, and then click the program name for the kind of file you
want to create. After the icon appears, double-click it to open the file and begin working.

Create new copy option profile and reset it to the default. Copy option profile is created for file based profile, thus it will not be stored into registry. Copy option
profile can be saved through the File-Save or File-SaveAs menu.

See also

Create new copy option profile - New menu.
Opening existing copy option profile - Open menu.
Close currently opened copy option profile - Close menu
Save opened copy option profile - Save menu.
Save current copy option profile with specified file name - Save As menu.
Open from the list of recently used copy option profile - Recent Profiles menu.

RichCopy 4.0 - Copy
Open copy option profile

Open existing copy option profile. While opening file based copy option profile, copy option profile bag is disabled until file based copy option profile is closed.

1. Find the file or folder that you want to open.
2. Double-click the file or folder to open it.

Notes

Double-clicking a file automatically opens its associated program (if it is not already open). In case of .rcx file, RichCopy will be executed and open it.
To open a file in a different program than the one that the file usually opens in, right-click the file, point to Open With, and then click a compatible
program in the list.
If you have a file that will not open, you probably need to install a program capable of opening the file. This might occur if someone sends you a file by
e-mail. Ask the sender what program opens the file and how you can install it. In case of .rcx file, it does mean that RichCopy is not properly installed.

See also

Create new copy option profile - New menu.
Opening existing copy option profile - Open menu.
Close currently opened copy option profile - Close menu
Save opened copy option profile - Save menu.
Save current copy option profile with specified file name - Save As menu.
Open from the list of recently used copy option profile - Recent Profiles menu.

RichCopy 4.0 - Copy

Save copy option profile

Save active copy option profile to file system. Both of file based and profile bag based copy option profile can be saved.

See also

Create new copy option profile - New menu.
Opening existing copy option profile - Open menu.
Close currently opened copy option profile - Close menu
Save opened copy option profile - Save menu.
Save current copy option profile with specified file name - Save As menu.
Open from the list of recently used copy option profile - Recent Profiles menu.

RichCopy 4.0

Save copy option profile with specified file name

Save copy option profile with specified file name. When active copy option profile is profile bag based, and then profile bag will be inactivated and switch to
file based. (Copy option profile drop down list box will be inactivated)

See also

Create new copy option profile - New menu.
Opening existing copy option profile - Open menu.
Close currently opened copy option profile - Close menu
Save opened copy option profile - Save menu.
Save current copy option profile with specified file name - Save As menu.
Open from the list of recently used copy option profile - Recent Profiles menu.

RichCopy 4.0

Action menu commands

The Action menu offers the following commands:

Start Start copy process.
Pause Suspend currently running copy process.

Cancel Stop currently running copy process.
Copy option Display copy option setting dialog.

RichCopy 4.0
Start copy copy operation

Start copy operation. If filed based copy option profile is opened, it will be used as copy configuration. If profile bag based profile is used, copy option profile
selected on drop down list box will be used as copy configuration.

RichCopy 4.0
Suspend running copy operation

Use this command to hold running copy operation. This is useful when RichCopy eats too much machine resource and you want to execute anther task
quickly.

RichCopy 4.0
Cancel copy operation

Cancel running copy operation. This command will not complete until all copy thread exit.

RichCopy 4.0
Show RichCopy option dialog

Show RichCopy option dialog

RichCopy 4.0
Edit menu commands

The Edit menu offers the following commands:

Cut Deletes data from the document and moves it to the clipboard.
Copy Copies data from the document to the clipboard.
Paste Pastes data from the clipboard into the document.

RichCopy 4.0 - Copy
Cut selected text

Cut selected text, and store into clipboard. This operation is same as regular cut text operation.

RichCopy 4.0 - Copy
Copy text

Copy selected text into clipboard. This action is same as other regular copy text operation.

RichCopy 4.0 - Copy option
Paste text

Paste text from clipboard to current location. This operation is same as regular paste text operation.

RichCopy 4.0
View menu commands

The View menu offers the following commands:

Toolbar Shows or hides the toolbar.
Status Bar Shows or hides the status bar.
Reset log Reset all logs.
Basic Shows only basic copy option settings in copy option profile dialog.
Advanced Shows all copy option settings in copy option profile dialog.
Options Shows RichCopy option dialog.

RichCopy 4.0

Toolbar

The toolbar is displayed across the top of the application window, below the menu bar. The toolbar provides quick mouse access to many tools used in
RichCopy,
To hide or display the toolbar, click Toolbar from the View menu.

RichCopy 4.0

Status bar

RichCopy is designed to utilize CPU power for file copy, and it is second priority to update the information on status bar. Status bar will be updated either
when CPU is idle or it passed more than 1 second since last update.

RichCopy 4.0
Reset log

Reset all items in log list view.

RichCopy 4.0
Basic copy options

Limit RichCopy Option Profile features to commonly used basic features. This affects copy options available in RichCopy option profile dialog.

RichCopy 4.0
Advanced copy option

Enable full RichCopy Option Profile features. This affects copy options available in RichCopy option profile dialog.

RichCopy 4.0
RichCopy Options

Shows RichCopy option dialog. This is NOT to show RichCopy option profile dialog.

RichCopy 4.0

Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Help Topics Offers you an index to topics on which you can get help.
About Displays the version number of this application.

RichCopy 4.0 - Copy
Help Topics

Show RichCopy help, which index, search feature are enabled. One you open help, you can click the contents button whenever you want to return to the
opening screen.

RichCopy 4.0 - Copy
About

Show RichCopy About dialog box. This about dialog box shows version and legal terms.

RichCopy 4.0 - Copy option

RichCopy Option Profile

RichCopy 4.0 supports profile based copy option settings, which allows user to create multiple copy options and save as
different profile. The other word, RichCopy 4.0 allows storing multiple copy options, and choose a copy setting from
unlike earlier versions.

See also

Overview
Process control
Attribute control and error handling
Filter to include files and directories
Filter to exclude files and directories
Other settings

RichCopy 4.0 - Copy option

Overview

RichCopy version 4.0 has improved usability especially copy option dialogs. This overview page has all basic copy
configuration settings that should satisfy most of your needs to file copy tool.

Method

Copy method is what RichCopy does during the copy operations. Selecting more options will slower the whole copy
process because of more tasks to do.

Method Description
Purge
Move Files in destination will be removed if it does not exist in source directory. This option is often
selected when source and destination directories need to be identical. (Remove files in destination
when it is removed in source)

Move files from source to destination. Actual operation is to delete files in source after successfully
copying files from source to destination.

RichCopy version 4.0 supports specifying multiple source directories. Default behavior is to create
directories with same name as source, and make a copy. When this option is selected, RichCopy
copy all sources files and directories into specified destination directory without creating directories
with same name as source.
For example without selecting "Consolidate multiple sources option"

Consolidate [Source]
multiple \\<source server>\<source share>\<directory A>[\<files A>]
sources \\<source server>\<source share>\<directory B>[\<files B>]
\\<source server>\<source share>\<directory C>[\<files C>]
[Destination]
\\<destination server>\<destination share>

Those three directories are copied like following.
\\<destination server>\<destination share>\<directory A>\[<files A>]
\\<destination server>\<destination share>\<directory B>\[<files B>]
\\<destination server>\<destination share>\<directory C>\[<files C>]

With this option, destination will be like

Verify \\<destination server>\<destination share>\[<files A>]
\\<destination server>\<destination share>\[<files B>]
\\<destination server>\<destination share>\[<files C>]

All copied files will be compare with source files after all copy operation successfully completes.

Mode

Mode decide the behavior of copy operation

Mode Description
Trickle
Preprocess This feature is currently not available.

Wait target All files and directories in source will be searched and check, including file
attributes, date and size. When this option is selected, RichCopy will prompt
Timer percentage of copied files.

When this option is selected, RichCopy holds copy process until specified source
directories become available when it does not exist.

Specified the date and time when copy process should start. When this option is
selected, copy process will not start immediately, but when it becomes specified
date and time.

Thread

Thread Description
Directory search
Directory copy Specify the number of thread to be used for directory search. Increasing number
File copy of thread for directory search is effective when directory structure is rather
complex, but it does not contribute to the performance so much when directory
structure is simple.

Specify the number of thread to be used to copy files. Thread number actually
identical to the number of copy process executed simultaneously. When 10 is
specified, and then 10 files are copied simultaneously.

Specified the number of thread to be used to copy a file. This is effective to copy
small number of huge file copy. It is not recommended to use more than 1 thread
for a file copy as it could consume large size of system resource. (Multiple number
of directory copy thread by number of file copy thread. )

General conditions

Option Description
Ignore This option force to copy files to destination when file already exist with READ-ONLY flag. If
READ_ONLY flag this option is not selected, copy will fail otherwise.
Directory
creation only Specified this option to copy directories only, no files.
Create directory
only when it has When this option is selected, directory will not be created if it has not child files or directories
child
Specify not to use system cache for file read and write. If you want to system to directly
Turn off system transfer data to storage system, you may turn of system cache by selecting this option.
buffer When this option is selected, the file is being opened with no system caching. This does not
affect hard disk caching or memory mapped files. This option may gives maximum
asynchronous performance, because the data the I/O does not rely on the synchronous
operations of the memory manager. However, some I/O operations take more time, because
data is not being held in the cache. RichCopy also does following additional tasks when this
option is selected.

Serialize disk Align file access byte offset to integer multiples of the volume sector size.
access Align buffer addresses for read and write operation with sector size.
Set file size afterwards

Some storage devices are not good at performing simultaneous disk access, such ATA based
disk drives especially over the USB. When this option is selected, RichCopy serialize all disk
access to the storage, and minimize the overhead at storage device end. This does not mean
that RichCopy limits the number of thread running simultaneously.

Compare options Description
This option force to copy files to destination when file already exist with READ-
Option
Copy always

Security setting ONLY flag. If this option is not selected, copy will fail otherwise.
Availability Compare the security setting of a file in source and destination.
File size Check if a file exist in destination.
Attribute Compare size of a file in source and destination.
Time stamp Compare attributes of a file in source and destination.
Compare time stamp of a file in source and destination

RichCopy 4.0 - Copy option

Thread and priority control

Settings in this page directly impacts to the performance and resource utilization such as CPU, storage, memory and
network. It is possible to make a machine not accept other tasks because of huge resource consumption by this tool.
Thus all settings have to be carefully reviewed and set with enough knowledge and understanding.
Following picture shows that there are three major parts. Directory Search engine explorer specified source directory,
and push information of identified files and directories to Search Cache, then Folder Copy engine pull the file and
directory information, and copy them.

Each engine is actually a group of multiple threads that does actual operation. As you can guess from below picture, it is
problematic using multiple thread for file copy. (file copy thread x folder copy thread = could consume huge system
resource)

Directory copy

Thread count used to copy directories

Parameter Description
Thread count
Specify the number of thread to be used to copy files. This setting actually means the number
of files to be copied simultaneously.

File copy

Thread count used to copy files (Thread count, cache size)

Parameter Description
Thread count
Cache size Specify the number of thread to be used for each copy task. A file is divided by the specified
number, and RichCopy kicks those threads and distribute the copy task. This is effective to
copy huge small number of files; however it is problematic to use other 1 thread when you use
multiple threads for "Directory copy" as actual resource consumption is <directory copy thread>
x <file copy thread> x <cache size>. It easily gets huge resource.

This is the cache size used for file copy. Each file copy transaction will occur per this cache
size. The other word, this is the data size read and written by RichCopy. For example,
RichCopy read and write 10 times to copy 64K bytes when 7K bytes is set as cache size

Search

Search (Thread count, cache size)

Parameter Description
Thread count
Specify how many threads should be used to search files and directories. RichCopy uses only
Cache size one thread per directory, thus using many threads will not be so helpful when directory
structure is rather simple, flat, but it has to be enough to feed file and directory information to
directory copy tasks.

Number of file information to be stored. If 10 is specified, information of 10 files and/or
directories can be stored. It is suggested to specified double size of directory copy thread
count. Search cache is traditional FIFO ring cache.

Process

Priority of whole process can be customized, but it directly impacts to other active process when highest priority is
selected.

Parameter Description
Priority
Critical means to try using all system resource. Idle means to run copy tasks without impacting
other process.

RichCopy 4.0 - Copy option

Attribute control and error handling

RichCopy supports selecting information to be copied and to be set. For example, if you want to copy files with file
attribute, but time stamp, you can do this by simply selecting "File attributes" and de-selecting "File stamp" option in
"Information to be copied" group. Also it is supported to add and/or remove any file attributes you want.

RichCopy also supports rich error handling support which is quite helpful when you copy files over slow and/or unstable
network. RichCopy is capable to restart from where copy fails. User can configure retry interval and error code to be
handled.

Information to be copied

File has multiple information in addition to its size and contents. Following options are to specify what information should
be copied from source to destination.

Information Description
Attributes Same file attributes as source file will be set to copied file in destination directories.
Time stamp Same time stamp as source file will be set to copied file in destination directories.
Set to specified
time stamp Set specified time stamp to copied files in destination directories.

Security Same security setting will be applied to copied files. This is valid only when the security
Information descriptor is based on same domain or workgroup. This option is not valid between servers
whose forest/domain or workgroup has not under trust relationship.

Attributes to set / remove

Any attributes can be set to copied files or remove. Following table shows what attributes can be set to copied files or
remove.

Attributes Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.

System file The file is not to be indexed by content indexing service.
Archive
A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.

Compressed For a directory, compression is the default for newly created files and
Temporary subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

Error handling

Original version of RichCopy was developed to survive slow and unstable network. It was quite often to face time out
error during the file copy, which was hard to recover from at that time. Error handling is the core and legacy RichCopy
feature. This feature is to automatically resume file copy process where it fails last time, not to start over.

Method Description

Number of retries to cancel Number of errors to retry. For example, RichCopy will stop copy process when
copy process error occurs three times if three is set.

Period until next try Interval to retry. RichCopy will wait specified interval until retry the task.

Errors to immediately cancel Checked errors are recognized critical and unrecoverable. When selected error
copy process occurs, entire RichCopy process will be canceled.

RichCopy 4.0 - Copy option

File Copy Options - Include

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to include files and directories. All files and directories satisfy the condition set in this dialog will be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*

readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
Temporary For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

File date to exclude Description

Date type The date the specifies when a file or directory is created. If the underlying file
Creation date system does not support creation time, this option is invalid.
Last write date
For a file, the date specified the last time that a file is written to. For a directory,
Last access date the date specifies when the directory is created. If the underlying file system does
not support the last access time, this option is invalid.

For a file, the date specifies the last time that a file is read from or written to. For a
directory, the date specifies when the directory is created. If the underlying file
system does not support the last access time, this options is invalid.

RichCopy 4.0 - Copy option

File Copy Options - Exclude

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to exclude files and directories. All files and directories satisfy the condition set in this dialog will not be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*
readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.

Temporary File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
File date to exclude handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.
Date type
Creation date Description
Last write date The date the specifies when a file or directory is created. If the underlying file
Last access date system does not support creation time, this option is invalid.
For a file, the date specified the last time that a file is written to. For a directory,
the date specifies when the directory is created. If the underlying file system does
not support the last access time, this option is invalid.
For a file, the date specifies the last time that a file is read from or written to. For a
directory, the date specifies when the directory is created. If the underlying file
system does not support the last access time, this options is invalid.

RichCopy 4.0 - Copy option

Others

This page has all other options

Command to execute

Executable file can be specified to start before starting copy process and after completing all. In this release, following
three parameters are supported. For example, "prep.cmd %DST" will be "pre.cmd <destination path>" when it is
executed

%SRC - This will be replaced with source path
%DST - This will be replaced with destination path
%DATE - This will be replaced with current date this command is executed
%TIME - This will be replaced with current time this command is executed
%SIZE - This will be replaced with copied file size. File size is always zero for "before starting copy process" and
not preprocessed mode.

Command Description

Before starting Any executable can be specified. If exit code of executed command is none-zero, RichCopy
copy process will not process rest of tasks. The other word, command can control whether to start copy
process or not by returning zero or non-zero.

After completing Any executable can be specified.
copy process

FTP

Information Description
Account Account when used to access FTP server
Password Password when user to access FTP server

Log

Information Description

Command line parameters

This is a sort of helper to build command option parameters. Parameters displayed in this edit control realize same
configuration as current copy option setting.

RichCopy 4.0 - Copy option

RichCopy Option Profile

RichCopy 4.0 supports profile based copy option settings, which allows user to create multiple copy options and save as
different profile. The other word, RichCopy 4.0 allows storing multiple copy options, and choose a copy setting from
unlike earlier versions.

See also

Overview
Process control
Attribute control and error handling
Filter to include files and directories
Filter to exclude files and directories
Other settings

RichCopy 4.0 - Copy option

Overview

RichCopy version 4.0 has improved usability especially copy option dialogs. This overview page has all basic copy
configuration settings that should satisfy most of your needs to file copy tool.

Method

Copy method is what RichCopy does during the copy operations. Selecting more options will slower the whole copy
process because of more tasks to do.

Method Description
Purge
Move Files in destination will be removed if it does not exist in source directory. This option is often
selected when source and destination directories need to be identical. (Remove files in destination
when it is removed in source)

Move files from source to destination. Actual operation is to delete files in source after successfully
copying files from source to destination.

RichCopy version 4.0 supports specifying multiple source directories. Default behavior is to create
directories with same name as source, and make a copy. When this option is selected, RichCopy
copy all sources files and directories into specified destination directory without creating directories
with same name as source.
For example without selecting "Consolidate multiple sources option"

Consolidate [Source]
multiple \\<source server>\<source share>\<directory A>[\<files A>]
sources \\<source server>\<source share>\<directory B>[\<files B>]
\\<source server>\<source share>\<directory C>[\<files C>]
[Destination]
\\<destination server>\<destination share>

Those three directories are copied like following.
\\<destination server>\<destination share>\<directory A>\[<files A>]
\\<destination server>\<destination share>\<directory B>\[<files B>]
\\<destination server>\<destination share>\<directory C>\[<files C>]

With this option, destination will be like

Verify \\<destination server>\<destination share>\[<files A>]
\\<destination server>\<destination share>\[<files B>]
\\<destination server>\<destination share>\[<files C>]

All copied files will be compare with source files after all copy operation successfully completes.

Mode

Mode decide the behavior of copy operation

Mode Description
Trickle
Preprocess This feature is currently not available.

Wait target All files and directories in source will be searched and check, including file
attributes, date and size. When this option is selected, RichCopy will prompt
Timer percentage of copied files.

When this option is selected, RichCopy holds copy process until specified source
directories become available when it does not exist.

Specified the date and time when copy process should start. When this option is
selected, copy process will not start immediately, but when it becomes specified
date and time.

Thread

Thread Description
Directory search
Directory copy Specify the number of thread to be used for directory search. Increasing number
File copy of thread for directory search is effective when directory structure is rather
complex, but it does not contribute to the performance so much when directory
structure is simple.

Specify the number of thread to be used to copy files. Thread number actually
identical to the number of copy process executed simultaneously. When 10 is
specified, and then 10 files are copied simultaneously.

Specified the number of thread to be used to copy a file. This is effective to copy
small number of huge file copy. It is not recommended to use more than 1 thread
for a file copy as it could consume large size of system resource. (Multiple number
of directory copy thread by number of file copy thread. )

General conditions

Option Description
Ignore This option force to copy files to destination when file already exist with READ-ONLY flag. If
READ_ONLY flag this option is not selected, copy will fail otherwise.
Directory
creation only Specified this option to copy directories only, no files.
Create directory
only when it has When this option is selected, directory will not be created if it has not child files or directories
child
Specify not to use system cache for file read and write. If you want to system to directly
Turn off system transfer data to storage system, you may turn of system cache by selecting this option.
buffer When this option is selected, the file is being opened with no system caching. This does not
affect hard disk caching or memory mapped files. This option may gives maximum
asynchronous performance, because the data the I/O does not rely on the synchronous
operations of the memory manager. However, some I/O operations take more time, because
data is not being held in the cache. RichCopy also does following additional tasks when this
option is selected.

Serialize disk Align file access byte offset to integer multiples of the volume sector size.
access Align buffer addresses for read and write operation with sector size.
Set file size afterwards

Some storage devices are not good at performing simultaneous disk access, such ATA based
disk drives especially over the USB. When this option is selected, RichCopy serialize all disk
access to the storage, and minimize the overhead at storage device end. This does not mean
that RichCopy limits the number of thread running simultaneously.

Compare options Description
This option force to copy files to destination when file already exist with READ-
Option
Copy always

Security setting ONLY flag. If this option is not selected, copy will fail otherwise.
Availability Compare the security setting of a file in source and destination.
File size Check if a file exist in destination.
Attribute Compare size of a file in source and destination.
Time stamp Compare attributes of a file in source and destination.
Compare time stamp of a file in source and destination

RichCopy 4.0 - Copy option

Thread and priority control

Settings in this page directly impacts to the performance and resource utilization such as CPU, storage, memory and
network. It is possible to make a machine not accept other tasks because of huge resource consumption by this tool.
Thus all settings have to be carefully reviewed and set with enough knowledge and understanding.
Following picture shows that there are three major parts. Directory Search engine explorer specified source directory,
and push information of identified files and directories to Search Cache, then Folder Copy engine pull the file and
directory information, and copy them.

Each engine is actually a group of multiple threads that does actual operation. As you can guess from below picture, it is
problematic using multiple thread for file copy. (file copy thread x folder copy thread = could consume huge system
resource)

Directory copy

Thread count used to copy directories

Parameter Description
Thread count
Specify the number of thread to be used to copy files. This setting actually means the number
of files to be copied simultaneously.

File copy

Thread count used to copy files (Thread count, cache size)

Parameter Description
Thread count
Cache size Specify the number of thread to be used for each copy task. A file is divided by the specified
number, and RichCopy kicks those threads and distribute the copy task. This is effective to
copy huge small number of files; however it is problematic to use other 1 thread when you use
multiple threads for "Directory copy" as actual resource consumption is <directory copy thread>
x <file copy thread> x <cache size>. It easily gets huge resource.

This is the cache size used for file copy. Each file copy transaction will occur per this cache
size. The other word, this is the data size read and written by RichCopy. For example,
RichCopy read and write 10 times to copy 64K bytes when 7K bytes is set as cache size

Search

Search (Thread count, cache size)

Parameter Description
Thread count
Specify how many threads should be used to search files and directories. RichCopy uses only
Cache size one thread per directory, thus using many threads will not be so helpful when directory
structure is rather simple, flat, but it has to be enough to feed file and directory information to
directory copy tasks.

Number of file information to be stored. If 10 is specified, information of 10 files and/or
directories can be stored. It is suggested to specified double size of directory copy thread
count. Search cache is traditional FIFO ring cache.

Process

Priority of whole process can be customized, but it directly impacts to other active process when highest priority is
selected.

Parameter Description
Priority
Critical means to try using all system resource. Idle means to run copy tasks without impacting
other process.

RichCopy 4.0 - Copy option

Attribute control and error handling

RichCopy supports selecting information to be copied and to be set. For example, if you want to copy files with file
attribute, but time stamp, you can do this by simply selecting "File attributes" and de-selecting "File stamp" option in
"Information to be copied" group. Also it is supported to add and/or remove any file attributes you want.

RichCopy also supports rich error handling support which is quite helpful when you copy files over slow and/or unstable
network. RichCopy is capable to restart from where copy fails. User can configure retry interval and error code to be
handled.

Information to be copied

File has multiple information in addition to its size and contents. Following options are to specify what information should
be copied from source to destination.

Information Description
Attributes Same file attributes as source file will be set to copied file in destination directories.
Time stamp Same time stamp as source file will be set to copied file in destination directories.
Set to specified
time stamp Set specified time stamp to copied files in destination directories.

Security Same security setting will be applied to copied files. This is valid only when the security
Information descriptor is based on same domain or workgroup. This option is not valid between servers
whose forest/domain or workgroup has not under trust relationship.

Attributes to set / remove

Any attributes can be set to copied files or remove. Following table shows what attributes can be set to copied files or
remove.

Attributes Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.

System file The file is not to be indexed by content indexing service.
Archive
A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.

Compressed For a directory, compression is the default for newly created files and
Temporary subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

Error handling

Original version of RichCopy was developed to survive slow and unstable network. It was quite often to face time out
error during the file copy, which was hard to recover from at that time. Error handling is the core and legacy RichCopy
feature. This feature is to automatically resume file copy process where it fails last time, not to start over.

Method Description

Number of retries to cancel Number of errors to retry. For example, RichCopy will stop copy process when
copy process error occurs three times if three is set.

Period until next try Interval to retry. RichCopy will wait specified interval until retry the task.

Errors to immediately cancel Checked errors are recognized critical and unrecoverable. When selected error
copy process occurs, entire RichCopy process will be canceled.

RichCopy 4.0 - Copy option

File Copy Options - Include

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to include files and directories. All files and directories satisfy the condition set in this dialog will be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*

readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
Temporary For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

File date to exclude Description

Date type The date the specifies when a file or directory is created. If the underlying file
Creation date system does not support creation time, this option is invalid.
Last write date
For a file, the date specified the last time that a file is written to. For a directory,
Last access date the date specifies when the directory is created. If the underlying file system does
not support the last access time, this option is invalid.

For a file, the date specifies the last time that a file is read from or written to. For a
directory, the date specifies when the directory is created. If the underlying file
system does not support the last access time, this options is invalid.

RichCopy 4.0 - Copy option

File Copy Options - Exclude

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to exclude files and directories. All files and directories satisfy the condition set in this dialog will not be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*
readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.

Temporary File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
File date to exclude handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.
Date type
Creation date Description
Last write date The date the specifies when a file or directory is created. If the underlying file
Last access date system does not support creation time, this option is invalid.
For a file, the date specified the last time that a file is written to. For a directory,
the date specifies when the directory is created. If the underlying file system does
not support the last access time, this option is invalid.
For a file, the date specifies the last time that a file is read from or written to. For a
directory, the date specifies when the directory is created. If the underlying file
system does not support the last access time, this options is invalid.

RichCopy 4.0 - Copy option

Others

This page has all other options

Command to execute

Executable file can be specified to start before starting copy process and after completing all. In this release, following
three parameters are supported. For example, "prep.cmd %DST" will be "pre.cmd <destination path>" when it is
executed

%SRC - This will be replaced with source path
%DST - This will be replaced with destination path
%DATE - This will be replaced with current date this command is executed
%TIME - This will be replaced with current time this command is executed
%SIZE - This will be replaced with copied file size. File size is always zero for "before starting copy process" and
not preprocessed mode.

Command Description

Before starting Any executable can be specified. If exit code of executed command is none-zero, RichCopy
copy process will not process rest of tasks. The other word, command can control whether to start copy
process or not by returning zero or non-zero.

After completing Any executable can be specified.
copy process

FTP

Information Description
Account Account when used to access FTP server
Password Password when user to access FTP server

Log

Information Description

Command line parameters

This is a sort of helper to build command option parameters. Parameters displayed in this edit control realize same
configuration as current copy option setting.

RichCopy 4.0 - Copy option

RichCopy Option Profile

RichCopy 4.0 supports profile based copy option settings, which allows user to create multiple copy options and save as
different profile. The other word, RichCopy 4.0 allows storing multiple copy options, and choose a copy setting from
unlike earlier versions.

See also

Overview
Process control
Attribute control and error handling
Filter to include files and directories
Filter to exclude files and directories
Other settings

RichCopy 4.0 - Copy option

Overview

RichCopy version 4.0 has improved usability especially copy option dialogs. This overview page has all basic copy
configuration settings that should satisfy most of your needs to file copy tool.

Method

Copy method is what RichCopy does during the copy operations. Selecting more options will slower the whole copy
process because of more tasks to do.

Method Description
Purge
Move Files in destination will be removed if it does not exist in source directory. This option is often
selected when source and destination directories need to be identical. (Remove files in destination
when it is removed in source)

Move files from source to destination. Actual operation is to delete files in source after successfully
copying files from source to destination.

RichCopy version 4.0 supports specifying multiple source directories. Default behavior is to create
directories with same name as source, and make a copy. When this option is selected, RichCopy
copy all sources files and directories into specified destination directory without creating directories
with same name as source.
For example without selecting "Consolidate multiple sources option"

Consolidate [Source]
multiple \\<source server>\<source share>\<directory A>[\<files A>]
sources \\<source server>\<source share>\<directory B>[\<files B>]
\\<source server>\<source share>\<directory C>[\<files C>]
[Destination]
\\<destination server>\<destination share>

Those three directories are copied like following.
\\<destination server>\<destination share>\<directory A>\[<files A>]
\\<destination server>\<destination share>\<directory B>\[<files B>]
\\<destination server>\<destination share>\<directory C>\[<files C>]

With this option, destination will be like

Verify \\<destination server>\<destination share>\[<files A>]
\\<destination server>\<destination share>\[<files B>]
\\<destination server>\<destination share>\[<files C>]

All copied files will be compare with source files after all copy operation successfully completes.

Mode

Mode decide the behavior of copy operation

Mode Description
Trickle
Preprocess This feature is currently not available.

Wait target All files and directories in source will be searched and check, including file
attributes, date and size. When this option is selected, RichCopy will prompt
Timer percentage of copied files.

When this option is selected, RichCopy holds copy process until specified source
directories become available when it does not exist.

Specified the date and time when copy process should start. When this option is
selected, copy process will not start immediately, but when it becomes specified
date and time.

Thread

Thread Description
Directory search
Directory copy Specify the number of thread to be used for directory search. Increasing number
File copy of thread for directory search is effective when directory structure is rather
complex, but it does not contribute to the performance so much when directory
structure is simple.

Specify the number of thread to be used to copy files. Thread number actually
identical to the number of copy process executed simultaneously. When 10 is
specified, and then 10 files are copied simultaneously.

Specified the number of thread to be used to copy a file. This is effective to copy
small number of huge file copy. It is not recommended to use more than 1 thread
for a file copy as it could consume large size of system resource. (Multiple number
of directory copy thread by number of file copy thread. )

General conditions

Option Description
Ignore This option force to copy files to destination when file already exist with READ-ONLY flag. If
READ_ONLY flag this option is not selected, copy will fail otherwise.
Directory
creation only Specified this option to copy directories only, no files.
Create directory
only when it has When this option is selected, directory will not be created if it has not child files or directories
child
Specify not to use system cache for file read and write. If you want to system to directly
Turn off system transfer data to storage system, you may turn of system cache by selecting this option.
buffer When this option is selected, the file is being opened with no system caching. This does not
affect hard disk caching or memory mapped files. This option may gives maximum
asynchronous performance, because the data the I/O does not rely on the synchronous
operations of the memory manager. However, some I/O operations take more time, because
data is not being held in the cache. RichCopy also does following additional tasks when this
option is selected.

Serialize disk Align file access byte offset to integer multiples of the volume sector size.
access Align buffer addresses for read and write operation with sector size.
Set file size afterwards

Some storage devices are not good at performing simultaneous disk access, such ATA based
disk drives especially over the USB. When this option is selected, RichCopy serialize all disk
access to the storage, and minimize the overhead at storage device end. This does not mean
that RichCopy limits the number of thread running simultaneously.

Compare options Description
This option force to copy files to destination when file already exist with READ-
Option
Copy always

Security setting ONLY flag. If this option is not selected, copy will fail otherwise.
Availability Compare the security setting of a file in source and destination.
File size Check if a file exist in destination.
Attribute Compare size of a file in source and destination.
Time stamp Compare attributes of a file in source and destination.
Compare time stamp of a file in source and destination

RichCopy 4.0 - Copy option

Thread and priority control

Settings in this page directly impacts to the performance and resource utilization such as CPU, storage, memory and
network. It is possible to make a machine not accept other tasks because of huge resource consumption by this tool.
Thus all settings have to be carefully reviewed and set with enough knowledge and understanding.
Following picture shows that there are three major parts. Directory Search engine explorer specified source directory,
and push information of identified files and directories to Search Cache, then Folder Copy engine pull the file and
directory information, and copy them.

Each engine is actually a group of multiple threads that does actual operation. As you can guess from below picture, it is
problematic using multiple thread for file copy. (file copy thread x folder copy thread = could consume huge system
resource)

Directory copy

Thread count used to copy directories

Parameter Description
Thread count
Specify the number of thread to be used to copy files. This setting actually means the number
of files to be copied simultaneously.

File copy

Thread count used to copy files (Thread count, cache size)

Parameter Description
Thread count
Cache size Specify the number of thread to be used for each copy task. A file is divided by the specified
number, and RichCopy kicks those threads and distribute the copy task. This is effective to
copy huge small number of files; however it is problematic to use other 1 thread when you use
multiple threads for "Directory copy" as actual resource consumption is <directory copy thread>
x <file copy thread> x <cache size>. It easily gets huge resource.

This is the cache size used for file copy. Each file copy transaction will occur per this cache
size. The other word, this is the data size read and written by RichCopy. For example,
RichCopy read and write 10 times to copy 64K bytes when 7K bytes is set as cache size

Search

Search (Thread count, cache size)

Parameter Description
Thread count
Specify how many threads should be used to search files and directories. RichCopy uses only
Cache size one thread per directory, thus using many threads will not be so helpful when directory
structure is rather simple, flat, but it has to be enough to feed file and directory information to
directory copy tasks.

Number of file information to be stored. If 10 is specified, information of 10 files and/or
directories can be stored. It is suggested to specified double size of directory copy thread
count. Search cache is traditional FIFO ring cache.

Process

Priority of whole process can be customized, but it directly impacts to other active process when highest priority is
selected.

Parameter Description
Priority
Critical means to try using all system resource. Idle means to run copy tasks without impacting
other process.

RichCopy 4.0 - Copy option

Attribute control and error handling

RichCopy supports selecting information to be copied and to be set. For example, if you want to copy files with file
attribute, but time stamp, you can do this by simply selecting "File attributes" and de-selecting "File stamp" option in
"Information to be copied" group. Also it is supported to add and/or remove any file attributes you want.

RichCopy also supports rich error handling support which is quite helpful when you copy files over slow and/or unstable
network. RichCopy is capable to restart from where copy fails. User can configure retry interval and error code to be
handled.

Information to be copied

File has multiple information in addition to its size and contents. Following options are to specify what information should
be copied from source to destination.

Information Description
Attributes Same file attributes as source file will be set to copied file in destination directories.
Time stamp Same time stamp as source file will be set to copied file in destination directories.
Set to specified
time stamp Set specified time stamp to copied files in destination directories.

Security Same security setting will be applied to copied files. This is valid only when the security
Information descriptor is based on same domain or workgroup. This option is not valid between servers
whose forest/domain or workgroup has not under trust relationship.

Attributes to set / remove

Any attributes can be set to copied files or remove. Following table shows what attributes can be set to copied files or
remove.

Attributes Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.

System file The file is not to be indexed by content indexing service.
Archive
A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.

Compressed For a directory, compression is the default for newly created files and
Temporary subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

Error handling

Original version of RichCopy was developed to survive slow and unstable network. It was quite often to face time out
error during the file copy, which was hard to recover from at that time. Error handling is the core and legacy RichCopy
feature. This feature is to automatically resume file copy process where it fails last time, not to start over.

Method Description

Number of retries to cancel Number of errors to retry. For example, RichCopy will stop copy process when
copy process error occurs three times if three is set.

Period until next try Interval to retry. RichCopy will wait specified interval until retry the task.

Errors to immediately cancel Checked errors are recognized critical and unrecoverable. When selected error
copy process occurs, entire RichCopy process will be canceled.

RichCopy 4.0 - Copy option

File Copy Options - Include

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to include files and directories. All files and directories satisfy the condition set in this dialog will be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*

readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
Temporary For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

File date to exclude Description

Date type The date the specifies when a file or directory is created. If the underlying file
Creation date system does not support creation time, this option is invalid.
Last write date
For a file, the date specified the last time that a file is written to. For a directory,
Last access date the date specifies when the directory is created. If the underlying file system does
not support the last access time, this option is invalid.

For a file, the date specifies the last time that a file is read from or written to. For a
directory, the date specifies when the directory is created. If the underlying file
system does not support the last access time, this options is invalid.

RichCopy 4.0 - Copy option

File Copy Options - Exclude

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to exclude files and directories. All files and directories satisfy the condition set in this dialog will not be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*
readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.

Temporary File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
File date to exclude handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.
Date type
Creation date Description
Last write date The date the specifies when a file or directory is created. If the underlying file
Last access date system does not support creation time, this option is invalid.
For a file, the date specified the last time that a file is written to. For a directory,
the date specifies when the directory is created. If the underlying file system does
not support the last access time, this option is invalid.
For a file, the date specifies the last time that a file is read from or written to. For a
directory, the date specifies when the directory is created. If the underlying file
system does not support the last access time, this options is invalid.

RichCopy 4.0 - Copy option

Others

This page has all other options

Command to execute

Executable file can be specified to start before starting copy process and after completing all. In this release, following
three parameters are supported. For example, "prep.cmd %DST" will be "pre.cmd <destination path>" when it is
executed

%SRC - This will be replaced with source path
%DST - This will be replaced with destination path
%DATE - This will be replaced with current date this command is executed
%TIME - This will be replaced with current time this command is executed
%SIZE - This will be replaced with copied file size. File size is always zero for "before starting copy process" and
not preprocessed mode.

Command Description

Before starting Any executable can be specified. If exit code of executed command is none-zero, RichCopy
copy process will not process rest of tasks. The other word, command can control whether to start copy
process or not by returning zero or non-zero.

After completing Any executable can be specified.
copy process

FTP

Information Description
Account Account when used to access FTP server
Password Password when user to access FTP server

Log

Information Description

Command line parameters

This is a sort of helper to build command option parameters. Parameters displayed in this edit control realize same
configuration as current copy option setting.

RichCopy 4.0 - Copy option

RichCopy Option Profile

RichCopy 4.0 supports profile based copy option settings, which allows user to create multiple copy options and save as
different profile. The other word, RichCopy 4.0 allows storing multiple copy options, and choose a copy setting from
unlike earlier versions.

See also

Overview
Process control
Attribute control and error handling
Filter to include files and directories
Filter to exclude files and directories
Other settings

RichCopy 4.0 - Copy option

Overview

RichCopy version 4.0 has improved usability especially copy option dialogs. This overview page has all basic copy
configuration settings that should satisfy most of your needs to file copy tool.

Method

Copy method is what RichCopy does during the copy operations. Selecting more options will slower the whole copy
process because of more tasks to do.

Method Description
Purge
Move Files in destination will be removed if it does not exist in source directory. This option is often
selected when source and destination directories need to be identical. (Remove files in destination
when it is removed in source)

Move files from source to destination. Actual operation is to delete files in source after successfully
copying files from source to destination.

RichCopy version 4.0 supports specifying multiple source directories. Default behavior is to create
directories with same name as source, and make a copy. When this option is selected, RichCopy
copy all sources files and directories into specified destination directory without creating directories
with same name as source.
For example without selecting "Consolidate multiple sources option"

Consolidate [Source]
multiple \\<source server>\<source share>\<directory A>[\<files A>]
sources \\<source server>\<source share>\<directory B>[\<files B>]
\\<source server>\<source share>\<directory C>[\<files C>]
[Destination]
\\<destination server>\<destination share>

Those three directories are copied like following.
\\<destination server>\<destination share>\<directory A>\[<files A>]
\\<destination server>\<destination share>\<directory B>\[<files B>]
\\<destination server>\<destination share>\<directory C>\[<files C>]

With this option, destination will be like

Verify \\<destination server>\<destination share>\[<files A>]
\\<destination server>\<destination share>\[<files B>]
\\<destination server>\<destination share>\[<files C>]

All copied files will be compare with source files after all copy operation successfully completes.

Mode

Mode decide the behavior of copy operation

Mode Description
Trickle
Preprocess This feature is currently not available.

Wait target All files and directories in source will be searched and check, including file
attributes, date and size. When this option is selected, RichCopy will prompt
Timer percentage of copied files.

When this option is selected, RichCopy holds copy process until specified source
directories become available when it does not exist.

Specified the date and time when copy process should start. When this option is
selected, copy process will not start immediately, but when it becomes specified
date and time.

Thread

Thread Description
Directory search
Directory copy Specify the number of thread to be used for directory search. Increasing number
File copy of thread for directory search is effective when directory structure is rather
complex, but it does not contribute to the performance so much when directory
structure is simple.

Specify the number of thread to be used to copy files. Thread number actually
identical to the number of copy process executed simultaneously. When 10 is
specified, and then 10 files are copied simultaneously.

Specified the number of thread to be used to copy a file. This is effective to copy
small number of huge file copy. It is not recommended to use more than 1 thread
for a file copy as it could consume large size of system resource. (Multiple number
of directory copy thread by number of file copy thread. )

General conditions

Option Description
Ignore This option force to copy files to destination when file already exist with READ-ONLY flag. If
READ_ONLY flag this option is not selected, copy will fail otherwise.
Directory
creation only Specified this option to copy directories only, no files.
Create directory
only when it has When this option is selected, directory will not be created if it has not child files or directories
child
Specify not to use system cache for file read and write. If you want to system to directly
Turn off system transfer data to storage system, you may turn of system cache by selecting this option.
buffer When this option is selected, the file is being opened with no system caching. This does not
affect hard disk caching or memory mapped files. This option may gives maximum
asynchronous performance, because the data the I/O does not rely on the synchronous
operations of the memory manager. However, some I/O operations take more time, because
data is not being held in the cache. RichCopy also does following additional tasks when this
option is selected.

Serialize disk Align file access byte offset to integer multiples of the volume sector size.
access Align buffer addresses for read and write operation with sector size.
Set file size afterwards

Some storage devices are not good at performing simultaneous disk access, such ATA based
disk drives especially over the USB. When this option is selected, RichCopy serialize all disk
access to the storage, and minimize the overhead at storage device end. This does not mean
that RichCopy limits the number of thread running simultaneously.

Compare options Description
This option force to copy files to destination when file already exist with READ-
Option
Copy always

Security setting ONLY flag. If this option is not selected, copy will fail otherwise.
Availability Compare the security setting of a file in source and destination.
File size Check if a file exist in destination.
Attribute Compare size of a file in source and destination.
Time stamp Compare attributes of a file in source and destination.
Compare time stamp of a file in source and destination

RichCopy 4.0 - Copy option

Thread and priority control

Settings in this page directly impacts to the performance and resource utilization such as CPU, storage, memory and
network. It is possible to make a machine not accept other tasks because of huge resource consumption by this tool.
Thus all settings have to be carefully reviewed and set with enough knowledge and understanding.
Following picture shows that there are three major parts. Directory Search engine explorer specified source directory,
and push information of identified files and directories to Search Cache, then Folder Copy engine pull the file and
directory information, and copy them.

Each engine is actually a group of multiple threads that does actual operation. As you can guess from below picture, it is
problematic using multiple thread for file copy. (file copy thread x folder copy thread = could consume huge system
resource)

Directory copy

Thread count used to copy directories

Parameter Description
Thread count
Specify the number of thread to be used to copy files. This setting actually means the number
of files to be copied simultaneously.

File copy

Thread count used to copy files (Thread count, cache size)

Parameter Description
Thread count
Cache size Specify the number of thread to be used for each copy task. A file is divided by the specified
number, and RichCopy kicks those threads and distribute the copy task. This is effective to
copy huge small number of files; however it is problematic to use other 1 thread when you use
multiple threads for "Directory copy" as actual resource consumption is <directory copy thread>
x <file copy thread> x <cache size>. It easily gets huge resource.

This is the cache size used for file copy. Each file copy transaction will occur per this cache
size. The other word, this is the data size read and written by RichCopy. For example,
RichCopy read and write 10 times to copy 64K bytes when 7K bytes is set as cache size

Search

Search (Thread count, cache size)

Parameter Description
Thread count
Specify how many threads should be used to search files and directories. RichCopy uses only
Cache size one thread per directory, thus using many threads will not be so helpful when directory
structure is rather simple, flat, but it has to be enough to feed file and directory information to
directory copy tasks.

Number of file information to be stored. If 10 is specified, information of 10 files and/or
directories can be stored. It is suggested to specified double size of directory copy thread
count. Search cache is traditional FIFO ring cache.

Process

Priority of whole process can be customized, but it directly impacts to other active process when highest priority is
selected.

Parameter Description
Priority
Critical means to try using all system resource. Idle means to run copy tasks without impacting
other process.

RichCopy 4.0 - Copy option

Attribute control and error handling

RichCopy supports selecting information to be copied and to be set. For example, if you want to copy files with file
attribute, but time stamp, you can do this by simply selecting "File attributes" and de-selecting "File stamp" option in
"Information to be copied" group. Also it is supported to add and/or remove any file attributes you want.

RichCopy also supports rich error handling support which is quite helpful when you copy files over slow and/or unstable
network. RichCopy is capable to restart from where copy fails. User can configure retry interval and error code to be
handled.

Information to be copied

File has multiple information in addition to its size and contents. Following options are to specify what information should
be copied from source to destination.

Information Description
Attributes Same file attributes as source file will be set to copied file in destination directories.
Time stamp Same time stamp as source file will be set to copied file in destination directories.
Set to specified
time stamp Set specified time stamp to copied files in destination directories.

Security Same security setting will be applied to copied files. This is valid only when the security
Information descriptor is based on same domain or workgroup. This option is not valid between servers
whose forest/domain or workgroup has not under trust relationship.

Attributes to set / remove

Any attributes can be set to copied files or remove. Following table shows what attributes can be set to copied files or
remove.

Attributes Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.

System file The file is not to be indexed by content indexing service.
Archive
A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.

Compressed For a directory, compression is the default for newly created files and
Temporary subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

Error handling

Original version of RichCopy was developed to survive slow and unstable network. It was quite often to face time out
error during the file copy, which was hard to recover from at that time. Error handling is the core and legacy RichCopy
feature. This feature is to automatically resume file copy process where it fails last time, not to start over.

Method Description

Number of retries to cancel Number of errors to retry. For example, RichCopy will stop copy process when
copy process error occurs three times if three is set.

Period until next try Interval to retry. RichCopy will wait specified interval until retry the task.

Errors to immediately cancel Checked errors are recognized critical and unrecoverable. When selected error
copy process occurs, entire RichCopy process will be canceled.

RichCopy 4.0 - Copy option

File Copy Options - Include

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to include files and directories. All files and directories satisfy the condition set in this dialog will be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*

readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
Temporary For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.
File systems avoid writing data back to mass storage if sufficient cache memory is
available, because typically, an application deletes a temporary file after the
handle is closed. In that scenario, the system can entirely avoid writing the data.
Otherwise, the data is written after the handle is closed.

File date to exclude Description

Date type The date the specifies when a file or directory is created. If the underlying file
Creation date system does not support creation time, this option is invalid.
Last write date
For a file, the date specified the last time that a file is written to. For a directory,
Last access date the date specifies when the directory is created. If the underlying file system does
not support the last access time, this option is invalid.

For a file, the date specifies the last time that a file is read from or written to. For a
directory, the date specifies when the directory is created. If the underlying file
system does not support the last access time, this options is invalid.

RichCopy 4.0 - Copy option

File Copy Options - Exclude

Just like earlier versions, RichCopy version 4.0 supports file and directories filtering with various parameters, and those
conditions can be set to different types, files and directories. File attributes RichCopy supports for filtering are name,
attributes, creation date, last write date and last access date. File size is not supported in this version. This dialog is to
set filters to exclude files and directories. All files and directories satisfy the condition set in this dialog will not be copied.

Use name to filter

Check this option to filter files with specified filter string. Files and directories will not be filtered with file name when this
option is not selected even if actual filters are specified

Name(s) Specify filters to exclude files. Each filter string can be delimited with colon <:>, semicolon <;>,
comma <,> and back slash </>. Also, standard wildcard syntax is valid in this option. Here is
valid filter strings as an example.

readme.*
readme.tx?
????copy.exe
readme.txt; readme.doc; richcopy.*

Use attributes to filter

Check this option to filter files with specified file attributes. Files will not be filtered with selected file attributes when this
option is not selected even if actual filter attributes are specified

Target attributes to exclude Description
Read only
Hidden A file or directory that is read-only.
Not content indexed For a file, applications can read the file, but cannot write to it or delete it.
Encrypted For a directory, applications cannot delete it.

Offline The file or directory is hidden. It is not included in an ordinary directory listing.
System file
Archive The file is not to be indexed by content indexing service.

Compressed A file or directory that is encrypted.
For a file, all data streams in the file are encrypted.
For a directory, encryption is the default for newly created files and subdirectories.

The data of a file is not available immediately.
This attribute indicates that the file data is physically moved to offline storage. This
attribute is used by Remote Storage, which is the hierarchical storage
management software. Applications should not arbitrarily change this attribute.

A file or directory that the operating system uses a part of, or uses exclusively.

A file or directory that is an archive file or directory.
Applications use this attribute to mark files for backup or removal.

A file or directory that is compressed.
For a file, all of the data in the file is compressed.
For a directory, compression is the default for newly created files and
subdirectories.

A file that is being used for temporary storage.


Click to View FlipBook Version