ASG-Rochade Installation Notes

Transcription

1 ASG-Rochade Installation Notes February 2015 This publication introduces changes made to the installation of ASG-Rochade (herein called Rochade) and its components. It also provides information on system requirements and general instructions for performing Rochade installations. The Rochade installation 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 actual installation process depends on the operating system on which you want to install Rochade (e.g., for Windows, an installer is available, and for UNIX, an install script is provided). ISP Updates and Service Packs ASG encourages you to visit the Intelligent Support Portal (ISP): The ISP allows you to verify whether any product or documentation revisions, new maintenance, or service packs apply to this product release. Open Source Components The Rochade installation uses these open source components: Apache Commons IO library - a library of utilities to assist with developing IO functionality (see Mozilla Rhino - JavaScript Implementation (see Apache Axis - Web Service Middleware (see The open source components included in the Rochade installation 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. Copyright 2015 ASG GmbH & Co. KG, a wholly owned subsidiary of Allen Systems Group, Inc. All rights reserved. All names and products contained herein are the trademarks or registered trademarks of their respective holders. 1

2 Installation Information Installation Overview The setup of a Rochade environment consists of different parts: The Server installation to set up the Rochade Server. The ADM installation to create new Rochade databases, import Rochade components into the databases, and configure the components on the Rochade Server. The Application installation to install and configure the Rochade components on the local computer. Before you start an ADM or Application installation, make sure that the Rochade Server is running, and check the installation prerequisites for the Rochade components. Also make sure that a valid backup of the databases is available. You can find information on system recommendations and supported environments for a specific Rochade component in the release notes for that component in the distribution readme directory. You can find information on system recommendations and supported environments for all Rochade components under For details, see the hyperlinks under the heading ASG-Rochade Product Groups. You must complete the ADM installation for the Rochade components before you begin to carry out the Application installation for them. Under Windows, the Application installation prompts you to select the components that you want to install. If all components have the status OK, they already are installed on your computer or you carried out the Application installation before the ADM installation (i.e., the components have not yet been updated in the databases). After the installation, additional steps might be required before you can use a Rochade component. For details, see the release notes and other documentation for the component. You can find the release notes in the distribution readme directory and, after the installation, in the readme subdirectory of the Rochade installation directory. The release notes are not installed under z/os and BS2000. For detailed installation instructions, see the ASG-Rochade Installation Guide. 2

3 Structure of the Distribution Directory The distribution directory contains all files required for installing Rochade components. Under Windows and UNIX, the directory has this structure: Windows/UNIX \optional \readme \server\<system>\disk1 \setup\win\<versions>\disk1 \setup\<system>\disk1 \TechDoc Content Optional software and files. Release notes. Server installation, where <system> specifies the operating system for which the software is provided. ADM or Application installation (Windows), where <versions> specifies the server versions for which the ADM and Application installations are supported. Applications installation (UNIX), where <system> specifies the UNIX system for which the software is provided. Technical documentation. Under z/os, the directory has this structure: z/os Content \README Release notes \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 Under BS2000, the directory has this structure: BS2000 \readme \ROBS2A \ROBS2B \*.bat Contents Release notes Files that are transferred to BS2000 in ASCII format during file transfer Files that are transferred to BS2000 in binary format during file transfer Command files for file transfer 3

4 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 Rochade installer activates an ADB if required. During the installation, you can select a database as ADB. The installer will create user accounts in the ADB (e.g., an administrator account for the current user). If you use Rochade-internal user authentication, you must specify a password to be set for the administrator account and for user accounts created during the ADB activation. Once the installation has finished, you can use Metability for setting individual passwords and for further user administration. Installation under Windows The Rochade installer requires Oracle Java Runtime Environment 6 or 7 to be installed on the computer on which you want to run the installer. 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 the Server installation, run.\server\win\disk1\setup.exe. For the ADM or Application installation, run.\setup\win\<versions>\disk1\setup.exe. Or Click Start All Programs <Rochade_Program_Folder> Rochade Setup to upgrade an existing installation of Rochade. Under Windows, the Rochade installation 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 directly after the ADM Setup. 4

5 The Rochade installer prompts you to select a directory in which Rochade data will be stored that can be altered by the user (e.g., initialization files and databases). By default, the directory is called Rochade and will be created in the Windows system directory for application data (e.g., C:\ProgramData\Rochade). Under Windows Server 2003, these data are stored by default in subdirectories of the directory C:\Program Files. NOTES: The installation uses LOCALE as the default value for the CODEPAGE and CODEPAGE_FILES settings. For details, see the ASG-Rochade System Administrator s Guide. Microsoft system libraries may be updated during Rochade installation, then a system reboot is required. Installation under UNIX To prepare for UNIX installation 1 Create a separate UNIX user account for Rochade. Installation under the root ID is possible, but ASG does not recommend it. 2 Copy all files from the distribution directory to the installation directory on your UNIX machine, using FTP or another suitable program. To start the installation In the installation directory, run the appropriate shell script: For the Server installation, run sh./server/<system>/disk1/install.sh. For the Application installation, run sh./setup/<system>/disk1/install.sh. The installation uses LOCALE as the default value for the CODEPAGE and CODEPAGE_FILES settings. 5

6 Installation under z/os This section describes only the installation from the distribution directory. 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?. The dataset prefix must not be longer than 19 characters, including separators. To load the files from the distribution directory 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 included in the system s PATH variable. The FTP server must be running on the z/os machine. 2 Create a PO dataset PFX?.ROINST.CNTL with these file attributes under z/os: Record format: FB Record length: 80 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 b In Windows, open the command prompt. In the command prompt, navigate to the distribution directory and enter this command to run 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. 6

7 4 Edit the data pool of the library PFX?.ROINST.CNTL: a b Modify the JOB card according to your requirements. Replace the PFX? placeholders with the dataset prefix for your Rochade installation. NOTES: If you are using SMS for data administration and want to make specifications for the management, storage, and data classes, add the specifications to the DD instructions. If you require UNIT or VOLSER specifications for the data administration, replace the U??? and V????? placeholders and remove the comment tags from the corresponding lines. 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 b In Windows, open the command prompt. In the command prompt, navigate to the distribution directory and enter this command to run the batch file for the transfer of the XMIT files: n2m_file.bat <user> <passwd> <hostname> <PFX?> where the parameters have the same meaning as in step 3 on page 6. Execution of the batch file can take several minutes. 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)' 7

8 Installation under BS2000 To load the data from the distribution directory 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 included in the system s PATH variable. The FTP server must be running on the BS2000 machine. 2 Transfer the installation files from the ROBS2A directory: a b In Windows, open the command prompt. In the command prompt, navigate to the distribution directory and enter this command to run 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. <hostname> is the name or IP address of the BS2000 machine. 3 Create the libraries under BS2000 via this procedure call: /CALL ROCHADE.DO.INSTALL.PREP 4 Transfer the libraries from the ROBS2B directory. a b In Windows, open the command prompt. In the command prompt, navigate to the distribution directory and enter this command to run 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 8. Execution of the batch file can take several minutes. 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.BS

9 Upgrade Installation You can perform upgrade installations for both the Rochade Server and the Rochade components. You can install an update by running the Server, ADM, or Application installation. Further, an upgrade can address the structure of the databases, Rochade components in the databases and/or file systems, and the installation environment itself. 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. Known Issues Consider these issues when installing Rochade: If you are working under Windows 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 alternate between starting Rochade Server as a Windows application and as a service, you must ensure that your user account and the user account LOCAL SERVICE (which Windows uses to start services by default) have the same access tokens and administrative rights. Otherwise, the server might not be able to access files that were created under the other user account (e.g., databases and log files). The ADM installation only supports installing in 12 Rochade databases at a time. 9

10 10