Sybase Adaptive Server Enterprise Installation Guide. Linux/Intel

Transcription

1 Sybase Adaptive Server Enterprise Installation Guide Linux/Intel Adaptive Server Enterprise Version Document ID: Last Revised: June 30, 1999

2

3 Principal author: Emeryville Technical Publications Document ID: This publication pertains to Adaptive Server Enterprise Version of the Sybase database management software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. Document Orders To order additional documents, U.S. and Canadian customers should call Customer Fulfillment at (800) , fax (617) Customers in other countries with a U.S. license agreement may contact Customer Fulfillment via the above fax number. All other international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only at regularly scheduled software release dates. Copyright by Sybase, Inc. All rights reserved. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Sybase, Inc. Sybase Trademarks Sybase, the SYBASE logo, Adaptive Server, APT-FORMS, Certified SYBASE Professional, the Certified SYBASE Professional logo, Column Design, ComponentPack, Data Workbench, First Impression, InfoMaker, ObjectCycle, PowerBuilder, PowerDesigner, Powersoft, Replication Server, S-Designor, SQL Advantage, SQL Debug, SQL SMART, Transact-SQL, Visual Components, VisualWriter, and VQL are registered trademarks of Sybase, Inc. Adaptable Windowing Environment, Adaptive Component Architecture, Adaptive Server Enterprise Monitor, Adaptive Warehouse, ADA Workbench, AnswerBase, Application Manager, AppModeler, APT-Build, APT-Edit, APT- Execute, APT-Library, APT-Translator, APT Workbench, Backup Server, BayCam, Bit-Wise, ClearConnect, Client-Library, Client Services, CodeBank, Connection Manager, DataArchitect, Database Analyzer, DataExpress, Data Pipeline, DataServer, DataWindow, DB-Library, dbqueue, Developers Workbench, DirectConnect, Distribution Agent, Distribution Director, Embedded SQL, EMS, Enterprise Application Server, Enterprise Application Studio, Enterprise Client/Server, EnterpriseConnect, Enterprise Data Studio, Enterprise Manager, Enterprise SQL Server Manager, Enterprise Work Architecture, Enterprise Work Designer, Enterprise Work Modeler, EWA, Formula One, Gateway Manager, GeoPoint, ImpactNow, InformationConnect, InstaHelp, InternetBuilder, iscript, Jaguar CTS, jconnect for JDBC, KnowledgeBase, Logical Memory Manager, MainframeConnect, Maintenance Express, MAP, MDI Access Server, MDI

4 Database Gateway, media.splash, MetaBridge, MetaWorks, MethodSet, MySupport, Net-Gateway, NetImpact, Net-Library, Next Generation Learning, ObjectConnect, OmniConnect, OmniSQL Access Module, OmniSQL Toolkit, Open Client, Open ClientConnect, Open Client/Server, Open Client/Server Interfaces, Open Gateway, Open Server, Open ServerConnect, Open Solutions, Optima++, PB-Gen, PC APT-Execute, PC DB-Net, PC Net Library, Power++, Power AMC, PowerBuilt, PowerBuilt with PowerBuilder, PowerDynamo, PowerJ, PowerScript, PowerSite, PowerSocket, Powersoft Portfolio, PowerStudio, Power Through Knowledge, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst, Replication Agent, Replication Driver, Replication Server Manager, Report- Execute, Report Workbench, Resource Manager, RW-DisplayLib, RW-Library, SAFE, SDF, Secure SQL Server, Secure SQL Toolset, Security Guardian, SKILS, smart.partners, smart.parts, smart.script, SQL Code Checker, SQL Edit, SQL Edit/TPU, SQL Modeler, SQL Remote, SQL Server, SQL Server/CFT, SQL Server/DBM, SQL Server Manager, SQL Server SNMP SubAgent, SQL Station, SQL Toolset, Sybase Central, Sybase Client/Server Interfaces, Sybase Development Framework, Sybase Financial Server, Sybase Gateways, Sybase Learning Connection, Sybase MPP, Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase Synergy Program, Sybase Virtual Server Architecture, Sybase User Workbench, SybaseWare, SyberAssist, SyBooks, System 10, System 11, the System XI logo, SystemTools, Tabular Data Stream, The Enterprise Client/Server Company, The Extensible Software Platform, The Future Is Wide Open, The Learning Connection, The Model for Client/Server Solutions, The Online Information Center, Translation Toolkit, Turning Imagination Into Reality, UltraLite, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Viewer, VisualSpeller, VisualWriter, WarehouseArchitect, Warehouse Studio, Warehouse WORKS, Watcom, Watcom SQL, Watcom SQL Server, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup SQL Server, XA-Library, XA- Server, and XP Server are trademarks of Sybase, Inc. 2/99 Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. All other company and product names used herein may be trademarks or registered trademarks of their respective companies. Acknowledgements Larry Ewing, and the GIMP (General Image Manipulation Program) for the use of the Linux 2.0 Penguin. Restricted Rights Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS for the DOD and as set forth in FAR (a)-(d) for civilian agencies. Sybase, Inc., 6475 Christie Avenue, Emeryville, CA

5 Table of Contents About This Book Audience xiii How To Use This Book xiii Related Documents xiv Other Sources of Information xvi Sybase Certifications on the Web xvii Conventions xviii If You Need Help xix 1. Overview Installation Definitions User Roles Product Descriptions Installation and Setup Utilities Environment Variables DSLISTEN DSQUERY PATH SYBASE Shared Libraries Sybase Installation Directory ($SYBASE) Client/Server Communication (the interfaces File) Adaptive Server Devices and System Databases Master Device sysprocsdev Device Optional Devices and Databases sybsecurity Device and Database sybsystemdb Device and Database Sample Databases sybsyntax Database dbccdb Database What s Next? Installation Requirements System Requirements Installation Guide for Linux/Intel v

6 Adaptive Server Enterprise Version Product Disk Space Requirements Language Module Sizes Adaptive Server Specifications What s Next? Unloading Server Products from Distribution Media Overview Pre-Unloading Tasks Unloading Using Red Hat Package Manager Unloading in an X-Windows Environment Installing the Java Runtime Environment What s Next? Installing Sybase Servers Overview Installation Methods Pre-Installation Tasks Determining the Location, Type, and Size of a Database Device Quick Start Installation Beginning the Quick Start Installation Process Continuing Quick Start Installation Adaptive Server Continuing Quick Start Installation Backup Server Continuing Quick Start Installation Monitor Server Continuing Quick Start Installation XP Server Custom Installation Beginning the Custom Installation Process Continuing Custom Installation Adaptive Server Continuing Custom Installation Backup Server Continuing Custom Installation Monitor Server Continuing Custom Installation XP Server Viewing the Installation Status Output Screen Changing the Default Language and Character Set Installation Complete Resource File Installation Editing a Resource File Editing a Sample Resource File Editing a Resource File Created by srvbuild Resource File Attributes for Adaptive Server Resource File Attributes for Backup Server vi Table of Contents

7 Adaptive Server Enterprise Version Using srvbuildres Resource File Installation Complete Post-Installation Tasks Verifying That Servers Are Running Setting the Sybase System Administrator Password Information Required for XP Server What s Next? Installing Sybase PC-Client Products Preinstallation Task Installing PC Clients Configuring Network Connections for Client Products Adding a Server to the sql.ini File Enabling TCP Connections Installing the Adaptive Server Plug-In for Sybase Central Installing the Plug-In Installing the Required Microsoft DLL on Windows Checking the Current File Version Replacing the File Running the Japanese Version of the Plug-In Installing the Java Runtime Environment Installing Java Utilities Installing jisql and ribo Installing the Java Development Kit System Requirements What s Next? Upgrading Sybase Servers Overview Pre-Upgrade Tasks Verifying Your Adaptive Server Environment Preparing Your Server for Upgrade Increasing the Size of the sybsystemprocs Database Increasing the Size of sybsystemprocs Only Increasing sybsystemprocs Beyond the Capacity of sysprocsdev Upgrading a Database That Uses Auditing Preparing to Upgrade with Replicated Databases Upgrading Adaptive Server Using sqlupgrade Installation Guide for Linux/Intel vii

8 Adaptive Server Enterprise Version Using sqlupgraderes Editing a Resource File Upgrading using sqlupgraderes Post-Upgrade Tasks Verifying That Servers Are Running Restoring Functionality in Adaptive Server Upgrading Backup Server, Monitor Server, and XP Server What s Next? Adding Optional Functionality to Adaptive Server Installing Auditing Audit System Devices and Databases The sybsecurity Device and Database Tables and Devices for the Audit Trail Device for syslogs Systems Table Overview of Audit Installation Pre-Installation Tasks Audit Installation Creating a Device for an Audit Table Creating a Device for the Audit Database Transaction Log Enabling Auditing Deleting a Device Entry Changing a Device Entry Installing Two-Phase Commit About Two-Phase Commit Enhancements to Two-Phase Commit spt_comittab Moved to sybsystemdb Improved Performance for the Commit Identifier Configuring for Two-Phase Commit Installing Online Help for Transact-SQL Syntax Online Syntax Help: sp_syntax Default Device for the sybsyntax Database Installing sybsyntax Installing Sample Databases Default Devices for Sample Databases pubs2 and pubs3 Databases Installing the pubs2 and pubs3 Databases interpubs Database Installing the interpubs Database jpubs Database viii Table of Contents

9 Adaptive Server Enterprise Version Installing the jpubs Database Maintaining the Sample Databases Starting and Stopping Servers Overview Starting Servers From the UNIX Command Line Using the Runserver File Using the startserver Command Using the monserver Command Starting Servers When the Operating System Restarts Stopping Servers Stopping Adaptive Server Stopping Backup Server Stopping Monitor Server Using the kill Command Shutdown and Shared Memory Files Troubleshooting Overview Error Log Locations For Installation Utilities For Sybase Servers Solutions to Common Installation Problems You Do Not Have a 17-Inch Monitor If sybsetup Prompts for a Customer Authorization String (CAS) Cannot Eject the CD from the Drive DISPLAY Environment Variable Not Set Correctly Connection Refused; Client Not Authorized to Connect to Server Address Already in Use Adaptive Server Failed to Boot Cannot Start XP Server Pre-Upgrade Eligibility Test Failed A. Preparing to Upgrade Servers with Replicated Databases Suspend Transaction Activity in the Databases and Suspend Replication A-1 Drain Transaction Logs for Primary Databases A-2 Manually Draining the RSSD Transaction Log A-3 Disable the LTM Truncation Point A-4 Installation Guide for Linux/Intel ix

10 Adaptive Server Enterprise Version Drain Each Replicated Primary A-4 Restore Replication After Upgrade A-6 Shut Down Replication Servers and LTMs A-6 Upgrade Adaptive Server A-6 Index x Table of Contents

11 List of Tables Table 1-1: Product descriptions Table 1-2: Installation and setup utilities Table 2-1: System requirements for Adaptive Server Table 2-2: System requirements for client products Table 2-3: Product disk space requirements Table 2-4: Language module sizes Table 2-5: Adaptive Server specifications for Linux Table 3-1: Adding SYBASE and $SYBASE/bin to the PATH environment variable Table 3-2: Summary of steps after unloading Adaptive Server Table 4-2: Adaptive Server database devices Table 4-3: Resource file attributes for Adaptive Server Table 4-4: Resource file attributes for Backup Server Table 5-1: System requirements for Windows NT and Windows Table 5-2: System requirements for UNIX Table 6-1: Resource file attributes for upgrading Adaptive Server Table 7-1: sp_syntax installation scripts Table 9-1: Error log locations for installation utilities Table 9-2: Error log locations for Sybase servers Installation Guide for Linux/Intel xi

12 Adaptive Server Enterprise Version xii List of Tables

13 About This Book This guide, Installation Guide for Linux/Intel, provides: An overview of the Sybase Adaptive Server Enterprise installation infrastructure Instructions for installing and upgrading Adaptive Server, and installing Backup Server, Monitor Server, XP Server, and client products, including the Adaptive Server plug-in for Sybase Central Instructions for installing optional Adaptive Server functionality, such as auditing, sample databases, and two-phase commit transactions, and localization information Audience This guide is written for Sybase System Administrators and other qualified installers who are familiar with their system s environment, networks, disk resources, and media devices. How To Use This Book This book contains the following chapters: Chapter 1, Overview, provides product definitions and an overview of the installation process and the Adaptive Server installation infrastructure. Chapter 2, Installation Requirements, provides descriptions and system-related information such as required RAM and disk space for all Adaptive Server server and client products for this release. Chapter 3, Unloading Server Products from Distribution Media, describes how to unload Adaptive Server products from the distribution media to your system. Chapter 4, Installing Sybase Servers, describes three ways to install Adaptive Server: Quick Start installation, custom installation, and resource file installation. This chapter also provides instructions for changing the language used for server messages. Installation Guide for Linux/Intel xiii

14 Related Documents Adaptive Server Enterprise Version Chapter 5, Installing Sybase PC-Client Products, describes how to install Adaptive Server client products like the Adaptive Server plug-in to Sybase Central and SQL Advantage. Chapter 6, Upgrading Sybase Servers, describes how to upgrade an existing Adaptive Server to the current release. Chapter 7, Adding Optional Functionality to Adaptive Server, describes how to install additional functionality such as auditing, sample databases that can be used for learning Transact-SQL, and two-phase commit. Chapter 8, Starting and Stopping Servers, describes the different methods of starting and stopping Adaptive Server, Backup Server, and other servers. Chapter 9, Troubleshooting, provides installation error messages and possible solutions to installation problems. Appendix A, Preparing to Upgrade Servers with Replicated Databases, provides instructions on how to prepare for an Adaptive Server upgrade if you are running Replication Server on your system. Appendix B, Installing and Using the Performance Archive Database, provides instructions on how to install the Performance Archive Database to obtain real-time performance and tuning recommendations from Sybase. Related Documents The following table lists the documents you need for installing and using Adaptive Server Enterprise and Adaptive Server Enterprise Monitor. See This Document For This Purpose Adaptive Server Enterprise Release Bulletin New Functionality in Adaptive Server Enterprise To review last-minute product or document information that was too late to be included in the books. To learn about the new functionality available in Adaptive Server version xiv About This Book

15 Adaptive Server Enterprise Version Related Documents See This Document Installing Adaptive Server Configuring Adaptive Server What s New in Adaptive Server Enterprise? Navigating the Documentation for Adaptive Server Transact-SQL User s Guide System Administration Guide Adaptive Server Reference Manual Managing and Monitoring Sybase Adaptive Server Enterprise Performance and Tuning Guide Utility Programs for UNIX Platforms Security Administration Guide Security Features User s Guide Quick Reference Guide For This Purpose To install or upgrade Adaptive Server and Sybase-related products. To customize setup and functionality. To review the new features and system changes in Adaptive Server version To access online links to the concepts and syntax in the Adaptive Server documentation. This online document is taskoriented. To learn about Transact-SQL, Sybase s enhanced version of the relational database language. To learn about administering servers and databases in Adaptive Server. As a reference to Adaptive Server commands, functions, system procedures, and datatypes. To manage Adaptive Server Enterprise and monitor its activities using Sybase Central. To tune Adaptive Server for maximum performance. As a reference to Adaptive Server utilities. As a System Administrator, to learn how to administer a secure operating environment and control user access to data. As a non-administrative user, to learn how to use the security features of Adaptive Server. As a quick reference to Adaptive Server 11.5 syntax and commands. Installation Guide for Linux/Intel xv

16 Other Sources of Information Adaptive Server Enterprise Version See This Document Troubleshooting and Error Messages Guide Adaptive Server Glossary Adaptive Server Enterprise Monitor Release Bulletin Adaptive Server Enterprise Monitor Historical Server User's Guide Adaptive Server Enterprise Monitor Server User's Guide Adaptive Server Enterprise Monitor Client Library Programmer s Guide For This Purpose To resolve system problems and frequently occurring error messages. To find definitions of technical terms used in the Adaptive Server documentation. To review last-minute product or document information that was too late to be included in the books. To set up and use Historical Server. To set up and use Monitor Server. To write Monitor Client Library applications. Other Sources of Information Use the Sybase Technical Library CD and the Technical Library Web site to learn more about your product: Technical Library CD contains product manuals and technical documents and is included with your software. The DynaText browser (included on the Technical Library CD) allows you to access technical information about your product in an easy-touse format. Refer to the Technical Library Installation Guide in your documentation package for instructions on installing and starting Technical Library. Technical Library Web site includes the Product Manuals site, which is an HTML version of the Technical Library CD that you can access using a standard Web browser. In addition, you ll find links to the Technical Documents Web site (formerly known as Tech Info Library), the Solved Cases page, and Sybase/Powersoft newsgroups. To access the Technical Library Web site, go to support.sybase.com, click the Electronic Support Services tab, and select a link under the Technical Library heading. xvi About This Book

17 Adaptive Server Enterprise Version Other Sources of Information Sybase Certifications on the Web Technical documentation at the Sybase Web site is updated frequently. For the latest information on product certifications and/or the EBF Rollups: 1. Point your Web browser to Technical Documents at the following Web site: techinfo.sybase.com 2. In the Browse section, click on the Hot entry. 3. Explore your area of interest: Hot Docs covering various topics, or Hot Links to Technical News, Certification Reports, Partner Certifications, and so on. If you are a registered SupportPlus user: 1. Point your Web browser to Technical Documents at the following Web site: techinfo.sybase.com 2. In the Browse section, click on the Hot entry. 3. Click on the EBF Rollups entry. You can research EBFs using Technical Documents, and you can download EBFs using Electronic Software Distribution (ESD). 4. Follow the instructions associated with the SupportPlus SM Online Services entries. If you are not a registered SupportPlus user, and you want to become one: You can register by following the instructions on the Web. To use SupportPlus, you need: A Web browser that supports the Secure Sockets Layer (SSL), such as Netscape Navigator 1.2 or later An active support license A named technical support contact Your user ID and password Installation Guide for Linux/Intel xvii

18 Conventions Adaptive Server Enterprise Version Whether or not you are a registered SupportPlus user: You may use Sybase s Technical Documents. Certification Reports are among the features documented at this site. 1. Point your Web browser to Technical Documents at the following Web site: techinfo.sybase.com 2. In the Browse section, click on the Hot entry. 3. Click on the topic that interests you. Conventions The following style conventions are used in this manual: In a sample screen display, commands you should enter exactly as shown are given in: this font In a sample screen display, words that you should replace with the appropriate value for your installation are shown in: this font In the regular text of this document, the names of files and directories appear in this font: /usr/u/sybase The names of programs, utilities, procedures, and commands appear in this font: sybsetup Commands for both the C shell and the Bourne shell are provided in this document, when they differ. The initialization file for the C shell is called.cshrc. The initialization file for the Bourne shell is called.profile. If you are using a different shell, such as the Korn shell, refer to your shell-specific documentation for the correct command syntax. xviii About This Book

19 Adaptive Server Enterprise Version If You Need Help The following table shows the conventions for syntax statements in this manual. Key Definition command Command names, command option names, utility names, utility flags, and other keywords are in bold. variable Variables, or words that stand for values that you fill in, are in italic. { } Curly braces indicate that you choose at least one of the enclosed options. Do not include braces in your option. [ ] Brackets mean choosing one or more of the enclosed options is optional. Do not include brackets in your option. ( ) Parentheses are to be typed as part of the command. The vertical bar means you can select only one of the options shown., The comma means you can choose as many of the options shown as you like, separating your choices with commas to be typed as part of the command. If You Need Help Each Sybase installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support. If you cannot resolve a problem using the manuals or online help, please have the designated person contact Sybase Technical Support or the Sybase subsidiary in your area. Installation Guide for Linux/Intel xix

20 If You Need Help Adaptive Server Enterprise Version xx About This Book

21 1 Overview 1. This chapter introduces important concepts about the installation of Adaptive Server and related products. Topics covered include: Installation Definitions 1-1 User Roles 1-1 Product Descriptions 1-2 Installation and Setup Utilities 1-4 Environment Variables 1-5 Sybase Installation Directory ($SYBASE) 1-6 Client/Server Communication (the interfaces File) 1-7 Adaptive Server Devices and System Databases 1-9 What s Next? 1-12 Installation Definitions In this book, these terms are defined as follows: Unload to copy Adaptive Server products from the distribution media to your machine, using the sybsetup or the Redhat Package Manager (RPM) utility. Install to make the Adaptive Server products fully functional by configuring various attributes, using the srvbuild utility. Upgrade to configure an existing Adaptive Server (or SQL Server ) to a more recent Adaptive Server version level. User Roles The Adaptive Server installation and setup process defines various user roles. Different user roles have different responsibilities and privileges. These user roles clarify the way Adaptive Server is to be integrated into your system: Operating System Administrator The individual who maintains the operating system. This individual has superuser or root privileges. Installation Guide for Linux/Intel 1-1

22 Product Descriptions Adaptive Server Enterprise Version System Administrator The individual in charge of Adaptive Server system administration, creating user accounts, assigning permissions on databases, and creating new databases. At installation time, the System Administrator s login name is sa. The sa login is not a UNIX login. The sa login is specific to Adaptive Server and is used to log in to Adaptive Server using the isql command. Sybase Login The sybase login is a UNIX login that owns all the Sybase installation directories and files, sets permissions on those directories and files, and performs the installation and upgrading of Adaptive Server. Product Descriptions Table 1-1 provides a description of the server and client products in your Adaptive Server package. Table 1-1: Product descriptions Product Adaptive Server Adaptive Server Plug-In to Sybase Central Description The relational database server. The default unloading process includes: Adaptive Server Backup Server Monitor Server XP Server Adaptive Server utilities Scripts and configuration files Sybase Central is a common framework for managing servers. It allows you to manage Adaptive Server installations using the Sybase Central graphical management tool. You can manage Adaptive Server running on any platform from a PC that is running Windows 95 or Windows NT. For information on how to use Sybase Central to manage Adaptive Server, see Managing and Monitoring Sybase Adaptive Server Enterprise. 1-2 Overview

23 Adaptive Server Enterprise Version Product Descriptions Table 1-1: Product descriptions (continued) Product Adaptive Server Enterprise Monitor Backup Server Description An Open Server application that obtains performance statistics on Adaptive Server and makes those statistics available to Monitor Server client applications. Adaptive Server Enterprise Monitor (also called Monitor Server) includes: Monitor Server for Adaptive Server Enterprise 11.9.x an Open Server application that obtains performance statistics on Adaptive Server and makes those statistics available to monitors in Sybase Central, Monitor Historical Servers, and applications built with Monitor Client Library. Monitor Server for SQL Server 11.0.x is also available. Adaptive Server plug-in for Sybase Central this graphical user interface obtains Adaptive Server performance data from Monitor Server and displays the data, in real time, in tables and graphs. Monitor Client Library a programming interface that provides access to Adaptive Server performance data. Monitor Historical Server an Open Server application that obtains performance statistics for many Adaptive Servers via Monitor Servers and records the data to specified file locations. Backup Server is an Open Server-based application that manages all database backup (dump) and restore (load) operations for Adaptive Server. Backup Server provides the following features: Allows you to use up to 32 dump devices (this is called dump striping) in parallel to dump or load a single database or transaction log. Allows one dump to span multiple tapes or allows multiple dumps to be made to a single tape. Allows dumping and loading over the network to or from a device on another machine. Provides automated determination of tape device characteristics, by using operating system commands, for a dump operation. Platform-specific tape handling options support dump and load command syntax specification for volume naming, dismount and load control, tape density, block size, tape capacity, days to retain, initialization, file naming for multidump volumes, and listing header or file information. Install Backup Server if you plan to back up and restore databases in Adaptive Server. Backup Server is unloaded, by default, when you unload Adaptive Server software from the distribution media. Use the srvbuild utility to set up Backup Server and to connect Backup Server and Adaptive Server through the interfaces file. Installation Guide for Linux/Intel 1-3

24 Installation and Setup Utilities Adaptive Server Enterprise Version Table 1-1: Product descriptions (continued) Product Language Modules (Server) Language Modules (Connectivity) ODBC Driver Open Client XP Server Description Provides system messages and date/time formats to help you localize your applications. Default installation includes the us_english language module and the following character sets: cp437 IBM CP437, U.S. code set cp850 IBM CP850, European code set iso_1 ISO , Latin-1 mac Standard Macintosh coding roman8 HP Roman-8 Other languages for Adaptive Server and Sybase client products are French, German, and Japanese. Language modules for Spanish, Korean, Brazilian Portuguese, and Simplified Chinese are also available for Adaptive Server. For more information on server language modules and character sets, see Configuring Adaptive Server for UNIX Platforms, version Provides messages and support files for running Open Client applications in various languages. Allows Windows NT client applications to access Adaptive Server data. Provides libraries and utilities for developing any Open Client application. An Open Server application that manages and executes extended stored procedures (ESPs) from within Adaptive Server. ESPs provide a method for calling procedural language functions from within Adaptive Server. XP Server is unloaded, by default, when you unload Adaptive Server software from the distribution media. Use the srvbuild utility to set up XP Server and to connect XP Server and Adaptive Server through the interfaces file. Installation and Setup Utilities Table 1-2 lists the Adaptive Server installation and setup utilities you can use to unload, install, upgrade, or customize Adaptive Server and its products on UNIX systems. Use of these utilities is not 1-4 Overview

25 Adaptive Server Enterprise Version Environment Variables described in this installation guide. For information see Configuring Adaptive Server for UNIX Platforms. Table 1-2: Installation and setup utilities Utility Use To Environment dscp Modify the interfaces file. Interactive, text-based interface dsedit Modify the interfaces file. X-Windows/Motif GUI sqlloc Modify localization settings, such as language and character set. X-Windows/Motif GUI sqllocres Modify localization settings, such as language and character set, using a resource file. Use of this utility is not described in this installation guide. For information on using sqllocres, see Utility Programs for UNIX Platforms. Noninteractive, file-based interface sqlupgrade Upgrade Adaptive Server. X-Windows/Motif GUI sqlupgraderes Upgrade Adaptive Server using a resource file. Noninteractive, file-based interface srvbuild Build a functional server. X-Windows/Motif GUI srvbuildres sybsetup Build a functional server using a resource file. Provide a main selection menu from which to select the installation or setup task you want to perform. Unload Adaptive Server products from distribution media. Noninteractive, file-based interface X-Windows/Motif GUI Environment Variables It is crucial to the operation of Sybase products that you set the system environment variables correctly. Environment variables are set in the user s environment either interactively or by including them in the user s.login and.cshrc files (for C shell) or.profile file (for Bourne shell). The installation instructions in this guide explain when to set these variables. Installation Guide for Linux/Intel 1-5

26 Sybase Installation Directory ($SYBASE) Adaptive Server Enterprise Version DSLISTEN The DSLISTEN environment variable defines the name Adaptive Server uses to listen for client connections if no name is given during the Adaptive Server start-up. If DSLISTEN is not set, and no name is given during the Adaptive Server start-up, the Adaptive Server name defaults to the server name given at installation. DSQUERY The DSQUERY environment variable defines the Adaptive Server name that client programs try to connect to if no Adaptive Server is specified with a command line option. If DSQUERY is not set, and you do not supply the Adaptive Server name with a command line option, clients attempt to connect to the server name given at installation. PATH The PATH environment variable specifies which directory path to search for executables. The Sybase executables are located in the $SYBASE/bin directory. SYBASE The SYBASE environment variable defines the path of the Sybase installation directory. The installation program uses the SYBASE environment variable during installation. Shared Libraries The name of the shared library environment variable is different for each UNIX platform. Chapter 3, Unloading Server Products from Distribution Media, defines this environment variable for your platform. Sybase Installation Directory ($SYBASE) The Sybase installation directory structure is created by the installation process. Adaptive Server is placed in the directory you 1-6 Overview

27 Adaptive Server Enterprise Version Client/Server Communication (the interfaces File) indicate when you run sybsetup. Figure 1-1 illustrates a portion of the Adaptive Server installation directory structure. $ S Y B A S E bin charsets init install locales scripts upgrade Executable files (such as bcp, isql, and dataserver) Character set and sort order definition files Support directories Install programs, setperm files, runserver files Localization files for language support SQL scripts, including sample database installation scripts Upgrade programs Figure 1-1: Adaptive Server installation directory structure The Adaptive Server installation directory contains executable files and administrative tools, which are added as each product is installed. Client/Server Communication (the interfaces File) Adaptive Server communicates with other Adaptive Servers, Open Server applications (such as Backup Server), and client software on your network. Clients can talk to one or more servers, and servers can communicate with other servers, by remote procedure calls. For Sybase products to interact with one another, each product needs to know where the others reside on the network. This information is Installation Guide for Linux/Intel 1-7

28 Client/Server Communication (the interfaces File) Adaptive Server Enterprise Version stored in an interfaces file, named interfaces on UNIX platforms, located in the Adaptive Server installation directory. After your Adaptive Server or client software is installed, it can connect with any server on the network that is listed in the interfaces file. The interfaces file is like an address book. It lists the name and address of every known server. When you are using a client program, and you want to connect with a particular server, the client program looks up the server name in the interfaces file and connects to that server (see Figure 1-2). You can supply the name of the server by using the DSQUERY environment variable. On TCP/IP networks, the port number gives clients a way to identify the Adaptive Server to which they want to connect. It also tells Adaptive Server where to listen for incoming connection attempts from clients. Adaptive Server uses a single port for these two services (referred to as query service and listener service). On SPX networks, the socket number gives clients and servers a way to identify each other. Connect me to the TEST Adaptive Server. Data Workbench $SYBASE/interfaces interfaces file TEST TEST Adaptive Server DSQUERY = TEST Figure 1-2: Communicating with a server During installation, you use the srvbuild utility to create a new server. The srvbuild process adds entries to the interfaces file for your new Adaptive Server, Backup Server, Monitor Server, and XP Server. For instructions on using dsedit or dscp to modify interfaces file entries or to create new interfaces file entries for existing servers, see Configuring Adaptive Server for UNIX Platforms. 1-8 Overview

29 Adaptive Server Enterprise Version Adaptive Server Devices and System Databases Adaptive Server Devices and System Databases Devices are files or portions of a disk that are used to store databases and database objects. You can initialize devices, using raw disk partitions (for production systems) or operating system files (for nonproduction uses). Adaptive Server requires the following devices: Master device to store system databases sysprocsdev device to store system procedures The master and sysprocsdev devices are created by srvbuild when you create a new Adaptive Server. Master Device The master device contains the following databases: master controls the operation of Adaptive Server as a whole and stores information about all users, user databases, devices, objects, and system table entries. The master database is contained entirely on the master device and cannot be expanded onto any other device. model provides a template for new user databases. The model database contains required system tables, which are copied into a new user database with the create database command. tempdb the work area for Adaptive Server. Each time Adaptive Server is started the tempdb database is cleared and rebuilt from the model database. The sample databases are stored on the master device at installation, but should be moved to a user-defined device after installation. For information on the sample databases, see Optional Devices and Databases on page Note For recovery purposes, Sybase recommend that you not create other system or user databases or user objects on the master device. Installation Guide for Linux/Intel 1-9

30 Adaptive Server Devices and System Databases Adaptive Server Enterprise Version sysprocsdev Device The sysprocsdev device stores the sybsystemprocs database, which contains most of the Sybase-supplied system procedures. System procedures are a collection of SQL statements and flow-of-control statements that perform system tasks; for example, sp_configure. System procedure names begin with sp_. The system procedures that are needed during recovery situations are stored in the master database. Note sysprocsdev is the default system name for this device. However, it is frequently referred to as the sybsystemprocs device, since it stores the sybsystemprocs database. Optional Devices and Databases The following devices and databases are needed only if you configure Adaptive Server for optional functionality, like auditing or two-phase commit transactions. sybsecurity Device and Database The sybsecurity device stores the sybsecurity database and the auditing system procedures with which you can configure auditing for your system. The auditing system records system security information in an Adaptive Server audit trail. You can use this audit trail to monitor the use of Adaptive Server or system resources. Install auditing using the auditinit utility. The sybsecurity device is created as part of the auditing installation process. See Chapter 7, Adding Optional Functionality to Adaptive Server, for instructions on how to configure Adaptive Server for auditing. The auditing system is discussed in more detail in the Security Administration Guide Overview

31 Adaptive Server Enterprise Version Adaptive Server Devices and System Databases sybsystemdb Device and Database The sybsystemdb device stores the sybsystemdb database, which stores information about two-phase commit transactions. See Chapter 7, Adding Optional Functionality to Adaptive Server, for instructions on how to create the sybsystemdb device and database and how to configure Adaptive Server for two-phase commit. Sample Databases The pubs2 and pubs3 databases are sample databases provided as a learning tool for Adaptive Server. pubs2 is used for most of the examples in the Adaptive Server documentation; other examples use pubs3. Both are available in U.S. English versions of Adaptive Server. The interpubs database contain French and German data. jpubs contains Japanese data. For information about installing the sample databases, see Chapter 7, Adding Optional Functionality to Adaptive Server. For information on the contents of these sample databases, see the Transact-SQL User s Guide. sybsyntax Database The syntax database, sybsyntax, contains syntax help for Transact-SQL commands, Sybase system procedures, Adaptive Server utilities, and Open Client routines. Users can retrieve this information using the system procedure sp_syntax. For example, to see the syntax of the Transact-SQL select command, enter: sp_syntax "select" Adaptive Server includes scripts for creating the sybsyntax database. See Chapter 7, Adding Optional Functionality to Adaptive Server, for instructions on how to install sybsyntax. See the Adaptive Server Reference Manual for more information about sp_syntax. dbccdb Database The database consistency checker (dbcc) provides commands for checking the logical and physical consistency of a database. The Installation Guide for Linux/Intel 1-11

32 What s Next? Adaptive Server Enterprise Version dbccdb database stores the results of dbcc when the dbcc checkstorage command is used. dbcc checkstorage records configuration information for the target database, operation activity, and the results of the operation in the dbccdb database. Stored in the database are dbcc stored procedures for creating and maintaining dbccdb and for generating reports on the results of dbcc checkstorage operations. Information on installing dbccdb is located in Chapter 18, Checking Database Consistency, of the System Administration Guide. What s Next? For Adaptive Server product descriptions, and server and database specifications, see Chapter 2, Installation Requirements Overview

33 2 Installation Requirements 2. This chapter covers: System Requirements 2-1 Product Disk Space Requirements 2-2 Language Module Sizes 2-2 Adaptive Server Specifications 2-3 What s Next? 2-5 For easier installation, make a copy of this chapter, so you have the requirements information available as you perform the pre-installation, installation, or upgrade procedures. System Requirements Table 2-1 shows the release-level, RAM, and network-protocol requirements for Adaptive Server. Table 2-1: System requirements for Adaptive Server Platform and Operating System Release Level RAM Required Network Protocol Linux Intel Certified on Kernel Version Linux Common Runtime Environment glibc MB required; 128MB+ recommended TCP/IP Sockets Table 2-2 lists the RAM required for client products. Table 2-2: Product System requirements for client products RAM Required Monitor Client Library Open Client/C jisql ribo 16MB (32MB recommended) 16MB 18MB 14MB Installation Guide for Linux/Intel 2-1

34 Product Disk Space Requirements Adaptive Server Enterprise Version Product Disk Space Requirements Table 2-3 lists the disk space requirements for each product. Table 2-3: Product disk space requirements Product and Version Level Adaptive Server Open Client/C Language Modules (Server ) Language Modules (Open Client ) Monitor Server Monitor Historical Server NT Monitor Client Library NT jisql ribo Disk Space Required 140MB 52MB 2 7MB per language 3 6MB per language 1.6MB 2.9MB 4.0MB 2.0MB 14KB Language Module Sizes Table 2-4 lists the sizes for the Adaptive Server and Open Client Language Modules. Table 2-4: Language Language module sizes Size of Adaptive Server Language Module Size of Open Client Language Module Brazilian Portuguese 6.5MB 1.2MB Chinese (simplified) 2MB 1.2MB French 6.5MB 1.5MB German 6.5MB 1.5MB Japanese 4.5MB 1.2MB Korean 2MB 1.2MB Spanish 6.5MB 1.2MB 2-2 Installation Requirements

35 Adaptive Server Enterprise Version Adaptive Server Specifications Adaptive Server Specifications This section provides Adaptive Server specifications for Linux. Table 2-5: Adaptive Server specifications for Linux Hardware Processor 32-bit Intel 486 Minimum RAM required for Adaptive Server >32MB 16,000 2K pages Minimum RAM per additional user 80K With default stack size, packet size, and user log cache size Default user stack size 34,816 bytes Minimum 26,624 bytes Database Specifications Databases per Adaptive Server 32,767 Practical limit is approximately 100 Default database size 2MB Minimum 2MB Maximum database size 2 42 (4TB) Maximum device size * 128 devices per database Maximum size of a database device (disk partition) Maximum number of database devices per server Maximum number of devices or device pieces per database Maximum number of segments per database master database model database 2 35 (32GB) MB 7MB 2MB 3MB Requires Solaris or later 2GB maximum device size if using operating system files 32GB device size with operating system files will be supported with Solaris 2.7 Minimum required for a new installation Minimum required for an upgrade Minimum required for a new installation Minimum required for an upgrade Installation Guide for Linux/Intel 2-3

36 Adaptive Server Specifications Adaptive Server Enterprise Version Table 2-5: Adaptive Server specifications for Linux (continued) tempdb database sybsystemprocs database pubs2 database pubs3 database interpubs database jpubs database 2MB 3MB 45MB 60MB 2MB 3MB 2MB 3MB 2MB 3MB 2MB 3MB Table Specifications User objects per database Columns per table 250 Indexes per table 250 (one clustered index) Rows per table Limited by available storage Maximum user data per row Maximum number of data bytes per text/image page 1960 bytes 1800 bytes Columns per composite index 31 Bytes per index key 600 Creation of clustered index Free space needed on segment is 1.2 * (size of table) Minimum required for a new installation Minimum required for an upgrade Minimum required for an upgrade Recommended for an upgrade Minimum required for a new installation Minimum required for an upgrade Minimum required for a new installation Minimum required for an upgrade Minimum required for a new installation Minimum required for an upgrade Minimum required for a new installation Minimum required for an upgrade Maximum 2 32 For sorted data, approximately 20% of the table size needed 2-4 Installation Requirements

37 Adaptive Server Enterprise Version What s Next? Table 2-5: Adaptive Server specifications for Linux (continued) Characters per database object name 30 Query Specifications Maximum number of tables in a union query Maximum number of databases participating in one transaction Practical number of databases participating in one query Maximum number of tables participating in a query Maximum number of tables with referential integrity constraints for a query Procedure Specifications Number of buffers and procedure buffers Minimum memory required per stored procedure Maximum number of parameters per stored procedure Includes database where transaction began, all databases changed during transaction, and tempdb, if it is used for results or worktables 16 Includes each occurrence of each database queried and tempdb, if it is used for results or worktables 16 Includes all worktables, result tables, tables referenced by views (the view itself is not counted), correlations, and self-joins 192 Configurable 2K 255 Limited by amount of RAM and maximum size of shared memory segment What s Next? To unload Adaptive Server software to your system, see Chapter 3, Unloading Server Products from Distribution Media. Installation Guide for Linux/Intel 2-5

38 What s Next? Adaptive Server Enterprise Version Installation Requirements

39 3 Unloading Server Products from Distribution Media 3. This chapter describes how to unload Adaptive Server Enterprise server products for UNIX from the Sybase distribution media onto your system. To unload client products, see Chapter 5, Installing Sybase PC- Client Products. Topics covered include: Overview 3-1 Pre-Unloading Tasks 3-1 Unloading in an X-Windows Environment 3-4 What s Next? 3-10 Overview Unload the server product files from the distribution media to your machine, using the instructions provided in this chapter. When you have finished unloading the products, either: Build the server products, using the instructions provided in Chapter 4, Installing Sybase Servers. Upgrade server products, using the instructions provided in Chapter 6, Upgrading Sybase Servers. Pre-Unloading Tasks Before unloading server products onto the system: 1. Read the release bulletins for the latest information on the products (Adaptive Server, Monitor Server, and so on) that you are unloading. Your Sybase products shipment includes printed release bulletins; they are also available at the Sybase Web site: 2. If you plan to run sybsetup on a remote machine, that machine must have permission to display the sybsetup screens on the local machine on which you are working. To give the remote machine Installation Guide for Linux/Intel 3-1

40 Pre-Unloading Tasks Adaptive Server Enterprise Version permission to display screens on your local machine, enter the following command at the UNIX prompt of your local machine: xhost +remote_machine where remote_machine is the machine on which you are running sybsetup. 3. At the remote machine where you are running sybsetup, verify that the DISPLAY environment variable is set to the local machine on which you are viewing sybsetup screens and output. If sybsetup cannot find your DISPLAY variable, you cannot run the graphical user interface. For C shell: setenv DISPLAY host_name:0.0 For Bourne shell: DISPLAY=host_name:0.0; export DISPLAY where host_name is the name of the local (display) machine. 4. Run sybsetup as root (uid=0). Under Linux, sybsetup invokes the RPM for correct product installation. The installation progress bar does not accurately indicate installation progress. Note A post-installation script, $SYBASE/install/sybinstall.sh, is automatically initiated by RPM during the sybsetup install. This script performs required post-install actions. It attempts to create a Sybase account on your system and to set the correct Sybase runtime environment variables. 5. Identify or create a directory location for the Sybase installation directory, where you unload the server products. 6. Verify that the directory location for the Sybase installation directory is in a UNIX file system that has sufficient space to accommodate unloading the software. Space requirements for Adaptive Server Enterprise products are listed in Chapter 2, Installation Requirements. 7. Set the SYBASE environment variable to the path of the Sybase installation directory. For example: setenv SYBASE /opt/sybase The SYBASE environment variable is used by the installation and setup utilities. 3-2 Unloading Server Products from Distribution Media

41 Adaptive Server Enterprise Version Unloading Using Red Hat Package Manager Note If you are upgrading your current Adaptive Server (or SQL Server) to Adaptive Server , set the SYBASE environment variable to the new Sybase installation directory rather than your current installation. 8. RPM sets correct product permissions and ownership. 9. During post-installation, RPM creates a.profile file for Bourne shell and a.cshrc file for C shell. When you log in as sybase for the first time after installation, check to see that the SYBASE environment variable is correctly set and that $SYBASE/bin is in your search path. Table 3-1: Adding SYBASE and $SYBASE/bin to the PATH environment variable Operating System Shell Bourne (sh) C (csh) After Unloading, Set SYBASE and PATH As Follows export SYBASE = rpm -q --queryformat %{installprefix} sybase-common export PATH = $SYBASE/bin: $PATH setenv SYBASE rpm -q --queryformat %{installprefix} sybase-common set path = ($SYBASE/bin $path) Unloading Using Red Hat Package Manager In the Linux platform, you can choose to unload Adaptive Server with either the Red Hat Package Manager (RPM) included in the standard bundle by all Linux distributors, or Sybase s sybsetup utility. To unload Adaptive Server products using RPM: 1. Verify that you are logged in as the root superuser and that your environment is set up as described in Pre-Unloading Tasks on page Veryify that you have a directory called /opt on your server, and that it has sufficient space to accommodate unloading the software. If an /opt directory does not already exist, the Linux RPM will create it in the root directory. 3. Place the Adaptive Server product CD in the CD-ROM drive. 4. At the # prompt, enter: # mount -t iso9660 /dev/cdrom /mnt/cdrom Installation Guide for Linux/Intel 3-3

42 Unloading in an X-Windows Environment Adaptive Server Enterprise Version Extract your Sybase products using RPM. For help on RPM, enter: # /bin/rpm Note All products depend on the sybase-common i386.rpm package. Install the sybase-common package before you install any other package. 6. Unload all of your necessary Sybase products into the /opt/sybase directory by entering: # rpm -hiv /mnt/cdrom/rpms/sybase-ase i386.rpm Note The packages can be relocated during installation using the rpm(1) --relocate option. Refer to the rpm(1) manual pages for correct command line instructions. 7. When unloading is complete, unmount the CD from the drive at your # prompt by entering: # umount /dev/cdrom Remove the CD by entering: # eject You have now successfully unloaded Adaptive Server onto your system; however, you do not yet have a fully functional product. To continue, see What s Next? on page Unloading in an X-Windows Environment In an X-Windows environment, use the sybsetup utility to unload from CD. To unload Adaptive Server products: 1. Verify that your environment is set up as described in Pre- Unloading Tasks on page Place the Adaptive Server product CD in the CD-ROM drive. 3. If you are still logged in as the sybase user (from doing the pre-unloading tasks), log out. 3-4 Unloading Server Products from Distribution Media

43 Adaptive Server Enterprise Version Unloading in an X-Windows Environment 4. Log in as root to the UNIX system attached to the CD-ROM drive. You must have root permission to mount the CD. This login can be either local or remote. If you are running sybsetup from a machine that is not attached to the CD-ROM, you must log in remotely. 5. Mount the CD-ROM: # mount -t iso9660 /dev/cdrom /mnt/cdrom Note When you mount the CD using the /etc/fstab directive, make sure to enable the exec option. See the manual page on mount(8) for the directive. 6. Execute the sybsetup utility by entering the command: # /mnt/cdrom/sybsetup The sybsetup screen is displayed. Installation Guide for Linux/Intel 3-5

44 Unloading in an X-Windows Environment Adaptive Server Enterprise Version Note Depending on your platform, there may be slight differences between the screen image on your terminal and the screen image presented in this document. These differences do not affect the instructions provided. 7. Choose Unload Sybase Products from the sybsetup menu. Note jisql and ribo are not available on the Adaptive Server Enterprise CD. However, you can run jisql and ribo on Linux. These utilities are included on the PC Client CD. See the section titled Installing jisql and ribo on page 5-9 to learn how to install these products. The Installation Destination screen is displayed: 8. Verify that the location of the installation directory displayed by sybsetup is where you want to unload Sybase software. sybsetup displays the value of the SYBASE environment variable, which you should have set as described in Pre-Unloading Tasks on page 3-1. For new installations, this is the value you want to use. 3-6 Unloading Server Products from Distribution Media

45 Adaptive Server Enterprise Version Unloading in an X-Windows Environment WARNING! If you are unloading for an upgrade, you must change the installation directory location so that it is different from the value of your current installation; otherwise, the current installation will be overwritten, and the upgrade will fail. If the SYBASE environment variable is not set, set it as described in Pre-Unloading Tasks on page 3-1. To install in a location that is different from the location displayed by sybsetup, change the directory location displayed on the sybsetup screen. Changing the installation directory in sybsetup does not reset the SYBASE environment variable on your system. 9. Click continue (the checkmark button). The Installation Source Device screen is displayed. 10. Provide the device media and device location, and indicate whether the source device is local or remote. To specify a CD-ROM device: a. Select CD-ROM (if not already selected by default). b. Enter /mnt/cdrom/sybimage as the name of the CD-ROM image. c. Select Local for the source device location (if it is not already selected by default). Installation Guide for Linux/Intel 3-7

46 Unloading in an X-Windows Environment Adaptive Server Enterprise Version Click continue (the checkmark button). The Product Selection screen is displayed. 12. At the top of the Product Selection screen, verify that the installation directory, media device, and machine name are correct. If any part of this information is incorrect, return to the main menu of sybsetup and begin again. 13. Click each product you want to install. After you make a product selection, the Disk Space Available field indicates the available space remaining in the installation directory. If you unload any languages on Adaptive Server in addition to the language you specify as the default, you may need to extend your master database. Each server language requires 2 7MB in the master database. Note By default, Backup Server and XP Server are unloaded with Adaptive Server. 14. Click Continue to unload the products. sybsetup displays the Installation Status screen, which shows the progress of the unloading process. Note Unloading the software may take half an hour or more, depending on the performance of your machine and how many products you are unloading. The progress meter is known not to show the progress of installation in this release. 15. At the end of the unloading process, you are asked if you want to install the sybsetup executable in the $SYBASE/bin directory. This allows you to run sybsetup and invoke the setup utilities later without remounting the CD. 16. Click Yes or No, depending on whether you want to install sybsetup in $SYBASE/bin. The Success screen is displayed after sybsetup is successfully unloaded. 3-8 Unloading Server Products from Distribution Media

47 Adaptive Server Enterprise Version Installing the Java Runtime Environment 17. Unmount the CD-ROM: # umount /mnt/cdrom then enter: # eject 18. You have successfully unloaded Adaptive Server onto your system. To continue, see What s Next? on page To install jisql and ribo, see Installing jisql and ribo on page 5-9. To install the Java Runtime Environment, see Installing the Java Runtime Environment on page 3-9. Installing the Java Runtime Environment If the Java Runtime Environment is not already installed on your PC, you can install it from the PC Client CD. Follow these steps: 1. When the Sybase installation program displays, click Exit to quit the installer. 2. Start the Windows NT Explorer. 3. Click the CD-ROM drive name to display the CD s contents in the Explorer. 4. In the Windows Explorer, navigate to the java directory on the CD. 5. Double-click jre116i-win32.exe. 6. Follow the instructions from the self-extracting zip file. Installation Guide for Linux/Intel 3-9

48 What s Next? Adaptive Server Enterprise Version What s Next? To determine your next step, see Table 3-2. Table 3-2: To Do This Summary of steps after unloading Adaptive Server See Perform a first-time installation of: Adaptive Server Backup Server Monitor Server XP Server Install client products Upgrade an existing: Adaptive Server Backup Server Monitor Server XP Server Configure and use Historical Server Configure and use Monitor Client Library Chapter 4, Installing Sybase Servers Chapter 5, Installing Sybase PC-Client Products Chapter 6, Upgrading Sybase Servers Sybase Adaptive Server Enterprise Monitor Historical Server User s Guide Sybase Adaptive Server Enterprise Monitor Client Library Programmer s Guide 3-10 Unloading Server Products from Distribution Media

49 4 Installing Sybase Servers 4. This chapter provides instructions for installing a new Adaptive Server, Backup Server, Monitor Server, and XP Server. Topics covered include: Overview 4-1 Pre-Installation Tasks 4-3 Quick Start Installation 4-6 Custom Installation 4-16 Viewing the Installation Status Output Screen 4-31 Changing the Default Language and Character Set 4-31 Installation Complete 4-32 Resource File Installation 4-32 Post-Installation Tasks 4-36 What s Next? 4-37 For information on how to upgrade an existing server, see Chapter 6, Upgrading Sybase Servers. For information on how to install additional Adaptive Server products, see Chapter 5, Installing Sybase PC-Client Products. Overview After you have unloaded the Adaptive Server product files from the distribution media, you are ready to install one or more of the following Sybase servers: Adaptive Server Backup Server Monitor Server XP Server These products are described in Chapter 1, Overview. Installation Guide for Linux/Intel 4-1

50 Overview Adaptive Server Enterprise Version The basic process for installing Sybase servers is: 1. Perform the pre-installation tasks as described in Pre- Installation Tasks on page Perform the installation using any of the methods described in Installation Methods on page Perform the post-installation tasks as described in Post- Installation Tasks on page Installation Methods You can install Sybase servers by using any of the following methods: Quick Start installation use the srvbuild utility to install servers with minimum customizing, using only system defaults and required parameters. Use the Quick Start method to install: - A nonproduction prototype to test new features and functionality before going into production - A default server to be used for training purposes - A basic production server that requires no customizing to meet the needs of your site This method is described in Quick Start Installation on page 4-6 Custom installation use the srvbuild utility to install servers with full customization. This method allows you to override system defaults and adding parameters. Use this method to customize servers for a production environment. Fully customizing a server at installation time will reduce the need to make changes later. This method is described in Custom Installation on page 4-16 Resource file installation use the srvbuildres utility to install Adaptive Server and Backup Server at sites that want to install multiple identical servers. Also enables installation if X-Windows is not available. Monitor Server and XP Server cannot be installed using resource files. This method is described in Resource File Installation on page Installing Sybase Servers

51 Adaptive Server Enterprise Version Pre-Installation Tasks Pre-Installation Tasks Before installing the Sybase servers: 1. Read the Special Installation Instructions section in the release bulletin. 2. Verify that your operating system meets the release-level, RAM, and network-protocol requirements. The operating system requirements are fully documented in Chapter 2, Installation Requirements. 3. If you have not unloaded the Adaptive Server software from the CD onto your system, complete the procedures in Chapter 3, Unloading Server Products from Distribution Media. 4. Verify that your SYBASE environment variable is set to the Sybase installation directory. 5. Verify that $SYBASE/bin has been added to the PATH environment variable. 6. Install operating system patches, if required. Required operating system patches are described in the release bulletin for the product (Adaptive Server, Monitor Server, and so on). 7. Verify that your network is configured to run in loopback mode. Although Adaptive Server and Sybase client applications are installed on a machine that is not connected to a network, Sybase software uses the network software, which must be configured to run in loopback mode. If you are having connection problems, or if you want to verify your network configuration, follow these steps: a. Log in to your host machine with this UNIX command: telnet host This command gives you a login prompt for the same machine. b. Without logging out, log in to your host machine again, using the same command. c. Log out twice. If you cannot log in to the machine a second time, your network software is not properly configured to run in loopback mode. See the network software documentation, or consult your vendor. 8. Adjust shared memory segments. Installation Guide for Linux/Intel 4-3

52 Pre-Installation Tasks Adaptive Server Enterprise Version Depending on the number and types of devices you use for backup (dump) and recovery (load), you may need to adjust the shared memory segment parameter in the operating system configuration file to accommodate concurrent Backup Server processes. The default number of shared memory segments available for process attachments is Determine the location, type, and size of each database device. You must provide this information during the installation of Adaptive Server. Devices are operating system files or portions of a disk (called raw partitions) used to store databases and database objects. For details, see Determining the Location, Type, and Size of a Database Device on page 4-4. Note At this time, Linux does not provide raw device support or a setup for Asynchronous Disk I/O. The Sybase Adaptive Server Enterprise installation does allow you to target block devices. When support for raw partitions becomes available under Linux and under Adaptive Server Enterprise, use an unbuffered raw partition for a production system master device. This reduces the risk of compromised data recovery after an operating system or server crash. Determining the Location, Type, and Size of a Database Device Adaptive Server requires several database devices, as shown in Table 4-2. Table 4-2: Adaptive Server database devices Device Purpose Minimum Size Recommended Size and Type master Stores system databases 25MB 30MB Raw partition sysprocsdev (also called the sybsystemprocs device) Stores the sybsystemprocs database 45MB 60MB (plus any space for holding stored procedures that you have created) Raw partition sybsystemdb (optional) Required for two-phase commit 5MB 5MB Raw partition 4-4 Installing Sybase Servers

53 Adaptive Server Enterprise Version Pre-Installation Tasks Table 4-2: Adaptive Server database devices (continued) sybsecurity (optional) Required for auditing 0 5MB 7MB; more for specialized auditing Raw partition Do not run Adaptive Server on network-mounted devices, such as NFS- or RFS-mounted files, for these reasons: Network problems can cause serious data integrity problems because the network lies between Adaptive Server and the devices on which it writes. If the remote machine is down when you reboot Adaptive Server, and database devices cannot be activated, automatic recovery fails. Adaptive Server is suspended when the remote machine or network is down. You may need to repartition the disk you choose. Contact your operating system administrator for assistance. When preparing a raw partition device, follow these guidelines: Do not initialize a database device on the partition that contains your Sybase installation software, or you will destroy all existing files on that partition. A raw partition designated for use by Sybase cannot be mounted for use by the operating system for any other purpose, such as for file systems or swap space. To avoid any possibility of using a partition that contains the partition map, do not use cylinder 0. After a Sybase configuration utility or the disk init command has initialized a portion of a partition as a database device, you cannot use the partition for any other purpose. Any space left on the partition beyond the size specified for the device becomes inaccessible, unless you drop and re-create the device. For best performance, place the Sybase software and all disk devices, including the master device, on the same machine. Place the database device on a character device, because the Adaptive Server recovery system needs unbuffered system I/O. The character devices are in the /dev directory. Installation Guide for Linux/Intel 4-5

54 Quick Start Installation Adaptive Server Enterprise Version To determine whether a device is a block device or a character device, run ls -l on the /dev directory. In the left column, b (block) or c (character) appears. To choose a raw partition: 1. Determine which raw partitions are available. 2. Determine the sizes of the raw partitions. 3. From the list of available raw partitions, select a raw partition for each device, based on the size recommendations in Table 4-2 on page Verify with the operating system administrator that the partition you have chosen is available. 5. Make sure the sybase user has read and write privileges to the raw partition. Note For more information on choosing a raw partition, see your operating system documentation. Quick Start Installation With Quick Start installation, you can install Adaptive Server only, or you can install Adaptive Server and one or more of the other servers (Backup Server, Monitor Server, and XP Server), using only the system defaults and required fields. Use the Quick Start method to install: A nonproduction prototype to test new features and functionality before going into production A default server to be used for training purposes A basic production server that requires no customizing to meet the needs of your site For information on installing client products, see Chapter 5, Installing Sybase PC-Client Products. You can use the Quick Start installation method only if you: Perform the installation in an X-Windows environment Install the servers from the CD 4-6 Installing Sybase Servers

55 Adaptive Server Enterprise Version Quick Start Installation Use operating system files, not raw partitions, for system devices Will use only required server attributes and server defaults Beginning the Quick Start Installation Process The following procedure provides instructions for beginning the installation process for Adaptive Server and any other server products you unloaded, such as Backup Server. To complete the installation process, you will go to other sections as described in step 6 at the end of this procedure. To begin the Quick Start installation process: 1. Be sure that: - You are logged in as sybase. - Your environment is set up as described in Pre-Unloading Tasks on page You have performed the Pre-Installation Tasks on page Start the srvbuild utility in one of two ways: - Choose Build New Servers from the sybsetup menu, or - At the UNIX prompt, enter: $SYBASE/bin/srvbuild 3. From the srvbuild screen, choose the server type to be installed. Only the server types that were unloaded from the distribution media are displayed on the srvbuild screen. For example, if you did not unload Monitor Server, it will not appear on the srvbuild screen. Installation Guide for Linux/Intel 4-7

56 Quick Start Installation Adaptive Server Enterprise Version If this is a first-time installation for your site, you must choose Adaptive Server. You can choose all server types at once or any combination of server types. srvbuild consecutively displays the attributes screen for each server you choose, in the order listed on the screen. For example, if you chose Adaptive Server, Backup Server and XP Server, the attributes screen for Adaptive Server appears first. When you finish choosing the attributes for Adaptive Server, and click OK, the Backup Server attributes screen appears. When you are finished with that screen, the XP Server attributes screen appears. The Monitor Server attributes screen does not appear because you did not check the box for installing that product. 4. Provide a name for each server you are installing. srvbuild provides a default server name using the name of the machine on which you are installing. 5. Click OK. 6. Go to the section in this manual that describes the next part of the Quick Start installation process for the product you chose to install. If you chose: - Adaptive Server go to Continuing Quick Start Installation Adaptive Server on page Backup Server go to Continuing Quick Start Installation Backup Server on page Monitor Server go to Continuing Quick Start Installation Monitor Server on page XP Server go to Continuing Quick Start Installation XP Server on page Continuing Quick Start Installation Adaptive Server The following procedure assumes that you have completed the procedure in the section Beginning the Quick Start Installation Process on page 4-7. To continue installing Adaptive Server, complete the following procedure. 4-8 Installing Sybase Servers

57 Adaptive Server Enterprise Version Quick Start Installation To continue Adaptive Server installation: 1. If you selected Adaptive Server to be installed, the Adaptive Server attribute screen is displayed: 2. Provide an operating system file for the master and sybsystemprocs device paths: /op_system_dir/master.dat /op_system_dir/systemprocs.dat where op_system_dir is the name of the operating system directory you are going to use. srvbuild creates the master.dat and systemprocs.dat files for you. srvbuild displays a warning regarding the use of an operating system file for the master and sybsystemprocs device paths. If this Adaptive Server is not intended for production use, you can ignore this warning. 3. For the other attributes, use the default values provided. Installation Guide for Linux/Intel 4-9

58 Quick Start Installation Adaptive Server Enterprise Version Do one of the following: - To proceed to the attribute screen for the next server type, click OK. Then, go to the section in this manual that describes the next part of the Quick Start installation process for that server. If you chose: Backup Server go to Continuing Quick Start Installation Backup Server on page Monitor Server go to Continuing Quick Start Installation Monitor Server on page XP Server go to Continuing Quick Start Installation XP Server on page To create the server or servers you have specified, click Build Server. srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Continuing Quick Start Installation Backup Server The following procedure assumes that you have completed the procedure in the section Beginning the Quick Start Installation Process on page 4-7. To continue installing Backup Server, complete the following procedure Installing Sybase Servers

59 Adaptive Server Enterprise Version Quick Start Installation To continue Backup Server installation: 1. If you selected Backup Server to be installed, the Backup Server attribute screen is displayed: 2. Provide the Related Adaptive Server name that will use this Backup Server. If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear. The Adaptive Server you are creating is used as the related Adaptive Server. 3. Provide the Sybase System Administrator (SA) user name for the related Adaptive Server, or accept the default value. If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear. 4. Provide the Adaptive Server SA password. This is the password for the related Adaptive Server. Installation Guide for Linux/Intel 4-11

60 Quick Start Installation Adaptive Server Enterprise Version If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear. 5. For the other attributes, use the default values provided. 6. Do one of the following: - To proceed to the attribute screen of the next server type, click OK. Then, go to the section in this manual that describes the next part of the Quick Start installation process for that server. If you chose: Monitor Server go to Continuing Quick Start Installation Monitor Server on page XP Server go to Continuing Quick Start Installation XP Server on page To create the server or servers you have specified, click Build Server. srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Continuing Quick Start Installation Monitor Server The following procedure assumes that you have completed the procedure in the section Beginning the Quick Start Installation Process on page 4-7. To continue installing Monitor Server, complete the following procedure. Note You must install Monitor Server on the same machine as the Adaptive Server that is being monitored Installing Sybase Servers

61 Adaptive Server Enterprise Version Quick Start Installation To continue Monitor Server installation: 1. If you selected Monitor Server to be installed, the Monitor Server attributes screen is displayed: 2. Provide the Related Adaptive Server name. This is the name of the Adaptive Server that will be monitored by this Monitor Server. If the related Adaptive Server is created in the same srvbuild session as Monitor Server, this field does not appear. The Adaptive Server you are creating is used as the related Adaptive Server. 3. Provide the Sybase System Administrator (SA) user name for the related Adaptive Server, or accept the default value. If the related Adaptive Server is created in the same srvbuild session as Monitor Server, this field does not appear. 4. Provide the Adaptive Server SA password. This is the password for the related Adaptive Server. If the related Adaptive Server is created in the same srvbuild session as Monitor Server, this field does not appear. Installation Guide for Linux/Intel 4-13

62 Quick Start Installation Adaptive Server Enterprise Version For the other attributes, use the default values provided. The default value for Maximum Number of Connections is Do one of the following: - To proceed to the attribute screen of the next server type, click OK. Then, go to the section in this manual that describes the next part of the Quick Start installation process for that server. If you chose: XP Server go to Continuing Quick Start Installation XP Server on page To create the server or servers you have specified, click Build Server. srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Continuing Quick Start Installation XP Server The following procedure assumes that you have completed the procedure in the section Beginning the Quick Start Installation Process on page 4-7. To continue installing XP Server, complete the following procedure Installing Sybase Servers

63 Adaptive Server Enterprise Version Quick Start Installation To continue XP Server installation: 1. If you selected XP Server to be installed, the XP Server attributes screen is displayed: 2. Provide the Related Adaptive Server name that will be using XP Server. If the related Adaptive Server is created in the same srvbuild session as XP Server, this field does not appear. The Adaptive Server you are creating is used as the related Adaptive Server. 3. Provide the Sybase System Administrator (SA) user name for the related Adaptive Server, or accept the default value. If the related Adaptive Server is created in the same srvbuild session as XP Server, this field does not appear. 4. Provide the Adaptive Server SA password. This is the password for the related Adaptive Server. If the related Adaptive Server is created in the same srvbuild session as XP Server, this field does not appear. 5. For the other attributes, accept the default values provided. 6. To create the server or servers you have specified, click Build Server. Installation Guide for Linux/Intel 4-15

64 Custom Installation Adaptive Server Enterprise Version srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Custom Installation Follow the instructions in this section to do a customized installation of Adaptive Server, Backup Server, Monitor Server, or XP Server. Beginning the Custom Installation Process 1. Be sure that: - You are logged in as sybase. - Your environment is set up as described in Pre-Unloading Tasks on page You have performed the Pre-Installation Tasks on page Use the srvbuild utility to build a server. You can start srvbuild in one of two ways: - Choose Build New Servers on the sybsetup menu, or - At the command line, enter: $SYBASE/bin/srvbuild 3. From the srvbuild screen, choose the server type that you want to install. Only the server types that were unloaded from the distribution media are displayed on the srvbuild screen. For example, if you did not unload Monitor Server, it will not appear on the srvbuild screen Installing Sybase Servers

65 Adaptive Server Enterprise Version Custom Installation If you unloaded Monitor Server for SQL Server 11.0.x, it does not appear on the srvbuild screen. For information on how to install and configure this product, see the release bulletin for Adaptive Server Enterprise Monitor. If this is a first-time installation for your site, you must select Adaptive Server. You can choose all server types at once or any combination of server types in addition to Adaptive Server. srvbuild consecutively displays the attribute screen for each server you choose, in the order listed on the screen. 4. Provide a name for each server you install. srvbuild provides a default server name using the name of the machine you are installing on. You can change the default name. Server naming conventions are as follows: - The name should not exceed 30 characters. - The initial character must be a letter; the characters that follow must be letters, numbers, or underscores (_). - Characters not allowed include: Control characters, spaces, ampersands (&), asterisks (*), periods (.), and question marks (?). - Use a name that is descriptive of your intended use and unique to your network. - Use the extensions ( _back, _mon, _XP ) to relate other server types to Adaptive Server. - The XP Server name must be all uppercase. Although srvbuild does this for you automatically, you should be aware of this requirement in case you need to modify the XP Server name in the interfaces file. If you are installing a new Backup Server to accompany an upgraded Adaptive Server, follow these guidelines when choosing your Backup Server name: - If you are upgrading from version 11.x, do not change the name of Backup Server. The server names are stored in the interfaces file by srvbuild and are used by clients and other servers to establish communication. Installation Guide for Linux/Intel 4-17

66 Custom Installation Adaptive Server Enterprise Version Click OK. 6. Go to the section in this manual that describes the next part of the custom installation process for the product you chose to install. If you chose: - Adaptive Server go to Continuing Custom Installation Adaptive Server on page Backup Server go to Continuing Custom Installation Backup Server on page Monitor Server go to Continuing Custom Installation Monitor Server on page XP Server go to Continuing Custom Installation XP Server on page Continuing Custom Installation Adaptive Server The following procedure assumes that you have completed the procedure in the section Beginning the Custom Installation Process on page To continue installing Adaptive Server, complete the following procedure Installing Sybase Servers

67 Adaptive Server Enterprise Version Custom Installation To continue Adaptive Server installation: If you selected Adaptive Server to be installed, the Adaptive Server attribute screen is displayed: 1. Provide a location for the master device. For production systems, it is recommended that you use a disk partition, instead of an operating system file, for the master device. For example: /dev/disk_partition where disk_partition is the disk partition you are going to use. If you have not selected a disk partition location, see Pre- Installation Tasks on page 4-3. If you use an operating system file, see Continuing Quick Start Installation Adaptive Server on page 4-8 in the Quick Start Installation section. 2. Provide a size for the master device. The default value is the recommended size. Installation Guide for Linux/Intel 4-19

68 Custom Installation Adaptive Server Enterprise Version If you entered a disk partition as the master device, the master device size reflects the size of the disk partition. You do not need to change the size. If you entered an operating system file, you can change the size. You can provide a size that is less than the default size, but the minimum allowable size is 25MB. The maximum size is the size of the file system. 3. Provide a size for the master database. The default size is recommended. If you are adding additional server languages for localization, you will need an additional 2 7MB of space in the master database per language. 4. Provide a location for the sybsystemprocs device. For production systems, it is recommended that you use a disk partition, instead of an operating system file, for the sybsystemprocs device. For example: /dev/disk_partition where disk_partition is the disk partition you are going to use. It is also recommended that the sybsystemprocs device be located on a device separate from the master device. The sybsystemprocs database usually increases in size from release to release, thus taking space from the master device. If you have not selected a disk partition location, see Pre- Installation Tasks on page 4-3. If you use an operating system file, see Continuing Quick Start Installation Adaptive Server on page 4-8 in the Quick Start Installation section. Note sysprocsdev is the default system name for this device. However, it is frequently referred to as the sybsystemprocs device, as in the Adaptive Server attribute screen, since it stores the sybsystemprocs database. 5. Provide a size for the sybsystemprocs device. The default value is the recommended size. Because the sybsystemprocs database is constantly increasing in size, allow space for growth on the device Installing Sybase Servers

69 Adaptive Server Enterprise Version Custom Installation If you entered a disk partition as the sybsystemprocs device, the sybsystemprocs device size reflects the size of the disk partition. You do not need to change the size. If you entered an operating system file, you can change the size. You can provide a size that is less than the default size, but the minimum allowable size is 45MB. The maximum size is the size of the file system. 6. Provide a size for the sybsystemprocs database. The default is the recommended size. If the sybsystemprocs device is large enough you have the option of making the sybsystemprocs database larger to accommodate future growth. 7. Provide an error log path name. You can provide a path name other than the default path provided. 8. For Interfaces File Entry, specify the transport type, host name, and port number. These entities comprise the interfaces file entry. This entry defines how servers and clients find and communicate with each other on the network. srvbuild adds this entry to the interfaces file during the installation process. - Transport type the menu provides a list of network protocols supported by Sybase. TCP is the default. Some network protocols in the menu may not be valid for your platform. Check with your operating system administrator. - Host name do not change the host name. The host name is the machine name where you installed Adaptive Server. - Port number if you did not change the default protocol, the port number displayed is the first available port address. The port number you specify cannot be used for any purpose other than installing Adaptive Server. If you change the default port number, verify that the new port is not in use. If you selected a protocol other than the default, you may not be able to use the first available port number supplied. Check with the operating system administrator to see what port numbers are available. Installation Guide for Linux/Intel 4-21

70 Custom Installation Adaptive Server Enterprise Version Click Edit Advanced Adaptive Server Attributes if you want to: - Create a sybsystemdb device path for the sybsystemdb database. Define this attribute if you want to add two-phase commit functionality. See Chapter 7, Adding Optional Functionality to Adaptive Server. - Place shared memory files in a directory other than the default location under $SYBASE. - Change your default Backup Server. 10. Do one of the following: - To proceed to the attribute screen for the next server type, click OK. Then, go to the section in this manual that describes the next part of the custom installation process for that server. If you chose: Backup Server go to Continuing Custom Installation Backup Server on page Monitor Server go to Continuing Custom Installation Monitor Server on page XP Server go to Continuing Custom Installation XP Server on page To create the server or servers you have specified, click Build Server. srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Continuing Custom Installation Backup Server The following procedure assumes that you have completed the procedure in the section Beginning the Custom Installation Process on page To continue installing Backup Server, complete the following procedure Installing Sybase Servers

71 Adaptive Server Enterprise Version Custom Installation To continue Backup Server installation: 1. If you selected Backup Server to be installed, the Backup Server attribute screen is displayed: 2. Provide the Related Adaptive Server name. This is the name of the Adaptive Server that will use this Backup Server. If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear. The Adaptive Server you are creating is used as the related Adaptive Server. 3. Provide the Sybase System Administrator (SA) user name for the related Adaptive Server, or accept the default value. If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear. 4. Provide the SA password for the related Adaptive Server. If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear. Installation Guide for Linux/Intel 4-23

72 Custom Installation Adaptive Server Enterprise Version Determine the error log path name for Backup Server. Accept the default provided or provide another location. 6. Determine the location of the tape configuration file. Backup Server reads this file, when a dump command is issued, to determine the device type and characteristics of the dump device specified in the dump command. Having access to this information speeds up the dump (recovery) process. The default location is $SYBASE/backup_tape.cfg. 7. Specify the language you want Backup Server to use for its error messages. The default language is us_english. The language available depends on which Language Modules were downloaded from distribution media to your system. If you unload languages into Adaptive Server in addition to the language you specify as the default, you may need to extend your master database. Each language requires 2 7MB in the master database. 8. Specify the character set you want Backup Server to use. All character sets are installed by default. Other options are: - cp850: Code Page 850 (Multilingual) character set - cp437: Code Page 437 (United States) character set - mac: Macintosh default character set for Western European locales 9. Specify the maximum number of network connections. You can accept the default or change it. This option specifies the total number of network connections available if you are backing up (dump) or restoring (load) a database over the network to a remote Backup Server. This option is not necessary if you are dumping to the default Backup Server, which is local. 10. Specify the maximum number of server connections. You can accept the default or change it. This option specifies the number of server connections to Backup Server. Backup Server requires at least: - Two connections for each dump (backup) operation - One connection for each load (recovery) operation 4-24 Installing Sybase Servers

73 Adaptive Server Enterprise Version Custom Installation - One connection for volume change messages Allow a maximum of three times the number of expected concurrent dump and load sessions. 11. For the Interfaces File Entry attribute, specify the transport type, host name, and port number. These entities comprise the interfaces file entry. This entry defines how Backup Server and Adaptive Server find and communicate with each other on the network. srvbuild adds this entry to the interfaces file during the installation process. - Transport type The menu provides a list of network protocols supported by Sybase. TCP is the default. Some network protocols in the menu may not be valid for your platform. Check with your operating system administrator. - Host name The host name is the machine name where you installed Backup Server. - Port number If you did not change the default protocol, the port number displayed is the first available port address. The port number you specify cannot be used for any purpose other than Backup Server. If you change the default port number, verify that the new port is not already in use. Check with your operating system administrator. If you selected a protocol other than the default, you may not be able to use the first available port number. Check with the operating system administrator to see what port numbers are available. 12. Do one of the following: - To proceed to the attribute screen for the next server type, click OK. Then, go to the section in this manual that describes the next part of the custom installation process for that server. If you chose: Monitor Server go to Continuing Custom Installation Monitor Server on page XP Server go to Continuing Custom Installation XP Server on page To create the server or servers you have specified, click Build Server. Installation Guide for Linux/Intel 4-25

74 Custom Installation Adaptive Server Enterprise Version srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Continuing Custom Installation Monitor Server The following procedure assumes that you have completed the procedure in the section Beginning the Custom Installation Process on page To continue installing Monitor Server, complete the following procedure. To continue Monitor Server installation: 1. If you selected Monitor Server to be installed, the Monitor Server attribute screen is displayed: 2. Provide the Related Adaptive Server name. This is the name of the Adaptive Server that Monitor Server will be monitoring. This field does not appear, if the related Adaptive Server is created in the same srvbuild session as Monitor Server. The Adaptive Server you are creating is used as the related Adaptive Server Installing Sybase Servers

75 Adaptive Server Enterprise Version Custom Installation 3. Specify the Sybase System Administrator (SA) user name. This option is required unless the USER environment variable is set. This name specifies the user name of the Monitor Server superuser. It must be a valid login account for the Adaptive Server to be monitored. For production systems, it is recommended that you use the sa or sybase user account as the Monitor Server superuser. Monitor Server uses the superuser account to connect to Adaptive Server to run special stored procedures and to verify shutdown requests that can be performed only by the superuser. This field does not appear, if the related Adaptive Server is created in the same srvbuild session as Monitor Server. 4. Provide the Adaptive Server SA password for the Monitor Server superuser. If the password is omitted, Monitor Server prompts for a password during start-up. This field does not appear, if the related Adaptive Server is created in the same srvbuild session as Monitor Server. 5. Determine the maximum number of connections allowed to Monitor Server. Valid values are The default is 5. A connection to Monitor Server can be any of the following: - A monitor in Sybase Central, - An active Historical Server session or a scheduled Historical Server recording session, or - A connection to Monitor Server from a Monitor Client Library application. For example, if a user starts a Historical Server recording session, and another user opens the Performance Summary Monitor in Sybase Central, two connections to Monitor Server are used. If the default configuration of five connections is in effect, three additional connections to Monitor Server are available. 6. Specify the error log path. This is the path name of the Monitor Server log file, where informational and error messages are logged. Installation Guide for Linux/Intel 4-27

76 Custom Installation Adaptive Server Enterprise Version The default location is the directory from which Monitor Server is started and the error log name is ms.log. 7. Specify the path of the configuration file. This is the path name of the Monitor Server configuration file. A default configuration file is not provided. This file is optional, but if specified, the values in the configuration file override the default runtime parameters that are otherwise used by Monitor Server. 8. Specify the shared memory directory. This specifies the name of the directory where the adaptiveservername.krg shared memory file is located. If this parameter is omitted, Monitor Server looks for the shared memory file in the Sybase installation directory. The shared memory file name must be specified or implied when you start Adaptive Server and Monitor Server. 9. For the Interfaces File Entry attribute, specify the transport type, host name, and port number. These entities comprise the interfaces file entry. This entry enables Monitor Server and Adaptive Server to find and communicate with each other on the network. srvbuild adds this entry to the interfaces file during the installation process. - Transport type The menu provides a list of network protocols supported by Sybase. TCP is the default. Some network protocols in the menu may not be valid for your platform. Check with your operating system administrator. - Host name The host name is the machine name where you installed Monitor Server. - Port number If you did not change the default protocol, the port number displayed is the first available port address. The port number you specify cannot be used for any purpose other than installing the Monitor Server. If you change the default port number, verify that the new port is not already in use. If you selected a protocol other than the default, you may not be able to use the first available port number. Check with the operating system administrator to see what port numbers are available. 10. Do one of the following: 4-28 Installing Sybase Servers

77 Adaptive Server Enterprise Version Custom Installation - To proceed to the attribute screen for the next server type, click OK. Then, go to the section in this manual that describes the next part of the custom installation process for that server. If you chose: XP Server go to Continuing Custom Installation XP Server on page To create the server or servers you have specified, click Build Server. srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Continuing Custom Installation XP Server The following procedure assumes that you have completed the procedure in the section Beginning the Custom Installation Process on page To continue installing XP Server, complete the following procedure. To continue XP Server installation: 1. If you selected XP Server to be installed, the XP Server attribute screen is displayed: 2. Provide the Related Adaptive Server name. Installation Guide for Linux/Intel 4-29

78 Custom Installation Adaptive Server Enterprise Version This specifies the name of the Adaptive Server that will be using XP Server. This field does not appear, if the related Adaptive Server is created in the same srvbuild session as XP Server. The Adaptive Server you are creating is used as the related Adaptive Server. 3. Provide the Sybase System Administrator (SA) user name for the related Adaptive Server, or accept the default value. This field does not appear, if the related Adaptive Server is created in the same srvbuild session as XP Server. 4. Provide the SA password for the related Adaptive Server. This field does not appear, if the related Adaptive Server is created in the same srvbuild session as XP Server. 5. For the Interfaces File Entry attribute, specify the transport type, host name, and port number. These entities comprise the interfaces file entry. This entry enables XP Server and Adaptive Server to find and communicate with each other on the network. srvbuild adds this entry to the interfaces file during the installation process. - Transport type The menu provides a list of network protocols supported by Sybase. TCP is the default. Some network protocols in the menu may not be valid for your platform. Check with your operating system administrator. - Host name The host name is the name of the machine where you installed XP Server. - Port number If you did not change the default protocol, the port number displayed is the first available port address. The port number you specify cannot be used for any purpose other than installing the XP Server. If you choose to change the default port number, verify that the new port is not already in use. If you selected a protocol other than the default, you may not be able to use the first available port number. Check with the operating system administrator to see what port numbers are available for use. 6. To create the server or servers you have specified, click Build Server Installing Sybase Servers

79 Adaptive Server Enterprise Version Viewing the Installation Status Output Screen srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute. Go to Viewing the Installation Status Output Screen on page Viewing the Installation Status Output Screen Use the information in this section each time you click the Build Server button after specifying the attributes for the server. 1. Review the Status Output screen for informational messages about the installation process. If the installation is not successful, see Chapter 9, Troubleshooting. If the installation is successful, a message similar to the following is displayed in the Status Output screen: Server server_name was successfully created. Done. 2. If you installed Adaptive Server during this srvbuild session, go to Changing the Default Language and Character Set on page Changing the Default Language and Character Set WARNING! Make all changes to the character set and sort order for a new Adaptive Server before you create any user databases or make any changes to the Sybase-supplied databases. Changing the character set and sort order after data or data structures have been added to Adaptive Server can cause incorrect behavior. If you need to change the character set or sort order after you have added data, see the System Administration Guide. If you installed Adaptive Server, srvbuild displays a Srvbuild Question screen asking if you want to localize your Adaptive Server to a language other than us_english and if you want to use a character set or sort order other than the default. srvbuild creates an Adaptive Server with the following defaults: us_english language Installation Guide for Linux/Intel 4-31

80 Installation Complete Adaptive Server Enterprise Version Binary sort order Valid language options depend on the Language Modules you unloaded from distribution media. All character sets are installed by default. You have two options: Click No to accept the defaults, and then go to Installation Complete on page Click Yes to change the defaults. The sqlloc menu is displayed. sqlloc is the GUI utility used to change default languages, character sets, and sort orders. When you finish this task, go to Installation Complete on page For information on using sqlloc, see Chapter 5, Localization Issues, in Configuring Adaptive Server for UNIX Platforms. Installation Complete You have completed the installation process. Go to Post-Installation Tasks on page Resource File Installation You can create an Adaptive Server or Backup Server, using values specified in a resource file that defines the attributes for the server. Resource files allow you to create servers in batch mode. You can create servers on multiple systems from the same resource file by editing a few values in that file. Within a single resource file, you can create only one server at a time. Note You cannot install Monitor Server or XP Server using resource files. To install an Adaptive Server or Backup Server using resource files: 1. Edit a resource file as described in Editing a Resource File on page Execute the srvbuildres utility, using the edited resource file as described in Using srvbuildres on page Installing Sybase Servers

81 Adaptive Server Enterprise Version Resource File Installation Editing a Resource File You can edit a resource file by: Editing a sample resource file Editing the resource file created by the srvbuild utility Editing a Sample Resource File Sample resource files for creating Adaptive Server and Backup Server are included in your Adaptive Server distribution in $SYBASE/init/sample_resource_files. Edit these files to specify the attributes for the servers you want to create. Editing a Resource File Created by srvbuild You can create a resource file by running the srvbuild utility. A new file containing the values you specified for each server is written to $SYBASE/init/logs/srvbuildMMDD.VVV-servername.rs. Edit these files to specify the attributes for the servers you want to create. WARNING! Be sure to edit the resource file generated by srvbuild to change attributes, such as device names, that may be different on another system. Resource File Attributes for Adaptive Server Table 4-3 on page 4-34 shows the Adaptive Server resource file attributes, their default values, and other options. The attributes in bold type are required. All alpha values are case sensitive. The prefix of the attribute name varies, depending on whether the resource file was created by srvbuild or by sybinit (from a pre-11.5 SQL Server). The prefix is ignored by srvbuildres when processing the resource file. Installation Guide for Linux/Intel 4-33

82 Resource File Installation Adaptive Server Enterprise Version The attribute names in Table 4-3 are the attribute names provided in the sample resource file included in your Adaptive Server distribution. Table 4-3: Resource file attributes for Adaptive Server Attribute sybinit.release_directory sybinit.product sqlsrv.server_name sqlsrv.new_config sqlsrv.do_add_server (to interfaces file) sqlsrv.network_protocol_list sqlsrv.network_hostname_list sqlsrv.network_port_list sqlsrv.master_device_physical_name sqlsrv.master_device_size sqlsrv.master_database_size sqlsrv.errorlog sqlsrv.do_upgrade sqlsrv.sybsystemprocs_device_physical_name sqlsrv.sybsystemprocs_device_size sqlsrv.sybsystemprocs_database_size sqlsrv.sybsytemdb_device_physical_name sqlsrv.sybsystemdb_device_size sqlsrv.sybsystemdb_database_size sqlsrv.default_backup_server Default Value [Other Options] The value of $SYBASE at your site sqlsrv server_name yes (This is the required value.) yes [no] tcp [spx] hostname port_number path_and_name_of_master_device 30 (MB) 5 (MB) $SYBASE/install/server_name.log no (This is the required value.) path_and_name_of_sybsystemprocs_device 45 (MB) 60 (MB) recommended 45 (MB) 60 (MB) recommended path_and_name_of_ sybsystemdb_device 5 (MB) 5 (MB) server_name_back Resource File Attributes for Backup Server Table 4-4 shows the Backup Server resource file attributes, their default values, and other options. The attributes in bold type are required Installing Sybase Servers

83 Adaptive Server Enterprise Version Resource File Installation All values are case sensitive. The prefix of the attribute name varies, depending on whether the resource file was created by srvbuild or by sybinit (from a pre-11.5 SQL Server). The prefix is ignored by srvbuildres when processing the resource file. The attribute names in Table 4-4 are the attribute names provided in the sample resource file included in your Adaptive Server distribution. Table 4-4: Resource file attributes for Backup Server Attribute Default Value [Other Options] sybinit.release_directory sybinit.product bsrv.server_name bsrv.do_add_backup_server (to interfaces file) bsrv.network_protocol_list bserv.network_hostname_list bsrv.network_port_list bsrv.language $SYBASE bsrv server_name_back yes [no] tcp [spx] hostname port_number us_english [chinese, french, german, japanese, spanish] bsrv.character_set [iso_1, cp850, cp437, deckanji, ascii_8, eucgb, eucjis, mac, roman8, sjis, utf8] bsrv.tape_config_file $SYBASE/backup_tape.cfg bsrv.errorlog $SYBASE/server_name_back.log Using srvbuildres To execute srvbuildres from the UNIX prompt: $SYBASE/bin/srvbuildres -r resource_file where resource_file specifies the resource file containing the attributes that describe the server to build. Note Unlike srvbuild, the srvbuildres utility does not require any X libraries. Installation Guide for Linux/Intel 4-35

84 Post-Installation Tasks Adaptive Server Enterprise Version Resource File Installation Complete You have completed resource file installation. Go to Post- Installation Tasks on page Post-Installation Tasks After installing your servers, complete the tasks in this section. Verifying That Servers Are Running To determine whether the servers you installed are running: 1. Do either of the following: - For each server, enter the following command at the UNIX prompt: $SYBASE/bin/isql -Usa -P -Sserver_name where server_name is the name of the server you want to check. If the server is running, you will see the isql prompt: 1> - At the UNIX prompt, enter: $SYBASE/install/showserver showserver shows how many Adaptive Server-related processes are on the system. Setting the Sybase System Administrator Password A user account called sa is created for the Sybase System Administrator when the Sybase software is installed. (See User Roles on page 1-1.) A user logged in as sa can use any database on Adaptive Server, including master, with full privileges. Immediately after a new installation, there is no password on the sa account. The initial default value for the password is NULL. In a production environment, the Sybase System Administrator should always use a non-default password Installing Sybase Servers

85 Adaptive Server Enterprise Version What s Next? The Sybase System Administrator should log in to the new Adaptive Server as sa and set a password with the sp_password system procedure: $SYBASE/bin/isql -Usa -P -Sserver_name 1> sp_password null, new_password 2> go Information Required for XP Server If you install Adaptive Server and XP Server in the same build session, srvbuild automatically adds information about the XP Server to the sysservers table of Adaptive Server. If you install XP Server in a different build session than the Adaptive Server installation, you are prompted during the XP Server installation process to supply the name of the related Adaptive Server and the System Administrator s name and password. This information is required by Adaptive Server to start XP Server. If you do not supply this required information during the installation process, XP Server cannot run. When you execute an extended stored procedure (ESP), you will see an error message similar to the following: Msg 11018, Level 16, State 1: Procedure 'xp_cmdshell', Line 2 XP Server must be up for ESP to execute. To add this required information to the sysservers table manually: 1. Run the following system procedure: sp_addserver servername_xp, NULL, servername_xp where servername is the name of the Adaptive Server. What s Next? For information on the using the servers you installed, see the following sections: Adaptive Server You have a running server, as well as various system databases and system tables. Some references that may help you get started using your new Adaptive Server are as follows: Installation Guide for Linux/Intel 4-37

86 What s Next? Adaptive Server Enterprise Version For an overview of Adaptive Server, see Introducing Sybase Adaptive Server for UNIX Platforms. To create an Adaptive Server user database and its devices, see Initializing Database Devices and Creating User Databases in the System Administration Guide. To write queries, see the Transact-SQL User s Guide. Backup Server For information on developing a backup and recovery plan and backing up and restoring user databases, see the System Administration Guide. Monitor Server Monitor Server requires some additional configuration after installation. See the Adaptive Server Enterprise Monitor Server User s Guide. XP Server For information on using extended stored procedures, see the Transact-SQL User s Guide Installing Sybase Servers

87 5 Installing Sybase PC-Client Products 5. Your UNIX-based Adaptive Server also includes PC-client products that you install on a PC and connect, via the interfaces file, with your Adaptive Server. This chapter describes how to install client products on Windows 95 and Windows NT 4.0. Topics covered include: Preinstallation Task 5-1 Installing PC Clients 5-1 Configuring Network Connections for Client Products 5-4 Installing the Adaptive Server Plug-In for Sybase Central 5-6 What s Next? 5-12 Preinstallation Task Before starting the installation process for PC-client products, be sure that the drive on which you install the products has at least an extra 2.4MB of disk space, and includes the \temp directory and TEMP environment variable. The installation program uses the extra space and directory to write files temporarily during the installation. The installation program frees this space after installation is complete. Installing PC Clients To install client products on Windows NT or Windows 95: 1. Verify that your computer has sufficient RAM for each product. See Chapter 2, Installation Requirements. 2. If you are installing on Windows NT, log in using an account with Windows NT administrator privileges. 3. Close any open applications or utilities to free memory and system resources. 4. Insert the CD containing the PC-client products into the CD-ROM drive. Installation Guide for Linux/Intel 5-1

88 Installing PC Clients Adaptive Server Enterprise Version Start the installation program by using one of the following methods: - Click the Start button, choose Run, and enter: n:\setup.exe where n is your CD-ROM drive. - Click the Start button, choose the Windows Explorer, select your CD-ROM drive, and then double-click the setup.exe file. The Welcome window is displayed. 6. Click Next. The Select Installation Type window is displayed: 7. Choose Licensed Products, and click Next. The Select Sybase Installation Directory is displayed. Do not change the default Sybase Installation Directory value. The default directory is either the value of the SYBASE environment variable, if set, or c:\sybase. This directory should not be located on a network drive. You can specify another local disk drive if it has at least 15MB space more than the amount required for installation. The installation program will download files to this directory. 8. Click Next. The Select a Program Folder window is displayed. 5-2 Installing Sybase PC-Client Products

89 Adaptive Server Enterprise Version Installing PC Clients Do not change the default Program folder. The installation program will create a program folder, named Sybase, in which to place icons. Click Next. The Product Selection window is displayed: 9. Click the box next to each product to be installed. The installation program will install each product you select. The Product Selection window provides the following information: - Available disk space. - Disk space required for all products selected. - Product description for each highlighted product, as it is selected. - Options for products that have a plus sign (+) to the left. To expand the tree, click the plus sign. 10. Click Next. The Installation Summary window is displayed. 11. Check the Installation Summary window to be sure the products selected are correct. Installation Guide for Linux/Intel 5-3