Sybase Technical Library - Product Manuals Home
[Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] Expand Search
Pre-installation tasks [Table of Contents] Chapter 5 Post-Installation Tasks

Installation Guide Adaptive Server Enterprise for IBM RISC System/6000 AIX

[-] Chapter 4 Installing Sybase Servers
[-] Installing server components

Installing server components

Follow the instructions in this section to install Adaptive Server, Backup Server, and Monitor Server.

Be sure that you are logged in as "sybase", and that you have performed the "Pre-installation tasks ".

Installation methods

Use any of the following methods to install Sybase servers:

Installing components with Studio Installer

The Studio Installer creates the target directory (if necessary) and installs all the selected components into that directory.

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

As part of the installation, the Studio Installer sets most of the environment variables needed for Adaptive Server products. However, you must source other environment variables by running the SYBASE.csh or SYBASE.sh script file after exiting the Studio Installer as described in Chapter 4, "Installing Sybase Servers ."

Studio Installer does not set jConnect or Java utility environment variables--you must set them manually using the instructions in Chapter 5, "Post-Installation Tasks."

To install server components:

  1. Insert the Server CD in the CD-ROM drive.

  2. Mount the CD-ROM:

    /usr/sbin/mount -v 'cdrfs' -r'' device_name /cdrom
cd /CDROM
./install
    where device_name is the CD-ROM drive device name and /cdrom is the name of the directory where the CD is to be mounted.

    The location of the mount command is site specific, and might be different than what is shown in these instructions. If you cannot mount the CD-ROM drive using the path shown, consult your operating system documentation or contact your operating system administrator.

  3. Select the type of installation to be performed.

    The Studio Installer generates an error message and stops the installation if you do not select any components for installation.

    The Studio Installer automatically installs any components that are required by the selected components, regardless of whether you deselected them.

    Click Back to select components, or Cancel to cancel the installation procedure.

  4. Click Next.

  5. Enter the target directory and click Next to proceed.

    If you select Customized Install, the next window is the Component Selection screen, which allows you to specify which components to install.

    Components that would be installed in a standard installation appear with a check in the check box to the left of the product name. You can select or deselect components from this list. Components with subcomponents have a More... button enabled. Click this button to select or deselect subcomponents.

  6. The Summary screen displays every component that is installed by the Studio Installer, the disk space required for each component, and the available disk space.

    If the target directory does not have enough free space, the available space appears in red. Clicking Next without sufficient hard disk space results in an error and stops the installation.

    Click Next.

  7. If the target directory does not exist, the Studio Installer prompts you to create it.

    Click Yes to proceed.

    Optionally, you can select Save from the Summary screen to save all the installation information into a cmdfile to proceed with the installation in a noninteractive, silent install. (See the Appendix, "Alternative Installation Methods")

    The Studio Installer installs the components on to the hard drive and displays a progress indicator.

    Warning!

    Do not interrupt the installation process. If you do, you must manually remove all of the Adaptive Server and related files, and restart the installation in a clean environment.

Sybase Software Asset Manager (SySAM)

If you install any components without the appropriate license information, only Adaptive Server 12.5, without licensed features, is enabled.

Warning!

The following SySAM license manager instructions are for the installation of Adaptive Server on the primary license host. If you are installing Adaptive Server on a secondary server, see the SySAM licensing instructions in "SySAM in the network environment".

  1. The Studio Installer prompts: "Do you have a Sybase Software Asset Management Certificate to register?"

    Click Yes.

  2. Enter information from the Sybase License Certificate for each Adaptive Server feature you have purchased. Entries are case sensitive.

    The installer records the information for the current feature in the license file and prompts you to enter information for an additional feature.

    See Chapter 3, "Sybase Software Asset Management (SySAM)" for detailed information about using the license manager.

  3. Click More. . . if you have purchased additional licensed features. The installer records the information for the current feature in the license file and prompts you to enter information for an additional feature.

  4. Click Continue Install after you have entered information from all of the Sybase License Certificates you have purchased. The installer records all license information and prompts you to configure the components you have installed.

    If you encounter problems, check the installation log file to see a record of the installation process. The file is located in$SYBASE/Installer.log.

  5. When the Studio Installer has completed the installation process, it asks if you want to configure the newly installed products and immediately launches the configuration utility if you select Yes.

Configuring the servers

The Studio Installer sets all the necessary environment variables to perform the configuration of Sybase servers. If your environment gets corrupted, the Studio Installer generates script files that you can run to correct the environment after the installation. If you need to correct the environment, run the following scripts as the "root" user.

When you log in as "sybase" for the first time after installation, verify that the SYBASE environment variable is correctly set and that $SYBASE/$SYBASE_ASE/bin and $SYBASE/$SYBASE_OCS/bin are in your search path.

Configuring Adaptive Server

  1. The Studio Installer automatically begins the configuration process.

  2. Enter the Sybase directory for this configuration. By default the installation directory displays.

    Click Next.

  3. The Build or Upgrade Adaptive Server, Backup Server, and Monitor Server screen is displayed. From the drop-down list, select Build new servers.

    The srvbuild screen displays.

    Only the server types that were installed display on the srvbuild screen. For example, if you did not install Monitor Server, it does not appear on the srvbuild screen.

    Figure 4-1: Server selection screenraster

  4. Select, at a minimum, Adaptive Server. Click the check box to the left of the server name.

    You can choose all server types at once or any combination of server types.

    srvbuild consecutively displays the attributes screen for each server you choose, in the order listed on the screen. For example, if you chose Adaptive Server, Backup Server, and XP Server, but did not select Monitor Server, the attribute screen for Adaptive Server appears first. When you finish choosing the attributes for Adaptive Server, and click OK, the Backup Server attribute screen appears. When you are finished with that screen, the XP Server attribute screen appears. The Monitor Server attribute screen does not appear because you did not check the box for installing that product.

  5. Click OK.

  6. Provide a name for each server you install.

    Do not change the name of your Backup Server.

    srvbuild provides a default server name using the name of the machine you are installing on. You can change the default name.

    Server naming conventions are as follows:

    All server names are stored in the interfaces file by srvbuild and are used by clients and other servers to establish communication.

  7. Click OK.

  8. From the drop-down list at the top of the Adaptive Server attribute screen, select the logical page size for this installation of Adaptive Server. All pages in this installation will have the logical page size you specify here. If this installation of Adaptive Server has a logical page size of 2K, and you decide that you want a logical page size of, for example, 8K, you must create a separate installation of Adaptive Server with the 8K page size.

    The size of the master database is automatically allocated to accommodate the logical page size. You can increase the master database size if you want.

    If you are adding additional server languages for localization, you need an additional 2-7MB of space, per language in the master database. See Chapter 2, "Installation Requirements" for language module sizes.

    For production systems, Sybase recommends that you use a disk partition instead of an operating system file, for the master device. This example specifies a raw partition: 

    /dev/rdsk/disk_partition

    If you entered a disk partition as the master device, only the master device can occupy the disk partition. Set the size of the partition to the recommended 30MB.

    If you entered an operating system file for the location of the master database, you can provide a size that is less than the default size, but the minimum allowable size is 25MB. The maximum size is the size of the file system, up to 2GB.

  9. Provide an operating system file for the master and sybsystemprocs device paths: 

    /op_system_dir/master.dat/op_system_dir/sybsystemprocs.dat

    where op_system_dir is the name of the operating system directory you are going to use.

    sysprocsdev is the default system name for this device. However, it is frequently referred to as the sybsystemprocs device, as in the Adaptive Server attribute screen, since it stores the sybsystemprocs database.

    Sybase recommends that the sybsystemprocs device be located on a device separate from the master device. The sybsystemprocs database usually increases in size from version to version.

  10. Provide an error log path name.

    The default is:

    $SYBASE/$SYBASE_ASE/install/errorlog

  11. For Directory Services, specify the transport type, host name, and port number.

    These entities define how servers and clients find and communicate with each other on the network. srvbuild adds this entry to the interfaces file during the installation process.

    If you want to use lightweight directory services for server connections instead of the interfaces file, see Configuring Adaptive Server Enterprise for your platform.

  12. Click Edit Advanced Adaptive Server Attributes if you want to:

  13. To create the server, click Build Server. To continue configuring other Sybase servers, select OK.

    srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute.

Configuring Backup Server

This procedure assumes that you have completed the "Pre-installation tasks ".

  1. The related Backup Server name is provided by default. It is the same name as the Adaptive Server with the extension "_back". This is the name of the Adaptive Server that will use this Backup Server.

  2. Provide the Sybase System Administrator (SA) user name for the related Adaptive Server, or accept the default value.

    If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear.

  3. Provide the Adaptive Server SA password. This is the password for the related Adaptive Server.

    If the related Adaptive Server is created in the same srvbuild session as Backup Server, this field does not appear.

  4. Provide an error log path for Backup Server.

  5. Provide a location for the tape configuration file.

    Backup Server reads this file when a dump command is issued, to determine the device type and characteristics of the dump device specified in the dump command. Having access to this information speeds up the dump (recovery) process.

  6. Specify the language you want Backup Server to use for its error messages. The default language is U.S. English.

    The language available depends on which language modules were installed on your system. By default, all character sets are copied from the CD when performing a standard or full install.

  7. Specify the character set you want Backup Server to use.

    The default character set is iso_1.

    Other options are:

  8. Specify the maximum number of network connections.

    This option specifies the total number of network connections available if you are backing up or restoring a database over the network to a remote Backup Server.

    This option is not necessary if you are backing up to the default Backup Server, which is local. Set to 0.

  9. Specify the maximum number of server connections. You can accept the default or change it.

    This option specifies the number of server connections to Backup Server. Backup Server requires at least:

    Allow a maximum of three times the number of expected concurrent dump and load sessions.

  10. For the Directory Services, specify the transport type, host name, and port number.

    These entities comprise the interfaces file entry. This entry defines how Backup Server and Adaptive Server find and communicate with each other on the network. srvbuild adds this entry to the interfaces file during the installation process.

  11. Click OK.

Configuring Monitor Server

This procedure assumes that you have completed the "Pre-installation tasks ".

  1. If you selected Monitor Server to be installed, the Monitor Server attribute screen displays.

  2. Provide the related Adaptive Server name. This field does not appear if the related Adaptive Server is created in the same srvbuild session as Monitor Server.

    This is the name of the Adaptive Server that Monitor Server will be monitoring.

  3. Specify the Sybase System Administrator (SA) user name. This field does not appear if the related Adaptive Server is created in the same srvbuild session as Monitor Server.

    This option is required unless the USER environment variable is set.

    This name specifies the Monitor Server superuser. It must be a valid login account for the Adaptive Server to be monitored. For production systems, Sybase recommends that you use the "sa" or "sybase" user account as the Monitor Server superuser.

    Monitor Server uses the superuser account to connect to Adaptive Server to run special stored procedures and to verify shutdown requests that can be performed only by the superuser.

  4. Provide the Adaptive Server SA password. This is the password of the Monitor Server superuser. This field does not appear if the related Adaptive Server is created in the same srvbuild session as Monitor Server.

    If you omit the password, Monitor Server prompts for a password during start-up.

  5. Determine the maximum number of connections allowed to Monitor Server. Valid values are 1-20.

    A connection to Monitor Server can be any of:

    For example, if a user starts a Historical Server recording session, and another user opens the Performance Summary Monitor in Sybase Central, two connections to Monitor Server are used. If Monitor Server is configured for five connections, there are only three more connections available.

  6. Specify the error log path.

    This is the path name of the Monitor Server log file, where informational and error messages are logged.

    The default location is the directory from which Monitor Server is started and the error log name is servername_mon.log, where servername is the name of the server.

  7. Specify the path of the configuration file.

    This is the path name of the Monitor Server configuration file. A default configuration file is not provided. This file is optional, but if specified, the values in the configuration file override the default runtime parameters that are otherwise used by Monitor Server.

  8. Specify the shared memory directory, where the servername.krg shared memory file is located and servername is the name of the Adaptive Server.

    If you omit this parameter, Monitor Server looks for the shared memory in the $SYBASE/$SYBASE_ASE directory.

    If you did not change the default location while configuring the Adaptive Server, the default value is correct. Otherwise, use the value you specified for the server.

  9. For the Directory Services, specify the transport type, host name, and port number. These entities comprise the interfaces file entry. This entry enables Monitor Server and Adaptive Server to find and communicate with each other on the network. srvbuild adds this entry to the interfaces file during the installation process.

  10. Click OK.

Configuring XP Server

If you selected XP Server to be installed, the XP Server Attribute Editor screen displays.

  1. Provide the related Adaptive Server name, which is the name of the Adaptive Server that will be using XP Server. If the related Adaptive Server is created in the same srvbuild session as XP Server, this field does not appear.

    The XP server name must be in all capital letters, and must follow the format ASE-NAME_XP.

  2. Provide the Sybase System Administrator (SA) user name for the related Adaptive Server, or accept the default value.

    If the related Adaptive Server is created in the same srvbuild session as XP Server, this field does not appear.

  3. Provide the related Adaptive Server SA password.

    If the related Adaptive Server is created in the same srvbuild session as XP Server, this field does not appear.

  4. For the Directory Services, accept the default values provided.

  5. Click Build Servers.

    srvbuild displays a Status Output screen that shows the status of the various installation tasks as they execute.

  6. When the installation is complete, the Status Output screen displays "Done". Click Exit to return to the main window. Click Exit, again.

Configuring EJB Server

You can modify the port number in the file, $SYBASE/$SYBASE_EJB/Repository/Listener/EJBServer_iiops.props.

Adaptive Server and related products have been successfully installed, and minimally configured for use. See "Installing sample databases ", to begin experimenting with your servers, or see the System Administration Guide for more advanced topics.

Viewing the installation status output screen

Use the information in this section each time you click the Build Server button after specifying the attributes for the server.

It takes several minutes to build the servers.

  1. Review the Status Output screen for informational messages about the installation process.

    If the installation is not successful, see Chapter 10, "Troubleshooting."

    If the installation is successful, you see a message similar to this on the Status Output screen: 

    Server server_name was successfully created.
 Done.

Adaptive Server

You have a running server, as well as various system databases and system tables. Some references that may help you get started using your new Adaptive Server are:

Backup Server

For information on developing a backup and recovery plan and backing up and restoring user databases, see the System Administration Guide.

Monitor Server

Monitor Server requires some additional configuration after installation. See the Adaptive Server Enterprise Monitor Server User's Guide.

XP Server

For information on using extended stored procedures, see the Transact-SQL User's Guide.

Pre-installation tasks [Table of Contents] Chapter 5 Post-Installation Tasks