Installation Instructions for SAS 9.4 Installation Kit for Planning DVD Installations on z

Installation Instructions for SAS 9.4 Installation Kit for Planning DVD Installations on z
Installation Instructions for SAS 9.4
Installation Kit for Planning DVD
Installations on z/OS
®
The correct bibliographic citation for this manual is as follows: SAS Institute Inc. 2013. Installation
Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS, Cary, NC: SAS
Institute Inc.
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Copyright © 2013, SAS Institute Inc., Cary, NC, USA
All rights reserved. Produced in the United States of America.
For a hard-copy book: No part of this publication may be reproduced, stored in a retrieval system, or
transmitted, in any form or by any means, electronic, mechanical, photocopying, or otherwise, without the
prior written permission of the publisher, SAS Institute Inc.
For a Web download or e-book: Your use of this publication shall be governed by the terms established by
the vendor at the time you acquire this publication.
The scanning, uploading, and distribution of this book via the Internet or any other means without the
permission of the publisher is illegal and punishable by law. Please purchase only authorized electronic
editions and do not participate in or encourage electronic piracy of copyrighted materials. Your support of
others’ rights is appreciated.
U.S. Government Restricted Rights Notice: Use, duplication, or disclosure of this software and related
documentation by the U.S. government is subject to the Agreement with SAS Institute and the restrictions
set forth in FAR 52.227-19, Commercial Computer Software-Restricted Rights (June 1987).
SAS Institute Inc., SAS Campus Drive, Cary, North Carolina 27513.
June 2013
SAS® Publishing provides a complete selection of books and electronic products to help customers use SAS
software to its fullest potential. For more information about our e-books, e-learning products, CDs, and
hard-copy books, visit the SAS Publishing Web site at support.sas.com/bookstore or call 1-800-727-3228.
SAS® and all other SAS Institute Inc. product or service names are registered trademarks or trademarks of
SAS Institute Inc. in the USA and other countries. ® indicates USA registration.
Other brand and product names are registered trademarks or trademarks of their respective companies.
Table of Contents
Before You Begin—Prerequisites........................................................................... 1
System Requirements ................................................................................................... 1
Installation Alert Notes ................................................................................................. 1
Software Order E-mail (SOE) ......................................................................................... 1
SAS Installation Data Files (SID files) ............................................................................. 1
SAS Home Location ...................................................................................................... 2
SAS Deployment Wizard ............................................................................................... 2
SAS Software Depot ..................................................................................................... 2
Location of SAS Software Depot.................................................................................................................2
Disk Space .................................................................................................................. 3
User ID Requirements................................................................................................... 3
Updating the Logon Password ........................................................................................ 3
Deployment Plan .......................................................................................................... 4
Pre-installation Review.................................................................................................. 4
Installing Required Third-Party Software ......................................................................... 4
X11 Server Availability .................................................................................................. 4
Installation Process ................................................................................................. 5
Step 1. Creating the SAS Software Depot .............................................................. 5
Make Your SAS Software Depot accessible to z/OS ........................................ 6
Step 2. Installing and Maintaining Your Software ................................................. 7
Installation Action—Action A or Action B .......................................................................... 7
Planning Metadata Migration from SAS 9.1.3, SAS 9.2 or SAS 9.3 ...................................... 7
Important Notes .......................................................................................................... 7
Installation Steps ......................................................................................................... 8
Updating an Existing Installation ................................................................. 17
Updating the Logon Password ...................................................................... 17
Step 3. Validate Installation and Post-Configuration .......................................... 18
Step 4. Managing Server Sessions....................................................................... 18
Step 5. Installing SAS 9.4 Mid-tier and Client Software from the SAS
Software Depot....................................................................................................... 19
Creating the SAS Software Depot for Your Mid-tier and Client Machines ...... 19
Installing Required Third-Party Software ..................................................... 19
Installing SAS Software from the SAS Software Depot ................................. 20
Step 6. Archiving Your SAS Software Depot ....................................................... 21
Tips and Additional Information ........................................................................... 21
Technical Support.................................................................................................. 22
i
12 July 2013
ii
Before You Begin—Prerequisites
This document provides all of the information related to installing a SAS 9.4 DVD Software planning
order on z/OS systems for which you have purchased licenses. Please review this document in its
entirety.
Be sure to review each of the topics in the “Prerequisites” and “Overview” sections before beginning
your installation.
System Requirements
Confirm that your system meets the minimum requirements by referring to the system requirements
from the SAS 9.4 Install Center Documentation web site
(http://support.sas.com/documentation/installcenter/94/index.html) and
selecting Documentation for SAS 9.4 Installation on z/OS.
Installation Alert Notes
On the http://support.sas.com/notes/index.html web page, select Outstanding Alert
Status Installation Problems. Select the Results Filter tab, and then select z/OS as the operating
system from the Operating System drop-down list. Then press Enter.
Review the Installation Alert Notes that are listed to see if they apply to this installation order.
Software Order E-mail (SOE)
To install SAS 9.4 on z/OS, start with the Software Order E-mail (SOE) you received from SAS
Institute. This e-mail contains details such as the order number, a key, and the type of installation you
have: Basic or Planning. Basic orders are generally straightforward single-machine deployments.
Planning orders are more complex, multi-machine deployments. This document is for a planning
order.
SAS Installation Data Files (SID files)
The SAS Software Depot includes one or more SAS installation data (SID) file or files. A SID file is
valid for a limited time and consists of customized installation information and product
authorization information. The SAS Deployment Wizard uses the installation information in a SID
file to install your licensed software and apply customized product authorization information to your
system. SID files follow a naming convention in which a file called
sas94_xxxxxx_yyyyyyyy_zzz.txt would mean xxxxxx is your order number, yyyyyyyy is
your setnumid (a unique identifier used by SAS Technical Support), and zzz is the operating system
for which the order is licensed.
If you are going to run your metadata server on z/OS, you will be installing a set of 64-bit libraries in
addition to the standard 31-bit libraries, which will have a separate SAS site number and a separate
SID file. The SID file for the 64-bit metadata installation will show “SAS Metadata Server” in the SID
file itself.
The SID files for your software order will be located in the sid_files directory at the root of your
SAS Software Depot.
If your order is more than 90 days old, one or more of the SID files shipped with the order may have
expired. Check your SOE for the expiration date of the SID files in your order. If they have expired,
Page 1
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
contact your SAS site representative who may have received a Renewal Software Order E-mail that
will contain more recent SID files. Once you have created your SAS Software Depot, put the updated
SID files in the sid_files directory in your SAS Software Depot. If the site representative does not
have updated SID files, please contact SAS Customer Service at 1-800-727-0025 (press option 3).
SAS Home Location
SASHOME is the UNIX directory location where the UNIX file system components of your SAS
software are installed on your machine. SASHOME is specified when you install software through
the SAS Deployment Wizard for the first time, and that location becomes the default installation
location for any other SAS software you install on the same machine. You will need about 3 GB of
UNIX file system space for your SAS Home directory.
Many sites prefer to have SAS Home in a separate UNIX file system than their SAS Software Depot.
This allows you to easily archive the SAS Software Depot and reuse that disk space. The directory
path for your SAS Home location cannot be a directory within your SAS software depot.
Note:
The length of the SASHOME path is limited to 54 characters.
Note:
The SAS Home directory is an integral part of the SAS 9.4 installation and MUST exist for you to
apply maintenance or hotfixes to your SAS 9.4 software.
SAS Deployment Wizard
The SAS Deployment Wizard is the common interface used to install and deploy all SAS 9.4 software.
Using the SAS Deployment Wizard, you interact with the SAS Software Depot, the repository of files
and data necessary to install your SAS 9.4 software. You will invoke the SAS Deployment Wizard on
each system that is part of your SAS software deployment.
SAS Software Depot
The SAS Software Depot is a collection of SAS installation files that represents one or more orders.
The SAS Software Depot is organized in a specific format that is meaningful to the SAS Deployment
Wizard, which is the tool that is used to install and initially configure SAS. The SAS Software Depot
contains the SAS Deployment Wizard executable, one or more deployment plans, a SID file, order
data, and product data. Please see your Software Order E-Mail for the space required for the SAS
Software Depot for your order.
Location of SAS Software Depot
You can load your SAS Software Depot from the DVD to either UNIX or Windows. The location you
choose must have enough free space to accommodate the entire SAS Software Depot, and you must
be able to:
•
•
2
Mount your UNIX or Windows directory on your z/OS system using NFS mount, or
Move your depot to z/OS using a third party utility that can transfer a complete directory
tree, or our provided SAS Software Depot Copy Utility, which uses FTP.
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Disk Space
Your SAS installation requires the following space defined in UNIX file system directories:
•
SAS Software Depot
The SAS Software Depot is a collection of SAS installation files that represents one or more
orders. The SAS Software Depot is organized in a specific format that is meaningful to the
SAS Deployment Wizard, which is the tool that is used to install and initially configure SAS.
The SAS Software Depot contains the SAS Deployment Wizard executable, one or more
deployment plans, a SID file, order data, and product data. Please see your Software Order
E-Mail for the space required for the SAS Software Depot for your order.
This directory must be available to z/OS. It can be:
1. A UNIX File System directory on the z/OS machine.
2. A UNIX File System or Windows remote directory that is accessible to the z/OS
machine via an NFS mount.
You do not need the SAS Software Depot after you have completed installing and
configuring your SAS software. You can archive your SAS Software Depot to tape using the
process documented in SAS Note SN 37119
(http://support.sas.com/kb/37/119.html).
•
•
SAS Home directory
The SAS Home directory is an integral part of the SAS 9.4 installation. You may want to have
your SAS Software Depot and SAS Home directory in separate UNIX file system spaces so
that you can easily recover the space from your SAS Software Depot after installation. For a
SAS foundation only installation, 3 GB should be allowed for the SASHome directory.
SAS configuration directory
This directory is where your SAS server scripts, configuration files, and metadata server
repositories will reside. The amount of space required varies widely depending on your
usage, but you should have at least 2 GB of space for this directory, 3 GB if you are migrating
metadata from an earlier SAS release. We recommend that the configuration directory not be
a subdirectory under the SAS Home directory.
User ID Requirements
The user ID used for installing SAS 9.4 must meet specific requirements:
•
•
•
•
Must have a home directory that is not root.
Must have a default program shell defined.
Must not be a superuser.
Must not share a UID with other user IDs.
The user IDs that will be running the SAS Deployment Wizard to install SAS 9.4 Foundation for z/OS
require a larger region setting:
•
•
If running under OMVS, a TSO region size and ASSIZEMAX setting of at least 800 MB.
If running UNIX-style commands using rlogin, putty, or telnet, an ASSIZEMAX setting of at
least 800 MB.
Updating the Logon Password
Before applying any maintenance or hot fixes, if the administrator of your system has changed their
logon password, you must update the logon password. See “Updating the Logon Password” on page
17 for more information only if you originally installed without –nojobsubmit.
3
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Deployment Plan
To install and configure SAS servers that are part of a planning order, you must have a deployment
plan. The deployment plan is an XML-based description of the topology for your SAS system. The
plan file is used in the SAS software deployment process to "instruct" the SAS Deployment Wizard
which software components to install and configure on each machine.
The SAS Deployment Wizard contains a set of standard deployment plans that may be used by many
sites with no customization. These are documented at
http://support.sas.com/demosdownloads/setupcat.jsp?cat=Standard+Deployment+Plans.
If you are working with a SAS consultant in the deployment of your software, that consultant may
create a customized deployment plan for your installation.
Pre-installation Review
The SAS 9.4 Intelligence Platform: Installation and Configuration Guide can be a very helpful companion
to this installation document and should be reviewed before you continue with this installation. This
installation guide:
•
leads you step by step through the installation of the SAS Intelligence Platform.
•
will help you with any pre-installation configuration steps needed to perform the installation.
•
will help you create a reference to use throughout the installation. For example, it will help
you gather information that you will use during the install such as user IDs for special SAS
users, port numbers, and the installation locations of third-party products used for this
installation.
If you are using one of the standard deployment plans, browse through our library of standard
deployment plans available at
http://support.sas.com/demosdownloads/setupcat.jsp?cat=Standard+Deployment+Plans
and select the plan for your installation.
Installing Required Third-Party Software
The checklist indicates any third-party software that must be installed before you install your SAS
software, as well as which third-party software must be obtained from its vendor. An example is the
X11 Server, described in the next section. Obtain that software and install it according to the vendor’s
instructions.
Some of your third-party software may be provided in your software order. That software is listed in
your ordersummary.html which is available in your SAS Software Depot. Follow the path for each
third-party product listed in the Third Party section of the ordersummary.html to locate the
documentation for its installation.
You must have a supported level of Java installed for a planning installation with SAS 9.4. You can
check SAS’s third party support web page for information about the latest supported versions of Java
at http://support.sas.com/resources/thirdpartysupport/.
X11 Server Availability
The SAS Deployment Wizard has a graphical user interface which requires the use of an X11 server, if
available. At many sites, this software is already available and running on a UNIX and/or Windows
system. X11 software is available from commercial and shareware sites.
If you do not have access to an X11 server, you may be able to use the SAS Deployment Wizard in
console mode, allowing you to use a headless system to configure your server. If you use console
4
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
mode, each dialog used in the deployment of your SAS software is represented in text. Console mode
is available in all orders for SAS 9.4. Refer to your Software Order E-mail to determine your version
number. Console mode cannot be used on your middle tier.
Note:
Configuring SAS Data Integration Studio on z/OS may require the use of some X11 features. If you
are configuring SAS Data Integration Studio and intend to use console mode, you must have a virtual
framebuffer such as Xvfb.
For more information about X11 server minimum version requirements, see the web page entitled
“SAS 9.4 Support for Additional Software Products” at
http://support.sas.com/resources/thirdpartysupport/v94/othersw.html#tab_x11.
Installation Process
Overview
The installation process consists of the following steps:
Step 1. Creating the SAS Software Depot
Step 2. Installing and Maintaining Your Software
Step 3. Validate Installation and Post-Configuration
Step 4. Managing Server Sessions
Step 5. Installing SAS 9.4 Mid-tier and Client Software from the SAS Software Depot
Step 6. Archiving Your SAS Software Depot
Follow these steps in order to install your SAS software
Step 1. Creating the SAS Software Depot
Follow these steps to create your SAS Software Depot:
1.
Confirm that you have received the software that you expected.
•
In your installation kit, find the SAS Order Information document, which lists the
software that you ordered. Verify that the SAS products and servers listed are correct,
and that they match what you expected to receive. If they are not, contact SAS Customer
Service at 1-800-727-0025.
•
The SAS Software Depot is a network-accessible repository of your SAS software. After
you have installed your software, the SAS Order Information document will also be
available from your SAS Software Depot at
<SAS Software Depot Location>/install_doc/<order number>/soi.html.
•
After you have created your SAS Software Depot, you may view an expanded list of the
software that makes up your order. Consult the ordersummary.html, located in your
SAS Software Depot at
<SAS Software Depot Location>/install_doc/<order number>/ordersummary.html.
5
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
2.
Insert your media into a DVD drive on either a Windows or UNIX system to create or add to
your SAS Software Depot.
•
If you already have a SAS Software Depot from a 9.4 installation, you should use the
same location for creating this SAS Software Depot. Only new products, releases, and
maintenance will need to be added to the SAS Software Depot, saving disk space. If you
are creating a new SAS Software Depot, choose a location that either is, or can be,
NFS-mounted on z/OS, or confirm that you have a third-party FTP utility that can move
the entire directory tree to the z/OS file system. The directory name must not contain
blanks.

For Windows users:

o
The media should autoplay. If it does not, double-click setup.exe at the root of
your DVD to start the SAS Deployment Wizard.
o
Using the SAS Deployment Wizard, choose “Create or Add to a SAS Software
Depot” to create or add to your SAS Software Depot.
o
When you enter the directory path name for the SAS Software Depot, the name
should not contain blanks.
For UNIX users:
o
UNIX users should mount their DVD with the appropriate mount command and
execute setup.sh at the root of the DVD.
Note: If you launch the SAS Deployment Wizard from an order that spans media, do not
use a shell in the removable media’s file system when you launch setup.sh. In
addition, the SAS Deployment Wizard should not be invoked via the File
Manager. Either of these methods for launching the SAS Deployment Wizard will
create a Device busy condition, which prevents disk swapping later in the
deployment process.
o
Using the SAS Deployment Wizard, choose “Create or Add to a SAS Software
Depot” to create or add to your SAS Software Depot.
o
When you enter the directory path name for the SAS Software Depot, the name
should not contain blanks.
Make Your SAS Software Depot accessible to z/OS
You must make the SAS Software Depot accessible to z/OS by using one of the following methods:
•
•
•
6
NFS mount the directory on z/OS, or
Use the SAS Software Depot Copy Utility (which is provided in your SAS Software
Depot. You can find instructions for this utility in the SAS Deployment Wizard and SAS
Deployment Manager 9.4: User’s Guide at
http://support.sas.com/documentation/installcenter/94/mvs/index.html), or
Transfer the SAS Software Depot to z/OS using a third-party utility such as Filezilla, WSFTP, Blue Zone, etc., that can move a complete directory tree.
1. FTP the entire directory tree, ensuring that all files are transferred in binary to a z/OS
UNIX File System directory, and the case of all file names is preserved.
2. Be sure to set the execute bits after moving from Windows. Execute the following
command:
chmod -R a+r+x <SAS Software Depot Location>
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Alternatively, if the SAS Depot is stored on UNIX, follow these steps:
1. Create a tar file of your existing SAS Software Depot on your UNIX machine. Execute
the following command:
tar -cvf <SAS Software Depot Location> <tar file name>
2.
FTP the tar file created in the previous step to z/OS in binary format.
3.
Extract the SAS Software Depot on z/OS in the zFS directory where you want the
SAS Software Depot created. Execute the following command from OMVS or rlogin:
tar -xvf <tar file name>
Note: The "v" option used in the tar commands is for “verbose.” Information is displayed back to
the terminal about each file as it is processed. It is not required.
Step 2. Installing and Maintaining Your Software
The remainder of this document describes the installation and maintenance (where applicable)
process in detail. At this point you should have reviewed and completed all of the pre-requisites for
this installation previously documented along with the pre-installation steps in the SAS 9.4
Intelligence Platform: Installation and Configuration Guide.
The SAS 9.4 Intelligence Platform: Installation and Configuration Guide is available at
http://support.sas.com/documentation/cdl/en/biig/63852/PDF/default/biig.pdf.
You must have an X11 server available on a Windows PC or UNIX machine at your site, and you
must use the SAS Deployment Wizard to install your software.
Installation Action—Action A or Action B
The installation process will prompt you for an installation action to choose. Determine which one of
these installation actions below apply to this installation.
•
•
Action A is for a new installation—if you do not currently have SAS 9.4 installed on your
system at all or you want to create a new SAS 9.4 installation.
Action B installs maintenance and/or new products directly into your existing
production SAS 9.4 libraries and directories.
Planning Metadata Migration from SAS 9.1.3, SAS 9.2 or SAS 9.3
If you are migrating metadata from SAS 9.1.3 or SAS 9.2, you must prepare your software for
migration. To prepare your SAS 9.1.3 or SAS 9.2 deployment for migration to SAS 9.4, follow the
instructions in the SAS 9.4 Intelligence Platform: Migration Guide at
http://support.sas.com/documentation/cdl/en/bimig/63853/PDF/default/bimig.pdf.
Important Notes
•
•
•
Do not log in to z/OS as a superuser (sometimes called “root” or “UID(0)”).
The user ID that will be running the SAS Deployment Wizard to install SAS 9.4 Foundation
for z/OS must have the same requirements as noted in “User ID Requirements” on page 3.
If you are applying maintenance or adding software to an existing installation, you must stop
all SAS servers and processes before updating your installation.
7
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Installation Steps
1.
In order to use the SAS Deployment Wizard interactively, you will need to have access to a
desktop computer with an X11 server installed and active. You need to determine whether
you have an X11 server.
a.
If you will be using an X11 server, set the DISPLAY environment variable to point to
your X11 server. Issue the following case-sensitive command from the z/OS UNIX
shell on your z/OS system before starting the SAS Deployment Wizard:
export DISPLAY=<your X11 server name>:0.0
Note: If you do not issue this command, setup.rexx will prompt you for the server name.
Make sure that the X11 server is started on your workstation before starting the
install.
b.
To invoke SAS using the graphical interface, enter the z/OS UNIX shell command
below from OMVS.
Important: If your metadata server will reside on z/OS, skip to Step 2 , otherwise if your
metadata server will reside on another machine, the metadata server must be installed,
configured, and already running on that other host., then proceed to Step 3 to invoke the SAS
Deployment Wizard for the 31-bit install.
Example:
./setup.rexx –x11 –jobsubmit
Note: -jobsubmit is optional and will allow the jobs to be submitted automatically
c.
If you don’t have an X11 server, you can use the –console option and you do not
have to issue the export display command. For example:
./setup.rexx
Note: Beginning with SAS 9.4, the -nojobsubmit and –console are set by defaultl.
The -console option means that you do not wish to rely on an X11 server; this
allows for a text-based interface.
Note: If you are configuring SAS Data Integration Studio and intend to use console mode, you
must have a virtual framebuffer such as Xvfb.
The ‐console line command option can be used with other options at the same time,
such as recording or playing back a response file.
Note:
8
If you are instructed to enter a sequence that includes angle brackets, such as
“Enter <q> to quit”, you must include those symbols.
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Note:
If you intend to run the SAS Deployment Wizard in console mode to perform a
deployment without a graphical display, ensure that the DISPLAY environment
variable is unset, as opposed to it being set to a blank value (that is, DISPLAY= ).
The –nojobsubmit option means that the SAS Deployment Wizard will not submit the
jobs automatically so that you can inspect and/or modify the JCL before execution.
By default, the SAS Deployment Wizard submits these jobs and:
• Assigns the same job name xxxxxxA to each job it automatically submits, where:
xxxxxxx is assigned the installer user ID “A” – suffix assigned to the installer user.
 Uses the FTP JES interface to track the progress of each job, and in particular
determine when they have completed.
Below are some of the reasons for using the –nojobsubmit command line option which will
allow you to edit and submit the batch jobs yourself:
• Your site uses JES3 (not JES2), or
• Your FTP server is configured for JESINTERFACELEVEL=2, or
• The SAS installer ID is not authorized to use FTP, or
• You need to make site-specific changes to the JCL or wish to review the JCL before
submission, or
• The FTP JES interface’s requirement that the job name be the user ID performing the
install suffixed with a single letter or digit is incompatible with your site’s job name
requirements.
2.
In SAS 9.4, the metadata server runs only in 64-bit mode and requires a separate installation.
If you plan to run your metadata server on z/OS, you must invoke the SAS Deployment
Wizard multiple times, and this should be your first invocation of the SAS Deployment
Wizard.
Important:
a.
If your metadata server will reside on another machine, the metadata server must be
installed, configured, and already running on that other host. Skip to Step 3 to
invoke the SAS Deployment Wizard for the 31-bit install.
Invoke the SAS Deployment Wizard with the required option –z64
./setup.rexx –z64
b.
Select “Install SAS Software” on the first screen.
9
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
The next 4 steps show some key screens and values. You will be prompted for the
deployment type on the second screen. Select “Install SAS Foundation and Related
Software” as shown below.
c.
10
When prompted for your SAS Home directory, note that you will use the same
directory for both the 64-bit and 31-bit installations.
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
d. Only select “SAS Foundation” in the “Select Products to Install” screen.
11
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
To ensure you are using the correct SID file for the z64 install, the only products that
should appear are the SAS Metadata Server and, if it is contained in your order,
SAS/Secure.
12
e.
Use a separate high-level qualifier for this installation than you will for your main
SAS installation (it could be the main SAS high-level qualifier with an additional
level, for example SAS.SAS94.Z64). Note that the load module libraries created for
the 64-bit installation do NOT need to be program-controlled as the libraries for the
31-bit installation do.
f.
If you specified –nojobsubmit, after the SAS Deployment Wizard has completed with
all green check marks, run the series of jobs indicated in the JOBINDEX member of
the <HLQz64>.INSTALL.CNTL data set. After you submit the first job, each job will
submit the subsequent job as its last step.
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
3.
Invoke the SAS Deployment Wizard for the 31-bit install. Note that this will be the second
invocation if you installed your metadata server on z/OS following the instructions in Step
2. On your z/OS system, from OMVS (not ISHELL), rlogin, or putty, enter the z/OS UNIX
shell command ./setup.rexx at the root of your SAS Software Depot to start the SAS
Deployment Wizard.
The most commonly used options are:
-record
records the values that you enter for the SAS Deployment Wizard
prompts in the file specified by the –responsefile option. This is
convenient when you have to enter many options such as port
numbers and you may have to rerun the configuration later. Note that
once you have saved a response file, you can use it in a subsequent
invocation of the SAS Deployment Wizard by specifying
–responsefile without the –record option.
-responsefile
if –record is also specified, a new file is created with the responses
entered in that invocation of the SAS Deployment Wizard. If –record
is not specified, an existing response file from a previous run will be
used to fill in the responses from that previous run. Your installation
user ID must have write access to the specified file.
-deploy
if you specify –record you must also specify –deploy to actually
deploy the software.
Example
setup.rexx -record -responsefile /u/userid/sdwresponse.properties
Notes:
o
By default, no deployment occurs when running in a record mode. In order to force
a deployment while recording, use –deploy. For example:
setup.rexx -record -responsefile
/u/userid/sdwresponse.properties –deploy
o
If you specify a file location where a file already exists, the pre‐existing file will be
overwritten by the SAS Deployment Wizard.
A full listing and description of these command-line options for setup.rexx may be
found in the SAS Deployment Wizard and SAS Deployment Manager 9.4: User’s Guide
at http://support.sas.com/documentation/installcenter/94/mvs/index.html.
o
4.
Before you configure your servers, you must have the SASCP64 module installed where it
can be accessed as a TSO or UNIX command. For TSO, the SASCP64 module must be in a
TSO command library or in STEPLIB. If you use rlogin to access your z/OS system, the
SASCP64 module must be in link list.
If you do not have the SAS SVC installed from a previous SAS 9 release, you must also install
that into your system before running the configuration. You can do this by installing (but not
configuring) 31-bit SAS and then obtain the SVC module from the load library, or you can
download it from SAS Note SN 43697 available at
http://support.sas.com/kb/43/697.html.
5.
Use the SAS Deployment Wizard dialogs to install the 31-bit software. If you are using the –
nojobsubmit option, you should check only “Install SAS Software” as shown below. If you
are not using the –nojobsubmit option, you can configure your servers in the same invocation
of the SAS Deployment Wizard.
13
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
o
o
Use the Help button for more information about the choices available in each page.
Be sure to use the same JRE as you are using to run the SAS Deployment Wizard for
the “Select Java Runtime Environment prompt” (see the screen image which follows).
If you are unsure of which JRE you are using, see the messages displayed when the
SAS Deployment Wizard starts up which indicate the JRE being used. Alternatively,
you may call SAS Technical Support for assistance.
This is an example of the messages displayed by the SAS Deployment Wizard (the
highlighted text is what you would have put in the prompt in the SAS Deployment
Wizard):
java runs from /usr/lpp/java/J6.0/bin/java by default.
The java version found is:
java version "1.6.0"
Java(TM) SE Runtime Environment (build pmz3160sr8fp1-20100624_01(SR8 FP1))
IBM J9 VM (build 2.4, JRE 1.6.0 IBM J9 2.4 z/OS s390-31 jvmmz3160sr8ifx20100609_59383 (JIT enabled, AOT enabled)
14
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
o
For more detailed information, please see the SAS Deployment Wizard and SAS
Deployment Manager 9.4: User’s Guide at
http://support.sas.com/documentation/installcenter/94/mvs/index.html.
o
One common point of confusion in the SAS Deployment Wizard is selecting which
machine in a multi-machine plan you are working with. For z/OS, you will usually be
choosing “Server,” “SAS Application Server,” or “SAS Metadata Server,” depending on
which plan you are using and what you wish to install on this machine.
15
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Continue through the dialogs or prompts until the SAS Deployment Wizard completes.
Note: If you did run with the –jobsubmit option, please verify that all batch jobs submitted by
the SAS Deployment Wizard ran successfully. The JOBINDEX member of
<HLQ>.INSTALL.CNTL shows which jobs should have executed.
6.
If you installed with the default option –nojobsubmit, after the SAS Deployment Wizard has
completed with all green check marks, run the series of jobs indicated in the JOBINDEX
member of the <HLQ>.INSTALL.CNTL data set. After you submit the first job, each job will
submit the subsequent job as its last step.
7.
You may want to edit each of the JOBCARDs in the jobs listed in the JOBINDEX member of
the INSTALL.CNTL data set to provide any required site-specific accounting information,
etc., if you want to do so. You may also want to edit the user-defined fields in the JCL
statements (such as UNIT values, SMS classes, etc.), to conform to standards used at your
site.
8.
If you want to submit each job individually, you will need to edit the last step that submits
the next job through the internal reader. Just delete the IEBGENER step at the end.
Otherwise; submit only the first job.
Note: After submitting an install job, the <HLQ>.INSTALL.CNTL library cannot be open in edit
mode. This may cause some of the install jobs to fail when trying to open the CNTL library for
update.
16
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
9.
Invoke the SAS Deployment Wizard again and check Configure SAS Software as follows:
Proceed through the remainder of the configuration.
Note: You should have defined ports, user IDs, servers, etc., in your pre-installation checklist that will
provide the information needed for the configuration dialogs.
Updating an Existing Installation
If you are adding a new order to an existing installation, and the jobs listed in the JOBINDEX member
were named MAINT1 through MAINTn, then the SAS Deployment Wizard went into update mode
and updated your installed SAS products to the most current level. If your order contained new SAS
products, you will need to invoke the SAS Deployment Wizard again to install those products,
following the same instructions above starting with Step 3 under “Installation Steps.”
Updating the Logon Password
When the administrator of your system changes their logon password, you must run a rexx program
to update the password that the previous SAS installation process stored. The user ID and password
of the person who initially installed the system is located in the install.properties file. The
password is encrypted and you will not be able to view it if you open the file. Do not attempt to edit
this file on your own.
The CHGPW.REXX program is used to change the password. It can be found in USS under
[SASHOME]/SASDeploymentManager/9.4.
17
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
To run this program in USS space, type chgpw.rexx and follow the prompts. Upon invoking the
program, you will see the java version found in the system displayed on the screen along with the
following:
Enter password for YOURID:
<enter the current password for your user ID>
The following prompt will appear:
Enter password again:
<enter the same password that you provided for the previous prompt>
If the passwords to the prompts are not the same, the following text will be displayed:
Passwords don't match. Try again.
If the passwords match, the following prompt will appear:
Password successfully updated.
Step 3. Validate Installation and Post-Configuration
1.
After all installation jobs have finished, submit the VALID job in the CNTL data set from the
31-bit installation and ensure that all steps complete with a return code of 0.
2.
Consult the configuration instructions available for your operating system for productspecific post-installation steps. The configuration instructions are available from Install
Center.
Note:
Before copying an installation to another system, please contact SAS Technical Support.
Step 4. Managing Server Sessions
After the SAS Deployment Wizard has finished configuration of your software, any servers you have
configured (metadata server, object spawner, OLAP server, etc.) will be running as UNIX processes.
To stop these processes cleanly, in OMVS navigate to your configuration directory, then the Lev1
directory below that, and execute the following command:
./sas.servers stop
You can also issue this command
./sas.servers status
to see the status of all servers (and which ones are running)
or
./sas.servers start
to start all servers in the correct order. If you want to run your servers as started tasks, for example,
you would stop all the UNIX processes, and then use the JCL created for the started tasks in the data
set <high-level-qualifier>.Wn.SRVPROC.
18
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Step 5. Installing SAS 9.4 Mid-tier and Client Software from the
SAS Software Depot
Creating the SAS Software Depot for Your Mid-tier and Client Machines
To install software on your mid-tier and client machines, the SAS Software Depot must be accessible
to those machines. If your machines can share directories, a single copy of the SAS Software Depot
can be shared between machines, even on machines with different operating systems.
Create your SAS Software Depot on your mid-tier and client machines by copying your SAS Software
Depot from z/OS to the other machines using a third-party FTP utility that can transfer entire
directory trees in binary mode and preserve the case of all file names. You may also create a copy of
the SAS Software Depot by reading the DVDs and executing either setup.sh or setup.exe for
UNIX or Windows, respectively.
Installing Required Third-Party Software
•
•
•
Your checklist names any third-party software that must be installed before you install your
SAS software. If you have no third-party software listed in the checklist or the
ordersummary.html, skip to “Installing SAS Software from the SAS Software Depot” on
page 20.
The checklist indicates which third-party software must be obtained from its vendor. Obtain
that software and install it according to the vendor’s instructions.
Some of your third-party software may be provided in your software order. That software is
listed in your ordersummary.html which is available in your SAS Software Depot. Follow
the path for each third-party product listed in the Third Party section of the
ordersummary.html to locate the documentation for its installation.
Note: You should use the same plan as you used for the z/OS Server tier. Select Middle Tier or Clients as
appropriate.
19
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Installing SAS Software from the SAS Software Depot
Windows users should double-click the setup.exe file at the top level of your SAS Software Depot.
The most commonly used options are:
-record
records the values that you enter for the SAS Deployment Wizard prompts in the
file specified by the –responsefile option. This is convenient when you have
to enter many options such as port numbers and you may have to rerun the
configuration later. Note that once you have saved a response file, you can use it
in a subsequent invocation of the SAS Deployment Wizard by specifying –
responsefile without the –record option.
-responsefile
if –record is also specified, a new file is created with the responses entered in
that invocation of the SAS Deployment Wizard. If –record is not specified, an
existing response file from a previous run will be used to fill in the responses
from that previous run.
-deploy
if you specify –record you must also specify –deploy to actually deploy the
software.
-console
only used for UNIX hosts, not needed on Windows.
Example
setup.exe -record -responsefile "C:\Program Files\SAS\sdwresponse.properties"
20
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Notes:
o
By default, no deployment occurs when running in a record mode. In order to force a
deployment while recording, use –deploy. For example (enter as one line):
setup.exe -record -responsefile "C:\Program Files\SAS\
sdwresponse.properties " –deploy
o
o
o
If you specify a file location where a file already exists, the pre‐existing file will be overwritten
by the SAS Deployment Wizard.
For more information about the choices available in each dialog, click the Help button. A full
listing and description of these command-line options for setup.exe may be found in the SAS
Deployment Wizard and SAS Deployment Manager 9.4: User’s Guide at
http://support.sas.com/documentation/installcenter/94/mvs/index.html.
UNIX users should execute setup.sh from the root of your SAS Software Depot.
Step 6. Archiving Your SAS Software Depot
For future maintenance or installation of additional SAS software products, you will need your SAS
Software Depot. It can be recreated, but you may find it easier to keep a backup of your SAS Software
Depot so that only updates must be downloaded in the future. SAS Note 37119 (available at
http://support.sas.com/kb/37/119.html) contains sample jobs to back up and restore your
SAS Software Depot.
Tips and Additional Information
For the latest installation news, please visit these sites for tips and additional information that may
not be in your documentation:
General support for SAS issues (including a link to Tech Support)
http://support.sas.com
Technical Support SAS 9.4 Hot Fix downloads
http://ftp.sas.com/techsup/download/hotfix/hotfix.html
Locating the log files for SAS 9.4 installations
http://support.sas.com/kb/43/606.html
Documentation for a SAS 9.4 installation on z/OS
http://support.sas.com/documentation/installcenter/94/mvs/index.html
21
Installation Instructions for SAS® 9.4 Installation Kit for Planning DVD Installations on z/OS
Technical Support
•
If you need assistance with the software, we ask that only the SAS Installation Representative or
the SAS Support Consultant call our Technical Support Division.
For U.S. and Canadian customers, support is provided from our corporate headquarters in Cary,
North Carolina. You may call (919) 677-8008, Monday through Friday.
Customers outside of the U.S. can obtain local-language technical support through the local office
in their countries. Customers in these locations should contact their local office for specific
support hours. See http://support.sas.com/techsup/contact/index.html for contact
information for local offices.
•
22
Before calling, you may want to explore the SAS Institute Technical Support web site at
http://support.sas.com/techsup/. The Technical Support web site offers a Knowledge
Base, FAQs, Technical Support Documents and more that may answer your questions. This web
site also provides a mechanism for reporting problems.
SAS is the leader in business analytics software
and services, and the largest independent vendor
in the business intelligence market. Through
innovative solutions, SAS helps customers at
more than 65,000 sites improve performance and
deliver value by making better decisions faster.
Since 1976 SAS has been giving customers
around the world THE POWER TO KNOW®.
IIOSPP94
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Related manuals

Download PDF

advertisement