Developer Edition ..............7 Adaptive Server specifications ............7 Product descriptions and directory layout ........8 Sybase support for ADO.NET, OLE DB, and ODBC....10 PC-Client product descriptions and directory layout ...... 11 Separately installable PC-Client products ....... 12 CHAPTER 2 Installing Adaptive Server ............
Page 4
Post installation instructions ............39 Verifying that servers are running ..........40 Verifying that you can connect to servers ........41 Connecting to Adaptive Server via Sybase Central ....... 42 Setting the System Administrator password ........42 The SAMreport ................43 Installing sample databases............
Page 5
Recovering from a failed upgrade ..........88 CHAPTER 6 Troubleshooting SySAM Issues ..........91 Calling Sybase technical support for SySAM-related issues ..91 Where to look for SySAM-related errors ........92 Troubleshooting SySAM ..............93 SySAM grace mode ............... 98 SySAM grace period ..............
Page 6
Contents Silent installation ................124 Configuration using resource files ..........126 Configuring from a resource file ..........126 Resource file variables ............128 Running the sybatch utility ............ 129 Upgrading Servers with Replicated Databases ......131 AP PE ND IX B Introduction ..................
About This Book The Installation Guide for Sybase Adaptive Server Enterprise for 15.0.2 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™, jConnect™...
Page 8
A more recent version of the release bulletin may be available on the World Wide Web. To check for critical product or document information that was added after the release of the product CD, use the Sybase Technical Library. •...
Page 9
• Component Integration Services User’s Guide – explains how to use the Adaptive Server Component Integration Services feature to connect remote Sybase and non-Sybase databases. • The Configuration Guide for your platform – provides instructions for performing specific configuration tasks for Adaptive Server.
Page 10
• Using Sybase Failover in a High Availability System – provides instructions for using Sybase Failover to configure an Adaptive Server as a companion server in a high availability system. • Unified Agent and Agent Management Console – Describes the Unified Agent, which provides runtime services to manage, monitor and control distributed Sybase resources.
Page 11
SAMreport, a report generator that helps you monitor the usage of applications that use FLEXnet licensing. Other sources of Use the Sybase Getting Started CD, the SyBooks CD, and the Sybase Product information Manuals Web site to learn more about your product: •...
Page 12
• The Sybase Product Manuals Web site is an online version of the SyBooks CD that you can access using a standard Web browser. In addition to product manuals, you will find links to EBFs/Maintenance, Technical Documents, Case Management, Solved Cases, newsgroups, and the Sybase Developer Network.
Page 13
EBF/Maintenance releases because you are not registered as a Technical Support Contact. If you have not registered, but have valid information provided by your Sybase representative or through your support contract, click Edit Roles to add the “Technical Support Contact”...
Page 14
Section 508 and W3C standards. 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.
• For information about installing Adaptive Server and its components, see Chapter 2, “Installing Adaptive Server” and Chapter 4, “Installing Sybase PC-Client Products.” For post-installation tasks see Chapter 3, “Post-Installation Tasks.” • For information about upgrading Adaptive Server from previous versions, see Chapter 5, “Upgrading Adaptive Server.”...
80/support/kb/articles/Q259/4/03.ASP&NoWebContent=1 Product licensing with SySAM 2.0 Starting with Adaptive Server Enterprise version 15.0, the Sybase Software Asset Management System (SySAM) implementation has changed. With these changes, SySAM configuration is no longer optional, and requires some changes in the Adaptive Server installation and configuration process. Review the updated SySAM implementation and plan your SySAM deployment before you install Adaptive Server Enterprise.
CHAPTER 1 Overview The Adaptive Server Installation Guide (this document) has the following information about SySAM-related tasks: • Installation instructions are described in “Installing components with the Installer in GUI mode” on page 27. • If you have problems, see Chapter 6, “Troubleshooting SySAM Issues.” •...
Product components All server processes share two distinct areas of shared memory: a kernel area and a DBMS area. The kernel area contains data structures that relate to task management and operating system services, while the DBMS component contains caches of database buffers, object descriptors, and other resources used by the DBMS component of the server process.
CHAPTER 1 Overview Stored procedures Stored procedures encapsulate a series of SQL commands that the server can execute as a single command. System stored procedures (SSPs) are created when the server is installed. The client A client uses functions provided by the CT-Library (CT-Lib) and Common Library (CS-Lib) APIs to establish a connection to the server, submit requests to the server, and receive results back from the server.
Developer Edition – has a limit on scalability and includes many of the options. Sybase also offers a series of options that you must purchase separately. Some of these options are intended for an enterprise-level site, and are not available in the Small Business Edition.
CHAPTER 1 Overview Developer Edition The Developer Edition (DE) is a competitively-priced version of Adaptive Server that developers can use to create applications in their development environment. The Developer Edition includes a full set of Adaptive Server Enterprise features and options (that is, DTM, High Availability, and so on), and allows for the following configuration: •...
Product descriptions and directory layout The Adaptive Server installation installs a wide array of software products into the SYBASE directory. Table 1-3 provides a brief description of the server products installed, and the top-level directory structure. Starting with ASE 15.0.2, the Enhanced Full-Text Search (EFTS) Note optional product will be not be shipped with ASE.
Page 23
Installed into the WS-15_0 directory. An optional product that provides access to Adaptive Server using HTTP/SOAP and WSDL. Agent Management This is a Sybase Central plug-in that manages the Unified Agent. It is installed into Console the AMCP directory. Installation Guide Evaluation Version...
The retired OLE DB Driver Kit was installed in %SYBASE%\OLEDB, and used the provider short name of “Sybase.ASEOLEDBProvider” and the long name of “Sybase ASE OLE DB Provider”. The new ASE OLE DB Provider by Sybase is installed in %SYBASE%\DataAccess\OLEDB, and uses provider short name “ASEOLEDB”.
In earlier versions, this directory was named shared-1_0. components • Sybase Central – Sybase Central is a Java-based framework used by the system management tools. In earlier versions, this component was placed into a top-level directory rather than in a shared directory.
Installed into the jConnect-6_0 directory. Provides a Java Database Connectivity (JDBC) driver for Adaptive Server. Agent Management This is a Sybase Central plug-in that manages the Unified Agent. It is installed into Console the AMCP directory. Interactive SQL Interactive SQL is a GUI tool that allows you to execute SQL statements, build scripts, and display data from Adaptive Server.
If you do not install a valid license for your configuration in this grace period, the product ceases to function. For general information about SySAM 2.0, see the Sybase Software Asset Management User’s Guide. Perform the pre-installation tasks as described in “Pre-installation tasks for Adaptive Server”...
System requirements Perform the installation using any of the methods described in “Installation methods” on page 27. Perform the post-installation tasks as described in Chapter 3, “Post- Installation Tasks.” System requirements Check to make sure your system has the required version-level, RAM, and network-protocol requirements for Adaptive Server.
For information about served and unserved licenses, and which model is best suited for your environment, see Chapter 2, “Choosing a License Model” in the Sybase Software Asset Management User’s Guide. If you plan to use a served license, you need a license server. Decide whether it will be an existing license server or a new license server.
SPDC, see “Generating licenses at SPDC” on page 18. Accessing SPDC Once you have purchased a Sybase product, typically you are expected to download the product and generate its licenses from the online Web portal, the Sybase Product Download Center (SPDC.)
CHAPTER 2 Installing Adaptive Server Once you have ordered a Sybase product you receive a welcome e-mail that contains a URL to the SPDC site, as well as a user name and password. If you have purchased your Sybase software from a Sybase reseller, Note you will receive a web key rather than an e-mail.
Select the product family that contains the product for which you wish to generate a license. A list of available Sybase products displays. Click the product with the appropriate edition and version. Make sure you select the product for the operating system you are using.
Page 33
“Generating an unserved license” on page 20. Note Some Sybase Products or specific license types do not give you a choice of license model to use, and therefore do not display this page. If this is the case, proceed with the SySAM license generation wizard to generate your license.
Page 34
You must save your license files with a .lic extension, or SySAM 2.0 Note will not recognize them. Sybase recommends that you setup the license server and required licenses before you install your SySAM 2.0 enabled Sybase product. Generating an unserved license To generate an unserved license: Select Un-served License and click Next.
Insert the CD into the CD drive. The Installer should start automatically. If it does not, start the setup program manually by selecting Start | Run. Browse to setup.exe. Launch the Sybase installer program by entering: setup The Welcome Window displays. Click Next.
Page 36
“Generating licenses at SPDC” on page From command prompt navigate to installed directory Source/Execute to setup the environment variables. • ASE150.bat Copy the license file in the %SYBASE%\%SYBASE_SYSAM%\licenses directory on the network license server machine. Refresh or restart the license server: Change to: %SYBASE%\%SYBASE_SYSAM%\bin...
Ltd. and/or Macrovision Corporation. All Rights Reserved. Flexible License Manager status on Wed 5/24/2006 15:04 License server status: 27000@mysysamserver License file(s) on keyserver: /opt/sybase/SYSAM_0/licenses/mysysamserver_60302031 5.lic For more information, see Chapter 6, “Troubleshooting SySAM Issues.” Pre-installation tasks for Adaptive Server Before installing Adaptive Server: Read the release bulletins for the latest information on the products (Adaptive Server, Monitor Server, and so on) that you are installing.
Page 38
Review the SySAM procedures and plan your client/server configuration using the configuration guide for your platform. Create a “sybase” account on your system to perform all installation tasks. The “sybase” user must have permission privileges from the top (or root) of the disk partition or operating system directory down to the specific physical device or operating system file.
Page 39
CHAPTER 2 Installing Adaptive Server • Severity level of an event that will trigger mail. Your choices are: • None • Informational • Warning • Error 10 Verify that the operating system meets the version-level, RAM, and network protocol requirements for your platform. 11 Adjust the operating system shared memory parameter.
Page 40
Pre-installation tasks for Adaptive Server Adaptive Server may allocate shared memory segments after start-up if any reconfiguration through requires additional memory. You sp_configure may need to account for these additional segments. Allocate the maximum memory you will make available to Adaptive Server, by using the allocate configuration parameter.
Adaptive Server version 15.0.2 will likely result in one or more products not working correctly. Sybase strongly recommends that Adaptive Server version 15.0.2 be installed into its own directory if possible. Where this is not practical and other products must be installed into the same directory, Adaptive Server version 15.0.2 should be installed last.
Page 42
You can also enter a directory for installation. If user has Sybase Central previously installed to a directory other than the one specified in step 5 the following pop-up dialogue will be shown: The install program detected a previously installed copy of Sybase Central 4.3 in the following...
Page 43
If you choose “no” to above question, the following pop-up dialogue will be shown You have chosen to install Sybase Central in a new location. Once the installation is complete you will no longer be able to access plug-ins previously registered.
Page 44
When you download the license file, copy it to the %SYBASE%\%SYBASE_SYSAM%\licenses directory. 13 The Sybase Software Asset Management Notification screen asks you to configure your server for e-mail notification. When configuration is enabled, designated users receive information about license management events requiring attention.
Page 45
CHAPTER 2 Installing Adaptive Server • Small Business Edition • Developers Edition • Express Edition You must select only the Adaptive Server edition for which you have Note a license. For more information about troubleshooting license type and edition problems, see Chapter 6, “Troubleshooting SySAM Issues.” 15 If you are installing Enterprise Edition or Small Business Edition, you must also enter the License Type under which Adaptive Server is licensed.
Page 46
Installing server components • Monitor Server – <host name>_MS • XP Server – <host name>_XP • Job Scheduler Agent – <host name>_JSAGENT If you configure the servers with default values, the Configure Server Attributes Summary window displays next. If you select to configure the server with custom values, you have the following choices: •...
Page 48
Installing server components Once you have entered the appropriate information, click Next to record the information. 22 The Custom Configure New Job Scheduler Input window prompts you to enter Job Scheduler information: • Agent name • Port number • Management device •...
Page 49
See “Installing sample databases” on page 44, to begin experimenting with your servers, or see the System Administration Guide at Sybase Product Manuals at http://www.sybase.com/support/manuals more advanced topics. Adaptive Server You have a running server, as well as various system databases and system tables.
Error Messages and Troubleshooting Guide for actions necessary to fix the problem. If the error is not listed in the manual, call Sybase Technical Support. After you have verified that your database is error free, back up your $SYBASE directory in case you need to roll back to the original version of the software.
For Windows installations, InstallShield starts automatically. For UNIX installations, change to the CD drive and enter ./setup Install Adaptive Server 15.0.2 over the $SYBASE installation path. Note Once files are loaded into your $SYBASE directory, InstallShield asks if you want to configure the new installed server. Deselect configuring the new server, and click continue to finish the installation.
Installing version 15.0.2 over an existing 15.x Adaptive Server Backward compatibility with previous Adaptive Server 15.x versions Before using the new Adaptive Server 15.0.2 features, read “Adaptive Server 15.0.2 Backward Compatibility,” the Sybase Web site at http://www.sybase.com/support/techdocs You can downgrade to earlier 15.x versions of Adaptive Server, but to do so you must take the precautions described in the technical note before using any of the new 15.0.2 features.
Adaptive Server on Windows platforms. These steps should be performed as the “sybase” user that installed the Adaptive Server product. Verify that the “sybase” user is a member of the Windows system-defined group “Administrators” so the user has the access privileges that allow them to complete the steps described below.
Sybase Adaptive Server entries installed. • Set the “Log On” properties for each of the entries to use “sybase” and the password for this account. This action results in the user “sybase” being granted ‘log on as a service” rights by Windows.
If you encounter errors, see the Troubleshooting Guide. Alternatively, start dsedit From the Windows task-bar, select Start | Programs | Sybase | Connectivity | Open Client Directory Service Editor. Open the Directory Services window by clicking OK. Highlight servername (the name of the server you want to test).
Setting the System Administrator password A user account called “sa” is created for the Sybase System Administrator when you install the Sybase software. A user logged in as “sa” can use any database on Adaptive Server, including , with full privileges.
2> go For greatest security, Sybase recommends that you set the password to have at least six characters, with a combination of letters and numbers. The SAMreport SAMreport is a SySAM 2.0 license reporting tool used in conjunction with the SySAM2.0 license server.
“Installing the jpubs database” on page 47 The sample databases contain information about a fictitious business. You can use this information to learn about the Sybase products, without affecting essential data. Table 3-1 lists the scripts that you can use to install the sample databases.
Page 59
Sybase does not recommend this configuration because it uses master valuable space that is best used for system tables. Each sample database requires 3MB on a 2K server, and multiples of 3MB on a 4K, 6K, 8K, and 16K server on your database device.
PICT, TIFF, and Sun raster file formats. Run instpix2 script only to use or test the datatype. Sybase does not supply any tools for image displaying data. You must use appropriate window graphics tools to image display the images after you have extracted them from the database.
-Usa -Ppassword -Sservername -Jeucjis -i%SYBASE%\%SYBASE_ASE%\scripts\eucjis\installjpubs isql -Usa -Ppassword -Sservername -Jsjis -i %SYBASE%\%SYBASE_ASE%\scripts\sjis\installjpubs For more information on the option in , see the Utility Guide. isql Installation Guide...
For more information about the guest user and a list of guest permissions, see the System Administration Guide. Note Sybase recommends that you remove the guest user from user databases in production systems. If possible, and if space allows, give each new user a clean copy of the sample databases so that she or he is not confused by other users’...
Installing PC-Client products Installing PowerDesigner, PowerTransfer, and InfoMaker Configuring network connections for client products Overview Clients, such as Sybase Central and Open Client, are used to access Adaptive Server. See the Open Client/Server Configuration Guide for Desktop Platforms. Sybase Central, ASE and...
Before you install the PC-Client products • Extended Architecture (XA) • jConnect for JDBC • ASE ODBC driver by Sybase • ASE OLE DB provider by Sybase • ASE ADO.NET Data provider by Sybase • Language modules • PowerDesigner •...
Page 65
Windows 2000 Professional, Server, Service Pack 4 or higher Advanced Server, and Data Center Editions Windows 2003 None; Sybase recommends using the latest service pack from Microsoft for best security protection Windows XP Professional None; Sybase recommends using latest service pack from Microsoft...
Page 66
Agreement, then click Next. Enter the directory path and click Next. • If user has Sybase Central previously installed to a directory other than the one specified in step 5 the following pop-up dialogue will be shown: The install program detected a previously installed copy of Sybase Central 4.3 in the...
CHAPTER 4 Installing Sybase PC-Client Products Select the type of installation to be performed. • Typical Install – installs the default components that most users need. • Full Install – installs every component on the CD. • Customized Install – allows you to select the components to install.
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 must know where the others reside on the network. This information is stored in the interfaces file on Windows or in a Lightweight Directory Access Protocol (LDAP) server.
Page 69
From the Windows task-bar, select Start | Programs | Sybase | Connectivity | Open Client Directory Service Editor. Select LDAP from the list of servers, and click OK. Click Add New Server Entry.
Adaptive Server, Backup Server, Monitor Server, Historical Server, or XP Server. To access a Sybase server through the interfaces file, each server must be included in the interfaces file on the client computer. To add a server entry to the interfaces file on your PC-Client computer: From the Microsoft Windows task bar, select Start | Programs | Sybase | Connectivity | Open Client Directory Service Editor.
Page 71
CHAPTER 4 Installing Sybase PC-Client Products In the Network Address box, you can enter either the server name or the IP address, along with the server port number. For example: machine_name, 4100 where machine_name is the name of the computer, and 4100 is the port number the server is using to “listen”...
From the drop-down list, select the Adaptive Server to which you want to connect. If Sybase Central is installed on the same computer as the server, click the icon for the server. If prompted to start Adaptive Server, click OK. When the traffic light icon representing the server is green, the server is running.
C H A P T E R This chapter describes the various steps for upgrading Adaptive Server to version 15.0.2. If you are installing Adaptive Server 15.0.2 on top of an earlier version refer to section Installing version 15.0.2 over an existing 15.x Adaptive Server in Chapter 2, “Installing Adaptive Server”.
Overview of the upgrade process Overview of the upgrade process You can upgrade to Adaptive Server 15.0.2 from any of these versions: • 11.9.2.6 and later • 12.5.x Adaptive Server version 15.0.2 does not support upgrade from Adaptive Note Server version 12.5.3a.
CHAPTER 5 Upgrading Adaptive Server Run the upgrade process. Adaptive Server issues advisory warnings when configuration Note parameters are not set to the default. These do not require any action. utilities are internally called by syconfig.exe or preupgrade upgrade sybatch.exe. Each new version of Adaptive Server contains features that introduce new parameters, commands, reserved words, and so on.
Pre-upgrade tasks Pre-upgrade tasks Note Before you begin the upgrade process, install Adaptive Server 15.0.2 onto your system. To ensure a successful upgrade, review the following pre-upgrade tasks and perform them as necessary. Depending on the old server configuration, you may not need to perform all pre-upgrade tasks.
Checking system and upgrade requirements To verify that your system environment is configured correctly: Verify that the computer on which you plan to upgrade the Sybase products meets the requirements. Determine whether your server supports an upgrade to Adaptive Server 15.0.2.
By default, the (master.dat) and system procedures device master (sybsytemprocs.dat) files are installed in the %SYBASE%\data directory. The device file names can be different from their device names. Be sure that the directory to which your TEMP environment variable points exists.
Page 79
CHAPTER 5 Upgrading Adaptive Server As part of the pre-upgrade process, syconfig.exe or sybatch.exe can perform the reserved word check for you. See the Reference Manual for a complete list of reserved words. If you change an object name, change applications and stored procedures Note that refer to that object.
Sybase recommends that you use to determine how much Note preupgrade free space is required for the upgrade. Increasing default database sizes You can use or Sybase Central to determine the current size of the sp_helpdb , and databases. master model sybsystemprocs...
Page 81
CHAPTER 5 Upgrading Adaptive Server , use to increase the size of the database. For isql alter database master example: 1> use master 2> go 1> alter database master on master=x 2> go This example increases the size of the database;...
You must remove named pipe directory service from the interfaces file before upgrading the Adaptive Server. To assist with the upgrade process, Sybase recommends you set the OLDSYBASE, OLDSYBASE_ASE, and OLDSYBASE_OCS environment variables to point to the old installation of Adaptive Server. If you set these...
Run Start | Programs | Sybase | Adaptive Server Enterprise | Server Config. Click Upgrade Adaptive Server in the Configure Sybase Servers window. Enter the name of the old Sybase directory. Enter the name of the old Adaptive Server directory, such as ASE-12_0. Enter the old OpenClient Server directory such as OCS-12_0.
Runs installmaster script Testing the Adaptive Server upgrade To start Adaptive Server and test the upgrade: From the Windows task-bar, select Start | Programs | Sybase | Sybase Central v4.3. Select the upgraded Adaptive Server. You are prompted to start the server.
Your user ID appears in parentheses next to the server name. Connect to each server listed to verify the installation. Do not start XP Server from Sybase Central. Adaptive Server Warning! starts XP Server automatically when Adaptive Server receives the first request for an extended stored procedure.
Post-upgrade tasks Restoring functionality in Adaptive Server To reset or enable options or functionality you had to change before the upgrade: Reset the configuration parameters. If you changed any configuration parameters before upgrading, use to set them back to their previous values. sp_configure to reset any database options you disabled before sp_dboption...
Page 87
Adaptive Server. The syntax is: sp_configure "configuration file", 0, "verify", "full_path_to_file" For example: sp_configure "configuration file", 0, "verify", "C:\Sybase\ASE125.cfg" For more information about , see the sp_configure sp_sysmon Reference Manual and the Performance and Tuning Guide. For more information about configuring memory, see the System Administration Guide.
If you used two-phase commit in 11.9.x, run the script to install the two-phase commit tables: isql -Usa -Psa_password -Sserver_name -i%SYBASE%\%SYBASE_ASE%\scripts\instcomm You do not need to run this script if you do not use two-phase commit. Reenabling Replication Server If you disabled replication before the upgrade, you must reenable replication.
Page 89
The replication system is now ready for Adaptive Server 12.5.x, and applications can resume. If you installed any Sybase client products, such as Open Client, use the dsedit utility to edit your interfaces file and to specify the servers to which you want to connect.
Page 90
Post-upgrade tasks Restoring replication after upgrade Restore the replication functionality: Log in to the RSSD for each replicated primary, and for each replicated RSSD, and issue: 1> use RSSD_name 2> go 1> rs_zeroltm dataserver, database 2> go Log in to each replicated primary, and replicated RSSD and issue: 1>...
CHAPTER 5 Upgrading Adaptive Server Reenabling auditing Reenable all auditing options for stored procedures using the audit options you recorded during pre-upgrade. Reenter the audit options using sp_audit For example, if you had enabled stored procedure auditing for sp_addlogin stored procedure in your server before upgrade, run the following sp_audit command to reenable auditing on sp_addlogin...
Select the Backup Server or the Monitor Server from the icons on the left and click the Upgrade Server button. Enter the name of the old Sybase directory. Enter the name of the old Adaptive Server directory such as ASE-12_0. Enter the name of the old OpenClient/Server directory such as OCS-12_0.
To check the upgrade, use the Windows Notepad to view the log file in %SYBASE%\%SYBASE_ASE%\init\logs Upgrading Job Scheduler After upgrading to the new Adaptive Server, perform the following steps to upgrade Job Scheduler. You must have $SYBASE/$SYBASE_OCS/bin directory in $PATH so the Note executable is accessible. isql Upgrading Job Scheduler Copy the directory services entry for JSAGENT (or jsagent) from the old server to the new server.
, run the installjsdb script that is sybmgmtdb isql included with this release and save the output to a file: isql -Usa -Psa_password -Sservername -n -i$SYBASE/$SYBASE_ASE/scripts/installjsdb -ooutput_file 10 Enable Job Scheduler to start when Adaptive Server starts. From enter isql the command: sp_configure "enable job scheduler", 1...
Page 95
If you have modified any of the Sybase-supplied templates stored procedures or XML documents, do not overlay the new templates with your versions. If you do, you will lose the enhancements provided by the revised templates.
Page 96
Upgrading Job Scheduler Modify jobs created Template Modified files Change description from this template SybRebuildIndexTemplate.xml Changed the datatype for the Required, modify job SQL rebuild indexes parameter from to change @dump_flag @dump_flag jst_reorg_rebuild_indexes datatype. varchar(5) SybRebuildTableTemplate.xml Changed the datatype for the Required, modify job SQL rebuild table parameter from...
Page 97
Install the Template stored procedures. • Move to the JS template stored procedure directory. For example: cd $SYBASE/$SYBASE_ASE/jobscheduler/Templates/sprocs • Run the stored procedure install script for each server being upgraded: installTemplateProcs <servername> <username> <password> Note Template stored procedures should be upgraded on all Job Scheduler servers and target servers upgraded to Adaptive Server version 15.0.2.
Use the cluster system command to stop monitoring resources associated with Adaptive Server on each cluster node. Follow the upgrade steps in “Upgrading to Adaptive Server 15.0.2” on page 68 to upgrade each of the Adaptive Servers separately. Run the new Adaptive Server installmaster script against the newly upgraded Adaptive Servers.
Page 99
CHAPTER 5 Upgrading Adaptive Server Manually restart Adaptive Server on each cluster node with trace flag 2209. Use the Adaptive Server command-line option -T2209 Do not use trace flag 2209 after the Adaptive Server Warning! companionship is re-established. 10 Use the cluster system command to restart monitoring resources associated with Adaptive Server on each cluster node.
In new Adaptive Server installation area, modify the high availability-related files such as the RUN_server_file, and the SYBASE.csh and SYBASE.sh files, if those files are required on that cluster platform. Use the cluster system command to reconfigure resource properties associated with Adaptive Server to reflect the new Adaptive Server installation location.
Page 101
32-bit Adaptive Server and make sure they run cleanly. In a new directory, copy the files for the 64-bit Adaptive Server. Shut down the 32-bit server. Copy the interfaces file and the configuration file from the 32-bit $SYBASE directory to the 64-bit $SYBASE directory. Installation Guide...
Remove all references to the 32-bit $SYBASE directories from your $PATH definition. Change to the 64-bit $SYBASE directory and source the ASE150.[csh, sh] script (Bourne shell). Change to the 64-bit $SYBASE/install directory and execute: startserver -f RUN_server...
Page 103
CHAPTER 5 Upgrading Adaptive Server isql> alter database dbname on device_name = "2m" In 15.0.2 Adaptive Server, allows you to specify the Note alter database size to alter the database with the unit-specifier ‘m’, or ‘M’. Installation Guide...
Page 104
Recovering from a failed upgrade Adaptive Server Enterprise...
SySAM grace period Enabling and changing e-mail notifications Calling Sybase technical support for SySAM-related issues If you call Sybase technical support for SySAM-related issues, be sure to have the following information available: • The Adaptive Server errorlog located in the install directory.
The licenses saved in the $SYBASE/SYSAM-2_0/licenses directory of the license server. • The license server log file in the $SYBASE/SYSAM-2_0/log directory. Where to look for SySAM-related errors All SySAM related errors are printed in the Adaptive Server errorlog. All SySAM-related messages are prefixed with in the "kernel SySAM:"...
CHAPTER 6 Troubleshooting SySAM Issues If you are using a served license model, the license server’s debug log located in the log directory provides information about any license check-out issues. Troubleshooting SySAM Table 6-1 lists methods for troubleshooting SySAM. Table 6-1: Troubleshooting SySAM Description What to do Cannot find license...
Page 108
If you support was not paid, you are not authorized to install an update. See Appendix B of Sybase Software Asset Management User’s Guide for explanation of how SySAM uses date-based versioning. See “Updating your Sybase licenses” in Chapter 3, “Getting and Using your Licenses,”...
Page 109
CHAPTER 6 Troubleshooting SySAM Issues Description What to do The license server The most common cause for the license server failing to start is that there are no served does not start licenses in the server. In order for license server to start, there needs to be at least one served license in the licenses directory.
Page 110
Appendix B, “Installing Product Updates, EBFs, and Support Renewal” in the Sybase Software Asset Management User’s Guide. For information about how to update your license, see the “Updating your Sybase licenses” section in Chapter 3, “Getting and Using your License,” in the Sybase Software Asset Management User’s Guide.
Page 111
If Adaptive Server cannot start because the grace period expired, examine the servername.properties file located in the ASE-15_0/sysam directory under your SYBASE directory for values. These values are stored in two lines that start with PE= and LT=. These lines are present only if the configuration is set.
CHAPTER 6 Troubleshooting SySAM Issues SySAM grace period Typically, you get a 30-day grace period to resolve any SySAM-related issues. When a license is awarded under grace, the Adaptive Server errorlog entry and optional e-mail message includes the date and time when the grace period expires.
Page 114
Enabling and changing e-mail notifications Adaptive Server Enterprise...
Error log locations Solutions to common installation problems Upgrading compiled objects with dbcc upgrade_object Overview For Sybase server products, there are two categories of errors: • Errors generated by the installation, upgrade, and setup utilities • Errors generated by the server (Adaptive Server, Backup Server, and...
Page 116
Note grace period has expired. Check the Adaptive Server error log for the cause of the license checkout failure and fix the issues. Sybase products cannot locate The installation program makes several modifications to your operating their required DLLs. environment to locate required files. Log out of Windows, and log in again for the changes to take effect.
This displays any error messages to the console which user can then correct. Stopping Adaptive Server after a failure If the installation or upgrade session fails after you start Adaptive Server, try using Sybase Central to shut down the server. If Sybase Central cannot shut down the server, use the command:...
Start and connect to Adaptive Server: isql %SYBASE%\%SYBASE_OCS%\bin\isql -Usa -P -Sserver_name Where: • %SYBASE% – is the Sybase installation directory • server_name – is the name of your Adaptive Server Shut down Adaptive Server using the command. shutdown with nowait...
See log for more information. Click Exit. The message: “Upgrade Check Failed” appears. Click OK. From the Configure Sybase Servers window, select Exit. Examine the log file created in the %SYBASE%\%SYBASE_ASE%\init\logs directory to find out why Adaptive Server failed the pre-upgrade eligibility test.
Page 121
CHAPTER 7 Troubleshooting If you think the upgrade failure or its cause may have damaged your databases, restore the databases from backups. For information on restoring databases, see the System Administration Guide. If you are concerned about the possible corruption of your databases, exit Server Config, but do not attempt to restart the upgrade session until you have restored the databases from backup.
Page 122
First diagnose and correct the failure, then run the upgrade utility: %SYBASE%/%SYBASE_ASE%/upgrade/upgrade.exe When restarted in this way, the upgrade process says it is “verifying” the upgrade rather than “starting” it, but it makes all the same checks as for the original upgrade.
Shutting down the server enables the installation program to start the server and re-run the upgrade session. Start Server Config from the Sybase program folder. Select Upgrade Adaptive Server, and proceed with the upgrade. If the cause of the failure is unknown...
Upgrading compiled objects with dbcc upgrade_object For example, if you have a user-defined stored procedure named , the list_proc presence of source text for is verified when you upgrade to Adaptive list_proc Server 15.0. The first time is invoked after the upgrade, Adaptive list_proc Server detects that the compiled object has not been upgraded.
Page 125
CHAPTER 7 Troubleshooting After reviewing the errors and potential problem areas, and fixing those that need to be changed, you can use to upgrade compiled dbcc upgrade_object objects manually instead of waiting for the server to upgrade the objects automatically. For details, see “Using dbcc upgrade_object” on page 113. Reserved word errors finds a reserved word used as an object name in a dbcc upgrade_object...
Page 126
Upgrading compiled objects with dbcc upgrade_object If quoted identifier errors occur, use the command to activate quoted , and then run to upgrade the object. identifiers dbcc upgrade_object For compiled objects created in version 11.9.2 or later, the upgrade process automatically activates or deactivates quoted identifiers as appropriate.
CHAPTER 7 Troubleshooting Determining whether reports the existence of in a view, compare the dbcc upgrade_object select * select * should be output of for the original view to the output of the table, to syscolumns changed in views determine whether columns have been added to or deleted from the table since the view was created.
Page 128
Upgrading compiled objects with dbcc upgrade_object • – specifies the database ID. If you do not specify , all compiled dbid dbid objects in the current database are upgraded. • – specifies the database name. If you do not specify , all dbname dbname...
Page 129
CHAPTER 7 Troubleshooting Example 2 Upgrades all stored procedures in the database. Single listdb quotes are used around because procedure set quoted identifiers dbcc upgrade_object(listdb, 'procedure') Upgrades all rules and check constraints in the database. Example 3 listdb Double quotes are used around because rule set quoted identifiers...
To send all the output from to the window, a System dbcc upgrade_object Administrator can execute . Sybase recommends that you dbcc traceon(3604) use this command if you think the output of error messages might overflow the error log. Using database dumps in upgrades Upgrading using dump and load You can load pre-12.5 database dumps and transaction logs and upgrade the...
CHAPTER 7 Troubleshooting Determining whether a compiled object has been upgraded To determine whether a compiled object has been upgraded, do one of the following: • Look at the column. If the object was upgraded, this sysprocedures.version column will contain the number 12500. •...
Page 132
Upgrading compiled objects with dbcc upgrade_object Adaptive Server Enterprise...
Restart the system to release any DLLs that are already loaded into memory. Run Start | Programs | Sybase | Adaptive Server Enterprise | Server Config, click remove “Remove Server”. Launch the uninstall program using the Change/Drop Programs option from the Control Panel.
Stop the server. Restart the machine to release any DLLs. From the Windows Task bar, select Start | Programs | Sybase | Server Config. The Configure Sybase Server window displays. From the icons on the left of the Configure Sybase Servers screen, select the type of Sybase server to remove.
Page 135
CHAPTER 8 Removing Adaptive Server Click Remove Adaptive Server. This displays an Existing Servers window. Select the server you remove, and click OK. Restart the computer to reset registry entries. Installation Guide...
Page 136
Removing an old server Adaptive Server Enterprise...
Alternative Installation A P P E N D I X Methods Topic Page Installation on consoles (non-GUI mode) Silent installation Configuration using resource files Installation on consoles (non-GUI mode) In cases where there is no graphics display device available, or for some other reason you wish to run the installer without the graphical user interface (GUI), the Installer can be launched in console or non-GUI mode.
Silent installation Silent installation A silent installation (sometimes referred to as an unattended install) is done by running the Installer and providing a response file that contains answers to all of the Installer’s questions. There are two methods of generating a response file for the Installer.
Page 139
APPENDIX A Alternative Installation Methods In either case it is possible to custom configure the servers as well as being able to select a typical install and use the default configuration values. Except for the absence of the GUI screens all actions of the Installer are the same and the result of an installation in silent mode is exactly the same as one done in GUI mode with the same responses.
You can install Adaptive Server via a resource file. Use the sample resource file provided with the software. Editing a sample resource file Sample resource files for creating Adaptive Server and Backup Server are included in your Adaptive Server distribution in: %SYBASE%\%SYBASE_ASE\sample\server directory. Adaptive Server Enterprise...
Page 141
Edit the resource file using a text editor such as Windows Notepad. You might want to edit a copy of the file. The sample resource files provided in the %SYBASE%\%SYBASE_ASE%\sample\server directory are: • sybatch_ase.res – Configure a new Adaptive Server •...
CP 850. CHARACTERSET ( sybinit The character set used to install Sybase products, such as CP 850. NAME-OF-THE-BACKUP-SERVER (default Backup Server) The name of the default server to be used as a model to create the Backup Server. Example names include TEST_BS or USE-DEFAULT.
The character set used by Backup Server, such as CP 850. PUT-THE-PATH-AND-NAME-OF-THE-MONITOR- The path in which Monitor Server error logs ERRORLOG (Monitor Server) are placed, such as c:\sybase\ASE- 15_0\install\ms.log. PORT-NUMBER (Monitor Server) The port number by which to identify Monitor Server on the network, such as 5002.
Page 144
Configuration using resource files Adaptive Server Enterprise...
Upgrading Servers with A P P E N D I X Replicated Databases Topic Page Introduction Suspending transaction processing and replication activities Draining the transaction logs for primary databases Draining the RSSD transaction log Disabling the secondary truncation point Introduction After you have upgraded, you will no longer be able to scan any part of the transaction log that existed before the upgrade, so you must follow the following process if your server contains replicated primary databases...
Suspending transaction processing and replication activities • Disabling the log truncation point. After upgrading to version 15.0, complete the post-upgrade tasks to re-enable database replications functions. For more information, see the Replication Server Reference Manual and the Replication Server System Administration Guide. Warning! As a safeguard, perform a and a...
APPENDIX B Upgrading Servers with Replicated Databases The status of all existing routes should be “Active.” If any routes are not active, resolve them before continuing. See the Replication Server documentation for help in diagnosing and fixing the problem with the route, and then go to step 3.
Page 148
Draining the transaction logs for primary databases to update one row in a single replicated table in the primary isql database: 1> update table set column = column 2> where key = unique_value 3> go command helps track whether all modifications to the update replicated database have been sent to the Replication Server.
APPENDIX B Upgrading Servers with Replicated Databases 2> go 12 If you are using LTM, shut down the LTM. After draining the transaction logs, do not allow any other activity in the databases. If activity does occur, you will need to redrain the logs. Draining the RSSD transaction log If the Replication Server has routes to other Replication Servers, you must ensure that Replication Server processes all transactions in the RSSD...
Disabling the secondary truncation point Log in to the replicate Replication Server and suspend the Log Transfer connection from the primary RSSD: 1> suspend log transfer from server.database 2> go If you are using Rep Agent, log in to the Adaptive Server, and stop the Rep Agent: 1>...
Using sybsystemprocs A P P E N D I X Topic Page Introduction Increasing the size of the sybsystemprocs database Increasing device and database capacity for system procedures Introduction is the default system name for this device. However, it Note sysprocsdev is frequently referred to as the device, as in the Adaptive sybsystemprocs...
• You can leave the database and old device alone and add a new device large enough to hold the additional megabytes, and alter the onto the new device. Sybase recommends that you expand sybsystemprocs the current device. Enlarging the sybsystemprocs database If you do not have a current backup, create one.
APPENDIX C Using sybsystemprocs If there is space available on another device, you can expand to a second device, or initialize another device that is large sybsystemprocs enough. For instructions on creating a larger device, see sybsystemprocs “Increasing device and database capacity for system procedures” on page 139.
Page 154
2> name = "sysprocsdev", 3> physname = "%SYBASE%\data\sysproc.dat", 4> vdevno = 9, 5> size = 51200 6> go where %SYBASE%\data is the path to your system procedures device. Create a database of the appropriate size on that device, sybsystemprocs for example:...
Page 155
Using sybsystemprocs 1> create database sybsystemprocs on sysprocsdev = 2> go Run the command in the old release directory. For version 12.0: instmstr isql -Usa -Ppassword -i%SYBASE%\%SYBASE_ASE% \scripts\instmstr -oinstmster.out For versions earlier than 12.0: isql -Usa -Ppassword -i%SYBASE%\scripts\instmstr -oinstmster.out Installation Guide...
Page 156
Increasing device and database capacity for system procedures Adaptive Server Enterprise...
RAM required by default stopping network protocols total memory parameter directories verifying environment for upgrade installation Administrator specifying new for installation Sybase System dsedit utility alter database command applications changing after renaming objects auditing feature Enterprise Edition package environment variables PATH...
Page 158
Open Client/C 11.9.2 for Windows network protocols Sybase products 39, 45, 46 named pipes installintpubs script installjpubs script TCP/IP installpix script Winsock interfaces file...
Page 159
XP Server recommended database device size if adding user- entries in sql.ini defined more information about Sybase installation directory starts automatically with first ESP request 58, 71 Sybase products installing 39, 45, 46 Open Client/C for Windows...
Need help?
Do you have a question about the Adaptive Server Enterprise 15.0.2 and is the answer not in the manual?
Questions and answers