After you have configured remote system connections, configuration
files, and preferences for push-to-client configurations, you can
export them to the remote system for distribution to client workspaces.
Before you begin
To export system or global configuration settings to the remote
system, you must have write access to the push-to-client configuration
files on the remote system. File permissions can be set for three
types of users: owner, group, and other. File permissions for the
push-to-client directory on the remote system are set by using the
file.permission directive
in the
pushtoclient.properties file. The default
setting allows read and write for owner (the user ID who created a
file) and group, and read for other. For more information about push-to-client
file permissions and configuring push-to-client support on z/OS®, refer to the
IBM® Rational® Developer for System z® Host Configuration Guide (SC23-7658).
About this task
Exporting configurations for push-to-client distribution
generates configuration files and transfers them to the remote system.
After the files have been exported, they are automatically downloaded
to client workstations when they connect to the remote system.
Note: Some
configuration files, such as installation configuration files, host-based
projects, and default values, are created manually on the remote system
and not exported from the workstation.
Procedure
To export push-to-client configuration files:
- Switch to the master workspace as described in Creating a master workspace for push-to-client configuration.
- Connect to the remote system to which you want to export
configuration files:
- Select the remote system in the Remote Systems view.
- Click Connect on the pop-up menu.
Remember: The push-to-client function supports only
one primary system. Before attempting to export configuration files,
verify that you are connected to only one primary system. If you are
exporting to a primary system that is different from the primary system
to which you last exported configuration files (for example, if your
site uses one primary system for testing and another for production), Rational Developer for System z prompts you to verify
that you are connected to the correct primary system.
- From the workspace menu bar, click File > Export. The Export window opens.
- In the Export window, click + to
expand Rational Developer for System z.
- Select Configuration Files and click Next.
- If the remote system is the primary system, the Global
Configuration Files window opens.
- If the remote system is not the primary system, the System
Configuration Files window opens.
Each of these windows contains two sections:- Global configuration or System
configuration lists configuration files that can be exported
from the workstation to the remote system.
- Key mapping update lists configuration
files that are created on the remote system. You cannot export these
files from the workstation.
If Rational Developer
for System z has been configured
to support configuration groups, this window might also include a Configuration
group drop-down list. Configuration groups are controlled
by parameters in the pushtoclient.properties file
on the remote system. For more information about this file, refer
to the IBM Rational Developer for System z Host Configuration Guide (SC23-7658)
- If the push-to-client environment has been configured
to support configuration groups, select the configuration group to
which you want to export the configuration files.
- Optional: To display the default locations
and names of the configuration files on the remote system, select Show
export properties. The following export properties
display:
- Export Path: The location on the remote
system to which the configuration file is to be exported.
- File Mask: The file name pattern for the
configuration file, which is useful when many configuration files
are saved in the same container.
- Encoding: The encoding of the configuration
file on the remote system.
- Select the check box next to the configuration files you
want to export and click Next or Finish. Rational Developer
for System z uploads the
configuration files to the remote system. Some configurations, such
as Software Analyzer Configurations, might offer you the opportunity
to select specific configuration files to export. If you have selected
a configuration that provides this option, a window listing available
configuration files opens.
- Optional: Select the files you want to export
and click OK.