Version 7.60
January 2013
This document contains general notes for the installation of ASG-Rochade (herein called Rochade) and its components.
The operating systems that Rochade supports are referred to by these names:
• Windows denotes Microsoft Windows XP, Vista, 7, and 8 as well as Microsoft
Windows Server 2003, 2008, and 2012.
• UNIX denotes IBM AIX, HP-UX, Sun Solaris, and Linux. • z/OS denotes IBM z/OS.
• BS2000 denotes BS2000/OSD.
Distribution of Rochade Components
The Rochade components and associated documentation are available for download from the ASG Intelligent Support Portal (ISP) at http://cust.asg.com/Rochade/Index_PS.aspx. On request, they also are available on CD.
See the ASG-Rochade Installation Guide for information about downloading from the
ISP and about the installation.
Detailed information on the hardware and software requirements for the respective operating systems and Rochade components is available from the ISP under
http://cust.asg.com/Rochade/ProductSpecifications/SupportedEnvironments.html. Initial notes for the Rochade components are located in the distribution readme directory. After installation, you can find the readme files in the readme folder under Windows and UNIX. The readme files are not installed under z/OS and BS2000.
Structure of the Installation Directory/Distribution Medium
The directory containing the files for installing Rochade under Windows and UNIX has this structure:
The directory containing the files for installing Rochade under z/OS has this structure:
The directory containing the files for installing Rochade under BS2000 has this structure:
Windows/UNIX Content
\optional Optional software and files.
\readme Readme files.
\server\<system>\disk1 Server installation, where <system> specifies the operating system for which the software is provided. \setup\win\<versions>\disk1 ADM or Application installation (Windows), where <versions> specifies the server versions for which the ADM and Application installations are supported. \setup\<system>\disk1 Applications installation (UNIX), where <system>
specifies the UNIX system for which the software is provided.
\TechDoc Technical documentation.
z/OS Content
\README Readme files
\ROINST.CNTL Jobs for the creation of datasets and loading of libraries
\XMIT.LIB The z/OS unloaded libraries in XMIT format
\*.bat Command files for file transfer
BS2000 Contents
\readme Readme files
\ROBS2A Files that are transferred to BS2000 in ASCII format during file transfer
\ROBS2B Files that are transferred to BS2000 in binary format during file transfer
Open Source Components
The Rochade installation program uses these open source components:
• Apache Commons IO library - a library of utilities to assist with developing IO
functionality (see http://www.apache.org/)
• Mozilla Rhino - JavaScript Implementation (see http://www.mozilla.org/rhino/) • Apache Axis - Web Service Middleware (see http://ws.apache.org/axis/)
Installation Principles
The Rochade installation process sets in place the software under the appropriate operating system (i.e., data and programs grouped by Rochade components) and carries out the basic configuration to prepare it for operation. The installation is composed of these phases:
• Server installation, which sets up the Rochade Server.
• ADM installation, which includes all tasks for importing Rochade components into
the Rochade databases. It comprises creation of new databases as well as the import of Rochade components into the databases and configuration of the components.
• Application installation, which installs the data and programs for starting and
executing the Rochade components on the local computer and configures the Rochade components there.
To install Rochade components
1 Make sure that the Rochade Server is running, and check the server version and other
installation prerequisites for the Rochade components. Also make sure that a valid backup of the databases is available.
2 Carry out the ADM installation if your distribution contains an installation directory
setup\win.
NOTE: The open source components included in Java API are not ASG products;
therefore, ASG has no control over their licensing strategy. ASG cannot guarantee their availability, quality, or future maintenance and might need to replace them with other products.
3 Carry out the Application installation.
The Application installation provides a dialog for selecting the components that you want to install. If the components all have the status OK, either they are installed already on your local computer or you carried out step 3 before step 2 and the components have not been updated in the databases for this reason.
4 Carry out additional steps for starting the component, as required. For details, see the
Readme files and other documentation for the component.
For detailed installation instructions, see the ASG-Rochade Installation Guide.
Installation under Windows
To start the installation
1 Log in to your computer as an administrator so you have all access rights. 2 On the installation disk, run the appropriate setup application:
• For Server installation, run .\server\win\disk1\setup.exe.
• For ADM or Application installation, run
.\setup\win\<Rochade_version>\disk1\setup.exe. Or
Click Start ► All Programs ►<Rochade_Program_Folder>► Rochade Setup to
upgrade an existing installation of Rochade.
Rochade setup under Windows includes both ADM and Application installation. On the Setup dialog, you can specify the installation that you want to run:
• Select the ADM Setup check box to carry out the ADM installation.
• Select the Application Setup check box to carry out the Application installation of
the components under Windows directly after the ADM Setup.
NOTE: The installation under Windows requires that Java 1.6 or later is installed.
NOTE: Microsoft system libraries may be updated during Rochade installation, then a
Installation under UNIX
To prepare for UNIX installation
1 Create a separate UNIX user account for Rochade.
2 Mount the installation CD to an empty subdirectory. Or
Copy all files from the installation directory or from the CD to the installation directory on your UNIX machine, using FTP or another suitable program.
To start the installation
► On the installation disk, run the appropriate shell script:
• For Server installation, run sh ./server/<system>/disk1/install.sh.
• For Application installation, run sh ./setup/<system>/disk1/install.sh.
Installation under z/OS
This section describes only the installation from the distribution directory or from CD. Each installation requires its own set of installation and target files. The names of the target files are comprised of a fixed part and a parametric dataset prefix called PFX?.
To load the files from the distribution directory or CD
1 Check these settings for FTP under Windows and z/OS:• The Windows environment variable TEMP must point to a directory for
which you have write privileges.
• The ftp.exe program must be available in the program path list of the PATH
variable.
NOTE: Installation under the root ID is possible, but ASG does not recommend it.
• Block length: 9040 • Primary space: 1 CYL • Secondary space: 1 CYL • Directory: 2 BLK
3 Transfer the preparation jobs to the dataset PFX?.ROINST.CNTL.
a In Windows, open the command-line interface (i.e., command prompt). b In the command-line interface, change to the distribution directory and start the
batch file for the transfer:
n2m_cntl.bat <user> <passwd> <hostname> <PFX?> where:
<user> is the TSO user ID.
<passwd> is the password for the TSO User ID.
<hostname> is the name or IP address of the z/OS machine.
<PFX?> is the dataset prefix.
4 Edit the data pool of the library PFX?.ROINST.CNTL: a Modify the JOB card according to your requirements.
b Replace the placeholders U???, V?????, and PFX? with the values that are
valid for your Rochade installation.
5 Under z/OS, start the job PFX?.ROINST.CNTL(C1CREATE) with submit to
create and allocate the PFX?.XMIT.LIB dataset for file transfer.
6 Transfer the XMIT files that contain the Rochade libraries to the library
PFX?.XMIT.LIB.
a In Windows, open the command-line interface.
In the command-line interface, change to the distribution directory and start the
NOTE: If you are using SMS for data administration, you must either adapt
all DD instructions containing UNIT and VOLSER specifications U???, T???, and V????? in accordance with the required keywords for management classes, storage classes, and data classes, or delete specifications that are not required.
where the parameters have the same meaning as in step 3 on page 6.
7 Under z/OS, start the job PFX?.ROINST.CNTL(C2LOAD) with submit to install
the Rochade data and load the libraries.
To start the installation
► Enter this TSO command to start the installation: TSO EX 'PFX?.ROINST.REXX(ROINST)'
Installation under BS2000
To load the data from the distribution directory or CD
1 Check these settings for FTP under Windows and BS2000:• The Windows environment variable TEMP must point to a directory for
which you have write privileges.
• The ftp.exe program must be available in the program path list of the PATH
variable.
• The FTP server must be running on the BS2000 machine. 2 Transfer the installation files from the ROBS2A directory.
a In Windows, open the command-line interface (i.e., Command Prompt). b In the command-line interface, change to the distribution directory and start the
batch file for the transfer:
n2b_robs2a.bat <user> <passwd> <account> <hostname> where:
<user> is the BS2000 User ID.
<passwd> is the password for the BS2000 User ID.
<account> is the BS2000 account number.
4 Transfer the libraries from the ROBS2B directory. a In Windows, open the command-line interface.
b In the command-line interface, change to the distribution directory and start the
batch file for the transfer:
n2b_robs2b.bat <user> <passwd> <account> <hostname> where the parameters have the same meaning as in step 2 on page 7.
To start the installation
► Enter the appropriate command to start the installation:
• For new installations, enter /CALL ROCHADE.DO.INSTALL.NEU.
• For upgrade installations, enter /CALL ROCHADE.DO.INSTALL.UPD. Also check the information in the file ROCHADE.README.BS2000.
Upgrade Installation
It is possible to upgrade each of the installation phases (i.e., the Server, ADM, and Application installation phases). Further, an upgrade can address the structure of the databases, individual Rochade components in the databases and/or file systems, and the installation environment itself.
User Authentication and Password Protection
Some Rochade components require an administration database (ADB) to be active on the Rochade Server (e.g., components that use Rochade’s role-based access control [RBAC]). The installation program activates an ADB if required. During the installation, you can select a database as ADB. The installation program will create user accounts in the ADB
NOTE: Execution of the batch file can take several minutes.
NOTE: ASG recommends that you back up your entire existing Rochade environment
(i.e., directories, libraries, files, and databases) before carrying out an upgrade installation. This ensures that you can re-implement any company-specific changes that might be lost during the upgrade.
If you use Rochade-internal user authentication, you have these additional options:
• Setting a password: You can specify a password that will be set for the user
accounts created during the ADB activation and for the administrator account.
• Deactivating password protection: Deactivates the password protection for all
user accounts created during the ADB activation, for the administrator account, and for all other existing user accounts.
Compatibility with Earlier Versions
Version 7.60
These changes have been made to the installation program for Rochade 7.60 and later:
• Under Windows, the Java installer is no longer part of the installation package. Java
is an installation prerequisite.
• The installation program accepts 32-bit and 64-bit Java installations. If you have
installed both, the installation program uses the 64-bit Java installation.
• If an ADB is activated during the installation, you now must specify the default
password to be used for the accounts that are created during the activation.
Version 7.10
These changes have been made to the installation program for Rochade 7.10 and later:
• Under Windows Vista, the installation program requests on the Choose Application
Data Location dialog that you select a directory in which Rochade will store data that can be altered by the user (e.g., initialization files and databases).
For a default option, the installation suggests that you use a directory called Rochade in the Windows system directory for application data of all users (e.g., C:\ProgramData\Rochade).
Under Windows 2000, Server 2003, and XP, these data are stored by default in subdirectories of C:\Program Files.
• The structure of the installation directories for Windows and UNIX has been changed
NOTE: Once the installation has finished, you can use Metability for setting individual
Known Issues
If you are working under Windows Vista or Server 2008 with User Account Control (UAC), be advised that, under a user account, an application (e.g., the Rochade Server) is carried out with all its access tokens and administrative rights, which in particular, affects the creation of files (e.g., databases or log files of the Rochade Server).
If you start the Rochade Server alternatively as a service or as a Windows application, you must ensure that your user account and the LOCAL SERVICE user account under which Windows starts services by default have the same access tokens and administrative rights. Otherwise, the Rochade Server might not be able to access files that were created under a different user account (e.g., databases and log files).
Rochade Customer Support
ASG provides support throughout the world to resolve questions or problems regarding installation, operation, or use of our products. ASG provides all levels of support during normal business hours and emergency support during non-business hours.