Sybase ASE Linux Installation Guide

Installation and getting started guide for SAP Sybase ASE

on Linux

www.sap.com

TABLE OF CONTENTS
INSTALLING ADAPTIVE SERVER .................................................................................................................. 3
Installing Adaptive Server with the GUI Wizard ........................................................................................... 3
STARTING AND STOPPING ADAPTIVE SERVER ......................................................................................... 5
Start Server ...................................................................................................................................................... 5
Server Startup-Parameters ................................................................................................................................ 5
Using the startserver Command ........................................................................................................................ 6
Adaptive Server Default Configuration Parameters ..................................................................................... 7
Connecting to Adaptive Server with isql ....................................................................................................... 7
Stopping Adaptive Server ............................................................................................................................... 7

2012 SAP AG. All rights reserved.

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.

INSTALLING ADAPTIVE SERVER

SAP Sybase recommends that you use the GUI wizard to install Adaptive Server .
The GUI wizard offers default values for the parameters while it installs Adaptive Server.

Installing Adaptive Server with the GUI Wizard

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
Default Character set

 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

-SCC agent administrator password

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_
server_name file.

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).
If your Adaptive Server is named SYBASE, the RUN_server_name file specification is optional.

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 systems 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.
shutdown with nowait does not wait for currently executing statements to finish, nor does it perform checkpoints in
every database. Use the shutdown with nowait command only when necessary.

 2012 SAP AG. All rights reserved.

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.