Sybase Adaptive Server Enterprise 12.5.x Quick Installation Manual

Mac os x
Table of Contents

Advertisement

Quick Links

Quick Installation Guide

Adaptive Server Enterprise
12.5.x
Mac OS X

Advertisement

Table of Contents
loading

Summary of Contents for Sybase Adaptive Server Enterprise 12.5.x

  • Page 1: Quick Installation Guide

    Quick Installation Guide Adaptive Server Enterprise 12.5.x Mac OS X...
  • Page 2 Copyright © 1989-2002 by Sybase, Inc. All rights reserved. This publication pertains to Sybase 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.
  • Page 3: Table Of Contents

    Viewing servers that are running on your network ......17 Verifying that you can connect to servers ........18 Connecting to Adaptive Server via Sybase Central ....... 21 Setting the System Administrator password........21 Starting and stopping Adaptive Server........... 22 Rebuilding Adaptive Server............
  • Page 4 Configuring trap generation from Adaptive Server ....30 Troubleshooting the installation ............. 31 Uninstalling Sybase software ............32 Further reading................32 CHAPTER 2 Sybase Software Asset Management .......... 33 SySAM overview ................33 Adaptive Server base license............33 Adaptive Server check-out procedure..........34 Utilities..................35 Starting Adaptive Server with optional features ......
  • Page 5: About This Book

    Instructions for installing optional Adaptive Server functionality, such as auditing, and sample databases, and localization information Audience This guide is written for Sybase System Administrators and other qualified personnel who are familiar with their system’s environment, networks, disk resources, and media devices.
  • Page 6 • Transact-SQL User’s Guide – documents Transact-SQL, Sybase’s enhanced version of the relational database language. This manual serves as a textbook for beginning users of the database management system. This manual also contains descriptions of the sample pubs2 pubs3 databases.
  • Page 7 Monitor Client Library Programmer’s Guide – describes how to write Monitor Client Library applications that access Adaptive Server performance data. Other sources of Use the Sybase Technical Library CD and the Technical Library Product information Manuals Web site to learn more about your product: •...
  • Page 8 Specify a time frame and click Go. Select a product. Click an EBF/Update title to display the report. To create a personalized view of the Sybase Web site (including support pages) Set up a MySybase profile. MySybase is a free service that allows you to create a personalized view of Sybase Web pages.
  • Page 9 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.
  • Page 11: Chapter 1 Installing Adaptive Server

    • Hard disk – At least 700MB of available disk space. Preinstallation system setup The following items are predetermined by the installer: • Installation directory – /Applications/Sybase • Hostname – yourhost (obtained dynamically via ‘hostname -s’ • Adaptive Server name, port number – hostname_ASE, 11222 •...
  • Page 12: Upgrading From The Early Adopter Release

    Preinstallation system setup • device pathname – master /Applications/Sybase/System/devices/master.dat • device size – 100MB master • device pathname – sybsystemprocs /Applications/Sybase/System/devices/sybprocs.dat • device size – 160MB sybsystemprocs • Server page size – 4096 bytes • Server default character set – iso_1 Upgrading from the early adopter release Upgrading from the Early Adopter release is not supported.
  • Page 13: Installing From A Cd

    (NFS-mounted file system), and then review “Installation on Xserve” on page 10. Downloading the software The Sybase Web site is located at http://www.sybase.com/mac Select the Download Now button. You are asked to answer a few questions and provide registration information.
  • Page 14: Installation

    Xserve” on page 10. Installation This section describes the steps required to install Adaptive Server on Mac OS Figure 1-1shows the Introduction page, which identifies this package as the Sybase Adaptive Server. To move to the next page, click Continue.
  • Page 15 You see the Read Me notes, which you can print, save, or read by using the scroll bar on the right. These notes are important, and Sybase recommends that you make a hard copy of these notes by clicking the Print button.
  • Page 16 Installation Figure 1-3: Software license agreement To continue with the installation, click Agree to accept the terms of the license agreement. If you select Disagree, the installer reverts to the previous window. Figure 1-4: Accepting the software license agreement From the next window, select Macintosh HD (which may vary on some machines.) This is the required boot device.
  • Page 17 Click Install to proceed. If you try to install this package a second time, this button changes to Upgrade. If you click Upgrade, the software is copied from the package into the release location at /Applications/Sybase, but no server is initialized and started.
  • Page 18 Figure 1-7: Processing Adaptive Server The installer is now running Sybase scripts that initialize a database, install Sybase provided stored procedures, and leave the server up and running when complete. This stage can take 5 – 10 minutes.
  • Page 19 Installing Adaptive Server Figure 1-8: Processing databases and stored procedures You are finished. Sybase Adaptive Server Enterprise is now ready for your use. Click on Close, and the installer exits. A record of the installation has been saved in /Library/Receipts/Sybase_ASE_12502.pkg.
  • Page 20: Installation On Xserve

    Installation on Xserve Figure 1-9: Finishing the installation Installation on Xserve To install Adaptive Server on Xserve running in a “headless” mode (without a monitor,) you have two options: • Use the command line installer. Place the disk image containing the installation package on a disk volume accessible to Xserve.
  • Page 21: Release Contents

    • Sybase Server Discovery – uses Rendezvous technology to display the name and location of all servers running on your network. Each Sybase server registers itself with Rendezvous when it starts, and Sybase Server Discovery shows you where each of these servers is located. Also, the Configuration option allows you to automatically generate and update entries in the interfaces file, for each server selected in the list.
  • Page 22: Features Not Yet Available

    Post-installation tasks • Backup Server • XP Server • ODBC driver from Open Link Software, Inc. Features not yet available Some of the JAdaptive Server features provided for other UNIX platforms are not available yet on Mac OS X, including: •...
  • Page 23: Entering License Keys

    Installing Adaptive Server • Viewing servers running on your network • Verifying that you can connect to servers • Connecting to Adaptive Server via Sybase Central • Setting the System Administrator password • Starting and stopping Adaptive Server • Reinitializing Adaptive Server •...
  • Page 24 Entering license keys Figure 1-10: License Entry icon You are asked whether you have a Sybase Software Asset Management Certificate. You should have the printed certificate(s) in front of you. Click Yes to continue. If you do not have license certificates to enter, click No and proceed to the next section, “Entering Network License Management...
  • Page 25 Execute the startd.sh script located in /Applications/Sybase/Systems/SYSA-1_0 from the terminal window. The license daemon needs to be started after the system is restarted. If you click No, when asked whether you have any Sybase Software Asset Management Certificates to enter, the following screen is displayed.
  • Page 26: Environment Variables

    “Sybase Software Asset Management” for more details. Environment variables Add entries to your login script (.login) so that Sybase environment variables area always set. An example of this is contained in /Applications/Sybase/System/SYBASE.csh. If you do not have a .login script in your home directory, you can use the .cshrc file.
  • Page 27: Viewing Servers That Are Running On Your Network

    Rendezvous technology, so that any Rendezvous client can discover what services are available. We have provided a service discovery tool for Sybase servers, called Server Discovery. Click Server Discovery from the Finder: Figure 1-14: Service discovery tool...
  • Page 28: Verifying That You Can Connect To Servers

    Verifying that you can connect to servers Figure 1-15: Server Discovery text file You can use its Configuration menu item to automatically update the Sybase interfaces file for those servers that you have highlighted in the window. In addition, the sample program ctos, in /Applications/Sybase/System/OCS- 12_5/sample/srvlibrary, contains an example of how to register an Open Server™...
  • Page 29 CHAPTER 1 Installing Adaptive Server Figure 1-16: jISQL icon Attempt to connect when you see the login screen: In the login window, enter: • Username – sa • Password – leave blank • Hostname – servername_ASE • Portnumber – 11222...
  • Page 30 Verifying that you can connect to servers Figure 1-17: jISQL login screen If you can connect successful, you see a window that looks like this: Figure 1-18: Post-connection screen If you see an error message instead of this window, use the Process Viewer or Server Discovery to determine whether or not the server is actually running.
  • Page 31: Connecting To Adaptive Server Via Sybase Central

    See “Setting the System Administrator password” on page 21 for more information. Sybase Central has online help files. To access the online help for a server, right-click the server icon, and select Online Help from the drop-down list. To access online help for Sybase Central, select Help from the menu bar, then select Sybase Central Help.
  • Page 32: Starting And Stopping Adaptive Server

    Once the server is stopped, you can restart it in one of two ways: • Open the Terminal window, and execute the command found in startserver /Applications/Sybase/System/ASE-12_5/install: startserver -f RUN_hostname_SYBASE • From the Finder, double-click the Start_servername.command file in /Applications/Sybase. The command file is recognized by the Finder as a shell script.
  • Page 33: Rebuilding Adaptive Server

    You need to change the size of the pages within the database. You can rebuild the server in one of two ways: • Using the bootstrap shell script in /Applications/Sybase/System/ASE- 12_5/install – you can edit this script to take action as necessary. The script installs a new server using which is driven by a resource file.
  • Page 34: Changing The Default Character Set And Sort Order

    You can charset use this utility only from the UNIX shell, so you must open a Terminal window. The utility is found at /Applications/Sybase/System/ASE-12_5/bin/charset. To change Adaptive Server’s defaults: Run the utility to add the character set to Adaptive Server’s system charset catalogues.
  • Page 35: Default Device For The Sybsyntax Database

    , see the Reference Manual. This script sp_syntax includes syntax information for Transact-SQL, the system procedures, and the Sybase utilities. When you execute this script, you install the SQL portion of database. sybsyntax When you first execute this script, it creates the...
  • Page 36 • Execute: isql -Usa -Ppassword -Sservername -i$SYBASE/$SYBASE_ASE/scripts/ins_syn_sql where sa is the user ID of the System Administrator, password is the System Administrator’s password, and servername is the Adaptive Server on which you plan to install the database. To ensure that you have installed the...
  • Page 37: Sybase Xp Server

    Starting Sybase services automatically By copying some files to the system’s /Library/StartupItems directory, you can ensure that Sybase services automatically start when your system starts opr restarts. In /Applications/Sybase/System/Install/StartupItems, more the following directories to /Library/StartupItems to enable the associated services to automatically start when the system is restarted: •...
  • Page 38: Sybase Snmp Subagent

    Installation Net-SNMP Master Agent The sybase SNMP Subagent uses the Agent X protocol for extending the capabilities of a master agent. It works with any master agent that implements the Agent X protocol. Included with this subagent is a distribution of the Net- SNMP master agent.
  • Page 39: Sybase Subagent

    Sybase subagent.Typically, the subagent resides on the same machine as the monitored server. The snmpagent.cfg file contains documentation for configuration settings. To test the Sybase subagent, you can start it from the command line by executing: java -jar $SYBASE/SNMP-1_0/lib/SybaseAgent \ -c $SYBASE/SNMP-1_0/snmpagent.cfg...
  • Page 40: Configuring Trap Generation From Adaptive Server

    Configuring trap generation from Adaptive Server The Sybase subagent allows a Sybase server to generate a trap through a remote procedure call, . When the remote procedure is called, a sp_errornotify trap is generated containing the values in its parameters.
  • Page 41: Troubleshooting The Installation

    CHAPTER 1 Installing Adaptive Server • The Sybase subagent maintains a table of the most recent 500 errors raised through . These values can be retrieved from the sp_errornotify aseErrorTable table definition in SYBASE-MIB. Troubleshooting the installation Please refer to the Release Bulletin for a complete list of known problems. If you cannot connect to the server, there are several things that you should check: •...
  • Page 42: Uninstalling Sybase Software

    /Applications/Sybase/System/Install. This script removes everything in /Applications/Sybase. Use it carefully. Note If you have set up your system to automatically restart Sybase services, these StartupItems are also deleted. Finally, the receipt for the installation, found in /Library/Receipts is removed. uninstall requires a single argument,...
  • Page 43: Chapter 2 Sybase Software Asset Management

    Adaptive Server features, add new licenses to existing servers, set up the license manager in a network environment, and set up redundant servers for high availability and failover using Sybase Software Asset Management (SySAM). You need to refer back to this chapter when you begin intalling Adapive Server in a network environment.
  • Page 44: Adaptive Server Check-Out Procedure

    Adaptive Server check-out procedure When you start Adaptive Server version 12.5, it attempts to locate the license file license.dat located in $SYBASE/$SYBASE_SYSAM/licenses. If the file does not exist, Adaptive Server looks for the license file specified in the environment variable LM_LICENSE_FILE.
  • Page 45: Utilities

    , to manage licensing activities, and two daemons – the license lmutil management daemon ( ) and the vendor daemon (SYBASE). The lmgrd daemons handle requests to check in or check out licensed features. Using information in the license file, Adaptive Server connects to SySAM and attempts to check out a license (ASE_SERVER or ASE_SBE) for the base Adaptive Server product.
  • Page 46: Types Of Sysam Systems

    Adaptive Server check-out procedure Table 2-1: Configuration parameters for optional features Configuration Feature name License name parameter Java in ASE ASE_JAVA enable java External File System ASE_XFS enable file access By default, the configuration parameters for optional features are set to 0 (off). To enable an optional feature use to set its configuration sp_configure...
  • Page 47: Sysam In The Network Environment

    CHAPTER 2 Sybase Software Asset Management As part of a failover plan or a load-balancing system, Redundant servers you can have multiple servers running on the same Adaptive Server configuration, using a redundant license across all servers. The redundant server system can be connected by a local-area network (LAN) or by a wide- area network (WAN).
  • Page 48: Sysam Administration

    For each machine in the redundant system enter the license information using the License Entry application. The certificate information is provided in you Adaptive Server package on a printed Sybase Software Asset Management Certificate. After the installation is completed, and for each server in the redundant system, set the LM_LICENSE_FILE environment variable to: "port@machine:port@machine:port@machine"...
  • Page 49: Starting The Software Manually

    Starting SySAM as an automatic service To start the SySAM sofware automatically when the system is starting, see “Starting Sybase Services Automatically” in this document. Adding feature licenses This section describes how to update the license file to enable Adaptive Server features.
  • Page 50 SySAM administration...
  • Page 51: Index

    Index changing sort order Adaptive Server changing language base license character set check-out procedures check-out procedures connecting via Sybase Central command line installer default character set Component Integration Services optional features configuration page size hard disk starting memory stopping contents...
  • Page 52 Index LDAP license agreement full-text search License Entry license keys entering hard disk configuration headless systems high availability Mac OS X Historical Server system requirements host name Macintosh HD manually starting SySAM master device pathname master device size memory requirements installation MIB files downloading software for...
  • Page 53 System Administrator starting Adaptive Server path stopping Adaptive Server for master device stopping the installation pathname Sybase Central for sybsystemprocs Sybase Server Discover port number SybaseCentral of Adaptive Server sybmigrate of Backup Server sybsyntax database of XP Server sybsystemprocs device pathname...
  • Page 54 Index viewing servers XP Server 12, 27 XP Server name XP Server port number Xserve...

Table of Contents