Sybase ASE Linux Installation Guide Installation and getting started guide for SAP Sybase ASE on Linux

(1)

Sybase ASE Linux Installation Guide

(2)

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries.

Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company.

Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360°, and B2B 360° Services are registered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAP company.

All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

www.sap.com

Use GUI mode to install Adaptive Server and related products. Shut down all programs before running the installer. The installer creates the target directory (if it does not yet exist) and installs the selected components into that directory. Note: Adaptive Server Enterprise 15.7 ESD #2 includes new major versions of Adaptive Server and many supporting components. Installing Adaptive Server version 15.7ESD#2 into the same directory with existing products should not impact the existing products. However, installing other products on top of Adaptive Server version 15.7 ESD #2 may result in one or more products not working correctly.

SAP Sybase strongly recommends that you install Adaptive Server version 15.7 ESD #2 into its own directory if possible.

At the end of the installation, you can verify the product installation. You may need to perform additional configuration procedures before using some products.

If you downloaded the product from SPDC or SAP Service Marketplace, go to the directory where you extracted the installation image and start the installer:

./setup.bin

 Select the language.

 On the Introduction screen, click Next.

 Accept the default directory or enter a new path, then click Next.  Select the type of installation: Typical | Full | Customize

o Typical: (Defaults) Installs the default components. This is recommended for most users o Full: Installs every Adaptive Server component, including all the supported language modules o Customize: Lets you select the components to install. Some components are automatically installed if

they are required to run selected components.

 Select the software license type for the Adaptive Server suite: o Install Free Developer Edition of Adaptive Server Suite

 Choose the most appropriate region, read the license terms, then click I agree. Click Next.

 After installation, following screen will come to configure New Adaptive Server – Make sure that “create sample databases” option is selected. If you chose a typical installation, the installer asks you following options , in screen typical of above.

Now configure following options based on Ports availability of your machine. Leaving defaults is recommended. Configure New Adaptive Server



Adaptive Server name



System administrator password



Port number



Error Log



Application Type- OLTP/DSS



Page Size



Default Language

(4)



Default Sort Order



Optimize ASE Configuration



Create sample database Configure New Adaptive Server



Master Device



Master Device size



Master Database size



System Procedure device



System procedure Device size



System Procedure Database size



System Device Size



System Database Size



Tempdb Device



Tempdb Device Size



Tempdb database size Configure New Backup Server



Backup Server Name



Port Number



Error Log

Configure New XP Server



XP Server Name



Port number 5002

Configure custom configuration values for the new Job Scheduler



Job scheduler agent name



-Port Number



-Management Device



-Mangement device size



-Managemetn Database size Configure Self-Management



Self-management user name -



Sybase Control Center- Configure Self Discovery Service Service Adaptor



Configure UDP Adaptor ( Recommended) Sybase Control Center (SCC)



Configure RMI Port -RMI Port- Integer between 1025-65535 SCC Login Module



SCC administrator password

(5)

STARTING AND STOPPING ADAPTIVE SERVER Start and stop Adaptive Server, Backup Server, and XP Server.

XP Server is not started by the installation process. XP Server is started by Adaptive Server when you issue an XP command through isql.

You can use Sybase Control Center to start and stop servers manually or automatically.

Start Server

Start Adaptive Server or Backup Server from the command line.

You can start Adaptive Server or Backup Server using RUN_server_name files and startserver commands. You can also customize the start up options by editing RUN_server_name.

To start a server, your user account must have:

• Access to the database servers (execute privileges) and database devices (read/write privileges). • Access to Adaptive Server distribution files.

• System environment variables set. • Access to SySAM licenses.

The installation program creates the interfaces file and system environment variables when you install servers on your computer.

Server Startup-Parameters

Set the start-up parameters to the correct location and device names for starting an Adaptive Server or Backup Server. The default start-up parameters are stored under $SYBASE/$SYBASE_ASE/install/RUN_server_name, where

server_name is the name of the server you installed.

You cannot change any of these default start-up parameters unless you edit the SYBASE/$SYBASE_ASE/install/RUN_

(6)

Switch Description

-d $SYBASE/data/master.dat Location of the master device file

-s server_name Name of the Adaptive Server

-e $SYBASE%\$SYBASE_ASE\ install\errorlog Location and name of error log file

-i $SYBASE\ini Directory containing the sql.ini file

-M $SYBASE\$SYBASE_ASE Directory that stores shared memory file

-N $SYBASE\$SYBASE_ASE\sysam\<srv_name>.properties Location and name of license cache file

RUN_server_name File

Each time a new Adaptive Server or Backup Server is created, the srvbuild program creates a RUN_server_name file that contains the information required to restart that server.

RUN_server_name files are created in the $SYBASE/$SYBASE_ASE/install directory.

For Adaptive Server, the RUN_servername file is named RUN_servername , where servername is the name of the server. For example, the RUN_servername file name for an Adaptive Server named TEST is RUN_TEST. For Backup Server, the RUN_servername files is named RUN_servername_back.

Warning! Do not delete the RUN_servername file that is created in $SYBASE/$SYBASE_ASE/install. This file restarts servers when you customize your installation. If you need the RUN_servername file in another location, make a copy of the original RUN_servername file in the new location

Using the startserver Command

Use startserver to start a server from the command line.

To start a server from the command line, enter:

$SYBASE/$SYBASE_ASE/install/startserver [ -f RUN_server_namefile ]

where $SYBASE/$SYBASE_ASE/install/startserver is the full path name of the startserver utility, and

RUN_server_name file is the full path name of the RUN_server_name file (usually SYBASE/$SYBASE_ASE/install/

RUN_server_name).

(7)

Adaptive Server Default Configuration Parameters

Installing or updating Adaptive Server automatically sets some default parameters and settings, and includes several auxiliary programs.

After installing and testing this “default” Adaptive Server, you must configure it to your system’s needs and install other optional features. Many of Adaptive Server settings are determined by the configuration file, which is located in $SYBASE, and set with the sp_configure system procedure.

Connecting to Adaptive Server with isql

isql sends Transact-SQL commands to Adaptive Server, formatting the results and printing them to standard output. There is no maximum size for an isql statement.

To log into Adaptive Server using isql: 1. Open a command prompt window.

2. Start isql and connect to Adaptive Server. For example, on UNIX:

$SYBASE/$SYBASE_OCS/bin/isql -Usa -Ppass_word -Sserver_name

$SYBASE – is the Sybase installation directory.

server_name – is the name of your Adaptive Server.

Adaptive Server displays the isql prompt:

1>

Stopping Adaptive Server

Only the system administrator can issue a shutdown command. Using a shutdown command minimizes the amount of work that automatic recovery needs to do when the servers are restarted. The preferred method of stopping Adaptive Server is to use the Transact-SQL shutdown command.

1. Log in to an Adaptive Server account with System Administrator privileges:

isql -Usa -Ppassword -Sserver_name

2. Enter:

1> shutdown 2> go

The default for the shutdown command is with wait. The with wait option allows Adaptive Server to finish executing SQL statements or procedures, perform a checkpoint in each database, disable new logins, and perform other shutdown tasks.

A message similar to this prints to the stderr file:

Server SHUTDOWN by request. The SQL Server is terminating this process. CT-LIBRARY error:

This is normal behavior.

If the message indicates that Adaptive Server is waiting for processes to complete, and you must stop Adaptive Server immediately, you can use the shutdown with nowait command.

(8)