Configuration Guide For SAS 9.4 Foundation For Microsoft Windows For x64
Configuration Guide For SAS 9.4 Foundation For Microsoft Windows For x64
Configuration Guide For SAS 9.4 Foundation For Microsoft Windows For x64
Copyright Notice
The correct bibliographic citation for this manual is as follows: SAS Institute Inc. 2013. Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64, Cary, NC: SAS Institute Inc. Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64 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.
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
i 24 December 2013
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Configuring SAS/ACCESS Interface to Cloudera Impala Software ................ 13 Configuring SAS/ACCESS Interface to Greenplum ........................................ 13
Bulkload .................................................................................................................... 14
Configuring SAS/ACCESS Interface to MySQL .............................................. 18 Configuring SAS/ACCESS Interface to ODBC Software ................................. 19 Configuring SAS/ACCESS Interface to Oracle ............................................... 20 Configuring SAS/ACCESS Interface to PC Files ............................................. 21 Configuring SAS/ACCESS Interface to PostgreSQL ....................................... 21 Configuring SAS/ACCESS Interface to R/3 ................................................... 22 Configuring SAS/ACCESS Interface to SAP HANA ......................................... 22
Create a Data Source.................................................................................................. 22 Bulkload .................................................................................................................... 23
Configuring SAS/ACCESS Interface to Sybase .............................................. 23 Configuring SAS/ACCESS Interface to Sybase IQ ......................................... 23 Configuring SAS/ACCESS to Teradata ........................................................... 23
Teradata Parallel Transporter ....................................................................................... 24 TPT or Legacy Teradata Utility (FastExport and Multiload) ............................................... 25 Legacy Teradata Utility Configuration ............................................................................ 25 FastExporting ............................................................................................................................................25 MultiLoad ..................................................................................................................................................25
Configuring SAS/ACCESS Interface to Vertica .............................................. 26 Configuring and Administering SAS In-Database Products ........................... 26
ii
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Chapter 12: Windows Performance Monitor and Event Log Support ............... 42
iii
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
iv
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
1.
4.
This completes the setup for the System Repository Manager. You can create additional repository managers (a user repository manager, for example) by repeating the steps above and by using a different path.
Page 1
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
4.
In the Description field, you can type any character string (for example, SASHELP Repository). Select OK to close the Register Repository (New) window. Select Close to exit the Repository Registration window. Repositories cannot span multiple directories because the path cannot contain concatenated directories. If you have existing metabases in concatenated directories, you should copy the metabases to a single path that will be referenced as a repository.
Note:
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Introduction
The SAS Deployment Wizard allows users to decide which set of languages to install for the SAS products that are listed. However, three images are automatically deployed for SAS on all Windows and UNIX machines: English English with DBCS and Unicode Support
When SAS 9.4 Foundation is installed, the installer creates a configuration file called !SASROOT\sasv9.cfg. When you open the file, you will find that the only option specified is the CONFIG option, which points to another configuration file. That configuration file contains the options used to establish your SAS session, including the LOCALE system option that establishes the NLS environment for SAS. Beginning with 9.4, the ENCODING system option is set explicitly in the configuration file for singlebyte languages and Unicode support. It is not set for double-byte languages. Occasionally, other NLS options will also be included in the configuration file. At least three NLS configuration files are created during the installation process: one in !SASROOT\nls\en for the default single-byte (SBCS) image that uses English messages one in !SASROOT\nls\1d for the default double-byte (DBCS) image that uses English messages one in !SASROOT\nls\u8 for the SAS Unicode server
If you have chosen to install any of the localized SAS images, you will find a folder under !SASROOT\nls for each. The folders are named with a SAS specific 2-character language code. Each contains its own configuration file with a LOCALE option value set to match the localization. As mentioned above, the configuration file also contains the ENCODING for single-byte languages. For example, the configuration file for French (fr) will have a LOCALE value with a French language code.
Page 3
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
For example, if the installer selects the Polish localization and the Polish locale, the LOCALE system option is set to pl_PL and the ENCODING option is set to wlatin2 in both the Polish configuration file and the English configuration file. The Polish configuration file is used to initialize SASFoundation, by default.
Specifying the Font Catalog in the Configuration File for Traditional Chinese Fonts
If you are not running a Traditional Chinese localization but you want to use the Traditional Chinese fonts, you need to modify the configuration file to set GFONTx to -set gfontx !SASROOT/nls/zt/font-name In this statement, x represents a value from 0-9. font-name represents the name of the font catalog you want to use.
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Specifying the Font Catalog in a SAS Session for Traditional Chinese Fonts
To specify the font catalog in a SAS session, submit the following libref statement: -libname gfontx !sasroot\nls\langcode\font-name In this statement, x represents a value from 0-9. font-name represents the name of the font catalog you want to use.
Chinese Localizations
The installer has the option to install localizations for both Simplified Chinese and Traditional Chinese. Several Chinese-based locales are supported by SAS. In some cases, the localization selected for the locale may not be intuitive. The following table shows which language SAS uses when you select one of the five Chinese locales. Note that the default language may be English.
Locale
Chinese (China) [zh_CN] Chinese (Hong Kong) [zh_HK] Chinese (Macau) [zh_MO] Chinese (Singapore) [zh_SG] Chinese (Taiwan) [zh_TW]
Language
Simplified Chinese Traditional Chinese English English Traditional Chinese
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Global Restrictions
Create the file !SASROOT\rstropts\rsasv9.cfg and add options to this file in the normal config file format.
User Restrictions
Create a file of the following format: !SASROOT\rstropts\users\<user ID>_rsasv9.cfg and add options to this file in the normal config file format. Example: For user smith, the file name is smith_rsasv9.cfg.
Additional information
To determine which options can be restricted, follow this example: Proc Options LISTRESTRICT; run; To verify that an option has been set correctly, follow this example: 1. 2. Assume the option -EMAILSYS=SMTP was specified in one of the restricted configuration files. Submit the following code: proc options restrict; run; The SAS log should then show a message similar to Option Value Information For SAS Option EMAILSYS Option Value: SMTP Option Scope: SAS Session How option value set: Site Administrator Restricted The following describes the process when a user attempts to change the option value. 1. 2. Assume the option -NOTHREADS was specified in one of the restricted configuration files. Submit the following code: options THREADS;
Page 6
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
The SAS log should then show a message similar to the following: options THREADS; ----36 WARNING 36-12: SAS option THREADS is restricted by your Site Administrator and cannot be updated.
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
These SAS components require that Hadoop JAR files be accessible to the SAS machines in your organization which will access Hadoop. Create a directory that is accessible to all SAS users. In the directory place Hive, Hadoop HDFS, and Hadoop authorization JAR files. Additional JAR files will be needed due to JAR file interdependencies. Here are the required JAR files for Cloudera CDH4.0.1; the set is different for other Hadoop editions: guava hadoop-auth hadoop-common hadoop-core hadoop-hdfs hive-exec hive-jdbc hive-metastore hive-service libfb303 pig protobuf-java
You may need assistance from your Hadoop administrator to locate the appropriate JAR files. Except for libfb303, JAR files include version numbers. For example, the pig JAR file might be pig-0.8.0, pig-0.9.1, etc. A superset of the JAR files that SAS requires is fine, but do not include Thrift JAR files such as libthrift in the JAR directory.
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
A SAS_HADOOP_JAR_PATH directory must not have multiple versions of a Hadoop JAR file; this can cause unpredictable behavior when SAS runs. Note: For SAS/ACCESS Interface to Hadoop to operate properly, your SAS_HADOOP_JAR_PATH directory must not contain any Thrift jars such as libthrift*.jar.
where C:\third_party\Hadoop\jars is as described above, containing hive-*.jars, etc., and where C:\mapr\hadoop\hadoop-0.20.2\lib is the JAR directory laid down by the MapR client installation software. In addition, set the SAS java.library.path property to the directory that contains the 64-bit MapRClient sharable library. For example on Windows if the 64-bit MapRClient sharable library location is C:\mapr\lib, then add this line to the JREOPTIONS in the SAS configuration file: -Djava.library.path=C:\mapr\lib Note: The MapR 64-bit library must be selected. Use of the MapR 32-bit library will produce undesirable results.
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
10
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
the original folder. For information about the options available when reassigning the work library, please refer to SAS documentation. To run the macros, submit the following commands in the Program Editor from SAS: ods html select none; ods listing; %let indconn = server=myserver user=myuserid password=XXXX database=SYSLIB; %udftdstt; %udftdem; %udftdets; proc tssql nolibs noerrorstop noprompt="(&credentials.)"; CREATE GLOP SET syslib.sas_vars; call DBCExtension.glop_add('syslib.sas_vars', 'SE', NULL, 'dmdb', 'N', 0, 'Y', 'M', 'E', 0, 256000, 1, '00'XB); CREATE GLOP SET syslib.sas_dmvars; call DBCExtension.glop_add('syslib.sas_dmvars', 'SE', NULL, 'dmine', 'N', 0, 'Y', 'M', 'E', 0, 256000, 1, '00'XB); quit; The first two statements in the program allow the registration macros to write and read temporary files without these files being redirected to the default HTML ODS destination of the SAS dms mode. The INDCONN macro variable provides credentials to connect to the Teradata machine. You must specify the server, user, password, and database to access the machine on which you have installed the Teradata data warehouse: myserver is the server on which the Teradata warehouse resides. myuserid is a valid user ID for that server that is granted the permissions described above. XXXX is the password for the user ID you are using. Because the SAS Analytics Accelerator UDFs must be registered in the SYSLIB database, database must be SYSLIB.
The statements executed by PROC TSSQL will create the GLOP sets and add the GLOPs used by SAS analytical procedures while executing the UDFs in Teradata database.
11
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
12
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
10. Click Test. After a message appears that indicates that the test was successful, click OK. 11. Click Save.
Page 13
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
1.
Use Windows Explorer to navigate to the !SASROOT\access\sasmisc directory where the <platform>gplm60.zip is located and where <platform> is specific to your operating system. This zip file contains a directory, gpl6.0 which includes the driver and the installation instructions for installing it. Use an unzip utility to unzip the contents to C:\. This should result in a directory C:\gpl6.0. Navigate to C:\gpl6.0 and follow the instructions in the Readme.txt file.
2. 3.
After you install the software, configure a Data Source Name (DSN) to access a Greenplum database. You can use the ODBC administrator to add it. If you have more than one user who may use the same workstation to access the Greenplum database, you can create it as a system DSN instead of a user DSN. Complete the following steps to create a data source for Greenplum database access: 1. 2. 3. 4. 5. 6. 7. 8. 9. Run Data Sources (ODBC) from Administrator Tools of the Control Panel. Click the User DSN or System DSN tab, depending on the number of users, as stated above. Click the Add button and choose SAS ACCESS to Greenplum from the pop-up window. Enter any name in the Data Source Name field. This will be the name that you will use inside of SAS when referencing this database connection. Enter a Description for this connection. Enter the host name as the name of the server where Greenplum resides (this may be an IP address). Enter the Port Number that the host is listening on for Greenplum connections. The default is 5432. Enter the Database Name of the database on the Greenplum server. Click Test Connection and enter your userid and password. A test connection will be initiated.
10. Click OK to close the ODBC Administrator and to save your new DSN entry.
Bulkload
SAS/ACCESS can interface with the Greenplum Client Loader interface for loading large volumes of data. To perform bulkloading, the Greenplum Client Loader Package must be present on the system where you installed SAS. SAS recommends using the gpfdist protocol for bulkloading. For this protocol you must set the GPLOAD_HOME environment variable to point to the location where the gpfdist utility allocates the files to be loaded onto the Greenplum tables. Additional information about how to use the bulkloading feature can be found in the SAS/ACCESS 9.4 for Relational Databases: Reference documentation.
14
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
15
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
failure is to disable the sticky bit on HDFS /tmp. If the sticky bit cannot be disabled, SAS data can be written to an alternate location specified by the HDFS_TEMPDIR= option. In this example of a Hadoop file system command, the sticky bit is set for HDFS /tmp. It is denoted by the t attribute. $ hadoop fs -ls / hdfs supergroup 0 2013-01-21 13:25 /tmp 0 2013-01-21 11:46 /user drwxrwxrwt - hdfs drwxr-xr-x - hdfs
Kerberos Security
Most SAS/ACCESS platforms can be configured for Kerberos ticket cache based login authentication using MIT Kerberos 5 with Cloudera CDH4.1.2 and higher running HiveServer2. However, SAS/ACCESS on the AIX platform requires Cloudera CDH4.2 and higher running HiveServer2. For SAS/ACCESS on both AIX and HP-UX, add this line to the JREOPTIONS in the SAS configuration file: -Djavax.security.auth.useSubjectCredsOnly=false
16
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Sample PROC SQL connection: proc sql; connect to hadoop (server=hadoop01 user=hadoop_usr password=hadoop_usr_pwd); Sample libref connection to HiveServer2: libname hdplib hadoop server=hadoop_h2 user=hadoop_usr password=hadoop_usr_pwd subprotocol=hive2; NOTE: Libref HDPLIB was successfully assigned as follows: Engine: HADOOP Physical Name: jdbc:hive2://hadoop_h2:10000/default
17
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
from Hive using the Hive CLI. For more information, perform a web search for Hive CLI and locate the appropriate Apache documentation. 1. Assume there are HDFS files weblog1.txt and weblog2.txt with data lines containing in order, a date field, a text integer field, and a string field. The fields are comma-delimited and lines \n terminated. $ hadoop fs -ls /user/hadoop/web_data Found 2 items -rw-r--r-- 3 hadoop [owner] [size/date] /user/hadoop/web_data/weblog1.txt -rw-r--r-- 3 hadoop [owner] [size/date] /user/hadoop/web_data/weblog2.txt Begin by terminating the Hive service if it is running. Next, at a Linux prompt, bring up the Hive CLI: $ hive 2. At the Hive command prompt, make the weblogs visible to Hive: hive> CREATE EXTERNAL TABLE weblogs (extract_date STRING, extract_type INT, webdata STRING) ROW FORMAT DELIMITED FIELDS TERMINATED BY ',' STORED AS TEXTFILE LOCATION '/user/hadoop/web_data'; 3. At the Hive command prompt, test that weblog1.txt is now accessible to Hive: hive> SELECT * FROM weblogs LIMIT 1; 4. If the SELECT works, quit the Hive CLI and start the Hive Service on default port 10000. For example, if you start the Hive service on node hadoop_cluster, a test access from SAS would be as follows: libname hdplib hadoop server=hadoop_cluster user=hadoop_usr password=hadoop_usr_pwd; data work.weblogs; set hdplib.weblogs(obs=1); put _all_; run; This is a complete but intentionally simple scenario intended for new Hive users. It is likely not representative of a mature Hive environment since the default Hive schema is used implicitly and the Hive default Derby metadata store may be in use. Consult Hadoop and Hive documentation to begin to explore Hive in detail. SAS/ACCESS user documentation provides more information on how SAS/ACCESS interacts with Hive.
18
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
update that information, use the SAS Deployment Manager. The procedure for updating the version is described in the Configure SAS/ACCESS Interface to MySQL section of SAS Deployment Wizard and SAS Deployment Manager 9.4: Users Guide, located at http://support.sas.com/documentation/installcenter/en/ikdeploywizug/66034/PDF/ default/user.pdf Before you can use SAS/ACCESS Interface to MySQL software, the following products are required: Base SAS software SAS/ACCESS Interface to MySQL software
Before you use SAS/ACCESS interface to MySQL software, verify that the MySQL client library (libmysql.dll) has been appended to Path, a system variable. The MySQL client library is often located in C:\mysql\bin or C:\program files\mysql\mysql server 5.1\bin. To locate the Path system variable, follow the instructions for your operating system. For Windows NT, right-click My Computer and choose Properties. Select the Environment tab and you will see Path in your list of system variables. For Windows 2000, right-click My Computer and choose Properties. Select the Advanced tab and select the Environment Variables button. You will see Path in your list of System Variables. For Windows XP, click Start then select Control Panel. Double-click System. Select the Advanced tab and select the Environment Variables button. You will see Path in your list of System Variables.
For more information about SAS/ACCESS Interface to MySQL, refer to the MySQL chapter in SAS/ACCESS 9.4 for Relational Databases: Reference.
The ODBC solution allows different technologies to be used by defining a standard interface. SAS/ACCESS Interface to ODBC software with ODBC drivers provides you with access to different databases. An ODBC driver processes ODBC function calls from--and returns results to-SAS/ACCESS software. You can get drivers from Microsoft, your database vendor, or other third party software vendors. To run SAS/ACCESS software on 32-bit Windows, you need 32-bit drivers. The application calls the 32-bit Driver Manager (ODBC32.DLL), which in turn calls the 32-bit drivers. The following figure illustrates the architecture:
19
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
SAS/ACCESS
32-Bit Drive r
32-Bit Drive r
32-Bit Drive r
Data Source
Data Source
Data Source
The ODBC Driver Manager and Administrator are Microsoft products that are included with all ODBC drivers. When you install an ODBC driver, the ODBC Driver Manager and Administrator are also installed. The ODBC Administrator should appear as an icon in the control panel. However, it can appear as an icon in the Start menu instead. After you install the ODBC driver, you can use the ODBC Administrator to define and manage the data sources. A data source associates a particular ODBC driver with the data you want to access through that driver. It can consist of information about the data you want to access and its associated operating system, DBMS, and network platform (if any) used to access the DBMS. For information about how to configure your data sources, refer to the documentation provided with your ODBC drivers. For more information about SAS/ACCESS to ODBC, refer to the ODBC chapter in SAS/ACCESS 9.4 for Relational Databases: Reference. For more information about ODBC, refer to Microsoft ODBC 3.0 Programmers Reference and SDK Guide.
After the Oracle client/server installation process is complete, ensure that the path to the Oracle client libraries is appended to the PATH system variable. The Oracle libraries are usually located in the directory ORACLE_HOME/bin.
20
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
If the PATH variable does not have ORACLE_HOME/bin, you will see the following error: ERROR: The SAS/ACCESS Interface to ORACLE cannot be loaded. ERROR: Image SASORA found but not loadable. For more information about SAS/ACCESS Interface to Oracle, refer to the Oracle chapter in SAS/ACCESS 9.4 for Relational Databases: Reference.
Both server mode and service mode store the server configuration settings in the Windows registry. If the settings are changed in server mode, the server running service mode will be affected after it is restarted. The default configuration should be sufficient for most installations. To change the configuration options, run the SAS PC Files Server in server mode. 1. 2. 3. 4. 5. Go to Windows Services (Start > Run and enter services.msc), locate and Stop the SAS PC Files Server Service. Start the PC Files Server in Server mode by clicking Start > SAS > PC Files Server. Change the options that you want to change on the PC Files Server application console. Click the Shutdown button to stop the PC Files Server in Server mode. Go to Windows Services again, locate and start the SAS PC Files Server Service.
21
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
If the DSN (data source) is created in ODBC Data Source Administrator, the DSN is used as in the following example: libname db postgres dsn=<dsn name> user=xxx password=xxxxxx; If no DSN is created, connect to the database directly as in the following example: libname db postgres server="xxx " database=xxxx; port=5433 user=xxx password=xxxx
22
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
7. 8. 9.
Click Connect. Enter the user name in the User field. Enter the password in the Password field.
10. Click OK. After a message appears that indicates that the test was successful, click OK. 11. Click OK.
Bulkload
The bulkload for SAS/ACCESS Interface to SAP HANA uses SFTP to transfer files to the SAP HANA server. If you want to use bulkload, you need to configure SFTP for accessing the SAP HANA server from the SAS server.
The process utilizes two Sybase facilities, defncopy and isql. To complete your installation, add -set sassyb sywx6150 to your sasv9.cfg file.
23
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
documented in the SAS/ACCESS to Teradata white paper, available at http://support.sas.com/resources/papers/teradata.pdf. If BTEQ fails to connect to the Teradata server, you may need an entry in the hosts file on your PC to provide the network address of the Teradata server. Typically, this means adding a dbccop1 entry to your hosts file. For more details about the entry, see your Teradata Client for Windows Installation Guide.
The following two requirements must be met: 1. The TPT API must be installed on the system where SAS Access is installed. The Teradata installation process installs both 32-bit and 64-bit libraries on x64 platforms, and the 64-bit libraries need to be referenced first in the PATH. Sometimes the TTU 13.10 installation process puts the 32-bit libraries first in the PATH, so you may need to check this, and manually adjust it. From our experience, TTU 14 does not have this issue. The 64-bit libraries must be listed before the 32-bit in your PATH! A normal Teradata installation of TPT will create the environment variable TWB_ROOT. Example: TWB_ROOT = C:\Program Files\Teradata\Client\13.10\Teradata Parallel Transporter. You can then reference this TWB_HOME env variable at the beginning of your PATH env variable, as: %TWB_ROOT\bin64\ %TWB_ROOT\msg64\ This sets the 64 bit libraries and message files first in your PATH env variable. 2. The system variable TKPATHX8664 must be modified. If the variable does not exist already, it must be added. To modify the variable, append the directory where sasiotpt.dll is located. Usually sasiotpt.dll is located in your SAS product tree. Example: C:\Program Files\SASHome\SASFoundation\9.4\access\sasexe (or the directory path where sasiotpt.dll resides) To locate and edit the TKPATHX8664 system variable, follow the instructions for your Windows operating system. To find out if TPT is installed correctly, perform a quick test within SAS. Issue a Teradata libref, and then invoke fastload with a single row: /* quick test to see if TPT is installed correctly */ /* TPT = YES b default */
24
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Libname x teradata server=mydbc user=dtest pw=xxxxx ; Data x.new (fastload=yes) ; x=99; run; NOTE: The data set X.new has 1 observations and 1 variables NOTE: Teradata connection: TPT Fastload has inserted 1 row(s). NOTE: Data statement used(Total process time): real time cpu time 4.39 0.29
The FastExport Utility is not required; SAS/ACCESS reads large tables quite efficiently without it. For further information, see the DBSLICEPARM option in your SAS/ACCESS to Teradata documentation. Please contact Teradata if you want to obtain the Teradata FastExport Utility. For more information about SAS/ACCESS Interface to Teradata software, please see the Teradata chapter in SAS/ACCESS 9.4 for Relational Databases: Reference, and the SAS/ACCESS to Teradata white paper, which can be found at http://support.sm/resources/papers/teradata.pdf.
MultiLoad
SAS/ACCESS can load large volumes of data to non-empty tables using MultiLoad. To perform MultiLoading, the Teradata MultiLoad Utility must be present on the system where you install SAS. You must also modify Path, a system variable.
25
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Append two directory paths to the end of Path: 1. 2. The directory where mload.exe (the MultiLoad Utility) is located. Often this is C:\Program Files\Teradata\Client\13.0\bin. The directory where sasmlam.dll and sasmlne.dll are located (sasmlam.dll and sasmlne.dll are usually located in your SAS product tree, in the !sasroot\access\sasexe directory.)
The MultiLoad Utility is not required; SAS/ACCESS provides other options for loading tables. For further information, see the MULTISTMT option in your SAS/ACCESS to Teradata documentation. Please contact Teradata if you want to obtain the Teradata MultiLoad Utility.
When you have completed the instructions described there, your software will be ready for use. The SAS In-Database Products: Administrator's Guide is located at http://support.sas.com/documentation/onlinedoc/indbtech/index.html.
26
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
You can run SAS/ASSIST software in two different styles - workplace or block menu. The block menu can be new style or old style. You can control this using the profile options below. Run workplace: SAS/Assist style: Run block menu new style: SAS/Assist style: Block Menu Workplace
27
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Save selections on end: Menu Style: Run old style: SAS/Assist style: Save selections on end: Menu Style:
By setting the default values in the master profile, you can control if users should use the new or old style of SAS/ASSIST software. In addition, there are many other profile options. For more information on these options, refer to SAS/ASSIST Administrators Guide. 4. Create group profiles. From the master profile, it is possible to create group profiles to allow groups of users to have different setups. The master profile controls group profiles and user profiles when a user is not a member of any group. All users are indirectly controlled by the master profile when option values are set to a restricted (R) status. From Setup > Master/Group..., select Tools > Create Group Profile. To add users to a group profile, select Tools > Update User Group. By default, the user ID is found in the macro variable &SYSJOBID. This value is set in the option user ID in the master profile (option type System Administration). Change the value if your site uses another variable to keep the user ID. If the value name starts with &, it is a macro variable; otherwise, it is an environment variable, which is set before the start of SAS 9.4.
28
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
TCP/IP
TCP/IP is the access method supported for SAS 9.4 on Windows for x64. SAS/CONNECT software supports Microsofts TCP/IP System Driver, which is provided with Windows.
By default, when the SAS Windows Spawner is installed as a Windows service, it runs under the LocalSystem user ID that has all required User Rights for running the SAS Windows Spawner. If you do not install the SAS Windows Spawner as a Windows service (run it from your system prompt), the Windows user ID that is used to start the SAS Windows Spawner must be the local Administrator of the machine and must have the following User Rights:
Page 29
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
act as part of the operating system bypass traverse checking (the default is everyone) increase quotas replace a process level token log on locally (the default is everyone)
The Windows user ID specified at sign on needs only the User Right log on as a batch job.
30
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Overview
All SAS/IntrNet installations are made up of two components: 1. 2. The SAS/IntrNet server (also referred to as the Application Server). This is where SAS Foundation is installed. CGI Tools (also referred to as the Broker). This is where the broker.cfg file and its supporting files are installed.
When you install SAS/IntrNet, choose between these two installation configurations: Type A - The SAS/IntrNet server and CGI Tools components are both installed on the same system machine. The web server must be installed before starting the SAS installation. Type B -The SAS/IntrNet server component is installed on one system machine and the CGI Tools component is installed on a different system machine. The web server must be installed on the CGI Tools system machine prior to installing CGI Tools.
Type A and Type B require different installation steps: Type A Installation Steps Confirm that the web server software (IIS, Apache etc.) is on the same system machine as your SAS/IntrNet software. Install your SAS products. Check CGI Tools for the web Server in the Select Products to Install menu. Type B Installation Steps Confirm that the web server software (IIS, Apache, etc.) is on the system machine where you will install CGI Tools. On your application server system machine, start your SAS installation. Uncheck CGI Tools for the web Server in the Select Products to Install menu. On your web server system machine, start your SAS installation. Uncheck all products except CGI Tools for the web Server in the Select Products to Install menu. You can optionally check the IntrNet
31
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Configure a Socket Service Start the Socket Service Test the Socket Service Refer to your web servers documentation for its installation procedures.
If you are performing a Type B installation (as described in the Overview above), do both of the following: 1. 2. Install the SAS software on the SAS System side, unchecking CGI Tools for the Web Server in the Select Products to Install dialog. Start the SAS software install on the web server and check CGI Tools for the Web Server in the Select Products to Install dialog. SAS/IntrNet Monitor and SAS/CONNECT Driver for Java are optional selections. Uncheck everything else.
32
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
The following are examples of common entries for popular web servers. Customize your entries according to your own web server environment. These fields will tell SAS where your web server software is located. Physical path corresponding to http://<your_server>/sasweb: IIS: C:\Inetpub\wwwroot\sasweb
Apache (Windows): C:\program files\Apache Software Foundation\Apache2.2\ htdocs\sasweb Apache (UNIX): /usr/local/apache2/htdocs/sasweb
Apache (Windows): C:\program files\Apache Software Foundation\Apache2.2 \cgi-bin Apache (UNIX): /usr/local/apache2/cgi-bin
URL for CGI Executables: IIS: http://<web_servername>/scripts Example: http://abcserver.comp.com/scripts Apache (Windows): http:// <web_servername>/cgi-bin Example: http://abcserver.comp.com/cgi-bin Apache (UNIX): http://<web_servername>/cgi-bin Example: http://abcserver.comp.com/cgi-bin
33
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Note that your entries for this dialog are added to the broker.cfg file. The broker.cfg file is a text file that can be edited after the installation is complete. Name of the Service Administrator: (optional) Enter the name of the administrator (for example, John Doe). Email Address of the Service Administrator: (optional) Enter the e-mail address of the administrator (for example, NetAdmin@comp.com). DNS Name or IP Address of Application Server Host: Enter the DNS name or IP address of the application server host where SAS Foundation is located. TCP Port Number for Application Server: The customary default port number is 5001, but you can use any valid available port on your system between 256 65535.
Installing CGI Tools and SAS Foundation on Machines with Different Operating Systems
Your SAS Foundation systems operating system might be different than your CGI Tools systems operating system. For example, your SAS Foundation might be installed on a Windows system and your CGI Tools might be installed on a UNIX system. The CGI Tools installation from the SAS Deployment Wizard will detect the destination operating system and install the appropriate operating system-specific software. There are two methods to make the SAS Software Depot available to the installer on the destination CGI Tools system. Choose the method that is appropriate for your sites available facilities:
34
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Launch the set-up from a SAS Software Depot that resides on a remote system. You might need to use a cross-platform file access method such as NFS or SAMBA to connect the two systems. Create media from an existing depot using the SAS Deployment Wizard and use that media on the host machine. This process is described more thoroughly in the SAS Deployment Wizard and SAS Deployment Manager 9.4: Users Guide, available from Install Center, http://support.sas.com/documentation/installcenter/en/ikdeploywizug/66034 /PDF/default/user.pdf SAS/IntrNet operation requires TCP/IP connectivity between the SAS Foundation system and the CGI Tools system, regardless of the operating systems on which these components are installed.
Note:
Apache: http://<web_servername>/cgi-bin/broker.exe Other hosts: http://your_webserver/cgi-bin/broker Replace your_webserver with the name of the web server. The URL path might also need to be changed if you installed CGI Tools to a different directory. You should see a web page similar to the following: SAS/IntrNet Application Dispatcher Application Broker Version 9.4 (Build 1502) Application Dispatcher Administration SAS/IntrNet Samples SAS/IntrNet Documentation - requires Internet access If you do not receive this page, you must debug your web server installation before continuing. Verify that your web server is enabled for CGI execution in the directory where you installed the Application Broker (broker.exe and broker.cfg files). This directory was determined by what was entered for Physical path for SAS/IntrNet CGI Executables during the CGI Tools installation above.
35
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
When the Choose Language window comes up, select the desired language and click OK. The SAS Deployment Manager (SDM) will display the Select SAS Deployment Manager Task window. Under SAS/IntrNet Service Tasks select Create Socket Service and click Next to continue. The Specify Service Name window displays. The default value for the Service Name field is default. Create this as your first service because this is what is used when you run the samples. Click Next to continue. The Specify Service Directory window displays. The SDM selects a default service root directory based on the location that you chose for user files when you installed SAS Software. This default location is recommended for most users, although you can use the Browse button to select a different directory. Click Next to continue. The Specify Service Ports window displays. Type the TCP/IP port number that you reserved for the default Application Dispatcher service. Click Next to continue. The Specify Administrator Password window displays. A password is not necessary for the default service. You can add an administrator password later if you use this service for production applications. Click Next to continue. The Summary window displays. It indicates Stage 1: Create Socket Service. If the information you have entered is correct, click Start. If you want to go back and change any of the values you entered, you can step backward through the windows by clicking the Back button.
4.
5.
6. 7.
8.
9.
10. The Deployment Complete screen displays when the task is finished. If the service is created correctly, a green checkmark appears next to the 1. SAS/IntrNet under Stage 1: Create Socket Service . If there was a problem, a yellow exclamation or red X appears and you should check the log for a description of the problem. The logs reside in <SASHOME>\SASFoundation\9.4\intrnet\sasmisc.
11. From the Start menu, select Programs SAS (or other program group where SAS is installed) IntrNet default Service Start Interactively. Your default Application Server should now be running.
36
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Apache: http://<web_servername>/cgi-bin/broker.exe Other hosts: http://your_webserver/cgi-bin/broker Replace your_webserver with the name of the web server. The URL path might also need to be changed if you installed the Application Broker to a different directory. You should see the following web page: SAS/IntrNet Application Dispatcher Application Broker Version 9.4 (Build 1502) Application Dispatcher Administration SAS/IntrNet Samples SAS/IntrNet Documentation - requires Internet access 2. 3. Click on the Application Dispatcher Administration link to see if the Application Broker can read the broker.cfg file. The Application Dispatcher Services web page should open. Verify connectivity between the Application Server and the web server. Click on the Application Dispatcher Administration link and then click on the ping link under SocketService default heading. If the ping is successful, you should see: Ping. The Application Server <hostname>:<port_number> is functioning properly. 4. To complete installation testing, type this URL in your browser address line: Windows: IIS: http://your_webserver/scripts/broker.exe?_service=default&_progra m=sample.webhello.sas Apache: http://your_webserver/cgibin/broker.exe?_service=default&_program=sample.webhello.sas Other hosts: http://your_webserver/cgi-bin/broker?_service=default&_program= sample.webhello.sas
37
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
You should see the string Hello World! in large bold type in your browser. If you do not, add the debug option to create a log: Windows: IIS: http://your_webserver/scripts/broker.exe?_service=default&_progra m=sample.webhello.sas&_debug=131 Apache:
http://your_webserver/cgibin/broker.exe?_service=default&_program=sample.webhello.sas&_debug=131
Other hosts:
http://yourwebserver/cgibin/broker?_service=default&_program=sample.webhello.sas&_debug=131
Save the log screen on the browser for SAS Technical Support.
38
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
If the SAS/SECURE Java Component was part of your software order, the SAS/SECURE components needed by Java clients will be installed automatically when you run the SAS Deployment Wizard.
FIPS-Compliant Encryption
FIPS stands for Federal Information Processing Systems, and its 140-2 standard defines the security requirements for cryptographic modules. The 140-2 standard is detailed in the following document: http://csrc.nist.gov/publications/fips/fips140-2/fips1402.pdf. The ENCRYPTFIPS option is an option added to SAS/CONNECT spawners, IOM spawners, and Base SAS so that the communication encryption will be compliant with FIPS 140-2. The ENCRYPTFIPS option is required for FIPS-compliant encryption. If you use ENCRYPTFIPS, the NETENCRALG option must be set to AES or SSL. In Windows 7 and later versions of Windows, you need to enable the System cryptography: Use FIPS-compliant algorithms for encryption, hashing, and signing setting under your Local Security Policy or as part of Group Policy. This setting informs applications that they should use only those cryptographic algorithms that are FIPS 140-2 compliant and in compliance with FIP- approved modes of operation. For more information about FIPS and encryption in general, refer to Encryption in SAS 9.4, available from SAS Knowledge Base Product Documentation: http://support.sas.com/documentation/cdl/en/secref/64866/HTML/default/view er.htm#titlepage.htm
Page 39
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
To use the TCP/IP access method, you must have the supporting software on each workstation on which a SAS/SHARE server or user will execute.
The server name must be 1-8 characters in length. The first character must be a letter or underscore. The remaining seven characters can include letters, digits, underscores, the dollar ($) sign, or the at (@) sign. The port number must be above 1024, as any port number equal to or less than 1024 is reserved. The protocol must always be TCP. An entry for a server with the name MKTSERV might look like this: mktserv 5000/tcp # SAS server for Marketing and Sales
The server name is specified with the SERVER= option in the PROC SERVER statement in the servers SAS session and in the PROC OPERATE and LIBNAME statements in user and server
Page 40
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
administrator programs. If the server name is not defined, you must s pecify __<port#>, two consecutive underscores followed by the port number (e.g., server=__5012). For more information about the options used with PROC SERVER and PROC OPERATE procedures, please refer to the SAS/SHARE 9.4 User's Guide.
Client-Side Components
SAS/SHARE software includes client components that are used outside of your SAS installation. These components are available from the SAS 9.4 Software Download site and are described below:
NLS Information
Sites that develop or support international applications that use SAS/SHARE software should refer to the chapter Post-Installation Instructions for National Language Support (NLS) on page 3.
41
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
Page 42
Configuration Guide for SAS 9.4 Foundation for Microsoft Windows for x64
43
SAS is the leader in business analytics software and services, and the largest independent vendor in the business intelligence market. Through innovative solutions delivered within an integrated framework, SAS helps customers at more than 50,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 .