SybaseWiki - User contributions [en]

Sybase links

2023-08-25T14:24:15Z

Psap:

Links to other websites

===Sybase documentation===
[http://infocenter.sybase.com/help/index.jsp Online documentation from Sybase]

===Community sites===
[https://web.archive.org/web/20200921092620/http://www.sypron.nl/main.html Rob Verschoor's old site]

[https://github.com/mpeppler/DBD-Sybase DBD::Sybase]

[https://github.com/mpeppler/sybperl sybperl]

[http://web.archive.org/web/20210305122314/http://peppler.org Sybase ASE on Linux FAQ]

[http://www.faqs.org/faqs/databases/sybase-faq/part1/ Sybase FAQ]

[http://www.rocket99.com/index.html Rocket99 Guide to Sybase, Oracle, UNIX, and More]

[http://www.selectorweb.com/sybase.html Info from Lev Selector]

Sybase links

2023-08-25T14:19:02Z

Psap:

Links to other websites

===Sybase documentation===
[http://infocenter.sybase.com/help/index.jsp Online documentation from Sybase]

===Community sites===
[https://web.archive.org/web/20200921092620/http://www.sypron.nl/main.html Rob Verschoor's old site]

DBD::Sybase and/or sybperl
[http://web.archive.org/web/20210305122314/http://peppler.org Sybase ASE on Linux FAQ]

[http://www.faqs.org/faqs/databases/sybase-faq/part1/ Sybase FAQ]

[http://www.rocket99.com/index.html Rocket99 Guide to Sybase, Oracle, UNIX, and More]

[http://www.selectorweb.com/sybase.html Info from Lev Selector]

Miscellaneous

2023-08-25T13:55:29Z

Psap: /* Patching the raspberrypi that hosts this wiki */

====Unix info====

[[SunOsUnix info]] Some commands to get around on the SunOS (Solaris) operating system.

====Two dutch language documents====

[[RDBMS auto tuning]]

[[RDBMS tuning]] (Manual)

====Patching the raspberrypi that hosts this wiki====
/etc/init.d/mysql stop
apt-get update
apt-get upgrade

Miscellaneous

2023-08-25T13:53:55Z

Psap:

Sybase links

2023-08-24T19:45:12Z

Psap:

Links to other popular websites

===Sybase documentation===
[http://infocenter.sybase.com/help/index.jsp Online documentation from Sybase]

[http://manuals.sybase.com/onlinebooks/group-as/asg1250e/sqlug/@Generic__BookView Transact-SQL User's Guide (12.5)]

[http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.sqlug/html/sqlug/title.htm Transact-SQL User's Guide (15.0)]

===Community sites===
[https://web.archive.org/web/20200921081534/http://www.sypron.nl/closing.html Rob Verschoor's old site]

[http://www.peppler.org/FAQ/linux.html Sybase ASE on Linux FAQ]

[http://www.faqs.org/faqs/databases/sybase-faq/part1/ Sybase FAQ]

[http://www.rocket99.com/index.html Rocket99 Guide to Sybase, Oracle, UNIX, and More]

[http://www.selectorweb.com/sybase.html Info from Lev Selector]

Main Page

2022-05-27T14:23:20Z

Psap: /* Other Pages */

=Welcome to the SybaseWiki=

This wiki is created to provide additional information for the usage of various [http://www.sybase.com Sybase] products. It's maintained by [[User:Psap|Peter Sap]]. If you want to add or change content, just drop me a mail at mailto:peter@petersap.nl and I'll create an account for you. Thank you.

Information in the wiki is grouped per product:
{|
|+
|-
| ||
|-
|[[:Category:ASE|Adaptive server Enterprise]]
|-
|[[:Category:RepServer|Replication Server]]
|-
|[[:Category:IQ|Sybase IQ]]
|-
|[[:Category:OpenSwitch|OpenSwitch]]
|}

A special place has been created for GUI tools: [[:Category:GUI Tools|GUI Tools]]

==Stay up to date==
The RSS feed is here: [http://www.petersap.nl/SybaseWiki/index.php?title=Special:Recentchanges&feed=rss Recent changes by RSS]

Or follow Peter Sap on twitter: [https://twitter.com/intent/follow?region=follow_link&screen_name=petersap&source=followbutton&variant=2.0 @petersap]

==Other Pages==
Links to other sites with Sybase info: [[Sybase links]]

Miscellaneous pages: [[Miscellaneous]]

PostgreSQL: [[PostgreSQL]]

Main Page

2022-02-04T08:53:46Z

Psap: /* Other Pages */

Main Page

2022-02-04T08:51:29Z

Psap:

Main Page

2022-02-04T08:50:59Z

Psap: /* Welcome to the SybaseWiki */

Miscellaneous

2021-12-14T12:46:09Z

Psap:

====Unix info====

[[SunOsUnix info]] Some commands to get around on the SunOS (Solaris) operating system.

====Two dutch language documents====

[[RDBMS auto tuning]]

[[RDBMS tuning]] (Manual)

Bitmap Failed internal checks

2018-04-09T07:37:05Z

Psap: Created page with "When you get this error I. 03/27 15:44:37. 0000021871 Exception Thrown from slib\s_bm.cxx:1855, Err# 1, tid 2047 origtid 2047 I. 03/27 15:44:37. 0000021871 O/S Err#: 0,..."

When you get this error

I. 03/27 15:44:37. 0000021871 Exception Thrown from slib\s_bm.cxx:1855, Err# 1, tid 2047 origtid 2047
I. 03/27 15:44:37. 0000021871 O/S Err#: 0, ErrID: 2049 (sbm_exception); SQLCode: -1009045, SQLState: 'QSA45', Severity: 14
I. 03/27 15:44:37. 0000021871 [20066]: Bitmap failed internal checks. You may have a damaged index. Please check your IQ message file for additional information.
-- (slib\s_bm.cxx 1855)

try setting the below option

SET option DML_Options14=8

[[Category:IQ]]

Linux configuration settings for Sybase ASE

2015-12-02T19:07:50Z

Psap: /* For connections to ASE */

To run Sybase ASE successfully on a Linux environment you need to configure a number of items. Below you will find a few of these, but please note that this is by far not an full overview. There could be more improvements to be made.

=Memory – Huge Pages=
The configuration of Huge Pages is needed to get an efficient translation from virtual memory pages to physical pages. When you configure for Huge Pages, the amount of memory assigned to Huge Pages is allocated and reserved for shared memory. Do not over configure to prevent swapping.

When ASE reports the below message in the errorlog, you need to configure for huge pages:

Could not allocate memory using Huge Pages. Allocated using regular pages. For better performance, reboot the server after configuring enough Huge Pages.

To get the values for huge pages first determine the maximum amount of memory you want to give to ASE. For instance, on a Linux server with 512Gb physical memory you can give 90% to ASE.
512 Gb x 90% = 460 Gb = 471040 Mb.

Then determine the size of a single huge page:

cat /proc/meminfo | grep Hugepagesize

Sample output:

Hugepagesize: 2048 kB

In this case 1 huge page is 2 Mb, so the number of huge pages we need will be 471040 Mb / 2 Mb = 235520

Then set the correct value in /etc/sysctl.conf:

vm.nr_hugepages = <value>

Next step is to calculate the number of huge pages in Kb and give the “sybase” user permission to grab the memory. Take the number of huge pages as calculated above. Then multiply by 2048. That wil give you the number of pages in Kb. Example: 235520 x 2048 = 482344960. Then have it stored in /etc/security/limits.conf like this

sybase soft memlock 482344960
sybase hard memlock 482344960

In this example, "sybase" is assumed to be the unix user running ASE.

Now reboot the Linux server to check if everything works as expected.

To see the configured number of huge pages at runtime:

cat /proc/sys/vm/nr_hugepages

Notes:
* As per Sybase recommendation (CR 627114) “lock shared memory” must be switched off.
* When ASE uses huge pages, it will allocate memory to the nearest multiple of 256Mb so don’t configure the ASE exactly to the maximum number of huge pages, but leave a small amount unused (e.g. 300 Mb). In case a small increase in size is needed due to the change of a Sybase config you will not get into trouble.

=Number of file descriptors=
You may need to increase the number of file descriptors per process if you get this error:

The number of file descriptors per ASE process required to support the current configuration exceeds the limit 4096 by 3955.

Make the following changes to /etc/security/limits.conf

sybase soft nofile 16384
sybase hard nofile 16384

In this example, "sybase" is assumed to be the unix user running ASE.

Log off and log on again to pick up the new settings.

=DISK I/O=
==fs.aio-max-nr ==
fs.aio-max-nr is the maximum number of asynchronous I/Os.

The recommended minimum value for fs.aio-max-nr is 1048576, but on a busy ASE with many engines you may need to have a higher number configured.

In ASE, set these values as a starting point.

* Set “disk i/o structures” to 1048576.
* Set “max async i/os per engine” to 8192.
* Keep "max async i/os per server" at it’s default value (2147483647).

When you have multiple engines configured within ASE then use this formula to calculate the value for fs.aio-max-nr

(disk i/o structures + max async i/os per engine) * max online engines

For example: (1048576 + 8192) * 32 engines = 33816576

Then set the value in /etc/sysctl.conf:

fs.aio-max-nr = 33816576

To get the value at runtime

cat /proc/sys/fs/aio-max-nr

===Troubleshooting fs.aio-max-nr===
When the below messages appear in the ASE errorlog, the configuration of fs.aio-max-nr is not correct:

kernel asynchronous I/O not initialized. The io_setup() system call returned -22.
or
kernel kistartup: asynchronous I/O not available: No such file or directory

Either recalculate the vale or reduce the Sybase related configuration options (“disk i/o structures” and/or “max async i/os per engine”)

===Troubleshooting dstartio===
When this message appears in the errorlog

kernel dstartio: I/O request repeatedly delayed; block number: <nr>, vdn: <nr>
then you need to increase "disk i/o structures" or "max async i/os per engine".

To determine if "disk i/o structures" or "max async i/os per engine" needs to be increased look at the output of sp_sysmon that was captured during the time that the message appeared. Snapshot of output:

I/Os Delayed by
Disk I/O Structures n/a n/a 0 n/a
Server Config Limit n/a n/a 0 n/a
Engine Config Limit n/a n/a 24582 n/a
Operating System Limit n/a n/a 0 n/a

When a non-zero value is reported, increase the corresponding Sybase parameter.
Alternatively, you can run sp_monitorconfig “all” to see if the maximum number of “disk i/o structures” has reached (see column Max_Used).

Be aware that the Linux setting for fs.aio-max-nr may need to be increased as well after changing the Sybase configuration settings.

==Queue depth==
Per Linux volume used by ASE the queue depth must be configured. The default value is 128 but it must be set to 1024.

You can only set the required value at boottime and, depending on the Linux distribution, you need to do it in /etc/init.d/boot.local (Suse) or /etc/init.d/rc.local (Ubuntu) or /etc/rc.d/rc.local (RedHat)

For example:

echo 1024 >/sys/block/sdb/queue/nr_requests

To retrieve the runtime value:

cat /sys/block/sd*/queue/nr_requests

=kernel.randomize_va_space=
This may be Suse and ASE 15.0.3 specific, but it may apply to other Linux / ASE version combinations as well.

Due to a high I/O load you may see stacktraces referring to the cm_writedes module, see below snippet.

00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00007ffff73a56a0 (null)+0x7ffff73a56a0()
00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00000000018fd036 cm_writedes+0x606()

In the later versions of ASE 15.7 this should be fixed and an error message is printed.
To prevent the issue, set the value for kernel.randomize_va_space to 0 in combination with a higher value of “cpu grace time” in ASE, like 1500.
To see the runtime value
cat /proc/sys/kernel/randomize_va_space
To see the boottime value, check /etc/sysctl.conf there must be line like kernel.randomize_va_space = 0

See also http://www.novell.com/support/kb/doc.php?id=7004855

After changing kernel.randomize_va_space do a reboot of the Linux server, as that seems to be necessary.

=Prevent a firewall from dropping idle connections=
==For connections to ASE==
When your Sybase server is behind a firewall there is always the risk that a connection from the client side (e.g. running isql) to ASE will be dropped when the firewall sees it as an idle session. This is regardless whether the session is really idle or that it is just a very long running query. To prevent it, put this in /etc/sysctl.conf

net.ipv4.tcp_keepalive_time = 300

and activate it

sysctl -p

==For ssh sessions==
===Putty===
Enable TCP keepalive. On the start screen of Putty click "Connection" and activate the check-box "Enable TCP keepalives".
===ssh===
Create a config file in your ssh directory (~/.ssh/config) with the following content
Host *
ServerAliveInterval 60
ServerAliveCountMax 1000
TCPKeepAlive=yes

Whenever you use ssh tell it to use the config file
ssh -F ~/.ssh/config <server>

=Soft / Hard limits for memory allocation (Suse only)=
By default, no more than 80 % of available memory (RAM and swap) can be claimed by a single process. This is the soft-virtual limit. To check the setting: cat /etc/sysconfig/ulimit and look for the value specified as SOFTVIRTUALLIMIT. Default is “80”.

Increase the setting as setting as needed, or set to “0” for unlimited.

Associated Sybase error message:

Attempt to attach shared memory (id 32768) at address (nil), with flags 0 failed

[[category:ASE]]

Linux configuration settings for Sybase ASE

2015-12-02T16:12:13Z

Psap:

To run Sybase ASE successfully on a Linux environment you need to configure a number of items. Below you will find a few of these, but please note that this is by far not an full overview. There could be more improvements to be made.

=Memory – Huge Pages=
The configuration of Huge Pages is needed to get an efficient translation from virtual memory pages to physical pages. When you configure for Huge Pages, the amount of memory assigned to Huge Pages is allocated and reserved for shared memory. Do not over configure to prevent swapping.

When ASE reports the below message in the errorlog, you need to configure for huge pages:

Could not allocate memory using Huge Pages. Allocated using regular pages. For better performance, reboot the server after configuring enough Huge Pages.

To get the values for huge pages first determine the maximum amount of memory you want to give to ASE. For instance, on a Linux server with 512Gb physical memory you can give 90% to ASE.
512 Gb x 90% = 460 Gb = 471040 Mb.

Then determine the size of a single huge page:

cat /proc/meminfo | grep Hugepagesize

Sample output:

Hugepagesize: 2048 kB

In this case 1 huge page is 2 Mb, so the number of huge pages we need will be 471040 Mb / 2 Mb = 235520

Then set the correct value in /etc/sysctl.conf:

vm.nr_hugepages = <value>

Next step is to calculate the number of huge pages in Kb and give the “sybase” user permission to grab the memory. Take the number of huge pages as calculated above. Then multiply by 2048. That wil give you the number of pages in Kb. Example: 235520 x 2048 = 482344960. Then have it stored in /etc/security/limits.conf like this

sybase soft memlock 482344960
sybase hard memlock 482344960

In this example, "sybase" is assumed to be the unix user running ASE.

Now reboot the Linux server to check if everything works as expected.

To see the configured number of huge pages at runtime:

cat /proc/sys/vm/nr_hugepages

Notes:
* As per Sybase recommendation (CR 627114) “lock shared memory” must be switched off.
* When ASE uses huge pages, it will allocate memory to the nearest multiple of 256Mb so don’t configure the ASE exactly to the maximum number of huge pages, but leave a small amount unused (e.g. 300 Mb). In case a small increase in size is needed due to the change of a Sybase config you will not get into trouble.

=Number of file descriptors=
You may need to increase the number of file descriptors per process if you get this error:

The number of file descriptors per ASE process required to support the current configuration exceeds the limit 4096 by 3955.

Make the following changes to /etc/security/limits.conf

sybase soft nofile 16384
sybase hard nofile 16384

In this example, "sybase" is assumed to be the unix user running ASE.

Log off and log on again to pick up the new settings.

=DISK I/O=
==fs.aio-max-nr ==
fs.aio-max-nr is the maximum number of asynchronous I/Os.

The recommended minimum value for fs.aio-max-nr is 1048576, but on a busy ASE with many engines you may need to have a higher number configured.

In ASE, set these values as a starting point.

* Set “disk i/o structures” to 1048576.
* Set “max async i/os per engine” to 8192.
* Keep "max async i/os per server" at it’s default value (2147483647).

When you have multiple engines configured within ASE then use this formula to calculate the value for fs.aio-max-nr

(disk i/o structures + max async i/os per engine) * max online engines

For example: (1048576 + 8192) * 32 engines = 33816576

Then set the value in /etc/sysctl.conf:

fs.aio-max-nr = 33816576

To get the value at runtime

cat /proc/sys/fs/aio-max-nr

===Troubleshooting fs.aio-max-nr===
When the below messages appear in the ASE errorlog, the configuration of fs.aio-max-nr is not correct:

kernel asynchronous I/O not initialized. The io_setup() system call returned -22.
or
kernel kistartup: asynchronous I/O not available: No such file or directory

Either recalculate the vale or reduce the Sybase related configuration options (“disk i/o structures” and/or “max async i/os per engine”)

===Troubleshooting dstartio===
When this message appears in the errorlog

kernel dstartio: I/O request repeatedly delayed; block number: <nr>, vdn: <nr>
then you need to increase "disk i/o structures" or "max async i/os per engine".

To determine if "disk i/o structures" or "max async i/os per engine" needs to be increased look at the output of sp_sysmon that was captured during the time that the message appeared. Snapshot of output:

I/Os Delayed by
Disk I/O Structures n/a n/a 0 n/a
Server Config Limit n/a n/a 0 n/a
Engine Config Limit n/a n/a 24582 n/a
Operating System Limit n/a n/a 0 n/a

When a non-zero value is reported, increase the corresponding Sybase parameter.
Alternatively, you can run sp_monitorconfig “all” to see if the maximum number of “disk i/o structures” has reached (see column Max_Used).

Be aware that the Linux setting for fs.aio-max-nr may need to be increased as well after changing the Sybase configuration settings.

==Queue depth==
Per Linux volume used by ASE the queue depth must be configured. The default value is 128 but it must be set to 1024.

You can only set the required value at boottime and, depending on the Linux distribution, you need to do it in /etc/init.d/boot.local (Suse) or /etc/init.d/rc.local (Ubuntu) or /etc/rc.d/rc.local (RedHat)

For example:

echo 1024 >/sys/block/sdb/queue/nr_requests

To retrieve the runtime value:

cat /sys/block/sd*/queue/nr_requests

=kernel.randomize_va_space=
This may be Suse and ASE 15.0.3 specific, but it may apply to other Linux / ASE version combinations as well.

Due to a high I/O load you may see stacktraces referring to the cm_writedes module, see below snippet.

00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00007ffff73a56a0 (null)+0x7ffff73a56a0()
00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00000000018fd036 cm_writedes+0x606()

In the later versions of ASE 15.7 this should be fixed and an error message is printed.
To prevent the issue, set the value for kernel.randomize_va_space to 0 in combination with a higher value of “cpu grace time” in ASE, like 1500.
To see the runtime value
cat /proc/sys/kernel/randomize_va_space
To see the boottime value, check /etc/sysctl.conf there must be line like kernel.randomize_va_space = 0

See also http://www.novell.com/support/kb/doc.php?id=7004855

After changing kernel.randomize_va_space do a reboot of the Linux server, as that seems to be necessary.

=Prevent a firewall from dropping idle connections=
==For connections to ASE==
When your Sybase server is behind a firewall there is always the risk that a connection from the client side (e.g. running isql) to ASE will be dropped when the firewall sees it as an idle session. This is regardless weather the session is really idle or that it is just a very long running query. To prevent it, put this in /etc/sysctl.conf

net.ipv4.tcp_keepalive_time = 300

and activate it

sysctl -p

==For ssh sessions==
===Putty===
Enable TCP keepalive. On the start screen of Putty click "Connection" and activate the check-box "Enable TCP keepalives".
===ssh===
Create a config file in your ssh directory (~/.ssh/config) with the following content
Host *
ServerAliveInterval 60
ServerAliveCountMax 1000
TCPKeepAlive=yes

Whenever you use ssh tell it to use the config file
ssh -F ~/.ssh/config <server>

=Soft / Hard limits for memory allocation (Suse only)=
By default, no more than 80 % of available memory (RAM and swap) can be claimed by a single process. This is the soft-virtual limit. To check the setting: cat /etc/sysconfig/ulimit and look for the value specified as SOFTVIRTUALLIMIT. Default is “80”.

Increase the setting as setting as needed, or set to “0” for unlimited.

Associated Sybase error message:

Attempt to attach shared memory (id 32768) at address (nil), with flags 0 failed

[[category:ASE]]

Docker - How to run Sybase ASE in a container

2015-11-17T19:35:56Z

Psap: /* For data */

This page will show you how SAP Sybase ASE (version 16.0 GA PL01) can be run in a docker container. You will also see how to work with docker images, containters and volumes.

All tests have been carried out on a Linux Centos 7 environment, I expect little to no change if you need to run it on Redhat. You need about 10 Gb of free space to install the Sybase software, database devices, etc. Beware that you need to split this free space into several separately mounted filesystems.

The Sybase ASE server will be called "ASE1".

No performance optimization has been done for docker nor for Sybase.

Unless otherwise noted, all commands need to be run under "root".

=Prepare the system=
Prepare your system to run docker and create the sybase user.
==Package update==
Under Centos / Redhat 7 firewalld can conflict with docker so we will remove it from the system.
yum remove firewalld

Make sure you have the latest patches installed. Reboot if a new kernel has been downloaded.
yum update
reboot

==Add sybase user and group==
Docker data volumes are separate filesystems on the Linux and are made available in a docker container. The sybase processes running in these containers must have the same uid/guid for the sybase user as on the host system (your Centos / Redhat server). Keep the uid/gid for the sybase user everywhere the same.

groupadd sybase -g <free-number>
useradd -u <free-number> -g sybase sybase

=Initial docker setup=

Install docker, start it, and have it started when the Linux server boots.

yum install docker
systemctl start docker
systemctl enable docker

If you run "docker images" you can see the available images. Download a basic docker image for centos.

docker images
docker pull centos
docker images

=Create 2 docker images customized for Sybase=
We will create 2 new docker images based on the centos image that has been downloaded previously. The first image will be used to store data (database devices, dump files) and the second image is used to run the Sybase processes. It is technically possible to use just 1 image.
==For data==
Run the centos image and start a bash shell. Make a note of the container id that is shown at the prompt.
docker run -t -i centos /bin/bash

Sample output:
docker run -t -i centos /bin/bash
[root@2d0c8aae3341 /]#
In this case the container id is 2d0c8aae3341.

yum update

Add the sybase group and user making sure that the uid and gid match with the host
groupadd sybase -g <number>
useradd -u <number> -g sybase sybase
exit

Create a new image based on the actions we have made
docker commit -m "sybase data image" -a "Peter Sap" <container-ID> sybase_data/centos:v1
docker images

==For the Sybase processes==
Run the centos image once more to install the additional packages that are required to run Sybase processes.
docker run -t -i centos /bin/bash
yum update
yum install glibc.i686 libaio
groupadd sybase -g <free-number>
useradd -u <free-number> -g sybase sybase
exit
docker commit -m "sybase server image" -a "Peter Sap" <2nd container-ID> sybase_server/centos:v1
docker images

=Setup storage=
In the test case that I have used a disk of 10 Gb was available at /dev/sdb. Modify all storage related instructions to your specific environment.

pvcreate /dev/sdb
vgcreate docker_vg /dev/sdb

=Create the docker container for the database files=
==Setup storage==
Create a filesystem of 2 Gb for the database files. Consider this as a bare minumum not sized for user databases nor for database dump files.
lvcreate -L 2G -n ASE1_data docker_vg
mkfs /dev/docker_vg/ASE1_data
mkdir /ASE1_data
mount /dev/docker_vg/ASE1_data /ASE1_data
chown sybase:sybase /ASE1_data

==Create a Dockerfile and the image==
mkdir -p /var/docker_projects/sybase_data
vi /var/docker_projects/sybase_data/Dockerfile

# Dockerfile for sybase data volume containers
FROM sybase_data/centos:v1
MAINTAINER peter@petersap.nl
USER sybase

Build the image
docker build -t="sybase/data:v1" /var/docker_projects/sybase_data

==Create the container==

docker create --privileged=true -v /ASE1_data:/ASE1_data --name=ASE1_data -t -i sybase/data:v1

=Create the container for the Sybase software=

==Setup storage==
Create a filesystem of 6 Gb for the Sybase software.
lvcreate -L 6G -n sybase-ase160.22544 docker_vg
mkfs /dev/docker_vg/sybase-ase160.22544
mkdir /sybase-ase160.22544
mount /dev/docker_vg/sybase-ase160.22544 /sybase-ase160.22544
chown sybase:sybase /sybase-ase160.22544

==Install the Sybase software==
su - sybase
cd /sybase-ase160.22544
Copy the Sybase software into the current directory
scp <user>@<server>:<directory>/EBF22544.tgz .
tar -xf EBF22544.tgz
rm EBF22544.tgz
cd ebf22544
Run the installer, install the software in /sybase-ase160.22544. Do not configure any of the products.
./setup.bin
cd ..
rm -Rf ebf22544
Type exit to go back to root
exit

==Create the container==
Note that we use the "sybase/data:v1" image again, as we did when the container for the database files was created.
docker create --privileged=true -v /sybase-ase160.22544:/sybase-ase160.22544 --name=ase160.22544 -t -i sybase/data:v1

=Create the container to run Sybase ASE=
==Setup storage==
Create a filesystem of 2 Gb to store the errorlog files, startup scripts, etc.
lvcreate -L 2G -n ASE1_server docker_vg
mkfs /dev/docker_vg/ASE1_server
mkdir /ASE1_server
mount /dev/docker_vg/ASE1_server /ASE1_server
chown sybase:sybase /ASE1_server

==Create a Dockerfile==
mkdir -p /var/docker_projects/sybase_server
vi /var/docker_projects/sybase_server/Dockerfile

# Dockerfile for sybase server containers
FROM sybase_server/centos:v1
MAINTAINER peter@petersap.nl
USER sybase

==Build the image==
docker build -t="sybase/server:v1" /var/docker_projects/sybase_server

==Create the container==
Change the ip-address 10.0.0.29 to match your own environment. The port numbers 5000 can also be changed. Remember to make the same changes later on.

As you can see below, the "docker create" statement references to the containers that have already been created, using the --volumes-from option.
docker create --hostname=ASE1_server --publish=10.0.0.29:5000:5000 --privileged=true --volumes-from ASE1_data --volumes-from ase160.22544 -v /ASE1_server:/ASE1_server --name=ASE1_server -t -i sybase/server:v1

=Build the Sybase ASE server=
At this point we have created the containers for the Sybase software (with the software installed), a container for the database devices and a container to run ASE. Now we will start the container for running ASE and build the Sybase server.
==Start the container==
docker start --attach=true --interactive=true ASE1_server

You should get a bash shell while running the container.

Source in the Sybase environment variables.
. /sybase-ase160.22544/SYBASE.sh
==Create a resource file==
Create a resource file for building ASE

cd /ASE1_server
vi ASE1.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: ASE1_server
sqlsrv.network_port_list: 5000
sqlsrv.application_type: USE_DEFAULT
sqlsrv.server_page_size: USE_DEFAULT
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /ASE1_data/master.dat
sqlsrv.master_device_size: USE_DEFAULT
sqlsrv.master_database_size: USE_DEFAULT
sqlsrv.errorlog: /ASE1_server/ASE1.errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /ASE1_data/sybsystemprocs.dat
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /ASE1_data/sybsystemdb.dat
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /ASE1_data/tempdb.dat
sqlsrv.tempdb_device_size: USE_DEFAULT
sqlsrv.tempdb_database_size: USE_DEFAULT
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: no
sqlsrv.avail_physical_memory: PUT_THE_AVAILABLE_PHYSICAL_MEMORY_FOR_ASE_IN_OPTIMIZATION
sqlsrv.avail_cpu_num: PUT_THE_AVAILABLE_NUMBER_CPU_FOR_ASE_IN_OPTIMIZATION
==Build ASE1==
srvbuildres -r ASE1.rs

Add an extra entry to the interfaces file to allow ASE to connect to the backupserver that will be running in another container. Remember to make changes to the ip-address and port number where needed.

vi $SYBASE/interfaces

Add these lines

SYB_BACKUP_docker
query tcp ether 10.0.0.29 5001

Modify the corresponding entry in ASE. Also, configure "console logging" to capture the ASE errorlog inside the log file of the running container.

isql -Usa -Psecret123 -SASE1
sp_addserver SYB_BACKUP,null,SYB_BACKUP_docker
go
sp_configure 'enable console logging',1
go
exit
==Create a start script==
Create a script that will start ASE1 when the docker container is kicked off.

cd /ASE1_server
vi start_ASE1.sh

#!/bin/sh

# Source in the Sybase environment variables

. /sybase-ase160.22544/SYBASE.sh

# Start ASE1
${SYBASE}/${SYBASE_ASE}/install/RUN_ASE1
RET=$?

exit ${RET}

chmod +x start_ASE1.sh
exit

You should now be back at the root prompt of your Linux centos/redhat host.

=Create a new container that will kick off ASE1 when the container starts=
As you have seen above, if you start the container you will get a bash prompt. Now we need to build the container once more with the ENTRYPOINT clause in the Dockerfile so start script is executed where container ASE1_server is started.
==Create a Dockerfile==
mkdir -p /var/docker_projects/ASE1_server
cp /var/docker_projects/sybase_server/Dockerfile /var/docker_projects/ASE1_server

Add this line to the new Dockerfile (/var/docker_projects/ASE1_server/Dockerfile)

ENTRYPOINT /ASE1_server/start_ASE1.sh

==Create image and container==

docker build -t="sybase/ase1:v1" /var/docker_projects/ASE1_server
docker rm ASE1_server
docker create --hostname=ASE1_server --publish=10.0.0.29:5000:5000 --privileged=true --volumes-from ASE1_data --volumes-from ase160.22544 -v /ASE1_server:/ASE1_server --name=ASE1_server -t -i sybase/ase1:v1
==Start the container to run ASE1==
docker start ASE1_server
Run "docker ps" to see the container running. If it is not running do "docker logs ASE1_server".
docker ps

=Build the Sybase backup server=
==Create the container==

docker create --hostname=ASE1_BCK_server --publish=10.0.0.29:5001:5001 --privileged=true --volumes-from ASE1_server --name=ASE1_BCK_server -t -i sybase/server:v1

==Build the Sybase backup server==

docker start --attach=true --interactive=true ASE1_BCK_server

. /sybase-ase160.22544/SYBASE.sh
cd /ASE1_server
vi SYB_BACKUP.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: ASE1_BCK_server
bsrv.network_port_list: 5001
bsrv.allow_hosts_list: +
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /ASE1_server/SYB_BACKUP.errorlog
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

srvbuildres -r SYB_BACKUP.rs

==Create a start script==
Create a script that will start the backup server when the docker container is started

vi start_ASE1_BCK.sh

#!/bin/sh

# Source in the Sybase environment variables

. /sybase-ase160.22544/SYBASE.sh

# Start ASE1_BCK
${SYBASE}/${SYBASE_ASE}/install/RUN_SYB_BACKUP
RET=$?

exit ${RET}

chmod +x start_ASE1_BCK.sh
exit

==Create a new container that will kick off ASE1_BCK when the container starts==
mkdir -p /var/docker_projects/ASE1_BCK_server
cp /var/docker_projects/sybase_server/Dockerfile /var/docker_projects/ASE1_BCK_server

Add this line to the new Dockerfile (/var/docker_projects/ASE1_BCK_server/Dockerfile)

ENTRYPOINT /ASE1_server/start_ASE1_BCK.sh

Create a new image and a new container, remember to change the ip-address and the port number.

docker build -t="sybase/ase1_bck:v1" /var/docker_projects/ASE1_BCK_server
docker rm ASE1_BCK_server
docker create --hostname=ASE1_BCK_server --publish=10.0.0.29:5001:5001 --privileged=true --volumes-from ASE1_server --name=ASE1_BCK_server -t -i sybase/ase1_bck:v1
docker start ASE1_BCK_server

=How to manage the Sybase instances=

Sybase ASE and backup server can be stopped and started with docker commands
docker start ASE1_server
docker start ASE1_BCK_server
docker ps
docker stop ASE1_server
docker stop ASE1_BCK_server

If you run the "shutdown" command in Sybase ASE the server will stop and the docker container will also end. Same for the backup server if you run "shutdown SYB_BACKUP" in ASE.

If for some reason a server will not start (or crashes) you can examine the console log file
docker logs ASE1_server

All the Sybase files are also accesable on the Linux (centos/Redhat) host so if a container will not start anymore you can still make changes to the configuration.

=Wrapping up=

==add to /etc/fstab==
Add the filesystems to /etc/fstab
/dev/docker_vg/sybase-ase160.22544 /sybase-ase160.22544 ext2 defaults 0 0
/dev/docker_vg/ASE1_data /ASE1_data ext2 defaults 0 0
/dev/docker_vg/ASE1_server /ASE1_server ext2 defaults 0 0

[[category:ASE]]

Sybase links

2015-11-08T10:56:11Z

Psap:

Links to other popular websites

===Sybase documentation===
[http://infocenter.sybase.com/help/index.jsp Online documentation from Sybase]

[http://manuals.sybase.com/onlinebooks/group-as/asg1250e/sqlug/@Generic__BookView Transact-SQL User's Guide (12.5)]

[http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.sqlug/html/sqlug/title.htm Transact-SQL User's Guide (15.0)]

===Community sites===
[http://www.sypron.nl/main.html Sybase Tips, Tricks, Tools & Documentation by Rob Verschoor]

[http://www.peppler.org/FAQ/linux.html Sybase ASE on Linux FAQ]

[http://www.faqs.org/faqs/databases/sybase-faq/part1/ Sybase FAQ]

[http://www.rocket99.com/index.html Rocket99 Guide to Sybase, Oracle, UNIX, and More]

[http://www.selectorweb.com/sybase.html Info from Lev Selector]

Sybase links

2015-11-08T10:55:36Z

Psap: /* Sybase */

Links to other popular websites

===Sybase===
[http://www.sybase.com Database Management, Mobile Solutions and Messaging, Data Warehousing, Data Integration - Sybase Inc]

===Sybase documentation===
[http://infocenter.sybase.com/help/index.jsp Online documentation from Sybase]

[http://manuals.sybase.com/onlinebooks/group-as/asg1250e/sqlug/@Generic__BookView Transact-SQL User's Guide (12.5)]

[http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.sqlug/html/sqlug/title.htm Transact-SQL User's Guide (15.0)]

===Community sites===
[http://www.sypron.nl/main.html Sybase Tips, Tricks, Tools & Documentation by Rob Verschoor]

[http://www.peppler.org/FAQ/linux.html Sybase ASE on Linux FAQ]

[http://www.faqs.org/faqs/databases/sybase-faq/part1/ Sybase FAQ]

[http://www.rocket99.com/index.html Rocket99 Guide to Sybase, Oracle, UNIX, and More]

[http://www.selectorweb.com/sybase.html Info from Lev Selector]

Sybase links

2015-11-08T10:53:23Z

Psap: /* Tools */

Links to other popular websites

===Sybase===
[http://www.sybase.com Database Management, Mobile Solutions and Messaging, Data Warehousing, Data Integration - Sybase Inc]

[http://www.youtube.com/user/SybaseInc Promotional videos from Sybase at YouTube]

===Sybase documentation===
[http://infocenter.sybase.com/help/index.jsp Online documentation from Sybase]

[http://manuals.sybase.com/onlinebooks/group-as/asg1250e/sqlug/@Generic__BookView Transact-SQL User's Guide (12.5)]

[http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.sqlug/html/sqlug/title.htm Transact-SQL User's Guide (15.0)]

===Community sites===
[http://www.sypron.nl/main.html Sybase Tips, Tricks, Tools & Documentation by Rob Verschoor]

[http://www.peppler.org/FAQ/linux.html Sybase ASE on Linux FAQ]

[http://www.faqs.org/faqs/databases/sybase-faq/part1/ Sybase FAQ]

[http://www.rocket99.com/index.html Rocket99 Guide to Sybase, Oracle, UNIX, and More]

[http://www.selectorweb.com/sybase.html Info from Lev Selector]

Sybase links

2015-11-08T10:52:51Z

Psap: /* Tools */

Links to other popular websites

===Sybase===
[http://www.sybase.com Database Management, Mobile Solutions and Messaging, Data Warehousing, Data Integration - Sybase Inc]

[http://www.youtube.com/user/SybaseInc Promotional videos from Sybase at YouTube]

===Sybase documentation===
[http://infocenter.sybase.com/help/index.jsp Online documentation from Sybase]

[http://manuals.sybase.com/onlinebooks/group-as/asg1250e/sqlug/@Generic__BookView Transact-SQL User's Guide (12.5)]

[http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.sqlug/html/sqlug/title.htm Transact-SQL User's Guide (15.0)]

===Tools===
[http://www.sqsh.org Sqsh Home Page]

===Community sites===
[http://www.sypron.nl/main.html Sybase Tips, Tricks, Tools & Documentation by Rob Verschoor]

[http://www.peppler.org/FAQ/linux.html Sybase ASE on Linux FAQ]

[http://www.faqs.org/faqs/databases/sybase-faq/part1/ Sybase FAQ]

[http://www.rocket99.com/index.html Rocket99 Guide to Sybase, Oracle, UNIX, and More]

[http://www.selectorweb.com/sybase.html Info from Lev Selector]

Warm Standby setup instructions

2015-10-12T11:50:12Z

Psap: /* Preparation of the Replication Server */

Sybase Replication Server allows you to create and maintain a warm standby environment. The creation can be done with, for instance, the rs_init utility or Sybase Central. In some cases extra flexibility is needed and this can best be achieved when command line statements are used.
For various other reasons people prefer using this method.

This page describes the steps to be taken to create a warm standby environment through a combination of commands given to ASE and Replication Server. It should be considered as a kind of worksheet. Feel free to make changes to suit your individual need. This might be needed when you are dealing with a database with big table(s) holding text or image datatypes or you want to optimize performance using replication definitions and subscriptions.

==Assumptions of the environment==
* The setup makes the following assumptions:
* The Replication Server is already configured and running.
* Replication is done between ASE servers
* Materialization will be done with a dump-load scenario
* Replication is performed without replication definitions and subscriptions
* User activity will continue throughout the creation process
The setup is divided into a number of steps, where each step is a separate unit of work.

==Preparation of the Sybase ASE-servers==
'''Create a maintenance user on both ASE's'''

The maintenance user is used by the replication server to apply transactions. Make sure that the name and password of the maintenance user on both servers are identical. For practical reasons make the maintenance user aliased to "dbo" in the database. Since a dump-load scenario is used to materialize the standby database, make sure that the suid of the maintenance user on both servers are identical.

sp_addlogin "<maintenance_user>","<maintenance_user_password>"
go
grant role replication_role to "<maintenance_user>"
go
-- check the value of the suid
select suser_id("<maintenance_user>")
go
use <database>
go
sp_addalias "<maintenance_user>","dbo"
go

'''Install the replication server stored procedures and tables'''

To do this, make a copy of the script rs_install_primary.sql located in the $SYBASE/$SYBASE_REP/scripts directory. Comment out 2 commands of the script: the dbcc settrunc and the sp_setreplicate commands. These can be found at the end of the file, or just above the definition of the rs_send_repserver_cmd stored procedure.

The commands that are skipped will be executed at a later stage, when the replication agent is configured. Apply the script on the active server in the right database.

isql -Usa -P<password> -S<active_server> -D<database> -i changed_rs_install_primary.sql

'''Configure both servers for replication'''

sp_configure "enable rep agent threads",1

==Preparation of the Replication Server==
'''Create a logical connection on the replication server'''

The name of it does not have to match with the name of the primary database server and database, but this convention is widely used.

create logical connection to <active_server>.<database>

'''Create a connection from the replication server to the active database'''

create connection to <active_server>.<database>
set error class to rs_sqlserver_error_class
set function string class to rs_sqlserver_function_class
set username to <maintenance_user>
set password to <maintenance_user_password>
with log transfer on
as active for <active_server>.<database>

'''Create a login in the replication server'''

This login is used by the rep-agent running in the ASE to connect to the replication server.

create user <rep-agent_user>
set password <rep-agent_password>
set password_expiration to '0'
go
grant connect source to <rep-agent_user>
go

==Configure the RepAgent==
The configuration of the Replication Agent within the active ASE should now be done. All steps within this paragraph should be executed within a controlled time frame since the transaction log cannot be cleared between the execution of the first sp_config_rep_agent and the sp_start_rep_agent.
The configuration is only needed on the primary server. Since we use a dump-load scenario the configuration is copied to the standby server during the materialization phase.

use <database>
go
sp_config_rep_agent "<database>", "enable", "<repserver>", "<rep-agent_user>", "<rep-agent_password>"
go
sp_config_rep_agent "<database>", "send warm standby xacts", true
go
sp_setreplicate rs_marker,"true"
go
sp_setreplicate rs_update_lastcommit,"true"
go
sp_start_rep_agent "<database>"
go

==Mark the database for replication and grant permissions==
Execute the sp_reptostandby stored procedure in the active ASE to activate replication from the active database to the replication server.

We also need to grant permissions to a few stored procedures.

use <database>
go
grant execute on rs_update_lastcommit to public
grant execute on rs_marker to public
grant execute on rs_check_repl_stat to public
go
sp_reptostandby "<database>","all"
go

==Configure the replication server for the standby database==
All steps within this paragraph should be executed within a controlled time frame since the stable queue in the replication server cannot be cleared between the execution of the create connection and resume connection.

'''Create a connection from the replication server to the standby server'''

create connection to <standby-server>.<database>
set error class to rs_sqlserver_error_class
set function string class to rs_sqlserver_function_class
set username to <maintenance_user>
set password to <maintenance_user_password>
with log transfer on
as standby for <active_server>.<database>
use dump marker

'''Dump the database on the active server so it can be loaded into the standby server'''

dump database <database> to "<file-name>"

'''Load the database dump into the standby server'''

load database <database> from "<file-name>"
go
online database <database>
go

'''Start the connection from the replication server to the standby database'''

resume connection to <standby-server>.<database>

Congratulations, you now have a working Warm Standby configuration!

[[Category:RepServer]]

Linux configuration settings for Sybase ASE

2015-10-09T12:09:11Z

Psap:

To run Sybase ASE successfully on a Linux environment you need to configure a number of items. Below you will find a few of these, but please note that this is by far not an full overview. There could be more improvements to be made.

=Memory – Huge Pages=
The configuration of Huge Pages is needed to get an efficient translation from virtual memory pages to physical pages. When you configure for Huge Pages, the amount of memory assigned to Huge Pages is allocated and reserved for shared memory. Do not over configure to prevent swapping.

When ASE reports the below message in the errorlog, you need to configure for huge pages:

Could not allocate memory using Huge Pages. Allocated using regular pages. For better performance, reboot the server after configuring enough Huge Pages.

To get the values for huge pages first determine the maximum amount of memory you want to give to ASE. For instance, on a Linux server with 512Gb physical memory you can give 90% to ASE.
512 Gb x 90% = 460 Gb = 471040 Mb.

Then determine the size of a single huge page:

cat /proc/meminfo | grep Hugepagesize

Sample output:

Hugepagesize: 2048 kB

In this case 1 huge page is 2 Mb, so the number of huge pages we need will be 471040 Mb / 2 Mb = 235520

Then set the correct value in /etc/sysctl.conf:

vm.nr_hugepages = <value>

Next step is to calculate the number of huge pages in Kb and give the “sybase” user permission to grab the memory. Take the number of huge pages as calculated above. Then multiply by 2048. That wil give you the number of pages in Kb. Example: 235520 x 2048 = 482344960. Then have it stored in /etc/security/limits.conf like this

sybase soft memlock 482344960
sybase hard memlock 482344960

In this example, "sybase" is assumed to be the unix user running ASE.

Now reboot the Linux server to check if everything works as expected.

To see the configured number of huge pages at runtime:

cat /proc/sys/vm/nr_hugepages

Notes:
* As per Sybase recommendation (CR 627114) “lock shared memory” must be switched off.
* When ASE uses huge pages, it will allocate memory to the nearest multiple of 256Mb so don’t configure the ASE exactly to the maximum number of huge pages, but leave a small amount unused (e.g. 300 Mb). In case a small increase in size is needed due to the change of a Sybase config you will not get into trouble.

=Number of file descriptors=
You may need to increase the number of file descriptors per process if you get this error:

The number of file descriptors per ASE process required to support the current configuration exceeds the limit 4096 by 3955.

Make the following changes to /etc/security/limits.conf

sybase soft nofile 16384
sybase hard nofile 16384

In this example, "sybase" is assumed to be the unix user running ASE.

Log off and log on again to pick up the new settings.

=DISK I/O=
==fs.aio-max-nr ==
fs.aio-max-nr is the maximum number of asynchronous I/Os.

The recommended minimum value for fs.aio-max-nr is 1048576, but on a busy ASE with many engines you may need to have a higher number configured.

In ASE, set these values as a starting point.

* Set “disk i/o structures” to 1048576.
* Set “max async i/os per engine” to 8192.
* Keep "max async i/os per server" at it’s default value (2147483647).

When you have multiple engines configured within ASE then use this formula to calculate the value for fs.aio-max-nr

(disk i/o structures + max async i/os per engine) * max online engines

For example: (1048576 + 8192) * 32 engines = 33816576

Then set the value in /etc/sysctl.conf:

fs.aio-max-nr = 33816576

To get the value at runtime

cat /proc/sys/fs/aio-max-nr

===Troubleshooting fs.aio-max-nr===
When the below messages appear in the ASE errorlog, the configuration of fs.aio-max-nr is not correct:

kernel asynchronous I/O not initialized. The io_setup() system call returned -22.
or
kernel kistartup: asynchronous I/O not available: No such file or directory

Either recalculate the vale or reduce the Sybase related configuration options (“disk i/o structures” and/or “max async i/os per engine”)

===Troubleshooting dstartio===
When this message appears in the errorlog

kernel dstartio: I/O request repeatedly delayed; block number: <nr>, vdn: <nr>
then you need to increase "disk i/o structures" or "max async i/os per engine".

To determine if "disk i/o structures" or "max async i/os per engine" needs to be increased look at the output of sp_sysmon that was captured during the time that the message appeared. Snapshot of output:

I/Os Delayed by
Disk I/O Structures n/a n/a 0 n/a
Server Config Limit n/a n/a 0 n/a
Engine Config Limit n/a n/a 24582 n/a
Operating System Limit n/a n/a 0 n/a

When a non-zero value is reported, increase the corresponding Sybase parameter.
Alternatively, you can run sp_monitorconfig “all” to see if the maximum number of “disk i/o structures” has reached (see column Max_Used).

Be aware that the Linux setting for fs.aio-max-nr may need to be increased as well after changing the Sybase configuration settings.

==Queue depth==
Per Linux volume used by ASE the queue depth must be configured. The default value is 128 but it must be set to 1024.

You can only set the required value at boottime and, depending on the Linux distribution, you need to do it in /etc/init.d/boot.local (Suse) or /etc/init.d/rc.local (Ubuntu) or /etc/rc.d/rc.local (RedHat)

For example:

echo 1024 >/sys/block/sdb/queue/nr_requests

To retrieve the runtime value:

cat /sys/block/sd*/queue/nr_requests

=kernel.randomize_va_space=
This may be Suse and ASE 15.0.3 specific, but it may apply to other Linux / ASE version combinations as well.

Due to a high I/O load you may see stacktraces referring to the cm_writedes module, see below snippet.

00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00007ffff73a56a0 (null)+0x7ffff73a56a0()
00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00000000018fd036 cm_writedes+0x606()

In the later versions of ASE 15.7 this should be fixed and an error message is printed.
To prevent the issue, set the value for kernel.randomize_va_space to 0 in combination with a higher value of “cpu grace time” in ASE, like 1500.
To see the runtime value
cat /proc/sys/kernel/randomize_va_space
To see the boottime value, check /etc/sysctl.conf there must be line like kernel.randomize_va_space = 0

See also http://www.novell.com/support/kb/doc.php?id=7004855

After changing kernel.randomize_va_space do a reboot of the Linux server, as that seems to be necessary.

=Soft / Hard limits for memory allocation (Suse only)=
By default, no more than 80 % of available memory (RAM and swap) can be claimed by a single process. This is the soft-virtual limit. To check the setting: cat /etc/sysconfig/ulimit and look for the value specified as SOFTVIRTUALLIMIT. Default is “80”.

Increase the setting as setting as needed, or set to “0” for unlimited.

Associated Sybase error message:

Attempt to attach shared memory (id 32768) at address (nil), with flags 0 failed

[[category:ASE]]

RepServer show changed configuration options

2015-09-09T13:46:57Z

Psap: Created page with "You can use the below SQL statement to see the changes to the Replication Server configuration as they have been made by either rs_configure (on the ASE side) or "configure re..."

You can use the below SQL statement to see the changes to the Replication Server configuration as they have been made by either rs_configure (on the ASE side) or "configure replication server" (on the Replication Server side).

It is assumed that you use ASE as the Replication Server System Database.

select optionname as "Option",
convert(varchar(16),dv) as "Default Value",
convert(varchar(16),charvalue) as "Config value"
from rs_config c
join rs_tvalues t
on c.optionname = t.name
and c.charvalue != t.dv
where t.type = "CF"
and t.value = 1
and not ((c.optionname = "cm_fadeout_time" and charvalue = "300")
or (c.optionname = "exec_nrm_request_limit" and c.charvalue = "8388608")
or (c.optionname = "id_security_mechanism" and c.charvalue = "")
or (c.optionname = "init_sqm_write_delay" and c.charvalue = "100")
or (c.optionname = "init_sqm_write_max_delay" and c.charvalue = "1000")
or (c.optionname = "mat_report_interval" and c.charvalue = "60")
or (c.optionname = "mem_thr_exec" and c.charvalue = "90")
or (c.optionname = "mem_thr_sqt" and c.charvalue = "85")
or (c.optionname = "memory_limit" and c.charvalue = "2047")
or (c.optionname = "sqm_cmd_cache_size" and c.charvalue = "20971520")
or (c.optionname = "sqt_max_cache_size" and c.charvalue = "20971520")
or (c.optionname = "sqt_max_prs_size" and c.charvalue = "2147483647"))
order by 1

Sample output

Option Default Value Config value
------------------------------ ---------------- ----------------
cm_max_connections 144 128
disallowed_prev_passwords 0 12
max_failed_logins 0 3
memory_limit 80 8192
min_password_len 6 8
num_client_connections 30 128
num_mutexes 1024 16777216
num_stable_queues 32 40
password_lowercase_required false true
password_numeric_required false true
password_uppercase_required false true
simple_passwords_allowed true false
sqm_recover_segs 1 4
sqm_write_flush on dio
sqt_max_cache_size 1048576 200000000
sts_cachesize 1000 30000
sts_full_cache_rs_columns off on
sts_full_cache_rs_config off on
sts_full_cache_rs_databases off on
sts_full_cache_rs_diskaffinity off on
sts_full_cache_rs_objects off on
sts_full_cache_rs_queues off on

(22 rows affected)

[[Category:RepServer]]

Docker - How to run Sybase ASE in a container

2015-06-22T11:43:05Z

Psap: Created page with "This page will show you how SAP Sybase ASE (version 16.0 GA PL01) can be run in a docker container. You will also see how to work with docker images, containters and volumes. ..."

This page will show you how SAP Sybase ASE (version 16.0 GA PL01) can be run in a docker container. You will also see how to work with docker images, containters and volumes.

All tests have been carried out on a Linux Centos 7 environment, I expect little to no change if you need to run it on Redhat. You need about 10 Gb of free space to install the Sybase software, database devices, etc. Beware that you need to split this free space into several separately mounted filesystems.

The Sybase ASE server will be called "ASE1".

No performance optimization has been done for docker nor for Sybase.

Unless otherwise noted, all commands need to be run under "root".

=Prepare the system=
Prepare your system to run docker and create the sybase user.
==Package update==
Under Centos / Redhat 7 firewalld can conflict with docker so we will remove it from the system.
yum remove firewalld

Make sure you have the latest patches installed. Reboot if a new kernel has been downloaded.
yum update
reboot

==Add sybase user and group==
Docker data volumes are separate filesystems on the Linux and are made available in a docker container. The sybase processes running in these containers must have the same uid/guid for the sybase user as on the host system (your Centos / Redhat server). Keep the uid/gid for the sybase user everywhere the same.

groupadd sybase -g <free-number>
useradd -u <free-number> -g sybase sybase

=Initial docker setup=

Install docker, start it, and have it started when the Linux server boots.

yum install docker
systemctl start docker
systemctl enable docker

If you run "docker images" you can see the available images. Download a basic docker image for centos.

docker images
docker pull centos
docker images

=Create 2 docker images customized for Sybase=
We will create 2 new docker images based on the centos image that has been downloaded previously. The first image will be used to store data (database devices, dump files) and the second image is used to run the Sybase processes. It is technically possible to use just 1 image.
==For data==
Run the centos image and start a bash shell. Make a note of the container id that is shown at the prompt.
docker run -t -i centos /bin/bash

yum update

Add the sybase group and user making sure that the uid and gid match with the host
groupadd sybase -g <number>
useradd -u <number> -g sybase sybase
exit

Create a new image based on the actions we have made
docker commit -m "sybase data image" -a "Peter Sap" <container-ID> sybase_data/centos:v1
docker images

==For the Sybase processes==
Run the centos image once more to install the additional packages that are required to run Sybase processes.
docker run -t -i centos /bin/bash
yum update
yum install glibc.i686 libaio
groupadd sybase -g <free-number>
useradd -u <free-number> -g sybase sybase
exit
docker commit -m "sybase server image" -a "Peter Sap" <2nd container-ID> sybase_server/centos:v1
docker images

=Setup storage=
In the test case that I have used a disk of 10 Gb was available at /dev/sdb. Modify all storage related instructions to your specific environment.

pvcreate /dev/sdb
vgcreate docker_vg /dev/sdb

=Create the docker container for the database files=
==Setup storage==
Create a filesystem of 2 Gb for the database files. Consider this as a bare minumum not sized for user databases nor for database dump files.
lvcreate -L 2G -n ASE1_data docker_vg
mkfs /dev/docker_vg/ASE1_data
mkdir /ASE1_data
mount /dev/docker_vg/ASE1_data /ASE1_data
chown sybase:sybase /ASE1_data

==Create a Dockerfile and the image==
mkdir -p /var/docker_projects/sybase_data
vi /var/docker_projects/sybase_data/Dockerfile

# Dockerfile for sybase data volume containers
FROM sybase_data/centos:v1
MAINTAINER peter@petersap.nl
USER sybase

Build the image
docker build -t="sybase/data:v1" /var/docker_projects/sybase_data

==Create the container==

docker create --privileged=true -v /ASE1_data:/ASE1_data --name=ASE1_data -t -i sybase/data:v1

=Create the container for the Sybase software=

==Setup storage==
Create a filesystem of 6 Gb for the Sybase software.
lvcreate -L 6G -n sybase-ase160.22544 docker_vg
mkfs /dev/docker_vg/sybase-ase160.22544
mkdir /sybase-ase160.22544
mount /dev/docker_vg/sybase-ase160.22544 /sybase-ase160.22544
chown sybase:sybase /sybase-ase160.22544

==Install the Sybase software==
su - sybase
cd /sybase-ase160.22544
Copy the Sybase software into the current directory
scp <user>@<server>:<directory>/EBF22544.tgz .
tar -xf EBF22544.tgz
rm EBF22544.tgz
cd ebf22544
Run the installer, install the software in /sybase-ase160.22544. Do not configure any of the products.
./setup.bin
cd ..
rm -Rf ebf22544
Type exit to go back to root
exit

==Create the dontainer==
Note that we use the "sybase/data:v1" image again, as we did when the container for the database files was created.
docker create --privileged=true -v /sybase-ase160.22544:/sybase-ase160.22544 --name=ase160.22544 -t -i sybase/data:v1

=Create the container to run Sybase ASE=
==Setup storage==
Create a filesystem of 2 Gb to store the errorlog files, startup scripts, etc.
lvcreate -L 2G -n ASE1_server docker_vg
mkfs /dev/docker_vg/ASE1_server
mkdir /ASE1_server
mount /dev/docker_vg/ASE1_server /ASE1_server
chown sybase:sybase /ASE1_server

==Create a Dockerfile==
mkdir -p /var/docker_projects/sybase_server
vi /var/docker_projects/sybase_server/Dockerfile

# Dockerfile for sybase server containers
FROM sybase_server/centos:v1
MAINTAINER peter@petersap.nl
USER sybase

==Build the image==
docker build -t="sybase/server:v1" /var/docker_projects/sybase_server

==Create the container==
Change the ip-address 10.0.0.29 to match your own environment. The port numbers 5000 can also be changed. Remember to make the same changes later on.

As you can see below, the "docker create" statement references to the containers that have already been created, using the --volumes-from option.
docker create --hostname=ASE1_server --publish=10.0.0.29:5000:5000 --privileged=true --volumes-from ASE1_data --volumes-from ase160.22544 -v /ASE1_server:/ASE1_server --name=ASE1_server -t -i sybase/server:v1

=Build the Sybase ASE server=
At this point we have created the containers for the Sybase software (with the software installed), a container for the database devices and a container to run ASE. Now we will start the container for running ASE and build the Sybase server.
==Start the container==
docker start --attach=true --interactive=true ASE1_server

You should get a bash shell while running the container.

Source in the Sybase environment variables.
. /sybase-ase160.22544/SYBASE.sh
==Create a resource file==
Create a resource file for building ASE

cd /ASE1_server
vi ASE1.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: ASE1_server
sqlsrv.network_port_list: 5000
sqlsrv.application_type: USE_DEFAULT
sqlsrv.server_page_size: USE_DEFAULT
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /ASE1_data/master.dat
sqlsrv.master_device_size: USE_DEFAULT
sqlsrv.master_database_size: USE_DEFAULT
sqlsrv.errorlog: /ASE1_server/ASE1.errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /ASE1_data/sybsystemprocs.dat
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /ASE1_data/sybsystemdb.dat
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /ASE1_data/tempdb.dat
sqlsrv.tempdb_device_size: USE_DEFAULT
sqlsrv.tempdb_database_size: USE_DEFAULT
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: no
sqlsrv.avail_physical_memory: PUT_THE_AVAILABLE_PHYSICAL_MEMORY_FOR_ASE_IN_OPTIMIZATION
sqlsrv.avail_cpu_num: PUT_THE_AVAILABLE_NUMBER_CPU_FOR_ASE_IN_OPTIMIZATION
==Build ASE1==
srvbuildres -r ASE1.rs

Add an extra entry to the interfaces file to allow ASE to connect to the backupserver that will be running in another container. Remember to make changes to the ip-address and port number where needed.

vi $SYBASE/interfaces

Add these lines

SYB_BACKUP_docker
query tcp ether 10.0.0.29 5001

Modify the corresponding entry in ASE. Also, configure "console logging" to capture the ASE errorlog inside the log file of the running container.

isql -Usa -Psecret123 -SASE1
sp_addserver SYB_BACKUP,null,SYB_BACKUP_docker
go
sp_configure 'enable console logging',1
go
exit
==Create a start script==
Create a script that will start ASE1 when the docker container is kicked off.

cd /ASE1_server
vi start_ASE1.sh

#!/bin/sh

# Source in the Sybase environment variables

. /sybase-ase160.22544/SYBASE.sh

# Start ASE1
${SYBASE}/${SYBASE_ASE}/install/RUN_ASE1
RET=$?

exit ${RET}

chmod +x start_ASE1.sh
exit

You should now be back at the root prompt of your Linux centos/redhat host.

=Create a new container that will kick off ASE1 when the container starts=
As you have seen above, if you start the container you will get a bash prompt. Now we need to build the container once more with the ENTRYPOINT clause in the Dockerfile so start script is executed where container ASE1_server is started.
==Create a Dockerfile==
mkdir -p /var/docker_projects/ASE1_server
cp /var/docker_projects/sybase_server/Dockerfile /var/docker_projects/ASE1_server

Add this line to the new Dockerfile (/var/docker_projects/ASE1_server/Dockerfile)

ENTRYPOINT /ASE1_server/start_ASE1.sh

==Create image and container==

docker build -t="sybase/ase1:v1" /var/docker_projects/ASE1_server
docker rm ASE1_server
docker create --hostname=ASE1_server --publish=10.0.0.29:5000:5000 --privileged=true --volumes-from ASE1_data --volumes-from ase160.22544 -v /ASE1_server:/ASE1_server --name=ASE1_server -t -i sybase/ase1:v1
==Start the container to run ASE1==
docker start ASE1_server
Run "docker ps" to see the container running. If it is not running do "docker logs ASE1_server".
docker ps

=Build the Sybase backup server=
==Create the container==

docker create --hostname=ASE1_BCK_server --publish=10.0.0.29:5001:5001 --privileged=true --volumes-from ASE1_server --name=ASE1_BCK_server -t -i sybase/server:v1

==Build the Sybase backup server==

docker start --attach=true --interactive=true ASE1_BCK_server

. /sybase-ase160.22544/SYBASE.sh
cd /ASE1_server
vi SYB_BACKUP.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: ASE1_BCK_server
bsrv.network_port_list: 5001
bsrv.allow_hosts_list: +
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /ASE1_server/SYB_BACKUP.errorlog
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

srvbuildres -r SYB_BACKUP.rs

==Create a start script==
Create a script that will start the backup server when the docker container is started

vi start_ASE1_BCK.sh

#!/bin/sh

# Source in the Sybase environment variables

. /sybase-ase160.22544/SYBASE.sh

# Start ASE1_BCK
${SYBASE}/${SYBASE_ASE}/install/RUN_SYB_BACKUP
RET=$?

exit ${RET}

chmod +x start_ASE1_BCK.sh
exit

==Create a new container that will kick off ASE1_BCK when the container starts==
mkdir -p /var/docker_projects/ASE1_BCK_server
cp /var/docker_projects/sybase_server/Dockerfile /var/docker_projects/ASE1_BCK_server

Add this line to the new Dockerfile (/var/docker_projects/ASE1_BCK_server/Dockerfile)

ENTRYPOINT /ASE1_server/start_ASE1_BCK.sh

Create a new image and a new container, remember to change the ip-address and the port number.

docker build -t="sybase/ase1_bck:v1" /var/docker_projects/ASE1_BCK_server
docker rm ASE1_BCK_server
docker create --hostname=ASE1_BCK_server --publish=10.0.0.29:5001:5001 --privileged=true --volumes-from ASE1_server --name=ASE1_BCK_server -t -i sybase/ase1_bck:v1
docker start ASE1_BCK_server

=How to manage the Sybase instances=

Sybase ASE and backup server can be stopped and started with docker commands
docker start ASE1_server
docker start ASE1_BCK_server
docker ps
docker stop ASE1_server
docker stop ASE1_BCK_server

If you run the "shutdown" command in Sybase ASE the server will stop and the docker container will also end. Same for the backup server if you run "shutdown SYB_BACKUP" in ASE.

If for some reason a server will not start (or crashes) you can examine the console log file
docker logs ASE1_server

All the Sybase files are also accesable on the Linux (centos/Redhat) host so if a container will not start anymore you can still make changes to the configuration.

=Wrapping up=

==add to /etc/fstab==
Add the filesystems to /etc/fstab
/dev/docker_vg/sybase-ase160.22544 /sybase-ase160.22544 ext2 defaults 0 0
/dev/docker_vg/ASE1_data /ASE1_data ext2 defaults 0 0
/dev/docker_vg/ASE1_server /ASE1_server ext2 defaults 0 0

[[category:ASE]]

Installation guidelines ASE 15.7

2015-02-20T12:31:59Z

Psap: /* Linux */

This page describes how to install and configure a Sybase ASE server version 15.7. You will also learn how to connect to the server, stop and restart it.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/ase_1500devel. You can download ASE 15.7 for various operating systems and chipsets. When you install ASE you can choose to run without a license (limited features) or install a licenced version and buy a license from Sybase.

Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can also be used for a full installation.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.5 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase157. Database files will be stored /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

===Linux===
====Shared Memory====
To see the current value of shared memory:
sysctl kernel.shmmax

To configure a shared memory segment of 4 Gb
sysctl -w kernel.shmmax=4294967296

Then add kernel.shmmax=4294967296 to /etc/sysctl.conf

See also [[Linux configuration settings for Sybase ASE]], but these settings can be done when the installation and configuration has been completed.

====32 bit libraries====
When installing Sybase ASE 64 bit version on Linux, you need to install the 32 bit shared libraries as well. This will prevent problems when running isql or bcp.

=====Debian based systems=====
apt-get install ia32-libs
=====RedHat based systems=====
yum install glibc.i686

===Solaris (pre version 10)===
/etc/system
set shmsys:shminfo_shmmax = 4294967296

===Solaris (system 10)===
/etc/project
projadd -c "sybase" 'user.sybase'
projmod -s -K "project.max-shm-memory={privileged,4GB,deny}" 'user.sybase'

==Raw devices or filesystem files==
Sybase recommends to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems. Also, consult your storage administrator when in doubt.

===Raw devices===
When you use raw devices, create the following:
* master (100 Mb)
* sybsystemprocs (172M)
* sybsystemdb (6M)
* data01 (for instance 10G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 2G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.

===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least 100Mb but, depending on your application, several Gb's or much more is not uncommon.

==Determine your license policy==
Since ASE 15.0 you cannot run a production server without a license file. License files can reside on the network or on the local system. Think about the license policy that suits you best. Most sites choose for license files on each Unix server.

When there is no valid license, ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license, or change the license settings revert to the Express Edition.

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

When you get a message like "A suitable JVM could not be found" or “exec: 2470: /tmp/install.dir.1392/Linux/resource/jre/bin/java: not found” check the following document for a solution: [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase157 as the destination directory, do a full installation. At the list of possible servers to configure, deselect all options. We will do a manual configuration.

When the installation has finished successful you can safely remove the work directory and the installation package.

==Setup your environment==
In /opt/sybase/ase157 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase157/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase157.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licenses

==Create the ASE server==
Most installations, especially for development purposes, run multiple ASE's and backup servers from a single Sybase software installation. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you have made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: <put your hostname here>
sqlsrv.network_port_list: 4000
sqlsrv.application_type: MIXED
sqlsrv.server_page_size: 4096
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dev
sqlsrv.master_device_size: 100
sqlsrv.master_database_size: 60
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dev
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dev
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /var/sybase/ASE1/tempdb.dev
sqlsrv.tempdb_device_size: 100
sqlsrv.tempdb_database_size: 100
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: yes
sqlsrv.avail_physical_memory: 256
sqlsrv.avail_cpu_num: 1

This resource file will a create a Sybase server with the following characteristics:
* The name of the server will be ASE1, can be changed later with the sp_addserver stored procedure.
* The server will have a listener on the ip-address as indicated with <hostname> and port 4000. This can be changed later in the interfaces file located at $SYBASE/interfaces.
* Application type is mixed, so you expect both oltp and dss type of queries. This can be changed later by modification of the “optimization goal” setting with sp_configure).
* Server page size will be 4 Kb. The default is 2 Kb but with today’s hardware this will give sub-optimal performance. Once the server has been created it cannot be changed, a complete server rebuild is needed then.
* The master device will be 100 Mb, the size of the master database will be 60 Mb. The master devices will contain the master database, the master database contains important meta-data about the server. It’s very unusual to increase the size of the master device or the master database.
* The location of the errorlog is /opt/sybase/admin/ASE1/errorlog, can be changed later in the configuration file.
* A device of 172 Mb will be created for the sybsystemprocs database, also with a size of 172 Mb. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A device of 6 Mb will be created for the sybsystemdb database. The size of the database will actually be 12Mb as a small portion will also reside on the master device. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A temporary database 'tempdb' will be created on a device with a size of 100 Mb, the database will also be 100 Mb. In fact, it will be a bit larger since also a small portion will reside on the master device. Again, the device and the tempdb database can be increased in size. You can also create multiple temporary databases for improved concurrency.
* We will build a backup server called SYB_BACKUP. The name can be changed later with sp_addserver.
* We will not use a PCI (Pluggable Component Interface) database. This database is mainly used for Java in the server.
* Use the optimize configuration feature and tune for 256 Mb of memory and 1 cpu.

Now build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a successful creation you can connect to the server using the command line tool isql. The login “sa" has been created, with the password that was specified in ASE.rs file. At the prompt of isql you can type a command or execute a stored procedure. Type exit to exit.
isql -Usa -Psecret123 -SASE1
sp_helpdb
go
exit

==Basic ASE configuration==

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown ASE

isql -Usa -Psecret123 -SASE1
shutdown
go

cd $SYBASE/$SYBASE_ASE
mv ASE1.cfg /opt/sybase/admin/ASE1
rm ASE1.*
cd install

Modify RUN_ASE1 and make the following changes:
* Make the -s flag the first option. This has the advantage that a listing of running processes on the system will show the name of the Sybase server.
* Change the location of the configuration files, as specified with the -c flag, to the admin directory
Each line must end with a backslash.
Example RUN_ASE1 file:

#!/bin/sh
#
# ASE page size (KB): 4096
# Master device path: /var/sybase/ASE1/master.dev
# Error log path: /opt/sybase/admin/ASE1/errorlog
# Configuration file path: /opt/sybase/ase157/ASE-15_0/ASE1.cfg
# Directory for shared memory files: /opt/sybase/ase157/ASE-15_0
# Adaptive Server name: ASE1
#
/opt/sybase/ase157/ASE-15_0/bin/dataserver \
-sASE1 \
-d/var/sybase/ASE1/master.dev \
-e/opt/sybase/admin/ASE1/errorlog \
-c/opt/sybase/admin/ASE1/ASE1.cfg \
-M/opt/sybase/ase157/ASE-15_0 \

Now restart the Sybase server
./startserver -f ./RUN_ASE1

===Load instmsg.ebf file===
The instmsgs.ebf file contains the latest update for Sybase error messages. You can load it with isql.
isql -Usa -Psecret123 -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: <put your hostname here>
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

===Move and modify configuration files===
In this step we will move the configuration file to the admin directory. First shutdown the backup server:
isql -Usa -Psecret123 -SASE1
shutdown SYB_BACKUP
go
exit

Modify the file RUN_SYB_BACKUP, located at $SYBASE/$SYBASE_ASE/install. Move the line with the -s flag to the top. Sample RUN_SYB_BACKUP:
#!/bin/sh
#
# Error log path: /opt/sybase/ase157/ASE-15_0/install/SYB_BACKUP.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Multibuf executable path: /opt/sybase/ase157/ASE-15_0/bin/sybmultbuf
# Backup Server name: SYB_BACKUP
#
/opt/sybase/ase157/ASE-15_0/bin/backupserver \
-SSYB_BACKUP \
-e/opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log \
-N25 \
-C20 \
-M/opt/sybase/ase157/ASE-15_0/bin/sybmultbuf \

Restart the backupserver
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_SYB_BACKUP

==Create a user database==
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go
==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installation guide for Linux http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30119.1570/doc/html/title.html

Sybase System administration http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31654.1570/html/sag1/title.htm

[[Category:ASE]]
[[category:Installation Guidelines]]

Installation guidelines IQ 15.0 and 15.1

2013-11-08T11:46:14Z

Psap: /* Notes */

This page describes how to install and configure a Sybase IQ server, version 15.0 and 15.1

==Get the software==
First download IQ.

For a licensed version you need to go http://sybase.subscribenet.com (account required) or to the Sybase eShop http://eshop.sybase.com/eshop/buy?id=48151

Alternatively, you can download an EBF for Sybase IQ 15 at http://downloads.sybase.com (registration required). Then click on “Sybase IQ” and download an EBF/Patch, for instance EBF16926. With an EBF/Patch you can install a full version as well.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 850 Mb so 2 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/iq150. Database files will be stored on raw devices and in /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Check that your operating system has the required patches and configuration settings. Look in the installation documentation at http://infocenter.sybase.com/help/topic/com.sybase.help.infocenter.iq.15.0/title.htm for detailed instructions. When you run the IQ installation, it will also check for some required packages.

==Prepare the Installation==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir work
mkdir iq150
cd work
<put the software in this directory>
tar -xf <software-distro>

==Installation==
Go into the directory with the installed software. Run the installer (for instance ./setupLinuxAMD64).
./setupLinuxAMD64
Answer the questions and install into /opt/sybase/iq150. You can select what license type you need, Licensed or Evaluation. For the licenced version you need an account at http://sybase.subscribenet.com. The evaluation license allows you to run IQ with all its features for 30 days.

To use the installar on Unix you may need to set the DISPLAY variable.

Once the installation is complete you can remove the work directory and its content.
cd ..
rm -Rf work
==Setup your environment==
In /opt/sybase/iq150/IQ-15_0 you will find a few files, like IQ-15_0.csh and IQ-15_0.sh. Depending on the type of shell you use, you need to source in one of these. For instance, when your default shell is bash you should do this:
. /opt/sybase/iq150/IQ-15_0/IQ-15_0.sh
Is is fairly common to activate such a script from your login script.
==Create raw devices==
For performance reasons you should use raw devices for the IQ Main and Temporary store. For testing purposes use 2Gb for the Main store and 1 Gb for the Temporary store. You can always add more when needed. Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot. Note: contrary to Sybase ASE behaviour, Sybase IQ will only accept raw devices and not "block special". Check the filetype with the "file" command. When needed, bind a block special device to a raw device with the "raw" command.
==Start the IQ server (utility database only)==
Before you can create a database the IQ server must be started with only the utility database active. Use the start_iq command, but specify the name of server as well using the -n flag. In this example the Sybase recommendation is followed to distinguish the name of the IQ server from the name of the database. For the IQ server IQ2_srv is used, and for the database IQ2_db.
start_iq -n IQ2_srv
==Create a database==
Create a directory where server and database specific files will be stored
mkdir /var/sybase/IQ2_srv

Create a connection to the IQ server with dbisql (Windows look and feel) or dbisqlc (very basic gui). Specify DBA as the user ID, use “sql” (lower case) as the password and “utility_db” as the name of the database. Once connected you can create a database. The create database command has several option that can have a big impact on performance. See notes below or study the Sybase documentation to get the best result.
Example:
create database '/var/sybase/IQ2_srv/IQ2_db.db'
transaction log on '/var/sybase/IQ2_srv/IQ2_db.log'
mirror '/var/sybase/IQ2_srv/IQ2_db_mirror.log'
iq path '/var/sybase/IQ2_srv/IQ2_db_01.iq'
iq size 2000
message path '/var/sybase/IQ2_srv/IQ2_db.iqmsg'
temporary path '/var/sybase/IQ2_srv/IQ2_db_01.iqtmp'
temporary size 1000
When the database has been successfully created, exit from dbisql or dbisqlc.
Then shutdown the IQ server.
stop_iq
===Notes for the "create database" command.===
* Sybase recommends to create the IQ_SYSTEM_MAIN with at least 100Gb for any serious production databases. For development servers you can use approx. 5 % of total expected IQ storage. The size can be specified with the "iq size" clause.
* The default page size for IQ files (.iq and .iqtmp files) is 128 Kb. When a single table in the database is expected to grow above 8 Tb or will have more than 4 billion rows choose the next bigger IQ page size of 256Kb.
* When creating a database or a dbspace you can ommit the fully specified path to the filename. When you use filenames relative to the IQ server it is more easy to move a database to another server.
* When the iq stores are created on raw devices and those raw devices are located on a disk array (as will be the case most of the time) then choose the next greater block size than the default value. When the IQ stores are on filesystem check the I/O size of the filesystem and choose that block size. A non-default block size can improve performance at the expense of disk space. The block size can be specified with the "block size" clause.
* When using raw devices do not use the clause "iq size" and/or "temporary size". IQ will determine the size of the raw device and use it completely.
* When the database is created and you know that it will grow after some time, add the “iq reserve” clause to the “create database” command. This will create a contiguous free list that is already large enough for the future size of the database and so prevents a fragmented free list. Do the same when the user dbspace is created (see below). Then add the “reserve” clause. Not needed for the temporary store.
* Be carefull when using a non-default page size for the catalog store (.db file). It can lead to inefficient memory use.

==Create a configuration file==
In the directory /var/sybase/IQ2_srv create a configuration file called params.cfg with at least the following content
-n IQ2_srv
-iqmc 60
-iqtc 140
-x tcpip{port=4000}
This configuration file sets the name of the server, the main cache size to 60Mb, the temp cache size to 140Mb and a port number for TCP/IP traffic. Specify as much memory as you can but leave a safe margin for other processes. Sybase recommends to keep the ration between main and temp cache 3:7.
Then start the database
start_iq @/var/sybase/IQ2_srv/params.cfg /var/sybase/IQ2_srv/IQ2_db.db

==Create a user dbspace==
Create a user space where all tables for the application should be created. Example:

create dbspace user_main
using file user_main_1 '/var/sybase/IQ2_srv/user_main_1.iq'
size 10000 MB
iq store;

set option public.default_dbspace = ‘user_main‘;
grant create on user_main to public;
revoke create on iq_system_main from public;

When the user db space becomes to small, additional space can be added by running this:
alter dbspace user_main
add file user_main_x '/var/sybase/IQ2_srv/user_main_2.iq'
size 10000 MB iq store

Try to keep all the files in a user dbspace the same size to achieve a situation that all files are more or less filled at the same capacity. Also, use a reseonable set of files to achive parallellism.

==(Optional) Configure striping==
For performance reasons it is best to have IQ handle the striped writes rather than a SAN storage system. Doing striped writes from both sides (SAN and IQ) may be counter productive. When you want to do striping within IQ you should prepare the disk layout for it.

IQ Stripe sizes as suggested below are based on the expected write activity to the various IQ stores.

IQ_SYSTEM_MAIN - 32 Kb

IQ_SYSTEM_TEMP - 64 Kb

User defined dbspace - 128 Kb

When the main store has been created striping is on by default but the stripesize is 1 Kb. The IQ main store will not store any user data but only IQ internal information and therefore the amount of data to be written will be far less when compared to iq system temp or a user dbspace.

alter dbspace IQ_SYSTEM_MAIN
striping on
stripesizekb 32

This setting may not have any effect when the IQ store consists of 1 file. Hoewever, when an additional file is added to the main store striping will kick in.

alter dbspace IQ_SYSTEM_TEMP
striping on
stripesizekb 64

Do the same for the user_main db space.

alter dbspace user_main
striping on
stripesizekb 128

==Set database options==
set option PUBLIC.APPEND_LOAD=’ON’;
set option PUBLIC.FORCE_NO_SCROLL_CURSORS = 'ON';
set option PUBLIC.QUERY_PLAN = 'OFF';
set option PUBLIC.QUERY_DETAIL = 'OFF';
set option PUBLIC.QUERY_TIMING = 'OFF';
set option PUBLIC.QUERY_TEMP_SPACE_LIMIT=5000; -- Value in Mb, recommended value is 1/4 of the total size of the temporary store.
set option PUBLIC.MAIN_RESERVED_DBSPACE_MB=500; -- Recommended value is 20% of the size of IQ_SYSTEM_MAIN.
set option PUBLIC.TEMP_RESERVED_DBSPACE_MB=500;
set option PUBLIC.LOAD_MEMORY_MB=100;

When the IQ stores are on filesystem (not on raw devices) you can set the option OS_FILE_CACHE_BUFFERING to off.
Example (IQ reboot required to activate):

set option PUBLIC.OS_FILE_CACHE_BUFFERING = 'OFF';

Notes:
* QUERY_TEMP_SPACE_LIMIT sets the amount of temporary store space that an individual query is allowed to use in the temporary store, for storing intermediate results and for sort operations. This value can be set higher than 5000 if enough temporary store is available. It is not recommended to set this value to 0 (= “unlimited”) because in that case carthesian products can fill the temporary store completely, which will prevent other queries to run.
* In IQ 15 a new option MAX_TEMP_SPACE_PER_CONNECTION has been introduced. When a single connection starts up more queries at the same time use this option.

==How to extend the size of the temporary store==
Since IQ 15 there can be only 1 dbspace for the temporary store. To increase the size of the IQ temporary store you need to alter the dbspace and add a file to it. Example:
alter dbspace IQ_SYSTEM_TEMP
add file temp_02 '/var/sybase/IQ2_srv/IQ2_db_02.iqtmp'
size 2000 MB ;

Try to keep all the files the same size to achieve a situation that all files are more or less filled at the same capacity. Also, use a reseonable set of files to achive parallellism.

Note: If raw volumes are used for Main/Temporary store, then specify the full paths to the raw volumes and omit the IQ SIZE and TEMPORARY SIZE clauses. The full raw volumes will automatically be used.

==Notes==
*In this example the mirror of the IQ transaction log is on the same physical device at the transaction log itself. Do not create such a situation on a production system.
*The Sybase IQ logfiles are by default created in the directory $IQDIR15/logfiles. Since the logfiles can become very big, its best to set the variable IQLOGDIR15 to /var/sybase/IQ2_srv before starting the IQ server.
[[category:IQ]]
[[category:Installation Guidelines]]

Installation guidelines IQ 12.6 and 12.7

2013-11-08T11:45:49Z

Psap: /* Notes */

This page describes how to install and configure a Sybase IQ server.

==Get the software==
First download IQ.

For a licensed version you need to go http://sybase.subscribenet.com (account required) or to the Sybase eShop http://eshop.sybase.com/eshop/buy?id=48151

Members of ISUG are entitled to a free download of a developers edition of Sybase IQ 12.6 and 12.7.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 500 Mb so 1.2 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/iq127. Database files will be stored on raw devices and in /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase
The shell script to start Sybase iq (start_asiq) also needs "csh" so make sure it is installed.
When you install IQ on a Debian type system (like Ubuntu) you need to create a /usr/tmp directory. When the directory does not exists, or is not writeble by the IQ installation software, the installation will fail.

==Prepare the Installation==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir work
mkdir iq127
cd work
<put the software in this directory>
tar -xf <software-distro>

==Installation==
Set the SYBASE variable before installation to the directory where the software will be installed.
export SYBASE=/opt/sybase/iq127
Start the installation by running sybinstall.
When you have the option on the first screen to choose "Sybase IQ ETL Server", then do not choose that option, but select "Sybase IQ server". During installation you can specify a new password for the DBA account.
./sybinstall

When the installation has finished succesful you can safely remove the work directory.
cd ..
rm -Rf work

==Setup your environment==
In /opt/sybase/iq127/ASIQ-12_7 you will find a few files, like ASIQ-12_7.csh and ASIQ-12_7.sh. Depending on the type of shell you use, you need to source in one of these. For instance, when your default shell is bash you should do this:

. $SYBASE/ASIQ-12_7/ASIQ-12_7.sh

Is is fairly common to activate such a script from your login script.

==Install optional EBF's==
At the time of writing a few EBF's have already been released for IQ 12.7 You can download these from http://downloads.sybase.com
To install an EBF just untar the file and run sybinstall.

==Install OpenClient software==
When you have installed Sybase IQ, check if the OpenClient software is also installed. You should see a directory called "OCS-15_0" in $SYBASE. When it's not there, follow these steps to install it.
* Get hold of an ASE installation package. Linux users may retrieve one at http://www.sybase.com/linuxpromo
* Put the software in a work directory and untar (tar -xf <file>)
* ./setup -console
* Within "setup" choose "Custom" as type to setup, then deselect all features except connectivity and Language modules. Finish setup.
You should now see some extra directories and files in $SYBASE

==Create raw devices==
For performance reasons you should use raw devices for the IQ Main and Temporary store. For testing purposes use 2Gb for the Main store and 1 Gb for the Temporary store. You can always add more when needed.
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.
Note: contrary to Sybase ASE behaviour, Sybase IQ will only accept raw devices and not "block special". Check the filetype with the "file" command. When needed, bind a block special device to a raw device with the "raw" command.

==Start the IQ server (utility database only)==
Before you can create a database the IQ server must be started with only the utility database active.
start_asiq -n IQ1

==Create a database==
Create a directory where server specific files will be stored
cd /var/sybase
mkdir IQ1
cd IQ1
Create a connection to the IQ server with dbisqlc.
dbisqlc
On the first screen do "Cancel"

[[Image:dbisqlc1.gif]]

On the next screen click on "Command" and "Connect…". Fill in the username / password combination as specified during sybinstall, use "utility_db" as database name.

[[Image:dbisqlc2.gif]]

In the command section of the screen you can now type the command to create a database. See screenshot below for the beginning of the command, see text further down for full command.

[[Image:dbisqlc3.gif]]

This example creates a database of 2000 Mb and a temporary store of 1000 Mb.
create database '/var/sybase/IQ1/IQ1.db'
transaction log on '/var/sybase/IQ1/IQ1.log'
mirror '/var/sybase/IQ1/IQ1_mirror.log'
iq path '/var/sybase/IQ1/IQ1_01.iq'
iq size 2000
message path '/var/sybase/IQ1/IQ1.iqmsg'
temporary path '/var/sybase/IQ1/IQ1_01.iqtmp'
temporary size 1000
When the database has been successfully created, exit from dbisqlc.

Then shutdown the IQ server.
stop_asiq

==Create a configuration file==
In the directory /var/sybase/IQ1 create a configuration file called params.cfg with at least the following content
-n IQ1
-iqmc 60
-iqtc 140
-x tcpip{port=4000}
This configuration file sets the name of the server, the main cache size to 60Mb, the temp cache size to 140Mb and a port number for TCP/IP traffic. Specify as much memory as you can. Sybase recommends to keep the ration between main and temp cache 3:7.

Then start the database
start_asiq @params.cfg IQ1.db

==Notes==
* In this example the mirror of the IQ transaction log is on the same physical device at the transaction log itself. Do not create such a situation on a production system.
* The Sybase IQ logfiles are created in the directory $ASDIR/logfiles. Since the logfiles can become very big, its best to set the variable ASLOGDIR to /var/sybase/IQ1 before starting the IQ server.

Recommended further reading: [[Sybase Central and the IQ Agent for Sybase IQ]]

[[Category:IQ]]
[[category:Installation Guidelines]]

Installation guidelines RepServer 15.7.1

2013-11-08T11:45:18Z

Psap:

This page describes how to install and configure a Sybase Replication Server version 15.7.1. You will also learn how to connect to the server, stop and restart it.

==Get the software==
First download the software for Replication Server.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=22574
Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can sometimes also be used for a full installation.

==Storage requirements==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 570 Mb so 2 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/rep1571.

Replication server partitions (stable devices) will be stored /var/sybase. The mininum size of the initial partition is 20 Mb.
Additional partitions that may be needed to queue up data must be taken into account as well. The requirements vary per environment and usage. When you run out of space in partitions you can always add more.

The partitions can be created on raw devices or on filesystem files (opened with Direct I/O).

==Memory requirements==
When running replication server on a virtualized environment, you need 300 Mb of RAM as a bare minimum. Increase memory when needed.
==Prepare the operating system==

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

Use /opt/sybase/rep1571 as the destination directory, do a full installation, and continue installation without a license key, no e-mail alerts. Do not start the sample replication server as we will do a manual configuration.

When the installation has finished successful you can safely remove the work directory and the installation package.

===Errors when running setup.bin===
====java not found====
When you get an error like this

exec: 2508: /tmp/install.dir.527/Linux/resource/jre/bin/java: not found

you need to install software to run 32 bit binaries on a 64 bit machine. Become root again and install the required packages.

On ubuntu:

apt-get install ia32-libs

On Redhat

yum install glibc-devel.i386

====Fontconfig error====
Ignore the error "Fontconfig error: Cannot load default config file" if you get it.

==Setup your environment==
In /opt/sybase/rep1571 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/rep1571/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/rep1571.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licenses

You can run without a license for 30 days (grace period).

==Create the Replication Server==
A Replication Server needs an system database (RSSD) to store its definitions. You can choose between a Sybase ASE (RSSD) or an embedded SQL Anywhere database (ERSSD).
The choice between them depends on licensing costs, availabity of hardware or personal preference. After configuring replication server with either RSSD or ERSSD you cannot switch between them.

When you select an ERSSD you do not need to manage it, it is all handled automatically. When choosing an RSSD (Sybase ASE) there is an extra layer of software that you need to install, manage and probably pay for as well.

In this document an ERSSD server will be used for the Replication Server System Database.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/REP1
mkdir admin/REP1_ERSSD
mkdir /var/sybase/REP1
mkdir -p /var/sybase/REP1_ERSSD/database
mkdir /var/sybase/REP1_ERSSD/translog
mkdir /var/sybase/REP1_ERSSD/backup

Now go to the "/opt/sybase/admin/REP1" directory and create a resource file. Use the following template as an example, call it REP1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_REP/init/rs/install.rs

sybinit.product: rs
rs.rs_operation: rs_install
rs.rs_idserver_name: REP1
rs.rs_id_server_is_rs_server: yes
# Password for rs_REP1_id_user (RS to RS connectivity)
rs.rs_idserver_pass: secret123
rs.rs_name: REP1
# Password for "sa" user
rs.rs_rs_sa_pass: secret123
rs.rs_needs_repagent: yes
rs.rs_rs_errorlog: /opt/sybase/admin/REP1/REP1.errorlog
rs.rs_rs_cfg_file: /opt/sybase/admin/REP1/REP1.cfg
rs.rs_rssd_embedded: yes
rs.rs_erssd_name: REP1_ERSSD
rs.rs_erssd_database_dir: /var/sybase/REP1_ERSSD/database
rs.rs_erssd_translog_dir: /var/sybase/REP1_ERSSD/translog
rs.rs_erssd_backup_dir: /var/sybase/REP1_ERSSD/backup
rs.rs_erssd_errorlog_dir: /opt/sybase/admin/REP1_ERSSD
# Password for REP1_RSSD_prim
rs.rs_rssd_prim_pass: secret123
# Password for REP1_RSSD_maint
rs.rs_rssd_maint_pass: secret123
rs.rs_diskp_name: /var/sybase/REP1/part1.dat
rs.rs_diskp_lname: part1
# Password for REP1_rsi
rs.rs_rs_pass: secret123
# Password for REP1_ltm
rs.rs_ltm_rs_pass: secret123
rs.rs_id_server_network_protocol_list: tcp
rs.rs_idserver_hostname: <put your hostname here>
rs.rs_idserver_port: 5000
rs.rs_rs_port: 5000

When the partition as defined by "rs.rs_diskp_name" is on filesystem, you need to create the file with the "touch" command.

touch /var/sybase/REP1/part1.dat

Add the entries for repserver and ERSSD to $SYBASE/interfaces

REP1
master tcp ether <put your hostname here> 5000
query tcp ether <put your hostname here> 5000

REP1_ERSSD
query tcp ether <put your hostname here> 5001

Now build the server with the command:
$SYBASE/$SYBASE_REP/install/rs_init -r REP1.rs

After a successful creation you can connect to the replication server using the command line tool isql. The login “sa" has been created, with the password that was specified in REP1.rs file. At the prompt of isql you can type a command or type exit to exit.
isql -Usa -Psecret123 -SREP1
admin who
go
exit

To connect to the ERSSD server cou can use the REP1_RSSD_prim login.
isql -UREP1_RSSD_prim -Psecret123 -SREP1_ERSSD
sa_conn_info
go
exit

==Basic Replication server tasks==

===To shutdown Replication Server===
isql -Usa -Psecret123 -SREP1
shutdown
go

===To start Replication Server===
cd /opt/sybase/admin/REP1
nohup ./RUN_REP1 &

===Check status===
When replication server has been started you can check if the status is ok by running the "admin health" command. It should return "HEALTHY". When the status is not healthy check the errorlog file (at /opt/sybase/admin/REP1/REP1.errorlog) for the cause.
Please note that immediately after a start of replication server it may take a couple of minutes before all processes are up and running.

isql -Usa -Psecret123 -SREP1
admin health
go
exit

==Recommended settings==
The following settings are recommended to improve stability and performance. To change a setting, use isql and log on with the sa account
isql -Usa -Psecret123 -SREP1

===Enable direct i/o===
Set sqm_write_flush to dio to enable direct I/O on the partitions. A reboot is needed to activate the setting.

configure replication server set sqm_write_flush to 'dio'
go
shutdown
go

===sqt_max_cache_size===
Increase sqt_max_cache_size when the following message is shown the errorlog:

WARNING #24068 SQT(105:1 DIST PRIM.tpcc) - t/sqtint.c(1333)
SQT cache size is too low to load more than one transaction into the cache.

As a rule of thumb you can double the value (default is 1048576 for 32 bit, 20971520 for 64 bit) but don't overdo it. Retrieve the current value with

admin config,sqt_max_cache_size
go

configure replication server set sqt_max_cache_size to '41943040'
go

Increasing the value may require that you increase the allocated amount of memory for replication server (setting memory_limit).
===sts_cachesize===
Increase the value for sts_cachesize when this message is printed in the errorlog:

I. 2013/01/12 15:39:53. A cached row for system table ‘rs_columns’ was swapped out of the cache in order to accomodate another row.

configure replication server set sts_cachesize to '2000'
go

You can retrieve the current value with

admin config,sts_cachesize
go

==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installation guide for Unix http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32237.1571/doc/html/title.html

Getting started http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc10114.1571/doc/html/title.html

Reference manual http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32410.1571/doc/html/title.html

[[Category:RepServer]]
[[category:Installation Guidelines]]

Installation guidelines ASE 15.7

2013-11-08T11:44:41Z

Psap: /* All done */

This page describes how to install and configure a Sybase ASE server version 15.7. You will also learn how to connect to the server, stop and restart it.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/ase_1500devel. You can download ASE 15.7 for various operating systems and chipsets. When you install ASE you can choose to run without a license (limited features) or install a licenced version and buy a license from Sybase.

Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can also be used for a full installation.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.5 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase157. Database files will be stored /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

===Linux===
To see the current value of shared memory:
sysctl kernel.shmmax

To configure a shared memory segment of 4 Gb
sysctl -w kernel.shmmax=4294967296

Then add kernel.shmmax=4294967296 to /etc/sysctl.conf

See also [[Linux configuration settings for Sybase ASE]], but these settings can be done when the installation and configuration has been completed.

When installing Sybase ASE 64 bit version on Linux, you may want to install the 32 bit shared libraries as well. This will prevent problems when running isql or bcp.
apt-get install ia32-libs

===Solaris (pre version 10)===
/etc/system
set shmsys:shminfo_shmmax = 4294967296

===Solaris (system 10)===
/etc/project
projadd -c "sybase" 'user.sybase'
projmod -s -K "project.max-shm-memory={privileged,4GB,deny}" 'user.sybase'

==Raw devices or filesystem files==
Sybase recommends to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems. Also, consult your storage administrator when in doubt.

===Raw devices===
When you use raw devices, create the following:
* master (100 Mb)
* sybsystemprocs (172M)
* sybsystemdb (6M)
* data01 (for instance 10G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 2G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.

===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least 100Mb but, depending on your application, several Gb's or much more is not uncommon.

==Determine your license policy==
Since ASE 15.0 you cannot run a production server without a license file. License files can reside on the network or on the local system. Think about the license policy that suits you best. Most sites choose for license files on each Unix server.

When there is no valid license, ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license, or change the license settings revert to the Express Edition.

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

When you get a message like "A suitable JVM could not be found" or “exec: 2470: /tmp/install.dir.1392/Linux/resource/jre/bin/java: not found” check the following document for a solution: [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase157 as the destination directory, do a full installation. At the list of possible servers to configure, deselect all options. We will do a manual configuration.

When the installation has finished successful you can safely remove the work directory and the installation package.

==Setup your environment==
In /opt/sybase/ase157 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase157/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase157.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licenses

==Create the ASE server==
Most installations, especially for development purposes, run multiple ASE's and backup servers from a single Sybase software installation. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you have made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: <put your hostname here>
sqlsrv.network_port_list: 4000
sqlsrv.application_type: MIXED
sqlsrv.server_page_size: 4096
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dev
sqlsrv.master_device_size: 100
sqlsrv.master_database_size: 60
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dev
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dev
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /var/sybase/ASE1/tempdb.dev
sqlsrv.tempdb_device_size: 100
sqlsrv.tempdb_database_size: 100
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: yes
sqlsrv.avail_physical_memory: 256
sqlsrv.avail_cpu_num: 1

This resource file will a create a Sybase server with the following characteristics:
* The name of the server will be ASE1, can be changed later with the sp_addserver stored procedure.
* The server will have a listener on the ip-address as indicated with <hostname> and port 4000. This can be changed later in the interfaces file located at $SYBASE/interfaces.
* Application type is mixed, so you expect both oltp and dss type of queries. This can be changed later by modification of the “optimization goal” setting with sp_configure).
* Server page size will be 4 Kb. The default is 2 Kb but with today’s hardware this will give sub-optimal performance. Once the server has been created it cannot be changed, a complete server rebuild is needed then.
* The master device will be 100 Mb, the size of the master database will be 60 Mb. The master devices will contain the master database, the master database contains important meta-data about the server. It’s very unusual to increase the size of the master device or the master database.
* The location of the errorlog is /opt/sybase/admin/ASE1/errorlog, can be changed later in the configuration file.
* A device of 172 Mb will be created for the sybsystemprocs database, also with a size of 172 Mb. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A device of 6 Mb will be created for the sybsystemdb database. The size of the database will actually be 12Mb as a small portion will also reside on the master device. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A temporary database 'tempdb' will be created on a device with a size of 100 Mb, the database will also be 100 Mb. In fact, it will be a bit larger since also a small portion will reside on the master device. Again, the device and the tempdb database can be increased in size. You can also create multiple temporary databases for improved concurrency.
* We will build a backup server called SYB_BACKUP. The name can be changed later with sp_addserver.
* We will not use a PCI (Pluggable Component Interface) database. This database is mainly used for Java in the server.
* Use the optimize configuration feature and tune for 256 Mb of memory and 1 cpu.

Now build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a successful creation you can connect to the server using the command line tool isql. The login “sa" has been created, with the password that was specified in ASE.rs file. At the prompt of isql you can type a command or execute a stored procedure. Type exit to exit.
isql -Usa -Psecret123 -SASE1
sp_helpdb
go
exit

==Basic ASE configuration==

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown ASE

isql -Usa -Psecret123 -SASE1
shutdown
go

cd $SYBASE/$SYBASE_ASE
mv ASE1.cfg /opt/sybase/admin/ASE1
rm ASE1.*
cd install

Modify RUN_ASE1 and make the following changes:
* Make the -s flag the first option. This has the advantage that a listing of running processes on the system will show the name of the Sybase server.
* Change the location of the configuration files, as specified with the -c flag, to the admin directory
Each line must end with a backslash.
Example RUN_ASE1 file:

#!/bin/sh
#
# ASE page size (KB): 4096
# Master device path: /var/sybase/ASE1/master.dev
# Error log path: /opt/sybase/admin/ASE1/errorlog
# Configuration file path: /opt/sybase/ase157/ASE-15_0/ASE1.cfg
# Directory for shared memory files: /opt/sybase/ase157/ASE-15_0
# Adaptive Server name: ASE1
#
/opt/sybase/ase157/ASE-15_0/bin/dataserver \
-sASE1 \
-d/var/sybase/ASE1/master.dev \
-e/opt/sybase/admin/ASE1/errorlog \
-c/opt/sybase/admin/ASE1/ASE1.cfg \
-M/opt/sybase/ase157/ASE-15_0 \

Now restart the Sybase server
./startserver -f ./RUN_ASE1

===Load instmsg.ebf file===
The instmsgs.ebf file contains the latest update for Sybase error messages. You can load it with isql.
isql -Usa -Psecret123 -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: <put your hostname here>
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

===Move and modify configuration files===
In this step we will move the configuration file to the admin directory. First shutdown the backup server:
isql -Usa -Psecret123 -SASE1
shutdown SYB_BACKUP
go
exit

Modify the file RUN_SYB_BACKUP, located at $SYBASE/$SYBASE_ASE/install. Move the line with the -s flag to the top. Sample RUN_SYB_BACKUP:
#!/bin/sh
#
# Error log path: /opt/sybase/ase157/ASE-15_0/install/SYB_BACKUP.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Multibuf executable path: /opt/sybase/ase157/ASE-15_0/bin/sybmultbuf
# Backup Server name: SYB_BACKUP
#
/opt/sybase/ase157/ASE-15_0/bin/backupserver \
-SSYB_BACKUP \
-e/opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log \
-N25 \
-C20 \
-M/opt/sybase/ase157/ASE-15_0/bin/sybmultbuf \

Restart the backupserver
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_SYB_BACKUP

==Create a user database==
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go
==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installation guide for Linux http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30119.1570/doc/html/title.html

Sybase System administration http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31654.1570/html/sag1/title.htm

[[Category:ASE]]
[[category:Installation Guidelines]]

Installation guidelines ASE 15.5

2013-11-08T11:44:11Z

Psap: /* All done */

This page describes how to install and configure a Sybase ASE server version 15.5.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/ase_1500devel. You can download ASE 15.5 for various operating systems and chipsets. When you install ASE you can choose to run without a license (limited features) or install a licenced version and buy a license from Sybase.

Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can also be used for a full installation.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.2 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase155. Database files will be stored on raw devices and/or in /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

*Solaris (pre version 10) /etc/system
set shmsys:shminfo_shmmax = 4294967295

*Solaris (system 10) /etc/project
projadd -c "sybase" 'user.sybase'
projmod -s -K "project.max-shm-memory={privileged,4GB,deny}" 'user.sybase'

*Linux:
Use "sysctl kernel.shmmax" to see the current value.
Configure a new value with "sysctl -w kernel.shmmax=78643200"
Then add kernel.shmmax=78643200 to /etc/sysctl.conf

==Raw devices or filesystem files==
Sybase recommends, and I fully 100% agree, to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems.

===Raw devices===
When you use raw devices, create the following:
* master (60Mb but 100Mb is better)
* sybsystemprocs (200M)
* sybsystemdb (20M)
* data01 (for instance 32G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 5G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.
===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least for 200Mb but, depending on your application, several Gb's or much more is not uncommon.

==Determine your license policy==
Since ASE 15.0 you cannot run a production server without license file. License files can reside on the network or on the local system. Think about the license policy that suits you best. For small sites choose for license files on each Unix server.

When there is no valid license after the installation ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license.

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

When you get a message like "A suitable JVM could not be found" or “exec: 2470: /tmp/install.dir.1392/Linux/resource/jre/bin/java: not found” check the following document for a solution: [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase155 as the destination directory, do a full installation. At the list of possible servers to configure, deselect all options. We will do a manual configuration.

When the installation has finished successful you can safely remove the work directory.

==Setup your environment==
In /opt/sybase/ase155 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase155/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase155.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licences
==Create the ASE server==
Most installations run multiple ASE's and backup servers from a single Sybase software installation. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you have made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: <your hostname>
sqlsrv.network_port_list: 4000
sqlsrv.application_type: MIXED
sqlsrv.server_page_size: USE_DEFAULT
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dev
sqlsrv.master_device_size: 100
sqlsrv.master_database_size: 60
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dev
sqlsrv.sybsystemprocs_device_size: 200
sqlsrv.sybsystemprocs_database_size: 200
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dev
sqlsrv.sybsystemdb_device_size: 20
sqlsrv.sybsystemdb_database_size: 20
sqlsrv.tempdb_device_physical_name: /var/sybase/ASE1/tempdb.dev
sqlsrv.tempdb_device_size: 100
sqlsrv.tempdb_database_size: 100M
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters:
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: no
sqlsrv.avail_physical_memory: PUT_THE_AVAILABLE_PHYSICAL_MEMORY_FOR_ASE_IN_OPTIMIZATION
sqlsrv.avail_cpu_num: PUT_THE_AVAILABLE_NUMBER_CPU_FOR_ASE_IN_OPTIMIZATION

This resource file will a create a Sybase server with the following characteristics:
* The name of the server will be ASE1, can be changed later with the sp_addserver stored procedure.
* The server will have a listener on the ip-address as indicated with <hostname> and port 4000. This can be changed later in the interfaces file.
* Application type is mixed, so you expect both oltp and dss type of queries. This can be changed later by modification of the “optimization goal” setting with sp_configure).
* Server page size will be 4 Kb, which is the default. This cannot be changed, a complete server rebuild is needed then.
* The master device will be 100 Mb, the size of the master database will be 60 Mb. The master devices will contain the master database, the master database contains important meta-data about the server. The master device can be increased with the “disk resize” command, the master database can be increased with the “alter database” command. There are no documented methods for shrinking devices or databases.
* The location of the errorlog is /opt/sybase/admin/ASE1/errorlog, can be changed later in the configuration file.
* A device of 200 Mb will be created for the sybsystemprocs database, also with a size of 200 Mb. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A device of 20 Mb will be created for the sybsystemdb database, also with a size of 20 Mb. A small portion will also reside on the master device. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A temporary database 'tempdb' will be created on a device with a size of 100 Mb, the database will also be 100 Mb. In fact, it will be a bit larger since also a small portion will reside on the master device. Again, the device and the tempdb database can be increased in size. You can also create multiple temporary databases for improved concurrency.
* We will build a backup server called SYB_BACKUP. The name can be changed later with sp_addserver.
* We will not use a PCI (Pluggable Component Interface) database. This database is mainly used for Java in the server.
* We will not use the optimize configuration feature now. When trying to use this feature through sqlsrv.do_optimize_config: yes can expect the error “Unable to find SQL file to run optimization task”. Configuration of the server will be done at a later stage.

Now build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
or
Optimizing server configuration...
Unable to find SQL file to run optimization task.
Task failed
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a successful creation you can connect to the server using the command line tool isql. At the prompt of isql you can type a command or execute a stored procedure. Type exit to exit.
isql -Usa -P -SASE1
sp_helpdb
go
exit

==Basic ASE configuration==

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown ASE

isql -Usa -P -SASE1
shutdown
go

cd $SYBASE/$SYBASE_ASE
mv ASE1.cfg /opt/sybase/admin/ASE1
rm ASE1.*
cd install

Modify RUN_ASE1 and make the following changes:
* Make the -s flag the first option. This has the advantage that a listing of running processes on the system will show the name of the Sybase server.
* Change the location of the configuration files, as specified with the -c flag, to the admin directory
Each line must end with a backslash.
Example RUN_ASE1 file:

#!/bin/sh
#
# ASE page size (KB): 2K
# Master device path: /var/sybase/ASE1/master.dev
# Error log path: /opt/sybase/admin/ASE1/errorlog
# Configuration file path: /opt/sybase/ase155/ASE-15_0/ASE1.cfg
# Directory for shared memory files: /opt/sybase/ase155/ASE-15_0
# Adaptive Server name: ASE1
#
/opt/sybase/ase155/ASE-15_0/bin/dataserver \
-sASE1 \
-d/var/sybase/ASE1/master.dev \
-e/opt/sybase/admin/ASE1/errorlog \
-c/opt/sybase/admin/ASE1/ASE1.cfg \
-M/opt/sybase/ase155/ASE-15_0 \

Now restart the Sybase server
./startserver -f ./RUN_ASE1

===Load instmsg.ebf file===
The instmsgs.ebf file contains the latest update for Sybase error messages. You can load it with isql.
isql -Usa -P -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

===Configure the server using optase.sh===
With the tool optase.sh you can configure your server. You need to supply the following information:
* The amount of memory that the Sybase server can use. A rough guideline is approx 80 % of total physical memory but lower the value if your other servers or application software at the same time.
* The number of CPU's that the Sybase server can use. Again, leave a safe margin for other processes and the operating system.
* The pagesize of the ASE server, as specified in the ASE1.rs file. When you have used the default page size it will be 4Kb.
* Type of product edition. Some ASE features are not available in certain editions.
* Application type, as specified in the ASE1.rs file.
You can run optase.sh and have you prompted per item, or supply all the required information when you start the tool.
Example
$SYBASE/$SYBASE_ASE/bin/optase.sh 1024 2 2 EE MIXED /tmp/config.sql

When done, run the configuration script.

isql -Usa -P -SASE1 -i /tmp/config.sql

Then reboot the ASE server, stop it first
isql -Usa -P -SASE1
shutdown
go

Start again
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_ASE1

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: prd-syb-ase2
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: USE_DEFAULT
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: USE_DEFAULT
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown the backup server:
isql -Usa -P -SASE1
shutdown SYB_BACKUP
go
exit

Modify the RUN_SYB_BACKUP, located at $SYBASE/$SYBASE_ASE/install. Change the location of the log file,as specified with the -e flag. Change it to the admin directory. Also, move the line with the -s flag to the top. Sample RUN_SYB_BACKUP:
#!/bin/sh
#
# Error log path: /opt/sybase/ase155/ASE-15_0/install/SYB_BACKUP.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Multibuf executable path: /opt/sybase/ase155/ASE-15_0/bin/sybmultbuf
# Backup Server name: SYB_BACKUP
#
/opt/sybase/ase155/ASE-15_0/bin/backupserver \
-SSYB_BACKUP \
-e/opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log \
-N25 \
-C20 \
-M/opt/sybase/ase155/ASE-15_0/bin/sybmultbuf \

Remove the old log file
rm $SYBASE/$SYBASE_ASE/install/SYB_BACKUP.log

Restart the backupserver
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_SYB_BACKUP

==Create a user database==
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go
==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installatin guide for Linux http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30119.1550/doc/html/title.html

Sybase System administration http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31654.1550/html/sag1/title.htm

[[Category:ASE]]
[[category:Installation Guidelines]]

Installation guidelines ASE 15.0

2013-11-08T11:43:40Z

Psap:

This page describes how to install and configure a Sybase ASE server.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/detail?id=1052712
At the Linux promotion page from Sybase http://www.sybase.com/linuxpromo you can download ASE 15.0.2 in both 32 and 64 bit versions.

Some alternative locations are described here http://www.sypron.nl/get_ase_soft.html

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 800 Mb so 3 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase15. Database files will be stored on raw devices and/or in /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

*Solaris (pre version 10) /etc/system
set shmsys:shminfo_shmmax = 4294967295

*Linux: modify /etc/sysctl.conf

Use "sysctl kernel.shmmax" to see the current value.
Configure a new value with "sysctl -w kernel.shmmax=78643200"

==Raw devices or filesystem files==
Sybase recommends, and I fully 100% agree, to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems. Whenever possible, use directio when the mounted filesystem allows it.
===Raw devices===
When you do raw devices, create the following:
* master (60Mb but 100Mb is better)
* sybsystemprocs(150M)
* sybsystemdb(20M)
* data01 (for instance 32G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 5G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.
===File system files===
Make sure you have a filesystem that's big enough to store the files mentioned in the 'Raw devices' section.
===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least for 100Mb but, depending on your application, 1Gb is not uncommon.

==Determine your license policy==
Since ASE 15 you cannot run a production server with no license file. License files can reside on the network or on the local system. Think about the license policy that suits you best.

When there is no valid license after the installation ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license.

==Installation==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir work
cd work
<put the software in this directory>
tar -xf <software-distro>

Start the installation.

./setup -console

When you get a message like "A suitable JVM could not be found" check the following documents for a possible solution
* [[Running a 32 bit ASE executable with a 64 bit chip]]
* [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase15 as the destination directory, do a full installation.
Assuming you store Sybase licenses on your local system, answer No at "Will licenses be obtained from the License Server?".
Also, at "Do you want to configure email alerts?" answer No.

At the possible options of the Product Edition choose the one that suits your situation. After installation you can reconfigure it, in case you picked the wrong option.

At the list of possible servers to configure, deselect all options. We will do it manually.

When the installation has finished succesful you can safely remove the work directory.

==Setup your environment==
In /opt/sybase/ase15 you will find a few files, like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase15/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase15.
Is is fairly common to activite the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/$SYBASE_SYSAM/licences
==Create the server==
Most installations run multiple ASE's and backup servers from a single Sybase software tree. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: PUT_YOUR_HOSTNAME_HERE
sqlsrv.network_port_list: 4000
sqlsrv.server_page_size: USE_DEFAULT
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dat
sqlsrv.master_device_size: 60
sqlsrv.master_database_size: 30
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dat
sqlsrv.sybsystemprocs_device_size: 150
sqlsrv.sybsystemprocs_database_size: 150
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dat
sqlsrv.sybsystemdb_device_size: 20
sqlsrv.sybsystemdb_database_size: 20
sqlsrv.default_backup_server: SYB_BACKUP
sqlsrv.addl_cmdline_parameters:

Please note that the option sqlsrv.addl_cmdline_parameters was added in 15.0.2 so you do not need to specify this for older releases.

Build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a succesful creation you can connect to the server:
isql -Usa -P -SASE1

==Basic configuration==
===Load additional files===
Often forgotten, but you should load this file too:
isql -Usa -P -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

Load the monitoring tables (automatically done since 15.0.2), like this:
Pre 15.0, create a loopback server
isql -Usa -P -SASE1
sp_addserver loopback,null,@@servername
go
quit
Since 12.5.0.3, load the monitoring tables:
isql -Usa -P -SASE1 < $SYBASE/$SYBASE_ASE/scripts/installmontables

===Increase the size of tempdb===
Log on with isql and do the following:
disk init name = temp01,physname="/var/sybase/ASE1/temp01.dat",dsync=false,size="100M"
go
alter database tempdb on temp01=100
go

For a more advanced configuration of tempdb, go here: [[Tempdb space management]].
===Create a user database===
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go

===Very basic server configuration===
Set some common options and increase memory size. Depending on your situation you need to increase the given values.
sp_configure "max memory",100000
go
sp_cacheconfig "default data cache","20M"
go
sp_poolconfig "default data cache","5M","4K"
go
sp_poolconfig "default data cache","5M","16K"
go
sp_configure "procedure cache size",14000
go

These values provide only a minimal starting point and should not be used in a production environment. Consult your local DBA for further assistance.

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: PUT_YOUR_HOSTNAME_HERE
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /opt/sybase/admin/SYB_BACKUP/errorlog
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: USE_DEFAULT
bsrv.addl_cmdline_parameters:

Please note that the option bsrv.addl_cmdline_parameters was added in 15.0.2 so you do not need to specify this for older releases.

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

==All done==
Happy Sybase-ing with your new server!!

Further reading: http://infocenter.sybase.com/help/topic/com.sybase.dc30119_1501/html/installnx/title.htm

[[Category:ASE]]
[[category:Installation Guidelines]]

Category:Installation Guidelines

2013-11-08T11:42:37Z

Psap: Created page with "This page lists the various Installation Guidelines available in the SybaseWiki."

This page lists the various Installation Guidelines available in the SybaseWiki.

Installation guidelines IQ 16

2013-11-08T11:41:13Z

Psap: Created page with "This page describes how to install and configure a Sybase IQ server, version 16.0. If you are new to Sybase IQ, it will also give some information about the product and termi..."

This page describes how to install and configure a Sybase IQ server, version 16.0.

If you are new to Sybase IQ, it will also give some information about the product and terminology.

==About Sybase IQ==
===About the product===
Here are 2 videos that might be worth watching.

{|
|+
|-
| ||
|-
|{{#ev:youtube|Bbcl8uY3tj4|500}}
|{{#ev:youtube|9V8bmtWtY8M|500}}
|-
|To get a basic feeling of the product you can watch this sales video from SAP
|This video is more targeted towards DBA's who already have experience with Sybase IQ and it highlights the new features in version 16. (you might want to skip the first 5 minutes as this is mostly sales talk).
|}

===Some terminology===
Sybase IQ stores it's data in various places, here is a very brief overview of them:
* Catalog store or SYSTEM dbspace, holds the meta data of the system, the table definitions, the stored procedures, etc. This is the .db file.
* Transactionlog, holds transactional information of activity in the catalog store. This is the .log file.
* Mirror logfile. An optional (but recommended) file that mirrors the transactionlog. There is no default file extension so use .mirror.

Then we have various dbspaces where the user data is stored, sorts are taking place, etc.
* IQ_SYSTEM_MAIN, holds various internal structures for checkpointing, backups, etc. These are the .iq files.
* IQ_SYSTEM_TEMP, holds temporary tables and is used for sorting data. These are the .iqtmp files.
* IQ_SHARED_TEMP, holds temporary data if you use Distributed Query Processing.
* User main, this dbspace holds your data. No default file extension here so use .iq.

Each dbspace (execept for SYSTEM) consists of various files.

==Get the software==
First download IQ.

For a licensed version you need to go http://sybase.subscribenet.com (account required) or to the Sybase eShop http://eshop.sybase.com/eshop/buy?id=48151

A trial version can be downloaded here: http://scn.sap.com/community/developer-center/analytic-server

==Sample directory structure==
In this document the following directory structure is used:

* /opt/sybase/iq - holds the Sybase IQ software
* /var/sybase/IQ1 – holds logfiles for the IQ instance and the for the catalog store
* /var/sybase/IQ1/iq_files – holds the dbspaces or symbolic links to raw devices.

==Prepare the Operating System==
Before installing Sybase IQ 16 for a production environment, make sure you have read and followed the recommendations in the hardware size guide http://scn.sap.com/docs/DOC-41455

Check that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.5 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/iq16. Database files will be stored on raw devices and in a subdirectory in /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Check that your operating system has the required patches and configuration settings. Look in the installation documentation at http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc10083.1600/doc/html/title.html for detailed instructions. When you run the IQ installation, it will also check for some required packages.

==Required packages==
For RedHat / Centos, you need to install these packages:
yum install csh
yum install file
yum install libaio
yum install libXext
yum install libXrender
yum install libXtst
yum install libXi

Based on Ubuntu Linux (unsupported but seems to work), you need to install these packages:

apt-get install libaio1
apt-get install csh
apt-get install libxrender1
apt-get install libxtst6
apt-get install ia32-libs

==Prepare the Installation==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir work
mkdir iq16
cd work
<put the software in this directory>
tar -xf <software-distro>

==Installation==
Go into the directory with the installed software. Run the installer (for instance ./setup.bin).
./setup.bin
Answer the questions and install into /opt/sybase/iq16, select Typical or Full as Install Set. You can select what license type you need, Licensed or Evaluation. For the licenced version you need an account at http://sybase.subscribenet.com to generate the license keys. The evaluation license allows you to run IQ with all its features for 30 days.
Accept the default port numbers for Sybase Control Center, and specify the password for the SCC administrator. Do not start Sybase Control Center.

Once the installation is complete you can remove the work directory and its content.
cd /opt/sybase
rm -Rf work
===Errors when running setup.bin===
====java not found====

When you get an error like this

exec: 2508: /tmp/install.dir.10616/Linux/resource/jre/bin/java: not found

you need to install software to run 32 bit binaries on a 64 bit machine. Become root again and install the required packages.

On ubuntu:

apt-get install ia32-libs

On Redhat

yum install glibc-devel.i386

====Fontconfig error====

Ignore the error "Fontconfig error: Cannot load default config file" if you get it.

==Setup your environment==
In /opt/sybase/iq16 you will find files like IQ.sh and IQ.csh. Depending on the type of shell you use, you need to source in one of these. For instance, when your default shell is bash you should do this:
. /opt/sybase/iq16/IQ.sh
Is is fairly common to activate such a script from your login script.

==Create raw devices==
Raw devices are recommended and you need them for the IQ Main Store, the Temporary Store and the User Stores.
For testing purposes use 2Gb for the Main store and 1 Gb for the Temporary store. You can always add more when needed, but plan well ahead in case you want to run any serious production.

The number of files in a dbspace are important, as well as the size and expected size in the future. In this example we will use 2 files per dbspace but use 8 to 12 files in production environments, each placed on a separate LUN.

Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.

==Start the IQ server (utility database only)==
Create a directory where server and database specific files will be stored
mkdir /var/sybase/IQ1
cd /var/sybase/IQ1
mkdir iq_files

Set the variable IQLOGDIR16 to a directory where the logfiles will be stored. When you do not set the variable, they will go to $IQDIR16/logfiles (/opt/sybase/iq16/IQ-16_0/logfiles).

export IQLOGDIR16=/var/sybase/IQ1

Start the IQ server with only the (virtual) utility database active. Use the start_iq command and specify the name of the server using the -n flag.

start_iq -n IQ1

==Connect to the IQ server==
Use dbisql to connect to the IQ server. You may need to set the DISPLAY variable.
dbisql

When you get the error “Could not initialize class java.awt.Toolkit” make sure that the required packages are installed. See above section.

Specify “DBA” for the User ID, “sql” for the password, choose “Connect to a running database on this computer” and “utility_db” as the database name. Click Connect.

Alternatively, you can use dbisqlc with a basic gui or iqisql but both of these tools are deprecated.

==Create a database==

The create database command has several option that can have a big impact on performance. See notes below or study the Sybase documentation to get the best result.
Example:
create database 'IQ1.db'
transaction log on 'IQ1.log'
mirror 'IQ1.mirror'
message path 'IQ1.iqmsg'
iq path 'iq_files/IQ1_01.iq'
iq size 2000
iq reserve 2000
temporary path 'iq_files/IQ1_01.iqtmp'
temporary size 1000
temporary reserve 1000
dba user 'DBA'
dba password '4yourEyes'

When the database has been successfully created you can stop the IQ server
stop engine
and then exit from dbisql.
exit
===Notes for the "create database" command.===
* The default page size for IQ files (.iq and .iqtmp files) is 128 Kb. When a single table in the database is expected to grow above 8 Tb or will have more than 4 billion rows choose the next bigger IQ page size of 256Kb.
* When creating a database or a dbspace you can ommit the fully specified path to the filename. When you use filenames relative to the IQ server it is more easy to move a database to another server.
* When using raw devices do not use the clause "iq size" and/or "temporary size". IQ will determine the size of the raw device and use it completely.
* When the database is created and you know that it will grow after some time, add the “iq reserve” clause to the “create database” command. This will create a contiguous free list that is already large enough for the future size of the database and so prevents a fragmented free list. Do the same when the user dbspace is created (see below). Then add the “reserve” clause.

==Create a configuration file==
In the directory /var/sybase/IQ1 create a configuration file called params.cfg with at least the following content
-n IQ1
-iqmc 4000
-iqtc 6000

This configuration file sets the name of the server, the main cache size to 4000Mb, the temp cache size to 6000Mb. Specify as much memory as you can but leave a safe margin for other processes. Sybase recommends to keep the ration between main and temp cache 3:7 or 4:6 but it really depends on the type of activity on the IQ instance.
Then start the database
start_iq @./params.cfg ./IQ1.db

==Create a user dbspace==
Log on with dbisql and use the username/password combination as specified with the create database command. Then create a user space where all tables for the application should be stored. Example:

create dbspace user_main
using file user_main_01 'iq_files/user_main_01.iq'
size 5000 MB
reserve 5000 MB
iq store;

As we do not want to store any user data in IQ_SYSTEM_MAIN transfer the privileges to create objects to user_main.

set option public.default_dbspace = 'user_main';
grant create on user_main to public;
revoke create on iq_system_main from public;

==Extend the db spaces with a second file==
For performance reasons you should use multiple files per dbspace. Here are examples to extend the 3 different dbspaces: IQ_SYSTEM_MAIN, IQ_SYSTEM_TEMP and user_main.

alter dbspace IQ_SYSTEM_MAIN
add file main_02 'iq_files/IQ1_02.iq'
size 2000 MB reserve 2000 MB;

alter dbspace IQ_SYSTEM_TEMP
add file temp_02 'iq_files/IQ1_02.iqtmp'
size 1000 MB reserve 1000 MB;

alter dbspace user_main
add file user_main_02 'iq_files/user_main_02.iq'
size 5000 MB
reserve 5000 MB;

Try to keep all the files in any dbspace to the same size to achieve a situation that all files are more or less filled at the same capacity.

By default, Sybase IQ stripes the date over the various files within a dbspace. For performance reasons it is best to have IQ handle the striped writes rather than a SAN storage system. Doing striped writes from both sides (SAN and IQ) may be counter productive.

You can run these stored procedures to view the dbspaces and their files

exec sp_iqfile;
exec sp_iqdbspace;

==Getting started with users and tables==

create user develop identified by 'GoodLuck';
grant create any object to develop;

Log off from dbisql and reconnect with the credentials of the new user. Then create the first table.

create table company(
company_id int not null,
company_name varchar(30) not null);

[[category:IQ]]
[[category:Installation Guidelines]]

Could not find or load the physical store DLL

2013-11-04T19:47:14Z

Psap: /* Make sure that asynchronous I/O is enabled */

When you get this error

Unable to start specified database: Could not find or load the physical store DLL.

You might want to investigate 2 things

==Do not use shared memory==
Remove the iqwmem switch from the params.cfg file for the IQ server when you are *not* on Solaris or HP-UX. Example:

-iqwmem 500

See http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00169.1600/doc/html/san1281545678021.html for more information.

==Make sure that asynchronous I/O is enabled==
Asynchronous I/O must be enabled on the server where the IQ instance is running.

On RedHat / Centos / Fedora

yum install libaio

On Ubuntu:

apt-get install libaio1

==Before you try again==
In both cases you need to reboot the IQ instance to activate the changed configuration

[[Category:IQ]]

Main Page

2013-10-19T16:03:09Z

Psap:

=Welcome to the SybaseWiki=

This wiki is created to provide additional information for the usage of various [http://www.sybase.com Sybase] products. It's maintained by [[User:Psap|Peter Sap]]. If you want to add or change content, just drop me a mail at mailto:peter@petersap.nl and I'll create an account for you. Thank you.

Information in the wiki is grouped per product:
{|
|+
|-
| ||
|-
|[[:Category:ASE|Adaptive server Enterprise]]
|-
|[[:Category:RepServer|Replication Server]]
|-
|[[:Category:IQ|Sybase IQ]]
|-
|[[:Category:OpenSwitch|OpenSwitch]]
|}

A special place has been created for GUI tools: [[:Category:GUI Tools|GUI Tools]]

==Stay up to date==
Through [http://www.feedburner.com FeedBurner (from Google)] you can subscribe to updates about new pages and changes to SybaseWiki. Follow this link to subscribe to this free service:

[http://www.feedburner.com/fb/a/emailverifySubmit?feedId=1613549&loc=en_US Subscribe to SybaseWiki - Recent changes by Email]

The RSS feed is here: [http://www.petersap.nl/SybaseWiki/index.php?title=Special:Recentchanges&feed=rss Recent changes by RSS]

Or follow Peter Sap on twitter: [https://twitter.com/intent/follow?region=follow_link&screen_name=petersap&source=followbutton&variant=2.0 @petersap]

==Other Pages==
Links to other sites with Sybase info: [[Sybase links]]

Miscellaneous pages: [[Miscellaneous]]

Could not find or load the physical store DLL

2013-10-02T19:31:39Z

Psap: Created page with 'When you get this error Unable to start specified database: Could not find or load the physical store DLL. You might want to investigate 2 things ==Do not use shared memory==…'

When you get this error

Unable to start specified database: Could not find or load the physical store DLL.

You might want to investigate 2 things

==Do not use shared memory==
Remove the iqwmem switch from the params.cfg file for the IQ server when you are *not* on Solaris or HP-UX. Example:

-iqwmem 500

See http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00169.1600/doc/html/san1281545678021.html for more information.

==Make sure that asynchronous I/O is enabled==
Asynchronous I/O must be enabled on the server where the IQ instance is running.

On Ubuntu:

apt-get install libaio1

==Before you try again==
In both cases you need to reboot the IQ instance to activate the changed configuration

[[Category:IQ]]

Installation guidelines RepServer 15.7.1

2013-04-29T10:03:39Z

Psap: Created page with 'This page describes how to install and configure a Sybase Replication Server version 15.7.1. You will also learn how to connect to the server, stop and restart it. ==Get the sof…'

Installation guidelines ASE 15.7

2013-04-10T12:40:49Z

Psap: /* Linux */

This page describes how to install and configure a Sybase ASE server version 15.7. You will also learn how to connect to the server, stop and restart it.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/ase_1500devel. You can download ASE 15.7 for various operating systems and chipsets. When you install ASE you can choose to run without a license (limited features) or install a licenced version and buy a license from Sybase.

Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can also be used for a full installation.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.5 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase157. Database files will be stored /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

===Linux===
To see the current value of shared memory:
sysctl kernel.shmmax

To configure a shared memory segment of 4 Gb
sysctl -w kernel.shmmax=4294967296

Then add kernel.shmmax=4294967296 to /etc/sysctl.conf

See also [[Linux configuration settings for Sybase ASE]], but these settings can be done when the installation and configuration has been completed.

When installing Sybase ASE 64 bit version on Linux, you may want to install the 32 bit shared libraries as well. This will prevent problems when running isql or bcp.
apt-get install ia32-libs

===Solaris (pre version 10)===
/etc/system
set shmsys:shminfo_shmmax = 4294967296

===Solaris (system 10)===
/etc/project
projadd -c "sybase" 'user.sybase'
projmod -s -K "project.max-shm-memory={privileged,4GB,deny}" 'user.sybase'

==Raw devices or filesystem files==
Sybase recommends to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems. Also, consult your storage administrator when in doubt.

===Raw devices===
When you use raw devices, create the following:
* master (100 Mb)
* sybsystemprocs (172M)
* sybsystemdb (6M)
* data01 (for instance 10G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 2G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.

===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least 100Mb but, depending on your application, several Gb's or much more is not uncommon.

==Determine your license policy==
Since ASE 15.0 you cannot run a production server without a license file. License files can reside on the network or on the local system. Think about the license policy that suits you best. Most sites choose for license files on each Unix server.

When there is no valid license, ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license, or change the license settings revert to the Express Edition.

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

When you get a message like "A suitable JVM could not be found" or “exec: 2470: /tmp/install.dir.1392/Linux/resource/jre/bin/java: not found” check the following document for a solution: [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase157 as the destination directory, do a full installation. At the list of possible servers to configure, deselect all options. We will do a manual configuration.

When the installation has finished successful you can safely remove the work directory and the installation package.

==Setup your environment==
In /opt/sybase/ase157 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase157/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase157.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licenses

==Create the ASE server==
Most installations, especially for development purposes, run multiple ASE's and backup servers from a single Sybase software installation. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you have made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: <put your hostname here>
sqlsrv.network_port_list: 4000
sqlsrv.application_type: MIXED
sqlsrv.server_page_size: 4096
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dev
sqlsrv.master_device_size: 100
sqlsrv.master_database_size: 60
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dev
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dev
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /var/sybase/ASE1/tempdb.dev
sqlsrv.tempdb_device_size: 100
sqlsrv.tempdb_database_size: 100
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: yes
sqlsrv.avail_physical_memory: 256
sqlsrv.avail_cpu_num: 1

This resource file will a create a Sybase server with the following characteristics:
* The name of the server will be ASE1, can be changed later with the sp_addserver stored procedure.
* The server will have a listener on the ip-address as indicated with <hostname> and port 4000. This can be changed later in the interfaces file located at $SYBASE/interfaces.
* Application type is mixed, so you expect both oltp and dss type of queries. This can be changed later by modification of the “optimization goal” setting with sp_configure).
* Server page size will be 4 Kb. The default is 2 Kb but with today’s hardware this will give sub-optimal performance. Once the server has been created it cannot be changed, a complete server rebuild is needed then.
* The master device will be 100 Mb, the size of the master database will be 60 Mb. The master devices will contain the master database, the master database contains important meta-data about the server. It’s very unusual to increase the size of the master device or the master database.
* The location of the errorlog is /opt/sybase/admin/ASE1/errorlog, can be changed later in the configuration file.
* A device of 172 Mb will be created for the sybsystemprocs database, also with a size of 172 Mb. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A device of 6 Mb will be created for the sybsystemdb database. The size of the database will actually be 12Mb as a small portion will also reside on the master device. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A temporary database 'tempdb' will be created on a device with a size of 100 Mb, the database will also be 100 Mb. In fact, it will be a bit larger since also a small portion will reside on the master device. Again, the device and the tempdb database can be increased in size. You can also create multiple temporary databases for improved concurrency.
* We will build a backup server called SYB_BACKUP. The name can be changed later with sp_addserver.
* We will not use a PCI (Pluggable Component Interface) database. This database is mainly used for Java in the server.
* Use the optimize configuration feature and tune for 256 Mb of memory and 1 cpu.

Now build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a successful creation you can connect to the server using the command line tool isql. The login “sa" has been created, with the password that was specified in ASE.rs file. At the prompt of isql you can type a command or execute a stored procedure. Type exit to exit.
isql -Usa -Psecret123 -SASE1
sp_helpdb
go
exit

==Basic ASE configuration==

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown ASE

isql -Usa -Psecret123 -SASE1
shutdown
go

cd $SYBASE/$SYBASE_ASE
mv ASE1.cfg /opt/sybase/admin/ASE1
rm ASE1.*
cd install

Modify RUN_ASE1 and make the following changes:
* Make the -s flag the first option. This has the advantage that a listing of running processes on the system will show the name of the Sybase server.
* Change the location of the configuration files, as specified with the -c flag, to the admin directory
Each line must end with a backslash.
Example RUN_ASE1 file:

#!/bin/sh
#
# ASE page size (KB): 4096
# Master device path: /var/sybase/ASE1/master.dev
# Error log path: /opt/sybase/admin/ASE1/errorlog
# Configuration file path: /opt/sybase/ase157/ASE-15_0/ASE1.cfg
# Directory for shared memory files: /opt/sybase/ase157/ASE-15_0
# Adaptive Server name: ASE1
#
/opt/sybase/ase157/ASE-15_0/bin/dataserver \
-sASE1 \
-d/var/sybase/ASE1/master.dev \
-e/opt/sybase/admin/ASE1/errorlog \
-c/opt/sybase/admin/ASE1/ASE1.cfg \
-M/opt/sybase/ase157/ASE-15_0 \

Now restart the Sybase server
./startserver -f ./RUN_ASE1

===Load instmsg.ebf file===
The instmsgs.ebf file contains the latest update for Sybase error messages. You can load it with isql.
isql -Usa -Psecret123 -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: <put your hostname here>
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

===Move and modify configuration files===
In this step we will move the configuration file to the admin directory. First shutdown the backup server:
isql -Usa -Psecret123 -SASE1
shutdown SYB_BACKUP
go
exit

Modify the file RUN_SYB_BACKUP, located at $SYBASE/$SYBASE_ASE/install. Move the line with the -s flag to the top. Sample RUN_SYB_BACKUP:
#!/bin/sh
#
# Error log path: /opt/sybase/ase157/ASE-15_0/install/SYB_BACKUP.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Multibuf executable path: /opt/sybase/ase157/ASE-15_0/bin/sybmultbuf
# Backup Server name: SYB_BACKUP
#
/opt/sybase/ase157/ASE-15_0/bin/backupserver \
-SSYB_BACKUP \
-e/opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log \
-N25 \
-C20 \
-M/opt/sybase/ase157/ASE-15_0/bin/sybmultbuf \

Restart the backupserver
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_SYB_BACKUP

==Create a user database==
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go
==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installation guide for Linux http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30119.1570/doc/html/title.html

Sybase System administration http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31654.1570/html/sag1/title.htm

[[Category:ASE]]

Installation guidelines ASE 15.7

2013-04-10T11:23:58Z

Psap:

This page describes how to install and configure a Sybase ASE server version 15.7. You will also learn how to connect to the server, stop and restart it.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/ase_1500devel. You can download ASE 15.7 for various operating systems and chipsets. When you install ASE you can choose to run without a license (limited features) or install a licenced version and buy a license from Sybase.

Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can also be used for a full installation.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.5 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase157. Database files will be stored /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

===Linux===
To see the current value of shared memory:
sysctl kernel.shmmax

To configure a shared memory segment of 4 Gb
sysctl -w kernel.shmmax=4294967296

Then add kernel.shmmax=4294967296 to /etc/sysctl.conf

See also [[Linux configuration settings for Sybase ASE]], but these settings can be done when the installation and configuration has been completed.

===Solaris (pre version 10)===
/etc/system
set shmsys:shminfo_shmmax = 4294967296

===Solaris (system 10)===
/etc/project
projadd -c "sybase" 'user.sybase'
projmod -s -K "project.max-shm-memory={privileged,4GB,deny}" 'user.sybase'

==Raw devices or filesystem files==
Sybase recommends to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems. Also, consult your storage administrator when in doubt.

===Raw devices===
When you use raw devices, create the following:
* master (100 Mb)
* sybsystemprocs (172M)
* sybsystemdb (6M)
* data01 (for instance 10G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 2G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.

===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least 100Mb but, depending on your application, several Gb's or much more is not uncommon.

==Determine your license policy==
Since ASE 15.0 you cannot run a production server without a license file. License files can reside on the network or on the local system. Think about the license policy that suits you best. Most sites choose for license files on each Unix server.

When there is no valid license, ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license, or change the license settings revert to the Express Edition.

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

When you get a message like "A suitable JVM could not be found" or “exec: 2470: /tmp/install.dir.1392/Linux/resource/jre/bin/java: not found” check the following document for a solution: [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase157 as the destination directory, do a full installation. At the list of possible servers to configure, deselect all options. We will do a manual configuration.

When the installation has finished successful you can safely remove the work directory and the installation package.

==Setup your environment==
In /opt/sybase/ase157 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase157/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase157.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licenses

==Create the ASE server==
Most installations, especially for development purposes, run multiple ASE's and backup servers from a single Sybase software installation. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you have made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: <put your hostname here>
sqlsrv.network_port_list: 4000
sqlsrv.application_type: MIXED
sqlsrv.server_page_size: 4096
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dev
sqlsrv.master_device_size: 100
sqlsrv.master_database_size: 60
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dev
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dev
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /var/sybase/ASE1/tempdb.dev
sqlsrv.tempdb_device_size: 100
sqlsrv.tempdb_database_size: 100
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: yes
sqlsrv.avail_physical_memory: 256
sqlsrv.avail_cpu_num: 1

This resource file will a create a Sybase server with the following characteristics:
* The name of the server will be ASE1, can be changed later with the sp_addserver stored procedure.
* The server will have a listener on the ip-address as indicated with <hostname> and port 4000. This can be changed later in the interfaces file located at $SYBASE/interfaces.
* Application type is mixed, so you expect both oltp and dss type of queries. This can be changed later by modification of the “optimization goal” setting with sp_configure).
* Server page size will be 4 Kb. The default is 2 Kb but with today’s hardware this will give sub-optimal performance. Once the server has been created it cannot be changed, a complete server rebuild is needed then.
* The master device will be 100 Mb, the size of the master database will be 60 Mb. The master devices will contain the master database, the master database contains important meta-data about the server. It’s very unusual to increase the size of the master device or the master database.
* The location of the errorlog is /opt/sybase/admin/ASE1/errorlog, can be changed later in the configuration file.
* A device of 172 Mb will be created for the sybsystemprocs database, also with a size of 172 Mb. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A device of 6 Mb will be created for the sybsystemdb database. The size of the database will actually be 12Mb as a small portion will also reside on the master device. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A temporary database 'tempdb' will be created on a device with a size of 100 Mb, the database will also be 100 Mb. In fact, it will be a bit larger since also a small portion will reside on the master device. Again, the device and the tempdb database can be increased in size. You can also create multiple temporary databases for improved concurrency.
* We will build a backup server called SYB_BACKUP. The name can be changed later with sp_addserver.
* We will not use a PCI (Pluggable Component Interface) database. This database is mainly used for Java in the server.
* Use the optimize configuration feature and tune for 256 Mb of memory and 1 cpu.

Now build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a successful creation you can connect to the server using the command line tool isql. The login “sa" has been created, with the password that was specified in ASE.rs file. At the prompt of isql you can type a command or execute a stored procedure. Type exit to exit.
isql -Usa -Psecret123 -SASE1
sp_helpdb
go
exit

==Basic ASE configuration==

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown ASE

isql -Usa -Psecret123 -SASE1
shutdown
go

cd $SYBASE/$SYBASE_ASE
mv ASE1.cfg /opt/sybase/admin/ASE1
rm ASE1.*
cd install

Modify RUN_ASE1 and make the following changes:
* Make the -s flag the first option. This has the advantage that a listing of running processes on the system will show the name of the Sybase server.
* Change the location of the configuration files, as specified with the -c flag, to the admin directory
Each line must end with a backslash.
Example RUN_ASE1 file:

#!/bin/sh
#
# ASE page size (KB): 4096
# Master device path: /var/sybase/ASE1/master.dev
# Error log path: /opt/sybase/admin/ASE1/errorlog
# Configuration file path: /opt/sybase/ase157/ASE-15_0/ASE1.cfg
# Directory for shared memory files: /opt/sybase/ase157/ASE-15_0
# Adaptive Server name: ASE1
#
/opt/sybase/ase157/ASE-15_0/bin/dataserver \
-sASE1 \
-d/var/sybase/ASE1/master.dev \
-e/opt/sybase/admin/ASE1/errorlog \
-c/opt/sybase/admin/ASE1/ASE1.cfg \
-M/opt/sybase/ase157/ASE-15_0 \

Now restart the Sybase server
./startserver -f ./RUN_ASE1

===Load instmsg.ebf file===
The instmsgs.ebf file contains the latest update for Sybase error messages. You can load it with isql.
isql -Usa -Psecret123 -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: <put your hostname here>
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

===Move and modify configuration files===
In this step we will move the configuration file to the admin directory. First shutdown the backup server:
isql -Usa -Psecret123 -SASE1
shutdown SYB_BACKUP
go
exit

Modify the file RUN_SYB_BACKUP, located at $SYBASE/$SYBASE_ASE/install. Move the line with the -s flag to the top. Sample RUN_SYB_BACKUP:
#!/bin/sh
#
# Error log path: /opt/sybase/ase157/ASE-15_0/install/SYB_BACKUP.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Multibuf executable path: /opt/sybase/ase157/ASE-15_0/bin/sybmultbuf
# Backup Server name: SYB_BACKUP
#
/opt/sybase/ase157/ASE-15_0/bin/backupserver \
-SSYB_BACKUP \
-e/opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log \
-N25 \
-C20 \
-M/opt/sybase/ase157/ASE-15_0/bin/sybmultbuf \

Restart the backupserver
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_SYB_BACKUP

==Create a user database==
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go
==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installation guide for Linux http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30119.1570/doc/html/title.html

Sybase System administration http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31654.1570/html/sag1/title.htm

[[Category:ASE]]

Installation guidelines ASE

2013-04-10T10:32:10Z

Psap: Redirected page to Installation guidelines ASE 15.7

#REDIRECT [[Installation guidelines ASE 15.7]]

Installation guidelines ASE 15.7

2013-04-10T07:50:30Z

Psap:

This page describes how to install and configure a Sybase ASE server version 15.7. You will also learn how to connect to the server, stop and restart it.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/ase_1500devel. You can download ASE 15.7 for various operating systems and chipsets. When you install ASE you can choose to run without a license (limited features) or install a licenced version and buy a license from Sybase.

Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can also be used for a full installation.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.5 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase157. Database files will be stored /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

*For Linux systems see [[Linux configuration settings for Sybase ASE]]

*Solaris (pre version 10) /etc/system
set shmsys:shminfo_shmmax = 4294967295

*Solaris (system 10) /etc/project
projadd -c "sybase" 'user.sybase'
projmod -s -K "project.max-shm-memory={privileged,4GB,deny}" 'user.sybase'

==Raw devices or filesystem files==
Sybase recommends to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems. Also, consult your storage administrator when in doubt.

===Raw devices===
When you use raw devices, create the following:
* master (100 Mb)
* sybsystemprocs (172M)
* sybsystemdb (6M)
* data01 (for instance 10G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 2G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.

===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least 100Mb but, depending on your application, several Gb's or much more is not uncommon.

==Determine your license policy==
Since ASE 15.0 you cannot run a production server without a license file. License files can reside on the network or on the local system. Think about the license policy that suits you best. Most sites choose for license files on each Unix server.

When there is no valid license, ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license, or change the license settings revert to the Express Edition.

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

When you get a message like "A suitable JVM could not be found" or “exec: 2470: /tmp/install.dir.1392/Linux/resource/jre/bin/java: not found” check the following document for a solution: [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase157 as the destination directory, do a full installation. At the list of possible servers to configure, deselect all options. We will do a manual configuration.

When the installation has finished successful you can safely remove the work directory and the installation package.

==Setup your environment==
In /opt/sybase/ase157 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase157/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase157.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licenses

==Create the ASE server==
Most installations, especially for development purposes, run multiple ASE's and backup servers from a single Sybase software installation. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you have made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: <put your hostname here>
sqlsrv.network_port_list: 4000
sqlsrv.application_type: MIXED
sqlsrv.server_page_size: 4096
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dev
sqlsrv.master_device_size: 100
sqlsrv.master_database_size: 60
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dev
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dev
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /var/sybase/ASE1/tempdb.dev
sqlsrv.tempdb_device_size: 100
sqlsrv.tempdb_database_size: 100
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: yes
sqlsrv.avail_physical_memory: 256
sqlsrv.avail_cpu_num: 1

This resource file will a create a Sybase server with the following characteristics:
* The name of the server will be ASE1, can be changed later with the sp_addserver stored procedure.
* The server will have a listener on the ip-address as indicated with <hostname> and port 4000. This can be changed later in the interfaces file located at $SYBASE/interfaces.
* Application type is mixed, so you expect both oltp and dss type of queries. This can be changed later by modification of the “optimization goal” setting with sp_configure).
* Server page size will be 4 Kb. The default is 2 Kb but with today’s hardware this will give sub-optimal performance. Once the server has been created it cannot be changed, a complete server rebuild is needed then.
* The master device will be 100 Mb, the size of the master database will be 60 Mb. The master devices will contain the master database, the master database contains important meta-data about the server. It’s very unusual to increase the size of the master device or the master database.
* The location of the errorlog is /opt/sybase/admin/ASE1/errorlog, can be changed later in the configuration file.
* A device of 172 Mb will be created for the sybsystemprocs database, also with a size of 172 Mb. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A device of 6 Mb will be created for the sybsystemdb database. The size of the database will actually be 12Mb as a small portion will also reside on the master device. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A temporary database 'tempdb' will be created on a device with a size of 100 Mb, the database will also be 100 Mb. In fact, it will be a bit larger since also a small portion will reside on the master device. Again, the device and the tempdb database can be increased in size. You can also create multiple temporary databases for improved concurrency.
* We will build a backup server called SYB_BACKUP. The name can be changed later with sp_addserver.
* We will not use a PCI (Pluggable Component Interface) database. This database is mainly used for Java in the server.
* Use the optimize configuration feature and tune for 256 Mb of memory and 1 cpu.

Now build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a successful creation you can connect to the server using the command line tool isql. The login “sa" has been created, with the password that was specified in ASE.rs file. At the prompt of isql you can type a command or execute a stored procedure. Type exit to exit.
isql -Usa -Psecret123 -SASE1
sp_helpdb
go
exit

==Basic ASE configuration==

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown ASE

isql -Usa -Psecret123 -SASE1
shutdown
go

cd $SYBASE/$SYBASE_ASE
mv ASE1.cfg /opt/sybase/admin/ASE1
rm ASE1.*
cd install

Modify RUN_ASE1 and make the following changes:
* Make the -s flag the first option. This has the advantage that a listing of running processes on the system will show the name of the Sybase server.
* Change the location of the configuration files, as specified with the -c flag, to the admin directory
Each line must end with a backslash.
Example RUN_ASE1 file:

#!/bin/sh
#
# ASE page size (KB): 4096
# Master device path: /var/sybase/ASE1/master.dev
# Error log path: /opt/sybase/admin/ASE1/errorlog
# Configuration file path: /opt/sybase/ase157/ASE-15_0/ASE1.cfg
# Directory for shared memory files: /opt/sybase/ase157/ASE-15_0
# Adaptive Server name: ASE1
#
/opt/sybase/ase157/ASE-15_0/bin/dataserver \
-sASE1 \
-d/var/sybase/ASE1/master.dev \
-e/opt/sybase/admin/ASE1/errorlog \
-c/opt/sybase/admin/ASE1/ASE1.cfg \
-M/opt/sybase/ase157/ASE-15_0 \

Now restart the Sybase server
./startserver -f ./RUN_ASE1

===Load instmsg.ebf file===
The instmsgs.ebf file contains the latest update for Sybase error messages. You can load it with isql.
isql -Usa -Psecret123 -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: <put your hostname here>
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

===Move and modify configuration files===
In this step we will move the configuration file to the admin directory. First shutdown the backup server:
isql -Usa -Psecret123 -SASE1
shutdown SYB_BACKUP
go
exit

Modify the file RUN_SYB_BACKUP, located at $SYBASE/$SYBASE_ASE/install. Move the line with the -s flag to the top. Sample RUN_SYB_BACKUP:
#!/bin/sh
#
# Error log path: /opt/sybase/ase157/ASE-15_0/install/SYB_BACKUP.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Multibuf executable path: /opt/sybase/ase157/ASE-15_0/bin/sybmultbuf
# Backup Server name: SYB_BACKUP
#
/opt/sybase/ase157/ASE-15_0/bin/backupserver \
-SSYB_BACKUP \
-e/opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log \
-N25 \
-C20 \
-M/opt/sybase/ase157/ASE-15_0/bin/sybmultbuf \

Restart the backupserver
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_SYB_BACKUP

==Create a user database==
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go
==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installation guide for Linux http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30119.1570/doc/html/title.html

Sybase System administration http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31654.1570/html/sag1/title.htm

[[Category:ASE]]

Linux configuration settings for Sybase ASE

2013-03-12T07:47:09Z

Psap:

To run Sybase ASE successfully on a Linux environment you need to configure a number of items. Below you will find a few of these, but please note that this is by far not an full overview. There could be more improvements to be made.

=Memory – Huge Pages=
The configuration of Huge Pages is needed to get an efficient translation from virtual memory pages to physical pages. When you configure for Huge Pages, the amount of memory assigned to Huge Pages is allocated and reserved for shared memory. Do not over configure to prevent swapping.

When ASE reports the below message in the errorlog, you need to configure for huge pages:

Could not allocate memory using Huge Pages. Allocated using regular pages. For better performance, reboot the server after configuring enough Huge Pages.

To get the values for huge pages first determine the maximum amount of memory you want to give to ASE. For instance, on a Linux server with 512Gb physical memory you can give 90% to ASE.
512 Gb x 90% = 460 Gb = 471040 Mb.

Then determine the size of a single huge page:

cat /proc/meminfo | grep Hugepagesize

Sample output:

Hugepagesize: 2048 kB

In this case 1 huge page is 2 Mb, so the number of huge pages we need will be 471040 Mb / 2 Mb = 235520

Then set the correct value in /etc/sysctl.conf:

vm.nr_hugepages = <value>

Next step is to calculate the number of huge pages in Kb and give the “sybase” user permission to grab the memory. Take the number of huge pages as calculated above. Then multiply by 2048. That wil give you the number of pages in Kb. Example: 235520 x 2048 = 482344960. Then have it stored in /etc/security/limits.conf like this

sybase soft memlock 482344960
sybase hard memlock 482344960

In this example, "sybase" is assumed to be the unix user running ASE.

Now reboot the Linux server to check if everything works as expected.

To see the configured number of huge pages at runtime:

cat /proc/sys/vm/nr_hugepages

Notes:
* As per Sybase recommendation (CR 627114) “lock shared memory” must be switched off.
* When ASE uses huge pages, it will allocate memory to the nearest multiple of 256Mb so don’t configure the ASE exactly to the maximum number of huge pages, but leave a small amount unused (e.g. 300 Mb). In case a small increase in size is needed due to the change of a Sybase config you will not get into trouble.

=DISK I/O=
==fs.aio-max-nr ==
fs.aio-max-nr is the maximum number of asynchronous I/Os.

The recommended minimum value for fs.aio-max-nr is 1048576, but on a busy ASE with many engines you may need to have a higher number configured.

In ASE, set these values as a starting point.

* Set “disk i/o structures” to 1048576.
* Set “max async i/os per engine” to 8192.
* Keep "max async i/os per server" at it’s default value (2147483647).

When you have multiple engines configured within ASE then use this formula to calculate the value for fs.aio-max-nr

(disk i/o structures + max async i/os per engine) * max online engines

For example: (1048576 + 8192) * 32 engines = 33816576

Then set the value in /etc/sysctl.conf:

fs.aio-max-nr = 33816576

To get the value at runtime

cat /proc/sys/fs/aio-max-nr

===Troubleshooting fs.aio-max-nr===
When the below messages appear in the ASE errorlog, the configuration of fs.aio-max-nr is not correct:

kernel asynchronous I/O not initialized. The io_setup() system call returned -22.
or
kernel kistartup: asynchronous I/O not available: No such file or directory

Either recalculate the vale or reduce the Sybase related configuration options (“disk i/o structures” and/or “max async i/os per engine”)

===Troubleshooting dstartio===
When this message appears in the errorlog

kernel dstartio: I/O request repeatedly delayed; block number: <nr>, vdn: <nr>
then you need to increase "disk i/o structures" or "max async i/os per engine".

To determine if "disk i/o structures" or "max async i/os per engine" needs to be increased look at the output of sp_sysmon that was captured during the time that the message appeared. Snapshot of output:

I/Os Delayed by
Disk I/O Structures n/a n/a 0 n/a
Server Config Limit n/a n/a 0 n/a
Engine Config Limit n/a n/a 24582 n/a
Operating System Limit n/a n/a 0 n/a

When a non-zero value is reported, increase the corresponding Sybase parameter.
Alternatively, you can run sp_monitorconfig “all” to see if the maximum number of “disk i/o structures” has reached (see column Max_Used).

Be aware that the Linux setting for fs.aio-max-nr may need to be increased as well after changing the Sybase configuration settings.

==Queue depth==
Per Linux volume used by ASE the queue depth must be configured. The default value is 128 but it must be set to 1024.

You can only set the required value at boottime and, depending on the Linux distribution, you need to do it in /etc/init.d/boot.local (Suse) or /etc/init.d/rc.local (Ubuntu) or /etc/rc.d/rc.local (RedHat)

For example:

echo 1024 >/sys/block/sdb/queue/nr_requests

To retrieve the runtime value:

cat /sys/block/sd*/queue/nr_requests

=kernel.randomize_va_space=
This may be Suse and ASE 15.0.3 specific, but it may apply to other Linux / ASE version combinations as well.

Due to a high I/O load you may see stacktraces referring to the cm_writedes module, see below snippet.

00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00007ffff73a56a0 (null)+0x7ffff73a56a0()
00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00000000018fd036 cm_writedes+0x606()

In the later versions of ASE 15.7 this should be fixed and an error message is printed.
To prevent the issue, set the value for kernel.randomize_va_space to 0 in combination with a higher value of “cpu grace time” in ASE, like 1500.
To see the runtime value
cat /proc/sys/kernel/randomize_va_space
To see the boottime value, check /etc/sysctl.conf there must be line like kernel.randomize_va_space = 0

See also http://www.novell.com/support/kb/doc.php?id=7004855

After changing kernel.randomize_va_space do a reboot of the Linux server, as that seems to be necessary.

=Soft / Hard limits for memory allocation (Suse only)=
By default, no more than 80 % of available memory (RAM and swap) can be claimed by a single process. This is the soft-virtual limit. To check the setting: cat /etc/sysconfig/ulimit and look for the value specified as SOFTVIRTUALLIMIT. Default is “80”.

Increase the setting as setting as needed, or set to “0” for unlimited.

Associated Sybase error message:

Attempt to attach shared memory (id 32768) at address (nil), with flags 0 failed

[[category:ASE]]

ASE Cache stalls

2013-03-12T07:46:18Z

Psap:

A cache stall in Sybase ASE may occur when a read from disk has to wait for a write to complete so that it can reuse the buffer. The page that needs to be written to disk has passed the wash marker in the cache and is scheduled to be written asynchronously to disk. The tasks in ASE dealing with that are the housekeeper and the checkpoint process.

When a stall occurs the process that requires the data to be read, just has to wait until the preceding writes are completed. Obviously, this is not good for performance.

Here is a simple query to see if your system is suffering from stalls:

select CacheName,
convert(char(3),IOBufferSize / 1024) + "Kb" as "IO Size",
Stalls
from master..monCachePool
where Stalls > 0
order by CacheName, IOBufferSize

Sample output

CacheName IO Size Stalls
------------------------------ ------- -----------
tempdb cache 8 Kb 92
tempdb cache 64 Kb 15

(2 rows affected)

==Potential solutions==
===Increase the wash size===
By increasing the wash size of a pool within a cache, the modified page will be triggered at an earlier stage to be written to disk. To see the definition of a cache run sp_cacheconfig followed by the name of the cache.

sp_cacheconfig "tempdb cache"
go

Sample output

Cache Name Status Type Config Value Run Value
------------ -------- ---------------- -------------- ------------
tempdb cache Active Mixed, HK Ignore 51200.00 Mb 51200.00 Mb
------------ ------------
Total 51200.0 Mb 51200.0 Mb
==========================================================================
Cache: tempdb cache, Status: Active, Type: Mixed, HK Ignore
Config Size: 51200.00 Mb, Run Size: 51200.00 Mb
Config Replacement: relaxed LRU, Run Replacement: relaxed LRU
Config Partition: 64, Run Partition: 64
IO Size Wash Size Config Size Run Size APF Percent
-------- ------------- ------------ ------------ -----------
8 Kb 3932160 Kb 0.00 Mb 25300.00 Mb 15
16 Kb 61440 Kb 300.00 Mb 300.00 Mb 15
64 Kb 3932160 Kb 25600.00 Mb 25600.00 Mb 15
(return status = 0)

The washsize can be increased by running sp_poolconfig as in this example:

sp_poolconfig "tempdb cache", "8K", "wash_size=5G"
go

The configuration change is immediate and no reboot is required. Do not make the wash area to big as it may be counterproductive.

===Tuning the housekeeper or checkpoint process===
Alternatively, you may need to tune the housekeeper or the checkpoint process. There is a good document for this here: http://www.sybase.com/files/White_Papers/Managing-DBMS-Workloads-v1.0-WP.pdf

But beware, a cache can be marked to be ignored by the housekeeper, as is the case in the example above. To configure such a state, add a line "cache status = HK ignore cache" to the ASE configuration file.

[[category:ASE]]

Linux configuration settings for Sybase ASE

2013-03-11T12:52:18Z

Psap: Created page with 'To run Sybase ASE successfully on a Linux environment you need to configure a number of items. Below you will find a few of these, but please note that this is by far not an full…'

To run Sybase ASE successfully on a Linux environment you need to configure a number of items. Below you will find a few of these, but please note that this is by far not an full overview. There could be more improvements to be made.

=Memory – Huge Pages=
The configuration of Huge Pages is needed to get an efficient translation from virtual memory pages to physical pages. When you configure for Huge Pages, the amount of memory assigned to Huge Pages is allocated and reserved for shared memory. Do not over configure to prevent swapping.

When ASE reports the below message in the errorlog, you need to configure for huge pages:

Could not allocate memory using Huge Pages. Allocated using regular pages. For better performance, reboot the server after configuring enough Huge Pages.

To get the values for huge pages first determine the maximum amount of memory you want to give to ASE. For instance, on a Linux server with 512Gb physical memory you can give 90% to ASE.
512 Gb x 90% = 460 Gb = 471040 Mb.

Then determine the size of a single huge page:

cat /proc/meminfo | grep Hugepagesize

Sample output:

Hugepagesize: 2048 kB

In this case 1 huge page is 2 Mb, so the number of huge pages we need will be 471040 Mb / 2 Mb = 235520

Then set the correct value in /etc/sysctl.conf:

vm.nr_hugepages = <value>

Next step is to calculate the number of huge pages in Kb and give the “sybase” user permission to grab the memory. Take the number of huge pages as calculated above. Then multiply by 2048. That wil give you the number of pages in Kb. Example: 235520 x 2048 = 482344960. Then have it stored in /etc/security/limits.conf like this

sybase soft memlock 482344960
sybase hard memlock 482344960

In this example, "sybase" is assumed to be the unix user running ASE.

Now reboot the Linux server to check if everything works as expected.

To see the configured number of huge pages at runtime:

cat /proc/sys/vm/nr_hugepages

Notes:
* As per Sybase recommendation (CR 627114) “lock shared memory” must be switched off.
* When ASE uses huge pages, it will allocate memory to the nearest multiple of 256Mb so don’t configure the ASE exactly to the maximum number of huge pages, but leave a small amount unused (e.g. 300 Mb). In case a small increase in size is needed due to the change of a Sybase config you will not get into trouble.

=DISK I/O=
==fs.aio-max-nr ==
fs.aio-max-nr is the maximum number of asynchronous I/Os.

The recommended minimum value for fs.aio-max-nr is 1048576, but on a busy ASE with many engines you may need to have a higher number configured.

In ASE, set these values as a starting point.

* Set “disk i/o structures” to 1048576.
* Set “max async i/os per engine” to 8192.
* Keep "max async i/os per server" at it’s default value (2147483647).

When you have multiple engines configured within ASE then use this formula to calculate the value for fs.aio-max-nr

(disk i/o structures + max async i/os per engine) * max online engines

For example: (1048576 + 8192) * 32 engines = 33816576

Then set the value in /etc/sysctl.conf:

fs.aio-max-nr = 33816576

To get the value at runtime

cat /proc/sys/fs/aio-max-nr

===Troubleshooting fs.aio-max-nr===
When the below messages appear in the ASE errorlog, the configuration of fs.aio-max-nr is not correct:

kernel asynchronous I/O not initialized. The io_setup() system call returned -22.
or
kernel kistartup: asynchronous I/O not available: No such file or directory

Either recalculate the vale or reduce the Sybase related configuration options (“disk i/o structures” and/or “max async i/os per engine”)

===Troubleshooting dstartio===
When this message appears in the errorlog

kernel dstartio: I/O request repeatedly delayed; block number: <nr>, vdn: <nr>
then you need to increase "disk i/o structures" or "max async i/os per engine".

To determine if "disk i/o structures" or "max async i/os per engine" needs to be increased look at the output of sp_sysmon that was captured during the time that the message appeared. Snapshot of output:

I/Os Delayed by
Disk I/O Structures n/a n/a 0 n/a
Server Config Limit n/a n/a 0 n/a
Engine Config Limit n/a n/a 24582 n/a
Operating System Limit n/a n/a 0 n/a

When a non-zero value is reported, increase the corresponding Sybase parameter.
Alternatively, you can run sp_monitorconfig “all” to see if the maximum number of “disk i/o structures” has reached (see column Max_Used).

Be aware that the Linux setting for fs.aio-max-nr may need to be increased as well after changing the Sybase configuration settings.

==Queue depth==
Per Linux volume used by ASE the queue depth must be configured. The default value is 128 but it must be set to 1024.

You can only set the required value at boottime and, depending on the Linux distribution, you need to do it in /etc/init.d/boot.local (Suse) or /etc/init.d/rc.local (Ubuntu) or /etc/rc.d/rc.local (RedHat)

For example:

echo 1024 >/sys/block/sdb/queue/nr_requests

To retrieve the runtime value:

cat /sys/block/sd*/queue/nr_requests

=kernel.randomize_va_space=
This may be Suse and ASE 15.0.3 specific, but it may apply to other Linux / ASE version combinations as well.

Due to a high I/O load you may see stacktraces referring to the cm_writedes module, see below snippet.

00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00007ffff73a56a0 (null)+0x7ffff73a56a0()
00:00000:00006:2012/11/11 01:18:41.45 kernel pc: 0x00000000018fd036 cm_writedes+0x606()

In the later versions of ASE 15.7 this should be fixed and an error message is printed.
To prevent the issue, set the value for kernel.randomize_va_space to 0 in combination with a higher value of “cpu grace time” in ASE, like 1500.
To see the runtime value
cat /proc/sys/kernel/randomize_va_space
To see the boottime value, check /etc/sysctl.conf there must be line like kernel.randomize_va_space = 0

See also http://www.novell.com/support/kb/doc.php?id=7004855

After changing kernel.randomize_va_space do a reboot of the Linux server, as that seems to be necessary.

=Soft / Hard limits for memory allocation (Suse only)=
By default, no more than 80 % of available memory (RAM and swap) can be claimed by a single process. This is the soft-virtual limit. To check the setting: cat /etc/sysconfig/ulimit and look for the value specified as SOFTVIRTUALLIMIT. Default is “80”.

Increase the setting as setting as needed, or set to “0” for unlimited.

Associated Sybase error message:

Attempt to attach shared memory (id 32768) at address (nil), with flags 0 failed

Warm Standby setup instructions

2013-02-27T12:29:05Z

Psap:

Sybase Replication Server allows you to create and maintain a warm standby environment. The creation can be done with, for instance, the rs_init utility or Sybase Central. In some cases extra flexibility is needed and this can best be achieved when command line statements are used.
For various other reasons people prefer using this method.

This page describes the steps to be taken to create a warm standby environment through a combination of commands given to ASE and Replication Server. It should be considered as a kind of worksheet. Feel free to make changes to suit your individual need. This might be needed when you are dealing with a database with big table(s) holding text or image datatypes or you want to optimize performance using replication definitions and subscriptions.

==Assumptions of the environment==
* The setup makes the following assumptions:
* The Replication Server is already configured and running.
* Replication is done between ASE servers
* Materialization will be done with a dump-load scenario
* Replication is performed without replication definitions and subscriptions
* User activity will continue throughout the creation process
The setup is divided into a number of steps, where each step is a separate unit of work.

==Preparation of the Sybase ASE-servers==
'''Create a maintenance user on both ASE's'''

The maintenance user is used by the replication server to apply transactions. Make sure that the name and password of the maintenance user on both servers are identical. For practical reasons make the maintenance user aliased to "dbo" in the database. Since a dump-load scenario is used to materialize the standby database, make sure that the suid of the maintenance user on both servers are identical.

sp_addlogin "<maintenance_user>","<maintenance_user_password>"
go
grant role replication_role to "<maintenance_user>"
go
-- check the value of the suid
select suser_id("<maintenance_user>")
go
use <database>
go
sp_addalias "<maintenance_user>","dbo"
go

'''Install the replication server stored procedures and tables'''

To do this, make a copy of the script rs_install_primary.sql located in the $SYBASE/$SYBASE_REP/scripts directory. Comment out 2 commands of the script: the dbcc settrunc and the sp_setreplicate commands. These can be found at the end of the file, or just above the definition of the rs_send_repserver_cmd stored procedure.

The commands that are skipped will be executed at a later stage, when the replication agent is configured. Apply the script on the active server in the right database.

isql -Usa -P<password> -S<active_server> -D<database> -i changed_rs_install_primary.sql

'''Configure both servers for replication'''

sp_configure "enable rep agent threads",1

==Preparation of the Replication Server==
'''Create a logical connection on the replication server'''

The name of it does not have to match with the name of the primary database server and database, but this convention is widely used.

create logical connection to <active_server>.<database>

'''Create a connection from the replication server to the active database'''

create connection to <active_server>.<database>
set error class to rs_sqlserver_error_class
set function string class to rs_sqlserver_function_class
set username to <maintenance_user>
set password to <maintenance_user_password>
with log transfer on
as active for <active_server>.<database>

'''Create a login in the replication server'''

This login is used by the rep-agent running in the ASE to connect to the replication server.

create user <rep-agent_user> set password <rep-agent_password>
go
grant connect source to <rep-agent_user>
go

==Configure the RepAgent==
The configuration of the Replication Agent within the active ASE should now be done. All steps within this paragraph should be executed within a controlled time frame since the transaction log cannot be cleared between the execution of the first sp_config_rep_agent and the sp_start_rep_agent.
The configuration is only needed on the primary server. Since we use a dump-load scenario the configuration is copied to the standby server during the materialization phase.

use <database>
go
sp_config_rep_agent "<database>", "enable", "<repserver>", "<rep-agent_user>", "<rep-agent_password>"
go
sp_config_rep_agent "<database>", "send warm standby xacts", true
go
sp_setreplicate rs_marker,"true"
go
sp_setreplicate rs_update_lastcommit,"true"
go
sp_start_rep_agent "<database>"
go

==Mark the database for replication and grant permissions==
Execute the sp_reptostandby stored procedure in the active ASE to activate replication from the active database to the replication server.

We also need to grant permissions to a few stored procedures.

use <database>
go
grant execute on rs_update_lastcommit to public
grant execute on rs_marker to public
grant execute on rs_check_repl_stat to public
go
sp_reptostandby "<database>","all"
go

==Configure the replication server for the standby database==
All steps within this paragraph should be executed within a controlled time frame since the stable queue in the replication server cannot be cleared between the execution of the create connection and resume connection.

'''Create a connection from the replication server to the standby server'''

create connection to <standby-server>.<database>
set error class to rs_sqlserver_error_class
set function string class to rs_sqlserver_function_class
set username to <maintenance_user>
set password to <maintenance_user_password>
with log transfer on
as standby for <active_server>.<database>
use dump marker

'''Dump the database on the active server so it can be loaded into the standby server'''

dump database <database> to "<file-name>"

'''Load the database dump into the standby server'''

load database <database> from "<file-name>"
go
online database <database>
go

'''Start the connection from the replication server to the standby database'''

resume connection to <standby-server>.<database>

Congratulations, you now have a working Warm Standby configuration!

[[Category:RepServer]]

ASE Cache stalls

2013-02-10T16:50:04Z

Psap: Created page with 'A cache stall in Sybase ASE may occur when a read from disk has to wait for a write to complete so that it can reuse the buffer. The page that needs to be written to disk has pas…'

Special Features for ASE

2012-11-08T08:09:41Z

Psap:

Sybase ASE has quite some special features that are not very well known. This page lists some of them (in alphabetical order) and provides a hyperlink to the white papers provided by Sybase.
Some of the features have been significantly enhanced or extended after publication of the white paper. Please visit http://www.sybase.com for the latest documentation.

Depending on your ASE license, some of the features can only be used after you bought the appropiate licence key. Contact Sybase sales or support for more information.

* Archived databases http://www.sybase.com/files/Product_Overviews/Sybase-ISUG-101707.pdf
* Cluster edition: http://www.sybase.com/files/White_Papers/Sybase_ASE_Cluster_TechWP.pdf
* Content management (a.k.a. external file access) http://www.sybase.com/content/1019936/ASEContMgmtPkg.pdf
* Cross platform dump and load http://www.sybase.com/content/1033627/18XPDL_1253_WP.pdf
* Distributed transactions http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.dtm/dtm.pdf
* Encrypted columns http://www.sybase.com/files/White_Papers/Sybase_ASE_Encrypt_3PSS_wp.pdf
* Fine grained access control: http://www.sybase.com/content/1013009/new_security_wp.pdf
* Full Text Search http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.verity/verity.pdf
* High Availability http://www.sybase.com/content/1019940/ASEHA.pdf
* In memory databases http://www.sybase.com/files/White_Papers/ASE-IMBD-WP.pdf
* Java in the database (15.0.3) http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31652.1503/pdf/java.pdf
* Java in the database (pre 15.0.3) http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31652.1502/pdf/java.pdf
* Job Scheduler http://www.sybase.com/content/1026304/job_scheduler_wp.pdf
* Kerberos/PAM http://www.sybase.com/content/1030018/ASE_1252_Security_wp.pdf
* LDAP / Active Directory http://www.sybase.com/content/1026313/SYSD1039LDAP_WP.pdf
* Light weight replicator http://infocenter.sybase.com/help/topic/com.sybase.help.ase_15.0.rl15ug/rl15ug.pdf (will go end-of-support at 9/30/2010)
* Partitions: http://www.sybase.com/files/White_Papers/ASE-Partitions-040307-wp.pdf
* SSL http://www.sybase.com/content/1013009/new_security_wp.pdf
* WebServices http://www.sybase.com/content/1017876/ASEWebServices.pdf
* XML http://www.sybase.com/content/20519/xml_wp-v2.pdf

[[Category:ASE]]

Bypasssing cross platform load issues

2012-11-03T10:18:09Z

Psap: /* Stacktrace in modules make_log_consistent and rec_build_recovery_info */

When loading an ASE database dump made on another platform you may run into problems. For instance, this can happen when the dump is made on an Intel x86 platform but you want to load it into an ASE running on Solaris Sparc. As documented by Sybase, you need to prepare a dump for this situation before attempting to load it.

See: http://www.sybase.com/detail?id=1033627 or go straight to this whitepaper http://www.sybase.com/content/1033627/18XPDL_1253_WP.pdf

When you do not follow the required steps before making the database dump you may get this error:

Started cross-platform conversion for log records.
Msg 3151, Level 16, State 2:
Server 'TEST', Line 1:
Adaptive Server cannot load this database because the database that was dumped
was not quiescent when the dump was performed. Run sp_flushstats before DUMP
DATABASE and ensure that the database is not updated during the dump.

Under some circumstances you may not want to follow the required steps and force ASE to bring the database online anyway. Below are the steps how you can do that. The name of database in the example is 'testdb'. You may run into some problems, see section below for solutions.

'''IMPORTANT''' This method may result in some loss of data or a an unusable database on the ASE where you load the database dump into. It's recommended to use it only for testing and query purposes.

==Bypassing Msg 3151==
After loading the database and Msg 3151 is reported follow these steps:

use master
go
sp_configure "allow updates",1
go
update sysdatabases set status = -32768,status3=131072 where name = "testdb"
go

Shutdown the server and start it up again.

A message in the errorlog indicates that recovery is not done for the database:

00:00000:00001:2011/04/05 16:07:54.38 server
*** Bypassing recovery of database id 4

Log on to ASE and rebuild the transaction log for the database
dbcc traceon(3604)
go
dbcc save_rebuild_log(testdb)
go
update sysdatabases set status = 0 where name = "testdb"
go

Shutdown the server and start it up again.

The database will now be brought online, watch the errorlog for any problems.
Now the database should be recovered succesfully.

Log on to the server and:
update sysdatabases set status3=524288 where name = "testdb"
go
use testdb
go
sp_post_xpload
go
update sysdatabases set status3=0 where name = "testdb"
go

All done now, you should be able to use the database for querying data.

==Problems and potential solutions==

===Transactionlog full during recovery===

00:00000:00013:2011/04/05 16:18:00.14 server Error: 1105, Severity: 17, State: 4
00:00000:00013:2011/04/05 16:18:00.14 server Can't allocate space for object 'syslogs' in database 'testdb' because 'logsegment' segment is full/has no free extents. If you ran out of space in syslogs, dump the transaction log. Otherwise, use ALTER DATABASE to increase the size of the segment.
00:00000:00013:2011/04/05 16:18:00.14 server This database requires upgrade, but its log is nearly full. Extend the log, or try 'DUMP TRAN testdb WITH NO_LOG', then retry ONLINE DATABASE.

Change the segment status for the database.

use master
go
update sysusages set segmap = 7 where dbid = db_id("testdb")
go

Now reload the database with the "load database" command and reboot ASE. Then:

use master
go
update sysdatabases
set status3 = status3 - 67108864,
status = -32768
where name = "testdb"
go

===Stacktrace in modules make_log_consistent and rec_build_recovery_info===
when an error in the errorlog appears like this:

00:00000:00001:2011/03/25 16:56:17.04 kernel Current process (0x30003) infected with signal 11 (SIGSEGV)
00:00000:00001:2011/03/25 16:56:17.04 kernel Address 0x00000000803b80fc (xls_open+0xdc), siginfo (code, address) = (1, 0x00000000000000ac)
00:00000:00001:2011/03/25 16:56:17.04 kernel Saved signal context address 0x0000010001b08280
00:00000:00001:2011/03/25 16:56:17.04 kernel pc=0x00000000803b80fc npc=0x00000000803b8100
00:00000:00001:2011/03/25 16:56:17.04 kernel g0-g2 0x0000000000000000 0x0000000000000008 0x00000000825fd000
00:00000:00001:2011/03/25 16:56:17.04 kernel g3-g5 0x0000000000000038 0x0000000081b3f9d0 0x00000000000001c0
00:00000:00001:2011/03/25 16:56:17.04 kernel g6-g7 0x0000000000000000 0xffffffff7eb00200
00:00000:00001:2011/03/25 16:56:17.04 kernel o0-o2 0x0000000000000000 0x000001001c99e6c0 0x000001001c83ab50
00:00000:00001:2011/03/25 16:56:17.04 kernel o3-o5 0x000001001d5dfc48 0x0000000000000000 0x0000000000000008
00:00000:00001:2011/03/25 16:56:17.04 kernel o6-o7 0x0000010001b07e61 0x00000000803b80f4
00:00000:00001:2011/03/25 16:56:17.04 kernel l0-l2 0x0000000080ddb5a0 0x00000000825c2c00 0x000001001e26a458
00:00000:00001:2011/03/25 16:56:17.04 kernel l3-l5 0x0000000000000000 0x0000000004000000 0x00000000825fd000
00:00000:00001:2011/03/25 16:56:17.04 kernel l6-l7 0x00000000822cc000 0x0000000004000000
00:00000:00001:2011/03/25 16:56:17.04 kernel i0-i2 0x0000000000000001 0x0000000000000000 0x0000000000000001
00:00000:00001:2011/03/25 16:56:17.04 kernel i3-i5 0x000001001e26a158 0x0000000000000104 0x0000000000000006
00:00000:00001:2011/03/25 16:56:17.04 kernel i6-i7 0x0000010001b07f11 0x0000000080ddb5f0
00:00000:00001:2011/03/25 16:56:17.04 kernel ************************************
00:00000:00001:2011/03/25 16:56:17.04 kernel SQL causing error : use master
00:00000:00001:2011/03/25 16:56:17.04 kernel ************************************
00:00000:00001:2011/03/25 16:56:17.04 server SQL Text: use master
00:00000:00001:2011/03/25 16:56:17.04 kernel curdb = 5 tempdb = 2 pstat = 0x1000
00:00000:00001:2011/03/25 16:56:17.04 kernel lasterror = 0 preverror = 0 transtate = 1
00:00000:00001:2011/03/25 16:56:17.04 kernel curcmd = 0 program =
00:00000:00001:2011/03/25 16:56:17.04 kernel extended error information: hostname: login:
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080f412e4 pcstkwalk+0x24(0x0000010001b06fa0, 0x0000010001b04e18, 0x000000000000270f, 0x0000000000000002, 0x0000000000000000)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080f4112c ucstkgentrace+0x1d0(0x000001001d5dfc48, 0x0000000000000002, 0x000000000000270f, 0x0000000000000000, 0x0000000000000000)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080eccb5c ucbacktrace+0xb4(0x0000000000000000, 0x0000000000000001, 0x0000000000007c00, 0x000001001d5dfc48, 0x000001001df6d540)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080594f74 terminate_process+0x131c(0x0000000000007400, 0xffffffffffffffff, 0x000001001d5dfc48, 0x0000000000008000, 0x0000000081b2e588)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080f05c2c kisignal+0x27c(0x0000000000000058, 0x0000010001b08560, 0x0000010001b08280, 0x0000000000030003, 0x0000000000000000)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x00000000803b80fc xls_open+0xdc(0x0000000000000001, 0x0000000000000000, 0x0000000000000001, 0x000001001e26a158, 0x0000000000000104)
00:00000:00001:2011/03/25 16:56:17.04 kernel [Handler pc: 0x0000000080de8c00 rec_handle installed by the following function:-]
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080ddb5f0 '''make_log_consistent'''+0xd8(0x0000000000000005, 0x00000000825c1c00, 0x0000000000000005, 0x000001001e26a158, 0x0000000000000005)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080ddc4e4 '''rec_build_recovery_info'''+0xc7c(0x00000000000000f0, 0x0000000000000000, 0x0000000000008000, 0x0000000000008000, 0x000000000000c000)
00:00000:00001:2011/03/25 16:56:17.04 kernel [Handler pc: 0x0000000080deccd0 rec__caller_hdlr installed by the following function:-]
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080de0d98 dorecover+0x118(0x000001001d5dfc48, 0x0000000000001000, 0x0000000000008090, 0x0000000081b2e400, 0x0000000000000000)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x00000000805988d4 ds__recoverdbs+0x660(0x000001001d5dfc48, 0x00000000000094d8, 0x000001001c97efc0, 0x0000000000000001, 0x0000000081d58514)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080591438 dsinit+0xa80(0x000001000002ec98, 0x0000000081b2e400, 0x0000000000000001, 0x0000000000000032, 0x0000000081d58514)
00:00000:00001:2011/03/25 16:56:17.04 kernel pc: 0x0000000080f57c0c _coldstart(0x0000000000000000, 0x00000000805909b8, 0x0000000000000000, 0x0000000000000000, 0x0000000000000000)
00:00000:00001:2011/03/25 16:56:17.04 kernel end of stack trace, spid 1, kpid 196611, suid 0

Then run these commands:

use master
go
update sysdatabases set status3 = 131072
where name = "testdb"
go

Reboot ASE, then

dbcc rebuild_log(testdb,1,1)
go
update sysdatabases set status = 0 where name = "testdb"
go

Reboot ASE once more.

===Transactionlog full===
When the database is accessible but the transactionlog becomes full, check the states:
use testdb
go
sp_helpsgement logsegment
go

When a negative value of free space is reported you may need to rebuild the transaction log.
dbcc save_rebuild_log(testdb)
go
use master
go
sp_dboption testdb,"single",true
go
use testdb
go
dbcc tablealloc(syslogs,full,fix)
go

[[category:ASE]]

Warm Standby setup instructions

2012-10-30T11:23:29Z

Psap:

Sybase Replication Server allows you to create and maintain a warm standby environment. The creation can be done with, for instance, the rs_init utility or Sybase Central. In some cases extra flexibility is needed and this can best be achieved when command line statements are used.
For various other reasons people prefer using this method.

This page describes the steps to be taken to create a warm standby environment through a combination of commands given to ASE and Replication Server. It should be considered as a kind of worksheet. Feel free to make changes to suit your individual need. This might be needed when you are dealing with a database with big table(s) holding text or image datatypes or you want to optimize performance using replication definitions and subscriptions.

==Assumptions of the environment==
* The setup makes the following assumptions:
* The Replication Server is already configured and running.
* Replication is done between ASE servers
* Materialization will be done with a dump-load scenario
* Replication is performed without replication definitions and subscriptions
* User activity will continue throughout the creation process
The setup is divided into a number of steps, where each step is a separate unit of work.

==Preparation of the Sybase ASE-servers==
'''Create a maintenance user on both ASE's'''

The maintenance user is used by the replication server to apply transactions. Make sure that the name and password of the maintenance user on both servers are identical. For practical reasons make the maintenance user aliased to "dbo" in the database. Since a dump-load scenario is used to materialize the standby database, make sure that the suid of the maintenance user on both servers are identical.

sp_addlogin "<maintenance_user>","<maintenance_user_password>"
go
grant role replication_role to "<maintenance_user>"
go
-- check the value of the suid
select suser_id("<maintenance_user>")
go
use <database>
go
sp_addalias "<maintenance_user>","dbo"
go

'''Install the replication server stored procedures and tables'''

To do this, make a copy of the script rs_install_primary.sql located in the $SYBASE/$SYBASE_REP/scripts directory. Comment out 2 commands of the script: the dbcc settrunc and the sp_setreplicate commands. These can be found at the end of the file, or just above the definition of the rs_send_repserver_cmd stored procedure.

The commands that are skipped will be executed at a later stage, when the replication agent is configured. Apply the script on the active server in the right database.

isql -Usa -P<password> -S<active_server> -D<database> -i changed_rs_install_primary.sql

'''Configure both servers for replication'''

sp_configure "enable rep agent threads",1

==Preparation of the Replication Server==
'''Create a logical connection on the replication server'''

The name of it does not have to match with the name of the primary database server and database, but this convention is widely used.

create logical connection to <active_server>.<database>

'''Create a connection from the replication server to the active database'''

create connection to <active_server>.<database>
set error class to rs_sqlserver_error_class
set function string class to rs_sqlserver_function_class
set username to <maintenance_user>
set password to <maintenance_user_password>
with log transfer on
as active for <active_server>.<database>

'''Create a login in the replication server'''

This login is used by the rep-agent running in the ASE to connect to the replication server.

create user <rep-agent_user> set password <rep-agent_password>
go
grant connect source to <rep-agent_user>
go

==Configure the RepAgent==
The configuration of the Replication Agent within the active ASE should now be done. All steps within this paragraph should be executed within a controlled time frame since the transaction log cannot be cleared between the execution of the first sp_config_rep_agent and the sp_start_rep_agent.
The configuration is only needed on the primary server. Since we use a dump-load scenario the configuration is copied to the standby server during the materialization phase.

use <database>
go
sp_config_rep_agent "<database>", "enable", "<repserver>", "<rep-agent_user>", "<rep-agent_password>"
go
sp_config_rep_agent "<database>", "send warm standby xacts", true
go
sp_setreplicate rs_marker,"true"
go
sp_setreplicate rs_update_lastcommit,"true"
go
sp_start_rep_agent "<database>"
go

==Mark the database for replication==
Execute the sp_reptostandby stored procedure in the active ASE to activate replication from the active database to the replication server.

use <database>
go
sp_reptostandby "<database>","all"
go

==Configure the replication server for the standby database==
All steps within this paragraph should be executed within a controlled time frame since the stable queue in the replication server cannot be cleared between the execution of the create connection and resume connection.

'''Create a connection from the replication server to the standby server'''

create connection to <standby-server>.<database>
set error class to rs_sqlserver_error_class
set function string class to rs_sqlserver_function_class
set username to <maintenance_user>
set password to <maintenance_user_password>
with log transfer on
as standby for <active_server>.<database>
use dump marker

'''Dump the database on the active server so it can be loaded into the standby server'''

dump database <database> to "<file-name>"

'''Load the database dump into the standby server'''

load database <database> from "<file-name>"
go
online database <database>
go

'''Start the connection from the replication server to the standby database'''

resume connection to <standby-server>.<database>

Congratulations, you now have a working Warm Standby configuration!

[[Category:RepServer]]

Dbcc traceflags

2012-10-26T08:49:16Z

Psap:

With dbcc traceflags you can do many different things, like change the behaviour of the server, see why a certain query plan is choosen or fine-tune the optimizer.
This page shows you how to use them and provides a list of known traceflags.

==Using traceflags==
You can set a traceflag in two ways
===At boottime===
Usually a server is booted through the runserver file. In this file (default location is $SYBASE/$SYBASE_ASE/install) you can add a traceflag by specifying a -T flag and one or more comma separated values.
===At run time===
When you are logged in to ASE you can set a traceflag with the dbcc traceon command. Example:

dbcc traceon(3604)

You can specify multiple values, comma separated.
To turn a traceflag off, use traceoff

dbcc traceoff(3604)

===Which traceflags are active===
To see which traceflags are active for your own session use the dbcc traceflags command

dbcc traceflags

To see the traceflags of other sessions as well

dbcc traceflags(2)

==List of known traceflags==
Below you will find a list of currently known traceflags. But beware of the following:

'''WARNING'''

* Most traceflags are undocumented and not supported by Sybase, use at your own risk. Certain traceflags can severely harm your databases.
* Some traceflags are obsolete and are replaced by configuration parameters.
* Certain traceflags should be used when you start the server, others are meant for a specific session, when known this is indicated in the list.
* Experiment first on a test server, use only on production systems when either the traceflag is documented by Sybase or when you have consulted Sybase Technical Support.

{| border="1"
|+ '''List of dbcc traceflags'''
! !! Explanation !! Since version !! Untill Version !! Boot time !! Run time
|-
| 100
| Display a parse tree for each command || || || ||
|-
| 108
| Allow dynamic and host variables in create view statements || 12.5 || || ||
|-
| 116
| Print the text of the abstract query plan. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00729_1500/html/errMessageAdvRes/BACDDIDE.htm see documentation] || || || ||
|-
| 200
| Display messages about the before image of the query-tree || || || ||
|-
| 201
| Display messages about the after image of the query tree || || || ||
|-
| 208
| Show types of locks taken || || || ||
|-
| 217
| Display a warning message for using the T-SQL extension of queries with grouped aggregates and columns in the select list which are not in the GROUP BY clause. || 15.0.2 ESD 2 || || ||
|-
| 241
| Compress all query-trees when ASE is started || || || ||
|-
| 243
| Do not expand select * to column names when creating a compiled object|| || || ||
|-
| 244
| When set, the maximum length of the returned value of str_replace() is 16384, otherwise it is 255. When Msg 511 is incorrectly raised with this flag on, upgrade to 15.0.2 ESD 6.|| || || ||
|-
| 260
| Reduce TDS (Tabular Data Stream) overhead in stored procedures. Turn off done-in-behaviour packets. See also [[Send doneinproc tokens]].|| || || ||
|-
| 291
| Changes the hierarchy and casting of datatypes to pre-11.5.1 behaviour. There was an issue is some very rare cases where a wrong result could occur, but that's been cleared up in 11.9.2 and above.|| || 11.9.2 || ||
|-
| 292
| Never send doneinproc tokens. See also [[Send doneinproc tokens]].|| || || ||
|-
| 298
| Display an error message when a query uses a correlated variable as an inner or outer member of an outer join.|| || || ||
|-
| 299
| Do not recompile a stored procedure that inherits a temp table from a parent procedure.|| || || ||
|-
| 302
| Print trace information on index selection, supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/X24199.htm see documentation]|| ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 303
| Display optimizer OR strategy || || 12.5 || ||Y
|-
| 304
| Revert special "or" optimizer strategy to the strategy used in pre-System 11 (this traceflag resolved several bug issues in System 11, most of these bugs are fixed in ASE 11.0.3.2)|| || || ||
|-
| 310
| Show the plan as choosen by the optimizer, as well as I/O costs. Supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/X24199.htm see documentation] || ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 311
| Display optimizers expected I/O cost|| ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 317
| Show all considered plans. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/X37588.htm see documentation] || ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 319
| Display optimizer reformatting strategy|| ||12.5 unless using compatibility mode in ASE 15.|| ||Y
|-
| 320
| Turn off join order heuristics|| ||12.5|| ||
|-
| 321
| Display optimizers reformatting strategy briefly|| ||12.5 unless using compatibility mode in ASE 15.|| ||
|-
| 324
| Turn off the like optimization for ad-hoc queries using local variables|| ||12.5|| ||
|-
| 326
| Instructs the server to use arithmetic averaging when calculating density instead of a geometric weighted average when updating statistics. Useful for building better stats when an index has skew on the leading column. Use only for updating the stats of a table/index with known skewed data.|| ||11.5|| ||
|-
| 329
| Turns on a strategy for fast first row return for queries using cursors with an ORDERBY.||15.0 ESD 2|| ||Y||N
|-
| 333
| Disables min-max optimization|| ||12.5|| ||
|-
| 334
| Enable merge joins|| ||12.5 unless using compatibility mode in ASE 15.|| ||
|-
| 353
| Turn off transitive closure|| || || ||
|-
| 364
| Use range density instead of total density|| || || ||
|-
| 370
| Use min-max index as an alternative to the table scan for single table queries. Does not perform aggregation optimization for joins.|| || || ||
|-
| 384
| Enable JTC||12.0||12.5 unless using compatibility mode in ASE 15.|| ||
|-
| 396
| Use min-max optimization for single table queries.|| || || ||
|-
| 441
| queries where literal autoparametrization applies will be processed in full compatibility mode when enabled. Supported by Sybase, [http://www.sybase.com/files/White_Papers/Sybase-ASE-Compatibility-Mode-072309-WP.pdf see documentation]||15.0.3 ESD 1|| || ||
|-
| 446
| Disable restricted compatibility mode. Supported by Sybase, [http://www.sybase.com/files/White_Papers/Sybase-ASE-Compatibility-Mode-072309-WP.pdf see documentation]||15.0.3 ESD 1|| || ||
|-
| 450
| Sort a group by operation in the order of the groups||15|| || ||
|-
| 457
| Try to use worktables for a select in a cursor in order to isolate the selected data from the base table (12.5 behaviour)||15.0.2 ESD 6|| || ||
|-
| 467
| Do not cache a statement in the statement cache when a temp tables is referenced.||15.0.2 ESD 5|| || ||
|-
| 477
| When using compatibility mode, print a message about the type being used. Supported by Sybase, [http://www.sybase.com/files/White_Papers/Sybase-ASE-Compatibility-Mode-072309-WP.pdf see documentation]||15.0.3 ESD 1|| || ||
|-
| 516
| Print mapping between xchg operators and worker processes when using parallel execution. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00743_1500/html/qp_abstrpln/qp_abstrpln106.htm see documentation] ||15|| || ||
|-
| 526
| Print semi-graphical execution operator tree when showplan is enabled. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc34982_1500/html/mig_gde/mig_gde161.htm see documentation] || || || ||
|-
| 589
| Close a cursor implicitly during a cursor fetch and after an error was hit.||15.0.2 ESD 2|| || ||
|-
| 602
| Prints out diagnostic information for deadlock prevention.|| || || ||
|-
| 603
| Prints out diagnostic information when avoiding deadlock.|| || || ||
|-
| 615
| When a read of a page does not indicate it's right identity a second read is done. When the identity is now correct the related device is suspect and ASE turns on additional diagnostic checks. The check can be turned off with the traceflag.||12.5.3 ESD 5 and 15.0 ESD 2|| ||Y||Y
|-
| 625
| When hitting Msg 12328, do not regenerate the row-offset table||12.5.4 ESD 10|| || ||
|-
| 646
| Turn off the new space allocation method as introduced in 12.5.3 for partitioned DOL tables||12.5.3|| || ||
|-
| 699
| Turn off transaction logging || || || ||
|-
| 712
| Disable procedure cache optimisation|| || || ||
|-
| 722
| ASE (debug version) will perform additional checks on the heap memory to detect possible memory corruption.||15.0 ESD 2|| ||Y||N
|-
| 833
| Do not report Msg 880 "Your query is blocked because it tried to write and database '<dbname>' is in quiesce state. Your query will proceed after the DBA performs QUIESCE DATABASE RELEASE.".||15.0 ESD 2||Y||N||
|-
| 990
| Allow only access to the server with the "sa" account. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc35892_1500/html/instalibm/instalibm108.htm see documentation] || || || ||
|-
| 1116
| Suppress Msg 1131. (The OAM page does not belong to object with index.....)|| || || ||
|-
| 1202
| Also show the blocked lock requests in master..syslocks|| || || ||
|-
| 1204
| Print deadlock information into errorlog|| || || ||
|-
| 1205
| Prints deadlock information by printing stacktraces.|| || || ||
|-
| 1206
| Disable lock promotion.|| || || ||
|-
| 1212
| Shows info about locks granted and released|| || || ||
|-
| 1213
| Used with dbcc object_stats|| || || ||
|-
| 1217
| Show info about locks being acquired|| || || ||
|-
| 1603
| Turns off async i/o and forces standard unix io. Can be useful if symptoms include transient corruption errors that may be caused by bad drives or controllers.|| || || ||
|-
| 1605
| Start secondary engines by hand|| || || ||
|-
| 1606
| Create a debug engine start file. This allows you to start up a debug engine which can access the server's shared memory for running diagnostics.|| || || ||
|-
| 1608
| Instructs server engine 0 to not on-line any other dataserver engines|| || || ||
|-
| 1610
| Boot the server with TCP_NODELAY enabled.|| || ||Y||
|-
| 1611
| If possible, pin shared memory -- check errorlog for success/failure.|| || || ||
|-
| 1613
| Set affinity of the ASE engine's onto particular CPUs usually pins engine 0 to processor 0, engine 1 to processor 1, etc|| || || ||
|-
| 1615
| SGI only: turn on recoverability to filesystem devices.|| || || ||
|-
| 1625
| Linux only: Revert to using cached filesystem I/O. By default, ASE on Linux opens filesystem devices using O_SYNC, unlike other Unix based releases, which means it is safe to use filesystems devices for production systems.||11.9.2|| || ||
|-
| 1630
| SuSE 32 bit Linux (SuSE 9 SP1 or later), ASE incorrectly identifies AIO to be KAIO while using Posix AIO. Can lead to ASE hang. Start with this trace flag.||12.5.3 ESD 5 and 15.0 ESD 2|| ||Y||N
|-
| 1642
| Reserve one third of the sockets for EJB.|| || || ||
|-
| 1648
| Enable DIRECT IO for block devices under on Linux|| || || ||
|-
| 1649
| (linux on Intel, amd and IBM P) When set ASE uses Linux Kernel Asynchronous IO, rather than POSIX AIO||12.5.4 ESD 10|| || ||
|-
| 1656
| (Sun only) ASE will not boot when Intimate Shared Memory is not available.||12.5.4 ESD 10, 15.0.2 ESD 6|| || ||
|-
| 2205
| Show HA debugging output, supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.ase_15.0.ha_avail/html/ha_avail/ha_avail223.htm see documentation]|| || || ||
|-
| 2209
| Used when upgrading ASE configured with high availability|| || || ||
|-
| 2511
| Suppress Msg 15082 during DBCC checks||12.5.4 ESD 10|| || ||
|-
| 2512
| Instructs dbcc checkalloc to skip the syslogs table during processing.|| || || ||
|-
| 2513
| Instructs dbcc checkalloc, tablealloc and indexalloc to check for whether foreign objects are stranded on a particular segment within a database. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00729_1500/html/errMessageAdvRes/X100548.htm see documentation] || || || ||
|-
| 2703
| When using update statistics with sampling and the index/column does not have existing statistics, set join density and total density to values from the sample rather then to defaults.||15.0 ESD 2|| || ||
|-
| 2716
| Generate statistics for private temp tables||15.0.3 ESD 3|| || ||
|-
| 2720
| When set, do not allow "update statistics" to be run within a multi-statement transaction||15.0.3 ESD 3|| || ||
|-
| 3100
| Load a database even when the characterset or sort order of a dump file is incompatible with the server.|| || || ||
|-
| 3199
| When ONLINE DATABASE fails with Msg 2610 (Could not find leaf row in nonclustered index partition ...) after a cross-platform database load, set the traceflag on, reload the dump and online again.||15.0 ESD 2|| || ||Y
|-
| 3300
| Display each log record that is being processed during recovery. You may wish to redirect stdout because it can be a lot of information.|| || || ||
|-
| 3500
| Disable checkpointing.|| || || ||
|-
| 3502
| Write an entry in the errorlog when a databases is checkpointed|| || || ||
|-
| 3601
| Write a stacktrace to the errorlog every time an error is raised.|| || || ||
|-
| 3604
| Send trace output to the session of the client. Supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/monitoring244.htm see documentation] || || || ||Y
|-
| 3605
| Send trace output to the errorlog of the server. Supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00743_1500/html/qp_abstrpln/CIHCEIJA.htm see documentation] || || || ||Y
|-
| 3607
| Do not start recovery when booting ASE.|| || ||Y||
|-
| 3608
| Recover only the master database. Do not clear tempdb or start up checkpoint process.|| || ||Y||
|-
| 3609
| Recover all databases. Do not clear tempdb or start up checkpoint process.|| || ||||
|-
| 3610
| Pre-System 10 behaviour: divide by zero to result in NULL instead of error|| || || ||
|-
| 3620
| Do not kill infected processes.|| || || ||
|-
| 3637
| Connection time averages for LDAPUA are printed||12.5.4 ESD 10|| || ||
|-
| 3706
| Performance improvement of drop table in tempdb.||15.0 ESD 2|| ||Y||Y
|-
| 3710
| Improve the performance of DROP INDEX and CREATE INDEX by releasing the system catalog locks when not in DDL-IN-TRAN mode after the commit of the transaction but before post commit work started.||12.5.4 ESD 10, 15.0.2 ESD 4|| ||Y||Y
|-
| 4001
| Display a message in the errorlog when a loginrecord is recieved|| || || ||
|-
| 4012
| Don't spawn chkptproc.|| || || ||
|-
| 4013
| Write a message to the errorlog when a login takes place.|| || || ||
|-
| 4020
| Boot without recover.|| || ||Y||
|-
| 4044
| Allows to log into ASE when the "sa" login is locked|| || || ||
|-
| 4072
| Disable the global login trigger||15|| || ||
|-
| 4073
| Export the result of certain "set" command within a login trigger to the session.||15.0 ESD 2|| ||Y||
|-
| 4080
| When an UPDATE using tsequal() is done within a stored procedure, tsequal() no longer returns a timestamp value unless the trace flag is set.||12.5.3 ESD 5 + 15.0 ESD 2|| || ||
|-
| 4082
| When set printing messages to console is made non-blocking||12.5.4 ESD 10|| || ||
|-
| 4083
| Disable SQLDBGR.||12.5.4 ESD 10|| ||Y||N
|-
| 4084
| Console logging will be disabled if setting console to nonblocking fails.||12.5.4 ESD 10, 15.0.2 ESD 5|| ||Y||N
|-
| 4413
| Trace queries in a 12.5 server that are join-order dependent.|| || || ||
|-
|-
| 4419
| In some cases, outer join on view or derived table with CASE expression may perform slower due to view materialization.The workaround is to use traceflag 4419.||12.5.4 ESD#6|| || ||
|-
| 5101
| Forces all I/O requests to go through engine 0. This removes the contention between processors but could create a bottleneck if engine 0 becomes busy with non-I/O tasks.|| || || ||
|-
| 5102
| Prevents engine 0 from running any non-affinitied tasks.|| || || ||
|-
| 7103
| Disable table lock promotion for text columns.|| || || ||
|-
| 7703
| When assinging a value from a table into a local variable, go through the whole resultset rather than jump to last row and assing the value once.|| || || ||
|-
| 7717
| Disable check of client compatibility in ASE 15. See [[Version 15 client compatibility]] ||15.0.1|| || ||
|-
| 7738
| Support plan sharing of cached statements across different users.||15.0.2 ESD 2|| || ||
|-
| 7741
| Avoid Msg 257 when using statement cache and a parameterized statement without "dynamic prepare" and a incompatible parameter is specified as null.||12.5.4 ESD 10|| || ||
|-
| 7815
| logs address connection requests and host / name lookups.|| || || ||
|-
| 7841
| Make ASE IPv6 aware. No longer needed since 15.0.2 ESD 5|| ||15.0.2 ESD 5|| ||
|-
| 7844
| Enable/disable concurrent Kerberos authentication|| || || ||
|-
| 7850
| When set, timeout after 60 s when no Kerberos security opaque token is received from client||12.5.4 ESD 10|| || ||
|-
| 8003
| prints info on RPC calls|| || || ||
|-
| 8203
| Display statement and transaction locks on a deadlock error.|| || || ||
|-
| 8399
| Instructs the dbcc monitor command to insert a valid description into the field_name column in the sysmonitors table. Not intended for use by users. Appears in the errorlog when sp_sysmon is used.|| || || ||
|-
| 9217
| When set, RepAgent will not stop after reporting error 9289 due to an inconsistent log record found. Instead it will attempt to continue after reporting error 9290 in the error log. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00729_1500/html/errMessageAdvRes/BABDABEI.htm see documentation] ||15.0 ESD 2|| || ||
|-
| 9531
| Dump expensive buffer allocation analysis||15.0.2 ESD 2|| || ||
|-
| 11201
| Logs client connect events, disconnect events, and attention events. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.ase_15.0.omni_ug/html/omni_ug/omni_ug120.htm see documentation] || || || ||
|-
| 11202
| Logs client language, cursor declare, dynamic prepare, and dynamic execute-immediate text. '''Very useful for tracing incoming statements into the ASE errorlog.''' Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11203
| Logs client rpc events. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11204
| Logs all messages routed to client. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11205
| Logs all interaction with remote server. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11206
| Show messages about query processing for file access. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11207
| Log the processing of text and image datatypes from remote servers. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm/omni_ug120.htm see documentation]|| || || ||
|-
| 11208
| Prevents the create index and drop table statements from being transmitted to a remote server. sysindexes is updated anyway. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11209
| When running "update statistics" on remote tables update only the rowcount. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11210
| Disables Component Integration Services enhanced remote query optimization.|| || || ||
|-
| 11211
| Prevents the drop table syntax from being forwarded to remote servers if the table was created using the create table at location syntax. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11212
| Prevents escape on underscores in table names. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11213
| Prevents generation of column and table constraints. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11214
| Disables Component Integration Services recovery at start-up. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || ||Y||
|-
| 11215
| Sets enhanced remote optimization for servers of class db2.|| || || ||
|-
| 11216
| For the session, disables enhanced remote optimization. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||Y
|-
| 11217
| For the server, disables enhanced remote optimization. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11218
| Any query that is part of a declare cursor command, and that references proxy tables, is read only by default. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11220
| Disables constraint checking of remote tables on the local server. This avoids duplicate checking. Setting this trace flag on ensures that queries are not rejected by the quickpass mode because of constraints. (spid) Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11221
| Disables alter table commands to the remote server when ON. This allows users to modify type, length, and nullability of columns in a local table without changing columns in the remote table. Use trace flag 11221 with caution. It may lead to tables that are “out of sync.” (spid). Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11223
| Disables proxy table index creation during create existing table or create proxy_table command execution. If this flag is set on, no index metadata is imported from the remote site referenced by the proxy table, and no indexes for the proxy table are created. This trace flag should be used with care and turned off when no longer necessary. (global) Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11228
| A 2762 error, "CREATE TABLE command is not allowed within multiple statement transaction" may be reported when executing a SQL INSERT..SELECT from proxy table mapped to a RPC. This traceflag has to be turned on to allow CREATE TABLE command in the remote procedure (for the session)||12.5.3. ESD 5 and 15.0 ESD 2|| || ||
|-
| 11229
| Use pre-12.5.3 behaviour to import statistics for proxy tables. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] ||12.5.3|| || ||
|-
| 11231
| CIS: Connections to remote servers are not disconnected and remain engine affinitied until the client session terminates. The connections can now be dropped and detached from an engine after executing a statement to the remote server by enabling this flag. Exceptions are when the statement is participating in cursor, transaction or stored procedure operations; or when ASE is in either HA failover or failback states.||15.0 ESD 2|| || ||
|-
| 11232
| A 2762 error, "CREATE TABLE command is not allowed within multiple statement transaction" may be reported when executing a SQL INSERT..SELECT from proxy table mapped to a RPC. This traceflag has to be turned on to allow CREATE TABLE command in the remote procedure (serverwide)||12.5.3. ESD 5 and 15.0 ESD 2|| || ||
|-
| 11237
| Only for proxy tables to Oracle, do not append unneeded "null clause" to "alter table modify" command||12.5.4 ESD 10|| || ||
|-
| 11299
| Allows connection information to be logged when a connection to a remote server fails. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11906
| Informational messages from REORG will no longer be printed to the errorlog.||15.0 ESD 2|| || ||
|-
| 12628
| Data insertion into DOL tables having nonclustered index will be done with the index prepend mode splits disabled, in order to improve disk space utilization.||15.0 ESD 2|| ||Y||N
|-
| 15302
| When a subquery appears in the ON clause of an outer join query, the performance may not be efficient. ASE will do optimization for subquery attachment to achieve more favorable performance when turned on.||15.0 ESD 2|| || ||
|-
| 15303
| Possible performance improvement on a SELECT statement when a BIT column is involved in the WHERE clause.||15.0 ESD 2|| || ||
|-
| 15322
| Use 12.5 behaviour when assigning variables in combination with subqueries.||15.0.2 ESD 6|| || ||
|-
| 15371
| When set, bug fix for a sub-optimal plan is chosen when the query contains a subquery from an IF EXISTS clause.||12.5.4 ESD 10|| || ||
|-
| 15381
| When set, the warning message 307, "Index <index_name> specified as optimizer hint in the FROM clause of table <table_name> does not exist. Optimizer will choose another index instead." is disabled.||15.0.2 ESD 4|| || ||
|-
| 15382
| Disable "special OR strategy" (see release notes for the fine details)||15.0.2 ESD 2|| || ||
|-
| 15556
| Allow dump and load in ASE cluster edition with multiple instances active||cluster edition|| || ||
|}

[[Category:ASE]]

Dbcc traceflags

2012-10-26T08:39:35Z

Psap:

With dbcc traceflags you can do many different things, like change the behaviour of the server, see why a certain query plan is choosen or fine-tune the optimizer.
This page shows you how to use them and provides a list of known traceflags.

==Using traceflags==
You can set a traceflag in two ways
===At boottime===
Usually a server is booted through the runserver file. In this file (default location is $SYBASE/$SYBASE_ASE/install) you can add a traceflag by specifying a -T flag and one or more comma separated values.
===At run time===
When you are logged in to ASE you can set a traceflag with the dbcc traceon command. Example:

dbcc traceon(3604)

You can specify multiple values, comma separated.
To turn a traceflag off, use traceoff

dbcc traceoff(3604)

===Which traceflags are active===
To see which traceflags are active for your own session use the dbcc traceflags command

dbcc traceflags

To see the traceflags of other sessions as well

dbcc traceflags(2)

==List of known traceflags==
Below you will find a list of currently known traceflags. But beware of the following:

'''WARNING'''

* Most traceflags are undocumented and not supported by Sybase, use at your own risk. Certain traceflags can severely harm your databases.
* Some traceflags are obsolete and are replaced by configuration parameters.
* Certain traceflags should be used when you start the server, others are meant for a specific session, when known this is indicated in the list.
* Experiment first on a test server, use only on production systems when either the traceflag is documented by Sybase or when you have consulted Sybase Technical Support.

{| border="1"
|+ '''List of dbcc traceflags'''
! !! Explanation !! Since version !! Untill Version !! Boot time !! Run time
|-
| 100
| Display a parse tree for each command || || || ||
|-
| 108
| Allow dynamic and host variables in create view statements || 12.5 || || ||
|-
| 116
| Print the text of the abstract query plan. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00729_1500/html/errMessageAdvRes/BACDDIDE.htm see documentation] || || || ||
|-
| 200
| Display messages about the before image of the query-tree || || || ||
|-
| 201
| Display messages about the after image of the query tree || || || ||
|-
| 208
| Show types of locks taken || || || ||
|-
| 217
| Display a warning message for using the T-SQL extension of queries with grouped aggregates and columns in the select list which are not in the GROUP BY clause. || 15.0.2 ESD 2 || || ||
|-
| 241
| Compress all query-trees when ASE is started || || || ||
|-
| 243
| Do not expand select * to column names when creating a compiled object|| || || ||
|-
| 244
| When set, the maximum length of the returned value of str_replace() is 16384, otherwise it is 255. When Msg 511 is incorrectly raised with this flag on, upgrade to 15.0.2 ESD 6.|| || || ||
|-
| 260
| Reduce TDS (Tabular Data Stream) overhead in stored procedures. Turn off done-in-behaviour packets. See also [[Send doneinproc tokens]].|| || || ||
|-
| 291
| Changes the hierarchy and casting of datatypes to pre-11.5.1 behaviour. There was an issue is some very rare cases where a wrong result could occur, but that's been cleared up in 11.9.2 and above.|| || 11.9.2 || ||
|-
| 292
| Never send doneinproc tokens. See also [[Send doneinproc tokens]].|| || || ||
|-
| 298
| Display an error message when a query uses a correlated variable as an inner or outer member of an outer join.|| || || ||
|-
| 299
| Do not recompile a stored procedure that inherits a temp table from a parent procedure.|| || || ||
|-
| 302
| Print trace information on index selection, supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/X24199.htm see documentation]|| ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 303
| Display optimizer OR strategy || || 12.5 || ||Y
|-
| 304
| Revert special "or" optimizer strategy to the strategy used in pre-System 11 (this traceflag resolved several bug issues in System 11, most of these bugs are fixed in ASE 11.0.3.2)|| || || ||
|-
| 310
| Show the plan as choosen by the optimizer, as well as I/O costs. Supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/X24199.htm see documentation] || ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 311
| Display optimizers expected I/O cost|| ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 317
| Show all considered plans. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/X37588.htm see documentation] || ||12.5 unless using compatibility mode in ASE 15|| ||Y
|-
| 319
| Display optimizer reformatting strategy|| ||12.5 unless using compatibility mode in ASE 15.|| ||Y
|-
| 320
| Turn off join order heuristics|| ||12.5|| ||
|-
| 321
| Display optimizers reformatting strategy briefly|| ||12.5 unless using compatibility mode in ASE 15.|| ||
|-
| 324
| Turn off the like optimization for ad-hoc queries using local variables|| ||12.5|| ||
|-
| 326
| Instructs the server to use arithmetic averaging when calculating density instead of a geometric weighted average when updating statistics. Useful for building better stats when an index has skew on the leading column. Use only for updating the stats of a table/index with known skewed data.|| ||11.5|| ||
|-
| 329
| Turns on a strategy for fast first row return for queries using cursors with an ORDERBY.||15.0 ESD 2|| ||Y||N
|-
| 333
| Disables min-max optimization|| ||12.5|| ||
|-
| 334
| Enable merge joins|| ||12.5 unless using compatibility mode in ASE 15.|| ||
|-
| 353
| Turn off transitive closure|| || || ||
|-
| 364
| Use range density instead of total density|| || || ||
|-
| 370
| Use min-max index as an alternative to the table scan for single table queries. Does not perform aggregation optimization for joins.|| || || ||
|-
| 384
| Enable JTC||12.0||12.5 unless using compatibility mode in ASE 15.|| ||
|-
| 396
| Use min-max optimization for single table queries.|| || || ||
|-
| 441
| queries where literal autoparametrization applies will be processed in full compatibility mode when enabled. Supported by Sybase, [http://www.sybase.com/files/White_Papers/Sybase-ASE-Compatibility-Mode-072309-WP.pdf see documentation]||15.0.3 ESD 1|| || ||
|-
| 446
| Disable restricted compatibility mode. Supported by Sybase, [http://www.sybase.com/files/White_Papers/Sybase-ASE-Compatibility-Mode-072309-WP.pdf see documentation]||15.0.3 ESD 1|| || ||
|-
| 450
| Sort a group by operation in the order of the groups||15|| || ||
|-
| 457
| Try to use worktables for a select in a cursor in order to isolate the selected data from the base table (12.5 behaviour)||15.0.2 ESD 6|| || ||
|-
| 467
| Do not cache a statement in the statement cache when a temp tables is referenced.||15.0.2 ESD 5|| || ||
|-
| 477
| When using compatibility mode, print a message about the type being used. Supported by Sybase, [http://www.sybase.com/files/White_Papers/Sybase-ASE-Compatibility-Mode-072309-WP.pdf see documentation]||15.0.3 ESD 1|| || ||
|-
| 516
| Print mapping between xchg operators and worker processes when using parallel execution. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00743_1500/html/qp_abstrpln/qp_abstrpln106.htm see documentation] ||15|| || ||
|-
| 526
| Print semi-graphical execution operator tree when showplan is enabled. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc34982_1500/html/mig_gde/mig_gde161.htm see documentation] || || || ||
|-
| 589
| Close a cursor implicitly during a cursor fetch and after an error was hit.||15.0.2 ESD 2|| || ||
|-
| 602
| Prints out diagnostic information for deadlock prevention.|| || || ||
|-
| 603
| Prints out diagnostic information when avoiding deadlock.|| || || ||
|-
| 615
| When a read of a page does not indicate it's right identity a second read is done. When the identity is now correct the related device is suspect and ASE turns on additional diagnostic checks. The check can be turned off with the traceflag.||12.5.3 ESD 5 and 15.0 ESD 2|| ||Y||Y
|-
| 625
| When hitting Msg 12328, do not regenerate the row-offset table||12.5.4 ESD 10|| || ||
|-
| 646
| Turn off the new space allocation method as introduced in 12.5.3 for partitioned DOL tables||12.5.3|| || ||
|-
| 699
| Turn off transaction logging || || || ||
|-
| 712
| Disable procedure cache optimisation|| || || ||
|-
| 722
| ASE (debug version) will perform additional checks on the heap memory to detect possible memory corruption.||15.0 ESD 2|| ||Y||N
|-
| 833
| Do not report Msg 880 "Your query is blocked because it tried to write and database '<dbname>' is in quiesce state. Your query will proceed after the DBA performs QUIESCE DATABASE RELEASE.".||15.0 ESD 2||Y||N||
|-
| 990
| Allow only access to the server with the "sa" account. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc35892_1500/html/instalibm/instalibm108.htm see documentation] || || || ||
|-
| 1116
| Suppress Msg 1131. (The OAM page does not belong to object with index.....)|| || || ||
|-
| 1202
| Also show the blocked lock requests in master..syslocks|| || || ||
|-
| 1204
| Print deadlock information into errorlog|| || || ||
|-
| 1205
| Prints deadlock information by printing stacktraces.|| || || ||
|-
| 1206
| Disable lock promotion.|| || || ||
|-
| 1212
| Shows info about locks granted and released|| || || ||
|-
| 1213
| Used with dbcc object_stats|| || || ||
|-
| 1217
| Show info about locks being acquired|| || || ||
|-
| 1603
| Turns off async i/o and forces standard unix io. Can be useful if symptoms include transient corruption errors that may be caused by bad drives or controllers.|| || || ||
|-
| 1605
| Start secondary engines by hand|| || || ||
|-
| 1606
| Create a debug engine start file. This allows you to start up a debug engine which can access the server's shared memory for running diagnostics.|| || || ||
|-
| 1608
| Instructs server engine 0 to not on-line any other dataserver engines|| || || ||
|-
| 1610
| Boot the server with TCP_NODELAY enabled.|| || ||Y||
|-
| 1611
| If possible, pin shared memory -- check errorlog for success/failure.|| || || ||
|-
| 1613
| Set affinity of the ASE engine's onto particular CPUs usually pins engine 0 to processor 0, engine 1 to processor 1, etc|| || || ||
|-
| 1615
| SGI only: turn on recoverability to filesystem devices.|| || || ||
|-
| 1625
| Linux only: Revert to using cached filesystem I/O. By default, ASE on Linux opens filesystem devices using O_SYNC, unlike other Unix based releases, which means it is safe to use filesystems devices for production systems.||11.9.2|| || ||
|-
| 1630
| SuSE 32 bit Linux (SuSE 9 SP1 or later), ASE incorrectly identifies AIO to be KAIO while using Posix AIO. Can lead to ASE hang. Start with this trace flag.||12.5.3 ESD 5 and 15.0 ESD 2|| ||Y||N
|-
| 1642
| Reserve one third of the sockets for EJB.|| || || ||
|-
| 1648
| Enable DIRECT IO for block devices under on Linux|| || || ||
|-
| 1649
| (linux on Intel, amd and IBM P) When set ASE uses Linux Kernel Asynchronous IO, rather than POSIX AIO||12.5.4 ESD 10|| || ||
|-
| 1656
| (Sun only) ASE will not boot when Intimate Shared Memory is not available.||12.5.4 ESD 10, 15.0.2 ESD 6|| || ||
|-
| 2205
| Show HA debugging output, supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.ase_15.0.ha_avail/html/ha_avail/ha_avail223.htm see documentation]|| || || ||
|-
| 2209
| Used when upgrading ASE configured with high availability|| || || ||
|-
| 2511
| Suppress Msg 15082 during DBCC checks||12.5.4 ESD 10|| || ||
|-
| 2512
| Instructs dbcc checkalloc to skip the syslogs table during processing.|| || || ||
|-
| 2513
| Instructs dbcc checkalloc, tablealloc and indexalloc to check for whether foreign objects are stranded on a particular segment within a database. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00729_1500/html/errMessageAdvRes/X100548.htm see documentation] || || || ||
|-
| 2703
| When using update statistics with sampling and the index/column does not have existing statistics, set join density and total density to values from the sample rather then to defaults.||15.0 ESD 2|| || ||
|-
| 2716
| Generate statistics for private temp tables||15.0.3 ESD 3|| || ||
|-
| 2720
| When set, do not allow "update statistics" to be run within a multi-statement transaction||15.0.3 ESD 3|| || ||
|-
| 3100
| Load a database even when the characterset or sort order of a dump file is incompatible with the server.|| || || ||
|-
| 3199
| When ONLINE DATABASE fails with Msg 2610 (Could not find leaf row in nonclustered index partition ...) after a cross-platform database load, set the traceflag on, reload the dump and online again.||15.0 ESD 2|| || ||Y
|-
| 3300
| Display each log record that is being processed during recovery. You may wish to redirect stdout because it can be a lot of information.|| || || ||
|-
| 3500
| Disable checkpointing.|| || || ||
|-
| 3502
| Write an entry in the errorlog when a databases is checkpointed|| || || ||
|-
| 3601
| Write a stacktrace to the errorlog every time an error is raised.|| || || ||
|-
| 3604
| Send trace output to the session of the client. Supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/monitoring244.htm see documentation] || || || ||Y
|-
| 3605
| Send trace output to the errorlog of the server. Supported by Sybase [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00743_1500/html/qp_abstrpln/CIHCEIJA.htm see documentation] || || || ||Y
|-
| 3607
| Do not start recovery when booting ASE.|| || ||Y||
|-
| 3608
| Recover only the master database. Do not clear tempdb or start up checkpoint process.|| || ||Y||
|-
| 3609
| Recover all databases. Do not clear tempdb or start up checkpoint process.|| || ||||
|-
| 3610
| Pre-System 10 behaviour: divide by zero to result in NULL instead of error|| || || ||
|-
| 3620
| Do not kill infected processes.|| || || ||
|-
| 3637
| Connection time averages for LDAPUA are printed||12.5.4 ESD 10|| || ||
|-
| 3706
| Performance improvement of drop table in tempdb.||15.0 ESD 2|| ||Y||Y
|-
| 3710
| Improve the performance of DROP INDEX and CREATE INDEX by releasing the system catalog locks when not in DDL-IN-TRAN mode after the commit of the transaction but before post commit work started.||12.5.4 ESD 10, 15.0.2 ESD 4|| ||Y||Y
|-
| 4001
| Display a message in the errorlog when a loginrecord is recieved|| || || ||
|-
| 4012
| Don't spawn chkptproc.|| || || ||
|-
| 4013
| Write a message to the errorlog when a login takes place.|| || || ||
|-
| 4020
| Boot without recover.|| || ||Y||
|-
| 4044
| Allows to log into ASE when the "sa" login is locked|| || || ||
|-
| 4072
| Disable the global login trigger||15|| || ||
|-
| 4073
| Export the result of certain "set" command within a login trigger to the session.||15.0 ESD 2|| ||Y||
|-
| 4080
| When an UPDATE using tsequal() is done within a stored procedure, tsequal() no longer returns a timestamp value unless the trace flag is set.||12.5.3 ESD 5 + 15.0 ESD 2|| || ||
|-
| 4082
| When set printing messages to console is made non-blocking||12.5.4 ESD 10|| || ||
|-
| 4083
| Disable SQLDBGR.||12.5.4 ESD 10|| ||Y||N
|-
| 4084
| Console logging will be disabled if setting console to nonblocking fails.||12.5.4 ESD 10, 15.0.2 ESD 5|| ||Y||N
|-
| 4413
| Trace queries in a 12.5 server that are join-order dependent.|| || || ||
|-
|-
| 4419
| In some cases, outer join on view or derived table with CASE expression may perform slower due to view materialization.The workaround is to use traceflag 4419.||12.5.4 ESD#6|| || ||
|-
| 5101
| Forces all I/O requests to go through engine 0. This removes the contention between processors but could create a bottleneck if engine 0 becomes busy with non-I/O tasks.|| || || ||
|-
| 5102
| Prevents engine 0 from running any non-affinitied tasks.|| || || ||
|-
| 7103
| Disable table lock promotion for text columns.|| || || ||
|-
| 7703
| When assinging a value from a table into a local variable, go through the whole resultset rather than jump to last row and assing the value once.|| || || ||
|-
| 7717
| Disable check of client compatibility in ASE 15. See [[Version 15 client compatibility]] ||15.0.1|| || ||
|-
| 7738
| Support plan sharing of cached statements across different users.||15.0.2 ESD 2|| || ||
|-
| 7741
| Avoid Msg 257 when using statement cache and a parameterized statement without "dynamic prepare" and a incompatible parameter is specified as null.||12.5.4 ESD 10|| || ||
|-
| 7815
| logs address connection requests and host / name lookups.|| || || ||
|-
| 7841
| Make ASE IPv6 aware. No longer needed since 15.0.2 ESD 5|| ||15.0.2 ESD 5|| ||
|-
| 7844
| Enable/disable concurrent Kerberos authentication|| || || ||
|-
| 7850
| When set, timeout after 60 s when no Kerberos security opaque token is received from client||12.5.4 ESD 10|| || ||
|-
| 8003
| prints info on RPC calls|| || || ||
|-
| 8203
| Display statement and transaction locks on a deadlock error.|| || || ||
|-
| 8399
| Instructs the dbcc monitor command to insert a valid description into the field_name column in the sysmonitors table. Not intended for use by users. Appears in the errorlog when sp_sysmon is used.|| || || ||
|-
| 9217
| When set, RepAgent will not stop after reporting error 9289 due to an inconsistent log record found. Instead it will attempt to continue after reporting error 9290 in the error log. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00729_1500/html/errMessageAdvRes/BABDABEI.htm see documentation] ||15.0 ESD 2|| || ||
|-
| 9531
| Dump expensive buffer allocation analysis||15.0.2 ESD 2|| || ||
|-
| 11201
| Logs client connect events, disconnect events, and attention events. Supported by Sybase, [http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.ase_15.0.omni_ug/html/omni_ug/omni_ug120.htm see documentation] || || || ||
|-
| 11202
| Logs client language, cursor declare, dynamic prepare, and dynamic execute-immediate text. '''Very useful for tracing incoming statements.''' Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11203
| Logs client rpc events. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11204
| Logs all messages routed to client. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11205
| Logs all interaction with remote server. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11206
| Show messages about query processing for file access. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11207
| Log the processing of text and image datatypes from remote servers. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm/omni_ug120.htm see documentation]|| || || ||
|-
| 11208
| Prevents the create index and drop table statements from being transmitted to a remote server. sysindexes is updated anyway. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11209
| When running "update statistics" on remote tables update only the rowcount. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11210
| Disables Component Integration Services enhanced remote query optimization.|| || || ||
|-
| 11211
| Prevents the drop table syntax from being forwarded to remote servers if the table was created using the create table at location syntax. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11212
| Prevents escape on underscores in table names. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11213
| Prevents generation of column and table constraints. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11214
| Disables Component Integration Services recovery at start-up. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || ||Y||
|-
| 11215
| Sets enhanced remote optimization for servers of class db2.|| || || ||
|-
| 11216
| For the session, disables enhanced remote optimization. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||Y
|-
| 11217
| For the server, disables enhanced remote optimization. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation]|| || || ||
|-
| 11218
| Any query that is part of a declare cursor command, and that references proxy tables, is read only by default. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11220
| Disables constraint checking of remote tables on the local server. This avoids duplicate checking. Setting this trace flag on ensures that queries are not rejected by the quickpass mode because of constraints. (spid) Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11221
| Disables alter table commands to the remote server when ON. This allows users to modify type, length, and nullability of columns in a local table without changing columns in the remote table. Use trace flag 11221 with caution. It may lead to tables that are “out of sync.” (spid). Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11223
| Disables proxy table index creation during create existing table or create proxy_table command execution. If this flag is set on, no index metadata is imported from the remote site referenced by the proxy table, and no indexes for the proxy table are created. This trace flag should be used with care and turned off when no longer necessary. (global) Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11228
| A 2762 error, "CREATE TABLE command is not allowed within multiple statement transaction" may be reported when executing a SQL INSERT..SELECT from proxy table mapped to a RPC. This traceflag has to be turned on to allow CREATE TABLE command in the remote procedure (for the session)||12.5.3. ESD 5 and 15.0 ESD 2|| || ||
|-
| 11229
| Use pre-12.5.3 behaviour to import statistics for proxy tables. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] ||12.5.3|| || ||
|-
| 11231
| CIS: Connections to remote servers are not disconnected and remain engine affinitied until the client session terminates. The connections can now be dropped and detached from an engine after executing a statement to the remote server by enabling this flag. Exceptions are when the statement is participating in cursor, transaction or stored procedure operations; or when ASE is in either HA failover or failback states.||15.0 ESD 2|| || ||
|-
| 11232
| A 2762 error, "CREATE TABLE command is not allowed within multiple statement transaction" may be reported when executing a SQL INSERT..SELECT from proxy table mapped to a RPC. This traceflag has to be turned on to allow CREATE TABLE command in the remote procedure (serverwide)||12.5.3. ESD 5 and 15.0 ESD 2|| || ||
|-
| 11237
| Only for proxy tables to Oracle, do not append unneeded "null clause" to "alter table modify" command||12.5.4 ESD 10|| || ||
|-
| 11299
| Allows connection information to be logged when a connection to a remote server fails. Supported by Sybase, [http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc32702.1570/html/omni_ug/CHDJIJEC.htm see documentation] || || || ||
|-
| 11906
| Informational messages from REORG will no longer be printed to the errorlog.||15.0 ESD 2|| || ||
|-
| 12628
| Data insertion into DOL tables having nonclustered index will be done with the index prepend mode splits disabled, in order to improve disk space utilization.||15.0 ESD 2|| ||Y||N
|-
| 15302
| When a subquery appears in the ON clause of an outer join query, the performance may not be efficient. ASE will do optimization for subquery attachment to achieve more favorable performance when turned on.||15.0 ESD 2|| || ||
|-
| 15303
| Possible performance improvement on a SELECT statement when a BIT column is involved in the WHERE clause.||15.0 ESD 2|| || ||
|-
| 15322
| Use 12.5 behaviour when assigning variables in combination with subqueries.||15.0.2 ESD 6|| || ||
|-
| 15371
| When set, bug fix for a sub-optimal plan is chosen when the query contains a subquery from an IF EXISTS clause.||12.5.4 ESD 10|| || ||
|-
| 15381
| When set, the warning message 307, "Index <index_name> specified as optimizer hint in the FROM clause of table <table_name> does not exist. Optimizer will choose another index instead." is disabled.||15.0.2 ESD 4|| || ||
|-
| 15382
| Disable "special OR strategy" (see release notes for the fine details)||15.0.2 ESD 2|| || ||
|-
| 15556
| Allow dump and load in ASE cluster edition with multiple instances active||cluster edition|| || ||
|}

[[Category:ASE]]

Installation guidelines ASE 15.7

2012-10-17T13:11:09Z

Psap: Created page with 'This page describes how to install and configure a Sybase ASE server version 15.7. You will also learn how to connect to the server, stop and restart it. ==Get the software== Fi…'

This page describes how to install and configure a Sybase ASE server version 15.7. You will also learn how to connect to the server, stop and restart it.

==Get the software==
First download ASE.

For a licensed version you need to go here: http://sybase.subscribenet.com (account required) or to the eShop at sybase.com: http://eshop.sybase.com/eshop/buy?id=19517

To get a free download you can go to this page http://www.sybase.com/ase_1500devel. You can download ASE 15.7 for various operating systems and chipsets. When you install ASE you can choose to run without a license (limited features) or install a licenced version and buy a license from Sybase.

Downloads are also available at the Sybase download center at http://downloads.sybase.com/swd/base.do?client=support. Once registered you can download the latest EBF (patch) for the desired platform. An EBF can also be used for a full installation.

==Prepare the Operating System==
Make sure that the filesystem for the Sybase software is big enough. A full installation needs approx. 1.5 Gb so 4 Gb should give you enough room to handle upgrades too. In this case we install the software in /opt/sybase/ase157. Database files will be stored /var/sybase.

Become root and add a group "sybase" and a user "sybase" to the system. Also create the needed directories.
Strictly spoken, the usage of the username and groupname called "sybase" is not needed, any username is fine.

mkdir -p /opt/sybase
mkdir -p /var/sybase
groupadd sybase
useradd -g sybase -d /opt/sybase sybase
passwd sybase
chown sybase:sybase /opt/sybase
chown sybase:sybase /var/sybase

Enable the operating system to allow more than the default value for shared memory.

*Solaris (pre version 10) /etc/system
set shmsys:shminfo_shmmax = 4294967295

*Solaris (system 10) /etc/project
projadd -c "sybase" 'user.sybase'
projmod -s -K "project.max-shm-memory={privileged,4GB,deny}" 'user.sybase'

*Linux:
Use "sysctl kernel.shmmax" to see the current value.

Configure a new value with "sysctl -w kernel.shmmax=274877906944"

Then add kernel.shmmax=274877906944 to /etc/sysctl.conf

==Raw devices or filesystem files==
Sybase recommends to store all database files on raw devices except for temporary databases like tempdb. Some Unix adminstrators do not like raw devices and then you need to put everything on filesystems. Also, consult your storage administrator when in doubt.

===Raw devices===
When you use raw devices, create the following:
* master (100 Mb)
* sybsystemprocs (172M)
* sybsystemdb (6M)
* data01 (for instance 10G but for testing purposes 100Mb is also good. You can always add more)
* log01(for instance 2G but for testing purposes 20Mb is also good. You can always add more).
Do not forget to chown the raw devices to the sybase user. Check if this setting is persistent after a reboot.

===Temporory databases===
Files for temporary databases (like tempdb) should be stored on the filesystem. Allow at least 100Mb but, depending on your application, several Gb's or much more is not uncommon.

==Determine your license policy==
Since ASE 15.0 you cannot run a production server without a license file. License files can reside on the network or on the local system. Think about the license policy that suits you best. Most sites choose for license files on each Unix server.

When there is no valid license, ASE will run with a grace time of 30 days. After that it will shutdown and it cannot be rebooted anymore until you install a license, or change the license settings revert to the Express Edition.

==Installation of the software==
Now, switch to the newly created user:
su - sybase
You should now be in the directory /opt/sybase. Make a work directory and put the downloaded Sybase software in it.
mkdir install
cd install
<put the software in this directory>
tar -xf <software-distro>

Start the installation (when using an EBF download as installation file you may need to go into a subdirectory)

./setup.bin

When you get a message like "A suitable JVM could not be found" or “exec: 2470: /tmp/install.dir.1392/Linux/resource/jre/bin/java: not found” check the following document for a solution: [[Ubuntu 64 bit ASE installation]]

Use /opt/sybase/ase157 as the destination directory, do a full installation. At the list of possible servers to configure, deselect all options. We will do a manual configuration.

When the installation has finished successful you can safely remove the work directory and the installation package.

==Setup your environment==
In /opt/sybase/ase157 you will find files like SYBASE.csh, SYBASE.sh and SYBASE.env. Depending on the type of shell you use you need to source in one of these. For instance, when your default shell is bash you should do this:

. /opt/sybase/ase157/SYBASE.sh

By doing:

echo $SYBASE

it should return /opt/sybase/ase157.
Is is fairly common to activate the SYBASE.sh script (or similar one) from your login script.

When you have generated a licence file through http://sybase.subscribenet.com install it in the directory $SYBASE/SYSAM-2_0/licenses

==Create the ASE server==
Most installations, especially for development purposes, run multiple ASE's and backup servers from a single Sybase software installation. For a good overview it is quite handy to store files that are specific for a server in it's own directory. In this example we create two servers: an ASE called ASE1 and a backupserver called SYB_BACKUP. Configuration files and the errorlog are stored in the admin directory, database files are stored in /var/sybase.

Create the directories for these servers:
cd /opt/sybase
mkdir admin
mkdir admin/ASE1
mkdir admin/SYB_BACKUP
mkdir /var/sybase/ASE1

When you choose to use raw device it's quite handy when you create symbolic links from /var/sybase/ASE1 to those devices. For example:
ln -s /dev/hda4 /var/sybase/ASE1/master.dat
Do this also for the other raw devices that you have made.

Now go to the "/opt/sybase/admin/ASE1" directory and create a resource file. Use the following template as an example, call it ASE1.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.adaptive_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: sqlsrv
sqlsrv.server_name: ASE1
sqlsrv.sa_password: secret123
sqlsrv.new_config: yes
sqlsrv.do_add_server: yes
sqlsrv.network_protocol_list: tcp
sqlsrv.network_hostname_list: <put your hostname here>
sqlsrv.network_port_list: 4000
sqlsrv.application_type: MIXED
sqlsrv.server_page_size: 4096
sqlsrv.force_buildmaster: no
sqlsrv.master_device_physical_name: /var/sybase/ASE1/master.dev
sqlsrv.master_device_size: 100
sqlsrv.master_database_size: 60
sqlsrv.errorlog: /opt/sybase/admin/ASE1/errorlog
sqlsrv.do_upgrade: no
sqlsrv.sybsystemprocs_device_physical_name: /var/sybase/ASE1/sybsystemprocs.dev
sqlsrv.sybsystemprocs_device_size: USE_DEFAULT
sqlsrv.sybsystemprocs_database_size: USE_DEFAULT
sqlsrv.sybsystemdb_device_physical_name: /var/sybase/ASE1/sybsystemdb.dev
sqlsrv.sybsystemdb_device_size: USE_DEFAULT
sqlsrv.sybsystemdb_database_size: USE_DEFAULT
sqlsrv.tempdb_device_physical_name: /var/sybase/ASE1/tempdb.dev
sqlsrv.tempdb_device_size: 100
sqlsrv.tempdb_database_size: 100
sqlsrv.default_backup_server: SYB_BACKUP
#sqlsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE
sqlsrv.do_configure_pci: no
sqlsrv.sybpcidb_device_physical_name: PUT_THE_PATH_OF_YOUR_SYBPCIDB_DATA_DEVICE_HERE
sqlsrv.sybpcidb_device_size: USE_DEFAULT
sqlsrv.sybpcidb_database_size: USE_DEFAULT
# If sqlsrv.do_optimize_config is set to yes, both sqlsrv.avail_physical_memory and sqlsrv.avail_cpu_num need to be set.
sqlsrv.do_optimize_config: yes
sqlsrv.avail_physical_memory: 256
sqlsrv.avail_cpu_num: 1

This resource file will a create a Sybase server with the following characteristics:
* The name of the server will be ASE1, can be changed later with the sp_addserver stored procedure.
* The server will have a listener on the ip-address as indicated with <hostname> and port 4000. This can be changed later in the interfaces file located at $SYBASE/interfaces.
* Application type is mixed, so you expect both oltp and dss type of queries. This can be changed later by modification of the “optimization goal” setting with sp_configure).
* Server page size will be 4 Kb. The default is 2 Kb but with today’s hardware this will give sub-optimal performance. Once the server has been created it cannot be changed, a complete server rebuild is needed then.
* The master device will be 100 Mb, the size of the master database will be 60 Mb. The master devices will contain the master database, the master database contains important meta-data about the server. It’s very unusual to increase the size of the master device or the master database.
* The location of the errorlog is /opt/sybase/admin/ASE1/errorlog, can be changed later in the configuration file.
* A device of 172 Mb will be created for the sybsystemprocs database, also with a size of 172 Mb. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A device of 6 Mb will be created for the sybsystemdb database. The size of the database will actually be 12Mb as a small portion will also reside on the master device. The size of the device can be increased with the “disk resize” command, the database can be increased with the “alter database” command.
* A temporary database 'tempdb' will be created on a device with a size of 100 Mb, the database will also be 100 Mb. In fact, it will be a bit larger since also a small portion will reside on the master device. Again, the device and the tempdb database can be increased in size. You can also create multiple temporary databases for improved concurrency.
* We will build a backup server called SYB_BACKUP. The name can be changed later with sp_addserver.
* We will not use a PCI (Pluggable Component Interface) database. This database is mainly used for Java in the server.
* Use the optimize configuration feature and tune for 256 Mb of memory and 1 cpu.

Now build the server with the command:
srvbuildres -r ASE1.rs

When the srvbuildres command fails with:
Task failed
Unable to boot server 'ASE1'.
Server 'ASE1' was not created.
then go to this page for tips how to solve this: [[srvbuildres task failed]].

After a successful creation you can connect to the server using the command line tool isql. The login “sa" has been created, with the password that was specified in ASE.rs file. At the prompt of isql you can type a command or execute a stored procedure. Type exit to exit.
isql -Usa -Psecret123 -SASE1
sp_helpdb
go
exit

==Basic ASE configuration==

===Move and modify configuration files===
In this step we will move the configuration files to the admin directory. First shutdown ASE

isql -Usa -Psecret123 -SASE1
shutdown
go

cd $SYBASE/$SYBASE_ASE
mv ASE1.cfg /opt/sybase/admin/ASE1
rm ASE1.*
cd install

Modify RUN_ASE1 and make the following changes:
* Make the -s flag the first option. This has the advantage that a listing of running processes on the system will show the name of the Sybase server.
* Change the location of the configuration files, as specified with the -c flag, to the admin directory
Each line must end with a backslash.
Example RUN_ASE1 file:

#!/bin/sh
#
# ASE page size (KB): 4096
# Master device path: /var/sybase/ASE1/master.dev
# Error log path: /opt/sybase/admin/ASE1/errorlog
# Configuration file path: /opt/sybase/ase157/ASE-15_0/ASE1.cfg
# Directory for shared memory files: /opt/sybase/ase157/ASE-15_0
# Adaptive Server name: ASE1
#
/opt/sybase/ase157/ASE-15_0/bin/dataserver \
-sASE1 \
-d/var/sybase/ASE1/master.dev \
-e/opt/sybase/admin/ASE1/errorlog \
-c/opt/sybase/admin/ASE1/ASE1.cfg \
-M/opt/sybase/ase157/ASE-15_0 \

Now restart the Sybase server
./startserver -f ./RUN_ASE1

===Load instmsg.ebf file===
The instmsgs.ebf file contains the latest update for Sybase error messages. You can load it with isql.
isql -Usa -Psecret123 -SASE1 < $SYBASE/$SYBASE_ASE/scripts/instmsgs.ebf

==Create the backup server==
Create the backup server using the following steps.

Go to the "/opt/sybase/admin/SYB_BACKUP" directory and create a resource file. Use the following template as an example, call it SYB_BACKUP.rs. You can also use the Sybase supplied resource file, it's $SYBASE/$SYBASE_ASE/init/sample_resource_files/srvbuild.backup_server.rs

sybinit.release_directory: USE_DEFAULT
sybinit.product: bsrv
bsrv.server_name: SYB_BACKUP
bsrv.new_config: yes
bsrv.do_add_backup_server: yes
bsrv.do_upgrade: no
bsrv.network_protocol_list: tcp
bsrv.network_hostname_list: <put your hostname here>
bsrv.network_port_list: 4001
bsrv.language: USE_DEFAULT
bsrv.character_set: USE_DEFAULT
bsrv.tape_config_file: USE_DEFAULT
bsrv.errorlog: /opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log
sqlsrv.related_sqlsrvr: ASE1
sqlsrv.sa_login: sa
sqlsrv.sa_password: secret123
#bsrv.addl_cmdline_parameters: PUT_ANY_ADDITIONAL_COMMAND_LINE_PARAMETERS_HERE

Build the server with the command:
srvbuildres -r SYB_BACKUP.rs

===Move and modify configuration files===
In this step we will move the configuration file to the admin directory. First shutdown the backup server:
isql -Usa -Psecret123 -SASE1
shutdown SYB_BACKUP
go
exit

Modify the file RUN_SYB_BACKUP, located at $SYBASE/$SYBASE_ASE/install. Move the line with the -s flag to the top. Sample RUN_SYB_BACKUP:
#!/bin/sh
#
# Error log path: /opt/sybase/ase157/ASE-15_0/install/SYB_BACKUP.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Multibuf executable path: /opt/sybase/ase157/ASE-15_0/bin/sybmultbuf
# Backup Server name: SYB_BACKUP
#
/opt/sybase/ase157/ASE-15_0/bin/backupserver \
-SSYB_BACKUP \
-e/opt/sybase/admin/SYB_BACKUP/SYB_BACKUP.log \
-N25 \
-C20 \
-M/opt/sybase/ase157/ASE-15_0/bin/sybmultbuf \

Restart the backupserver
startserver -f $SYBASE/$SYBASE_ASE/install/RUN_SYB_BACKUP

==Create a user database==
disk init name = data01,size="1G",physname="/var/sybase/ASE1/data01.dat"
go
disk init name = log01,size="100M",physname="/var/sybase/ASE1/log01.dat"
go
create database my_database on data01="1G" log on log01 = "100M"
go
==All done==
Happy Sybase-ing with your new server!!

Further reading:

Installation guide for Linux http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30119.1570/doc/html/title.html

Sybase System administration http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc31654.1570/html/sag1/title.htm

[[Category:ASE]]