rfa

The command to transfer files between hosts.

Synopsis

rfa subcommand [options]
rfa -h
rfa -V

Description

The rfa subcommands are useful when transferring files between hosts during installation or package upgrades. Use this command to list files on a specified host, copy files to and from other hosts, or remove files from a host.

You must have permission to access specified directories. You must have appropriate read and write privileges on specified hosts.

If you are using a firewall, you need to set the environment variable EGO_CLIENT_ADDR on the client to configure the port range for the firewall. It is required to set this variable on the client machine before running the rfa command.

Note: In all cases, if no authentication information is provided (for example, user name or password), then existing credentials are automatically used. If there are no existing credentials, you are prompted for a username and password.
-h
Outputs command usage and exits.
-V
Outputs product version and exits.

Subcommand synopsis

list -s remote_dir [-t host_name] [-p consumer_name] [-c credential | -u user_name -x password]
get -d local_destination_file -s remote_source_file [-t host_name] [-p consumer_name] [-c credential | -u user_name -x password]
put -d remote_destination_file -s local_source_file [-t host_name] [-p consumer_name] [-c credential | -u user_name -x password]
remove -s source_file [-t host_name] [-p consumer_name] [-c credential | -u user_name -x password] [-d ]

list -s remote_dir [-t host_name] [-p consumer_name] [-c credential | -u user_name -x password]

Lists files on a specified host.

-s remote_dir
Absolute path to the remote directory from which you want to list files.
-t host_name
(Optional) Name of host you want to list files for.
-p consumer_name
(Optional) Name of the consumer requesting the resource allocation.
-c credential
(Optional) Authorization ID provided from current EGO logon. Credentials stored here:
  • Linux®:
    • Directory: /tmp
    • Parameter: secegocc_uid
  • Windows:
    • Directory: %TEMP%\\secegocc_osUserName (where %TEMP% is the TEMP environment variable)
    • Parameter: secegocc_osUserName
Note: Use the escape character (\) before each double quoted character in the credential. For example: Admin\"2007-01-12T02:36:44Z\"fbmTKOzDeUs1RtU+gXKJW8PYSYZZCgHXrjciZnBToGSQC/3tUqYXftYMzv4v1ciJ71wP+wZNeJ6cRxTmzQhOLA==\"IwN0XXwwRXaIgM5KIieZbw==

Stored credentials expire after a certain length of time. If you do not specify an authorization ID, you need to specify a user name and password (see -u and -x options).

-u user_name
(Optional) Fully-qualified name of the EGO user with associated permissions for the consumer requesting the resource allocation.
-x password
(Optional) Password to register for the EGO user with associated permissions for the consumer requesting the resource allocation.

get -d local_destination_file -s remote_source_file [-t host_name] [-p consumer_name] [-c credential | -u user_name -x password]

Copies a file from a specified host to a local destination.

-d local_destination_file
Name of the local destination file, including its directory location, you want to copy to. Directory path must be absolute.
-s remote_source_file
Name of the remote source file, including its directory location, you want to copy. Directory path must be absolute.
-t host_name
(Optional) Name of host from which you want to copy a file.
-p consumer_name
(Optional) Name of the consumer requesting the resource allocation.
-c credential
(Optional) Authorization ID provided from current EGO logon. Credentials stored here:
  • Linux:
    • Directory: /tmp
    • Parameter: secegocc_uid
  • Windows:
    • Directory: %TEMP%\\secegocc_osUserName (where %TEMP% is the TEMP environment variable)
    • Parameter: secegocc_osUserName
Note: Use the escape character (\) before each double quoted character in the credential. For example: Admin\"2007-01-12T02:36:44Z\"fbmTKOzDeUs1RtU+gXKJW8PYSYZZCgHXrjciZnBToGSQC/3tUqYXftYMzv4v1ciJ71wP+wZNeJ6cRxTmzQhOLA==\"IwN0XXwwRXaIgM5KIieZbw==

Stored credentials expire after a certain length of time. If you do not specify an authorization ID, you need to specify a user name and password (see -u and -x options).

-u user_name
(Optional) Fully-qualified name of the EGO user with associated permissions for the consumer requesting the resource allocation.
-x password
(Optional) Password to register for the EGO user with associated permissions for the consumer requesting the resource allocation.

put -d remote_destination_file -s local_source_file [-t host_name] [-p consumer_name ] [-c credential | -u user_name -x password]

Copies a file to a specified host from a local location.

-d remote_destination_file
Name of the remote destination file, including its directory location, you want to copy to. Directory path must be absolute.
-s local_source_file
Name of the local source file, including its directory location, you want to copy. Directory path must be absolute.
-t host_name
(Optional) Name of host you want to copy a file to.
-p consumer_name
(Optional) Name of the consumer requesting the resource allocation.
-c credential
(Optional) Authorization ID provided from current EGO logon. Credentials stored here:
  • Linux:
    • Directory: /tmp
    • Parameter: secegocc_user_id
  • Windows:
    • Directory: %TEMP%\\secegocc_osUserName (where %TEMP% is the TEMP environment variable)
    • Parameter: secegocc_osUserName
Note: Use the escape character (\) before each double quoted character in the credential. For example: Admin\"2007-01-12T02:36:44Z\"fbmTKOzDeUs1RtU+gXKJW8PYSYZZCgHXrjciZnBToGSQC/3tUqYXftYMzv4v1ciJ71wP+wZNeJ6cRxTmzQhOLA==\"IwN0XXwwRXaIgM5KIieZbw==

Stored credentials expire after a certain length of time. If you do not specify an authorization ID, you need to specify a user name and password (see -u and -x options).

-u user_name
(Optional) Fully-qualified name of the EGO user with associated permissions for the consumer requesting the resource allocation.
-x password
(Optional) Password to register for the EGO user with associated permissions for the consumer requesting the resource allocation.

remove -s source_file [-t host_name] [-p consumer_name] [-c credential | -u user_name -x password] [-d]

Removes a file from a specified host.

-s source_file
Name of the source file, including its directory location, you are removing. Directory path must be absolute.
-t host_name
(Optional) Name of host you want to remove a file from.
-p consumer_name
(Optional) Name of the consumer requesting the resource allocation.
-c credential
(Optional) Authorization ID provided from current EGO logon. Credentials stored here:
  • Linux:
    • Directory: /tmp
    • Parameter: secegocc_uid
  • Windows:
    • Directory: %TEMP%\\secegocc_osUserName (where %TEMP% is the TEMP environment variable)
    • Parameter: secegocc_osUserName
Note: Use the escape character (\) before each double quoted character in the credential. For example: Admin\"2007-01-12T02:36:44Z\"fbmTKOzDeUs1RtU+gXKJW8PYSYZZCgHXrjciZnBToGSQC/3tUqYXftYMzv4v1ciJ71wP+wZNeJ6cRxTmzQhOLA==\"IwN0XXwwRXaIgM5KIieZbw==

Stored credentials expire after a certain length of time. If you do not specify an authorization ID, you need to specify a user name and password (see -u and -x options).

-u user_name
(Optional) Fully-qualified name of the EGO user with associated permissions for the consumer requesting the resource allocation.
-x password
(Optional) Password to register for the EGO user with associated permissions for the consumer requesting the resource allocation.
-d
(Optional) The -d flag indicates that the source file specified in the remove command is a directory. This command removes the specified directory and all its contents.