IBM Rational Developer for System z

RSE Server Installation Guide

Linux on System z

Version 7.6
GC27-2810-00
First edition (September 2009)

This edition applies to IBM Rational Developer for System z Version 7.6 (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:30 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, 2009.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Linux on System z host requisites
Linux on System z host prerequisites
Linux on System z
SDK for Linux on System z, Java 2 Technology Edition
RSE Server installation and configuration
RSE Server installation, updates, and uninstall
Installing
Uninstalling
Updating
RSE directory configuration
Starting the RSE Server
Example: Server start
RSE Server SSL configuration
Example: Server start using SSL
Notices IBM Rational Developer for System z
Index

Linux on System z host requisites

The products listed in this section are all available at the time of publication for this manual. See the IBM® Software Support 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-01.ibm.com/software/awdtools/rdz/library/) and supersedes the requirements listed in this document.

Common to all platforms, a version of Perl must be installed to start the IBM Rational Developer for System z Remote Systems Explorer (RSE) server. The Host Connect emulator requires a Telnet server. To connect to an RSE server using Host Connect, the RSE server must have a Telnet server installed and running to create a session.

Linux on System z host prerequisites

Linux on System z

One of the following levels must be installed:

Product Name
Red Hat Linux® Enterprise Server 5 (s390x)
Red Hat Linux Enterprise Server 4 (s390x)
SUSE Linux Enterprise Server 10 (s390x)
SUSE Linux Enterprise Server 9 (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/
Attention: The 64 bit version is supported.

RSE Server installation and configuration

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

There is currently no z/OS® Project for Linux on System z.

RSE Server installation, updates, and uninstall

Installing

RSE Server is a version of RSE that allows access to the file system and command shells on a Linux on System z system using Developer for System z.

The RSE Server install is simple and uses Installation Manager.

The following steps guide you through the RSE Server installation:

  1. Copy the installation file, rdzrse76.tar, from the IBM Rational Developer for System z RSE Server for AIX®, Linux, and Linux on System z Installation CD to a writable file system directory on the server (/tmp would be a good location). The CD has three directories, AIX, Linux, and zLinux that contain the rdzrse76.tar specific to the target OS. Pick the appropriate file from the directory that matches the OS on the intended installation system.
  2. Extract the RSE Server install image.
    tar -xvf rdzrse76.tar
  3. Use Installation Manager to install the RSE Server as well as installing updates and rolling back to the previous version of installed products. You can run Installation Manager as an X Window System program or from the command line in a silent install mode. If you run Installation Manager using X Windows, a console must be connected to the Linux on System z system or an X Windows server running on another system to which the DISPLAY variable is redirected. Install the RSE Server when running as the root user.
  4. From the directory that contains the extracted tar file, run the install program to run the X Windows Installation Manager. If X Windows® is not available, you can run a silent install from the directory that contains the untarred Developer for System z installation files. By default the RSE server is placed in the /opt/IBM/RDz76 directory. To install in a non default directory with silent install, edit the install.xml file and update the this line, <profile installLocation="<desired install location>" id="IBM Rational Developer for System z"/>, to specify the desired directory. To run the silent install execute the following command.:
      ./install --launcher.ini ./silent-install.ini

Uninstalling

To uninstall the Developer for System z RSE Server start the IBM Installation Manager launcher in the /opt/IBM/InstallationManager/eclipse directory, click the uninstall button and follow the instructions on the panels. For a silent uninstall go to the /opt/IBM/InstallationManager/eclipse directory and run:

./IBMIM --launcher.ini silent-install.ini -input <RSE install dir>/uninstall/uninstall.xml

where installed path is the directory where Developer for System z RSE Server is installed. The default installation directory is /opt/IBM/RDz76.

Updating

To update the Developer for System z RSE Server, start the IBM Installation Manager launcher in the /opt/IBM/InstallationManager/eclipse directory. Point to the location that contains the update by clicking File->Preferences and clicking the Add Repository button. After adding the repository, click the Update link on the main IBM Installation Manager screen and follow the instructions on the panels.

RSE directory configuration

After the RSE server has been installed, only the root user can log in to the system using RSE. To allow other users to access the Linux on System z system using RSE, the Linux on System z system administrator must open permissions for those users using the chmod command. Read and execute permission is required on the directory path to the RSE installation as well as the files in the RSE directory.

Assuming that the RSE server is the only product installed in the default directory /opt/IBM/RDz76, executing the following command allows the owning user, root, and any user in the root group, to connect to the RSE server:

 chmod -R ug+xr /opt/IBM/RDz76 

Using chmod -R ugo+xr /opt/IBM/RDz76 gives every user on the system permission to use RSE.

Starting the RSE Server

In the default installation directory /opt/IBM/RDz76/bin, there are two scripts which start the RSE server. One script, rsedaemon.RedHat.sh, is for running a Red Hat system and the other, rsedaemon.SuSe.sh, is for use on SuSe. Use one of the following commands to start the RSE server:

rsedaemon.RedHat.sh
The RSE server starts and is listening on the default port of 4035.
rsedaemon.RedHat.sh 3076
The RSE server starts and is listening on the specified port of 3076.
rsedaemon.SuSe.sh
The RSE server starts and is listening on the default port of 4035.
rsedaemon.SuSe.sh 3076
The RSE server starts and is listening on the specified port of 3076.

Example: Server start

When the RSE server is successfully started on a system the display shows configuration information used by the startup script. This information scrolls off the screen looks like the following example:

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/RDz76/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

RSE Server SSL configuration

SSL can be used to secure communication between Developer for System z and the Linux on System z system by creating a Java keystore file and setting the RSE ssl.properties file to point to this JKS file. When the RSE server starts, the properties file is read and the connection with Developer for System z is secured with SSL.

Since RSE uses the ssl.properties file to enable SSL, the system administrator can secure communication, or not, with the installation. You cannot have both secured and non-secured from the same RSE directory. If secured and non-secured ports are needed, you need a second installation of the RSE Server. To accomplish this, rerun Installation Manager and specify a new install directory such as /opt/IBM/RDz76SSL.

In the new directory, modify the ssl.properties file to reference the Java keystore file, which is in the <RDz Install Path>/bin directory. Now the RSE server can be started on a different port, 4077, with SSL securing the communications.

 rsedaemon.RedHat.sh 4077

With a Java keystore file named RDZRSE.jks, created in the /opt/IBM/RDz76SSL directory and using the password RDzisGreat, edit the ssl.properties file and change the following stanzas:

Note:
The path to the JKS file MUST be given in the daemon_keystore_file parameter.
#
daemon_keystore_file=/opt/IBM/RDz750SSL/RDZRSE.jks
daemon_keystore_password=RDzisGreat
#

To enable SSL authentication change the two stanzas enable_ssl and disable_server_ssl in the ssl.properties file to:

enable_ssl=true
disable_server_ssl=false

Example: Server start using SSL

When the RSE server is successfully started and a connection is made using SSL, on a system with a host name of RDzAIXServer, the screen looks like the following example:

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

Notices IBM Rational Developer for System z

?? Copyright IBM Corporation - 2009

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 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). Portions of this code are derived from IBM Corp. Sample Programs. ?? Copyright IBM Corp. [enter the year or year, year.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

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 www.ibm.com/legal/copytrade.shtml.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

Rational is a trademark of International Business Machines Corporation and Rational Software Corporation, in the United States, other countries, or both.

Intel and Pentium are trademarks of Intel Corporation in the United States, or other countries, or both.

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

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

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

Index

C D I L P S