RichCopy4

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.