Rational Developer for System z

IBM Rational Developer for System z Version 8.0.3

RSE Server Installation Guide: Linux on System z


GC27-2810-02
Note

Before using this information, be sure to read the general information under Notices.

Third edition (October 2011)

This edition applies to IBM Rational Developer for System z Version 8.0.3 (program number 5724-T07) and to all subsequent releases and modifications until otherwise indicated in new editions.

Order publications by phone or fax. IBM Software Manufacturing Solutions takes publication orders between 8 a.m. and 7:00 p.m. eastern standard time (EST). The phone number is (800) 879-2755. The fax number is (800) 445-9269. Send faxes Attn: Publications, 3rd floor.

You can also order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below.

IBM welcomes your comments. You can send your comments by mail to the following address:

IBM Corporation
Attn: Information Development Department 53NA
Building 501 P.O. Box 12195
Research Triangle Park NC 27709-2195.
USA

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Copyright International Business Machines Corporation 2000, 2011.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

About this document

This document describes how to install the RSE server option of IBM® Rational® Developer for System z® Version 8.0.3 on a Linux on System z host system.

From here on, the following names are used in this manual:

For earlier releases, including IBM Rational Developer for System z, WebSphere® Developer for zSeries® and IBM WebSphere Enterprise Developer, use the installation information found in the documentation included in those releases.

The information in this document applies to all IBM Rational Developer for System z Version 8.0.3 packages including Developer for zEnterprise.

Chapter 1. Who should use this document

This document is intended for system programmers installing and configuring IBM Rational Developer for System z Version 8.0.3 on a Linux on System z host system.

This document lists in detail the different steps needed to install the RSE server component of Developer for System z. To use this document, you need to be familiar with the Linux on System z host system.

Chapter 2. Introduction

The Remote System Explorer communications server (RSE server) is installed on a remote AIX®, Intel Linux, or Linux on System z system.

The RSE server allows a workstation running Developer for System z to perform the following types of tasks on the connected remote host system:

This document describes how to install, use, and uninstall the RSE server on a Linux on System z host system.

Chapter 3. Linux on System z host requisites

General information

The products listed in this section are all available at the time of publication for this manual. See the IBM Software Lifecycle Web site (http://www.ibm.com/software/support/lifecycle/) to see whether a selected IBM product is still available at the time that you want to use the related Developer for System z function.

The most current listing of prerequisites and corequisites is available in the Developer for System z Prerequisites Guide (SC23-7659). This document is available on the IBM Rational Developer for System z Web site Library page (http://www.ibm.com/software/rational/products/developer/systemz/library/) and supersedes the requirements listed in this document.

Linux on System z

One of the following levels must be installed:

Product Name
Red Hat Linux Enterprise Server 6 (s390x)
Red Hat Linux Enterprise Server 5 (s390x)
SUSE Linux Enterprise Server 11 (s390x)
SUSE Linux Enterprise Server 10 (s390x)

The related product Web site is:

http://www-03.ibm.com/systems/z/os/linux/

SDK for Linux on System z, Java 2 Technology Edition

To use Remote Systems Explorer (RSE) on Linux on System z, one of the following levels must be installed:

Program Number Product Name
6207-001 IBM 64-bit Runtime Environment for Linux on System z, Java 2 Technology Edition, Version 6
6205-001 IBM 64-bit Runtime Environment for Linux on System z, Java 2 Technology Edition, Version 5

The related product Web site is:

http://www.ibm.com/developerworks/java/jdk/linux/
Note: The 32-bit version is not supported.

Chapter 4. RSE server installation and configuration

The supported functions of the RSE server on Linux on System z using IBM Rational Developer for System z are the following:

RSE server installation, updates, and uninstall

Installing

Use IBM Installation Manager to install the RSE server.

Note: You can also use Installation Manager to install updates for the RSE server or to roll back a previously installed update (see Updating).

Terms used: In the following instructions:

You can run the Installation Manager in either of two ways: using the X Window System or using the silent mode of Installation Manager. These methods are described in the next two subtopics.

Installation with the X Window System

  1. Copy the installation file, rdzrse80.tar, from the installation CD to a writable file system directory on the server system (/tmp would be a good location).
  2. Extract the RSE server install image:
    tar -xvf rdzrse80.tar
  3. Connect the client system to the server system. Here are two methods for connecting the systems:
  4. On the system running the X Window System, enter the following command on the command line:
    xhost +server_system
    where server_system is the host name of the server system. For example:
    xhost +myserver
    This command tells the X Window System to accept a display stream from the server system.
  5. Start the Installation Manager. On the command line:
    1. Change to the directory where you unpacked the rdzrse80.tar file.
    2. Enter the install command to start the Installation Manager:
      install
  6. Follow the directions in Installation Manager to complete the installation.

Installation using silent mode

This method uses the silent mode capability of the Installation Manager. For more information about silent mode see the IBM Information Center for the Installation Manager at http://publib.boulder.ibm.com/infocenter/install/v1r4/index.jsp.

Note: Run the Installation Manager as the root user.
  1. Copy the installation file, rdzrse80.tar, from the installation CD to a writable file system directory on the server system (/tmp would be a good location).
  2. Extract the RSE server install image:
    tar -xvf rdzrse80.tar
  3. On the command line, change to the directory where you unpacked the rdzrse80.tar file.
  4. The default install directory for the RSE server is /opt/IBM/RDz80. To select another install directory:
    1. Open the install.xml response file with a text editor.
    2. Find the <profile> element.
    3. Change the installLocation parameter to specify the install directory that you want to use. For example:
      <profile
          id="IBM Rational Developer for System z Remote Systems Explorer"
          installLocation="rse_directory">
      </profile>    
      where rse_directory is the directory in which you want to install the RSE server.
    4. Close the text editor.
  5. If you are installing multiple RSE server instances onto the system, you must specify a unique identifier and a unique install location for each instance of the server. To specify a unique identifier and install location:
    1. Open the install.xml response file with a text editor.
    2. Make the following changes to the <profile> element:
      1. Change the id parameter to specify the install name that you want to use for this instance of the server.
      2. Change the installLocation parameter to specify the install location for this instance of the server. For example:
        <profile
            id="IBM Rational Developer for System z Remote Systems Explorer_1"
            installLocation="/opt/IBM/RDz80_1">
        </profile>
        where the _1 suffix is used to make the values unique.
    3. Also change the <offering> element so that the profile parameter has the same value as the id parameter of the <profile> element. For example:
      <offering profile="IBM Rational Developer for 
              System z Remote Systems Explorer_1"
              id="com.ibm.rational.rdz.rseserver.v80"
              version="8.0.3.2011"/>
    4. Close the text editor.
  6. To run the Installation Manager, enter the following command on one line. On Linux on System Z:
    ./install --launcher.ini ./silent-install.ini -acceptLicense

Directories created

Directories created: Installation Manager creates the following directories:

Uninstalling

Use IBM Installation Manager to uninstall the RSE server:

Updating

Use IBM Installation Manager to update the RSE server.

Note: The update process makes backup copies of the current configuration files in the subdirectory backup within the installation directory. You might also want to make your own backup copies of any configuration files that you have modified to ensure that you can easily restore the files after the update is complete.

RSE directory configuration

Important: After the RSE server has been installed on a host system, only the root user can log in to the host system.

To allow other users to log in to the system, the system administrator must grant read and execute permissions on the directory where the RSE server is installed and on all the files and subdirectories within that directory.

To grant permissions to the owning user (root) and to all users in the root group, enter the following command at the command line:

 chmod -R ug+xr  rse_directory

where rse_directory is the path of the directory where the RSE server is installed. The default path is /opt/IBM/RDz80.

Note: This example assumes that the RSE server is the only product installed in the directory.

To grant permissions to every user on the system, enter the following command at the command line:

 chmod -R ugo+xr  rse_directory

where rse_directory is the path of the directory where the RSE server is installed. The default path is /opt/IBM/RDz80.

Note: This example assumes that the RSE server is the only product installed in the directory.

Starting the RSE server

To start the RSE server:

  1. Open the ksh shell.
  2. Change to the directory containing the executable programs and scripts for the RSE server. If the RSE server is installed in the default directory /opt/IBM/RDz80, then the executable programs and scripts are contained in the directory /opt/IBM/RDz80/bin.
  3. Enter the following command:

Examples:

Example: RSE server start

The following example shows what the command line interface looks like when the RSE server is started successfully. The first line of text is the command to start the server and the subsequent lines are output from that command:

rsedaemon.RedHat.sh
...
java version "1.6.0"
Java(TM) SE Runtime Environment (build pxz6460sr5-20090529_04(SR5))
IBM J9 VM (build 2.4, J2RE 1.6.0 IBM J9 2.4 Linux s390x-64
        jvmxz6460sr5-20090519_35743 (JIT enabled, AOT enabled)
J9VM - 20090519_035743_BHdSMr
JIT  - r9_20090518_2017
GC   - 20090417_AA)
JCL  - 20090529_01

FEK001I RseDaemon being initialized
FEK010I (rsed.envvars location = /opt/IBM/RDz80/bin/)
FEK011I (log directory = ./../log/)
java version "1.6.0"
Java(TM) SE Runtime Environment (build pxz6460sr5-20090529_04(SR5))
IBM J9 VM (build 2.4, J2RE 1.6.0 IBM J9 2.4 Linux s390x-64
        jvmxz6460sr5-20090519_35743 (JIT enabled, AOT enabled)
J9VM - 20090519_035743_BHdSMr
JIT  - r9_20090518_2017
GC   - 20090417_AA)
JCL  - 20090529_01

FEK002I RseDaemon started. (port=4035)
Server Started Successfully

Configuring the RSE server to use SSL

You can configure the RSE server to use SSL authentication to provide secure connections between the server and its clients. To configure the RSE server to use SSL authentication follow these steps:

  1. Create a Java keystore file on the system where the RSE server is installed.

    Use the keytool program provided with the Java SDK to generate a key pair (public key and associated private key). For example:

    keytool -genkey -alias alias_name -validity 3650 -keystore keystore_name 
        -storepass keystore_password -keypass key_password

    where:

  2. In the RSE server install directory, update the ssl.properties file:

    1. Open the ssl.properties file with a text editor.
    2. Specify the location of the Java keystore file and the password:
      daemon_keystore_file=jks_file
      daemon_keystore_password=jks_password 
      where:
      • jks_file is the path of the Java keystore file that you created, and
      • jks_password is the password for the Java keystore file.
    3. Set the following two properties to enable SSL authentication:
      enable_ssl=true
      disable_server_ssl=false
    4. Close the ssl.properties file.
  3. Start the SSL Server in the usual way.

Example: RSE server start with SSL

The following example shows what the command line interface looks like when the RSE server with SSL is started successfully. The first line is the command to start the server and the subsequent lines are output from that command:

 rsedaemon.RedHat.sh 4077
 
SSL Settings
[daemon keystore:       /opt/IBM/RDz80SSL/rdzrse.jks]
[daemon keystore pw:    MyKeystorePassword]
[server keystore:       /opt/IBM/RDz80SSL/rdzrse.jks]
[server keystore pw:    MyKeystorePassword]
Daemon running on:      RDzServer.rtp.raleigh.ibm.com, port: 4077

Secure and nonsecure sessions

If you want to concurrently run both secure sessions and nonsecure sessions, you must install a second instance of the RSE server and configure the ssl.properties file in the new installation directory. You cannot use a single instance of the server to run both secure sessions and nonsecure sessions concurrently.

For example, suppose that you have installed the RSE server in the default directory and you have configured it to run nonsecure sessions using the default port 4035. Now you want to install the RSE server a second time and run secure sessions from port 4077. Follow these steps:

  1. Install a second instance of the RSE server into a new installation directory, such as /opt/IBM/RDz80SSL.
  2. In the installation directory, modify the ssl.properties file as described in the topic Configuring the RSE server to use SSL:
    daemon_keystore_file=jks_file
    daemon_keystore_password=jks_password 
    
    enable_ssl=true
    disable_server_ssl=false
  3. Start the server, using a different port than the port used for nonsecure connections:
    rsedaemon.RedHat.sh 4077

Notices

© Copyright IBM Corporation 2000, 2011.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Programming interfaces: Intended programming interfaces allow the customer to write programs to obtain the services of IBM Rational Developer for System z.

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
3-2-12, Roppongi, Minato-ku, Tokyo 106-8711 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
20 Maguire Road
Lexington, Massachusetts 02421-3112
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements, or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice and represent goals and objectives only.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

Copyright license

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Each copy or any portion of these sample programs or any derivative work must include a copyright notice as follows: "© (your company name) (year). © Copyright IBM Corporation 2000, 2011. Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. 2000, 2011".

Trademark acknowledgments

IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information [www.ibm.com/legal/copytrade.shtml].

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Other product and service names might be trademarks of IBM or other companies.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)