Before installing Adaptive Server:
Read the release bulletins for the latest information on the products (Adaptive Server, Monitor Server, and so on) that you are installing. See “Special Installation Instructions” in the release bulletin.
Install operating system patches, if required.
If you are having trouble starting the installer, make sure you have the required operating system patches for the Java Runtime Environment (JRE) version 1.4.2.
Information about the required operating system patches is available from the IBM Java Web site.
Review the SySAM procedures and plan your client/server configuration using the configuration guide for your platform.
Create a “sybase” account on your system to perform all installation tasks.
The “sybase” user must have permission privileges from the top (or root) of the disk partition or operating system directory down to the specific physical device or operating system file.
Log in to the machine as the “sybase” user.
Maintain consistent ownership and privileges for all files and directories. A single user—the Sybase System Administrator with read, write, and execute permissions—should perform all installation, upgrade, and setup tasks.
Decide where the Adaptive Server software will be installed. Make sure there is sufficient available disk space. There cannot be any spaces in the path name of the directory.
Know what product edition you are installing. The options are:
Enterprise Edition
Small Business Edition
Developers Edition
Express Edition
If you are installing the Small Business or Enterprise Edition, you must know the license type under which Adaptive Server was licensed. For more information about license types, see the “License types” in Chapter 3 “Getting and Using your License” of the Sybase Software Asset Management User’s Guide.
Sybase recommends that you specify license types at the time of installation. However, you may choose to specify the product edition and license type later using sp_lmconfig. For information on sp_lmconfig, see Reference Manual:Procedures.
You must decide if you want licensing events to trigger e-mail alerts and the severity of the events that will generate e-mail messages.
If you choose to have e-mail notification of license events, you must know the:
SMTP server host name
Port number for an SMTP server
E-mail return address
Recipients of the notifications
Severity level of an event that will trigger mail. Your choices are:
None
Informational
Warning
Error
Verify that the operating system meets the version-level, RAM, and network protocol requirements for your platform.
Verify that your network software is configured.
Sybase software uses network software even if Adaptive Server and Sybase client applications are installed on a machine that is not connected to a network.
If you are having connection problems, or to verify your network configuration, ping the host.
Adjust the operating system shared memory parameter.
For Adaptive Server to run, the operating system must be configured to allow allocation of a shared memory segment at least as large as the Adaptive Server total logical memory configuration parameter.
The default total logical memory configuration parameter on HP Tru64 UNIX is 47,104 2K pages, or 92MB. To adjust the shared memory value of the operating system, add the following lines to the operating system configuration file /etc/sysconfigtab:
ipc: shm-max=nnn
For HP Tru64 UNIX 5.0a, add:
ssm-threshold=0
If this parameter is not set, Adaptive Server does not start, and the following message is displayed:
os create region: shmat "xx": invalid argument
After you install Adaptive Server, you can change any configuration parameter, procedure cache, and data cache sizes. This may require that you increase the configuration parameter max memory.
Adjust the operating system shared memory parameter, if necessary.
For Adaptive Server to run, the operating system must allow allocation of a shared memory segment at least as large as the Adaptive Server total logical memory configuration parameter.
The default size limit for shared-memory segments on IRIX 6.5 is 80 percent of physical memory, which should be sufficient. To verify the current setting, use:
systune shmmax
To adjust the setting, log in as “root”, and use the following, where nnn is at least 28MB for a default Adaptive Server.
systune shmmax nnn
After you install Adaptive Server, you can change any configuration parameter, procedure cache size, and data cache size. This may also require you to increase the value of the configuration parameter max memory.
Adjust the operating system shared memory parameter.
Solaris 10 is shifting to a new method of controlling system resources. shminfo_shmmax is technically obsolete, but if you have an entry for it in /etc/system it will still work. A new way to set this up is to add an entry to the file /etc/project. Example:
project-sybase:200:For use by Sybase:sybase:sybase: project.max-shm-memory=\(privileged,17179869184,deny)
project.max-shm-memory=(privileged,17179869184,deny) – this is the name for the project parameter that replaces the old shminfo-shmmax parameter. “privilege” is a threshold value on a resource control that constitutes a point at which local actions can be triggered or global actions such as logging in to machine can occur. Three privilege levels exist: “basic”- can be modified by owner of the calling process, “privilege” - can be modified by privileged callers, “system” - is fixed for the duration of the operating system instance.
In specifying the threshold value of “privilege”, you can use the abbreviation “priv” For example:
project.max-shm-memory=(priv, 17179869184, deny)
"17179869184" is the threshold value (16GB) on the resource control
deny – means attempts to use more than 16GB are denied.
The default value for project.max-shm-memory is 25% of the physical memory on the system. The maximum value is UINT64_MAX, which works out to 18446744073709551615 bytes, so essentially this is limited only by the size of physical memory.
The setting project.max-shm-memory can be done while the system is running by using the prctl command. The rctladm command can be used to set things permanently.
The operating system shared memory default, for most Linux releases is 32MB. The minimum required by Adaptive Server is 64MB for default Server with 2K pages. A higher value is required if you plan to increase Adaptive Server’s total memory.
Use the sysctl(8) method to check and adjust the operating system shared memory parameter.
To check the current shared memory size enter:
# /sbin/sysctl kernel.shmmax
To adjust the shared memory size enter the following where nnn is the new size in bytes (at least 64MB, which is 67108864 bytes):
# /sbin/sysctl -w kernel.shmmax=nnn
To guarantee that this value is applied every time the system is started, add the above line to your /etc/rc.d/rc.local file. On SuSE systems, the file is /etc/init.d/boot.local.
On Linux RHEL Update 3.0 and greater, Adaptive Server version 15.0 running on multiple engines requires the security feature Exec-Shield to be disabled.
To disable Exec-Shield:
Add the following lines in /etc/sysctl.conf:
kernel.exec-shield=0 kernel.exec-shield-randomize=0
As SU, enter:
/sbin/sysctl -P
for the action to take effect.
For additional information, see the Red Hat Web site.
If after adjusting the SHMMAX parameter the server fails to reboot, you may need to increase the value of another Kernel parameter, SHMALL. This is the maximum amount of shared memory that can be allocated. Its value is in the file /proc/sys/kernel/shmall. This task requires root permission.
