Home

	Expand Search

Installing Adaptive Server Enterprise on Siemens

Chapter 3: Unloading Server Products from Distribution Media

Chapter 3

This chapter describes how to unload Adaptive Server Enterprise server products for UNIX from the Sybase distribution media onto your system.

To unload client products, see Chapter 5, "Installing Sybase PC-Client Products."

Topics covered include:

• Overview
• Pre-Unloading Tasks
• Unloading in an X-Windows Environment
• Unloading Products in a Text Mode Environment
• What's Next?

Overview

Unload the server product files from the distribution media to your machine, using the instructions provided in this chapter. When you have finished unloading the products, do either of the following:

• Build the server products, using the instructions provided in Chapter 4, "Installing Sybase Servers."
• Upgrade server products, using the instructions provided in Chapter 6, "Upgrading Sybase Servers."

Pre-Unloading Tasks

Before unloading server products onto the system:

1. Read the release bulletins for the latest information on the products (Adaptive Server, Monitor Server, and so on) that you are unloading.

   Your Sybase products shipment includes printed release bulletins; they are also available at the Sybase Web site:

   http://www.sybase.com

2. If you plan to run sybsetup on a remote machine, that machine must have permission to display the sybsetup screens on the local machine on which you are working. To give the remote machine permission to display screens on your local machine, enter the following command at the UNIX prompt of your local machine:

   xhost +remote_machine 

   where remote_machine is the machine on which you are running sybsetup.

3. At the remote machine where you are running sybsetup, verify that the DISPLAY environment variable is set to the local machine on which you are viewing sybsetup screens and output. If sybsetup cannot find your DISPLAY variable, you cannot run the graphical user interface.

   For C shell:

   setenv DISPLAY host_name:0.0 

   For Bourne shell:

   DISPLAY=host_name:0.0; export DISPLAY 

   where host_name is the name of the local (display) machine.

4. Create a "sybase" account on your system to perform all unloading tasks. The operating system administrator usually sets up this account, as this requires "root" privileges.

5. Log on to the machine as the "sybase" user.

   It is important to 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 unload, installation, upgrade and setup 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.

6. Identify or create a directory location for the Sybase installation directory, where you unload the server products.

   If you are unloading for an upgrade, see "If You Are Unloading for an Upgrade".

7. Verify that the directory location for the Sybase installation directory is in a UNIX file system that has sufficient space to accommodate unloading the software.

   Space requirements for Adaptive Server Enterprise products are listed in Chapter 2, "Installation Requirements."

8. Set the SYBASE environment variable to the path of the Sybase installation directory. For example:

   setenv SYBASE /work/server 

   The SYBASE environment variable is used by the installation and setup utilities.

   Note: , If you are unloading for the purpose of upgrading your current Adaptive Server (or SQL Server) to Adaptive Server 11.9.2, set the SYBASE environment variable to the new Sybase installation directory rather than your current installation.

9. Verify that permissions are set correctly in the Sybase installation directory.

   The permissions needed are read, write, and execute. If you use sybsetup to create the Sybase installation directory, be sure you have these permissions.

10. Add $SYBASE/bin to your PATH environment variable. After unloading and installing, you will be executing commands that are located in $SYBASE/bin.

    Table 3-1: Adding $SYBASE/bin to the PATH environment variable

    Operating System Shell	Set PATH As Follows
    Bourne (sh)	PATH=$SYBASE/bin: $PATH; export PATH
    C (csh)	setenv PATH $SYBASE/bin: $PATH

11. Set the shared library environment variable. This environment variable is needed to execute all installation and setup utilities.

    WARNING! <(/)b>To ensure a proper installation, add $SYBASE/lib first to the LD_LIBRARY_PATH. If /usr/shlib comes before $SYBASE/lib in LD_LIBRARY_PATH, you may encounter unresolvable symbol errors.

    Table 3-2: Setting the LD_LIBRARY_PATH environment variable

    Status of LD_LIBRARY_PATH	Operating System Shell	Set LD_LIBRARY_PATH As Follows
    Not currently set	Bourne (sh)	LD_LIBRARY_PATH=$SYBASE/lib; export LD_LIBRARY_PATH
    	C (csh)	setenv LD_LIBRARY_PATH $SYBASE/lib
    Currently set	Bourne (sh)	LD_LIBRARY_PATH=$SYBASE/lib: $LD_LIBRARY_PATH; export LD_LIBRARY_PATH
    	C (csh)	setenv LD_LIBRARY_PATH $SYBASE/lib: $LD_LIBRARY_PATH

If You Are Unloading for an Upgrade

To unload for the purpose of upgrading an Adaptive Server product, do the following:

1. Back up all existing Sybase installations. Unloading into an existing Sybase installation directory overwrites the previous installation.

2. Unload the new Adaptive Server software into a different directory from your currently installed version. Verify the new location in the Sybase Release Directory box in the sybsetup main menu.

   WARNING! <(/)b>If you unload Adaptive Server into the same directory as the currently installed version, the new version overwrites the old one. If this occurs, the upgrade cannot complete, because you must have both the old and the new versions of Adaptive Server to perform an upgrade.

3. If you are unloading Monitor Server for SQL Server 11.0.x, verify that you have write permissions on the current Monitor Server files. The files are:
   • $SYBASE/bin/monserver_110x
   • $SYBASE/scripts/installmon
   • $SYBASE/install/setperm_monserv

Unloading in an X-Windows Environment

In an X-Windows environment, use the sybsetup utility to unload from CD.

To unload Adaptive Server products:

1. Verify that you are logged in as the "sybase" user and that your environment is set up as described in "Pre-Unloading Tasks".

2. Place the Adaptive Server product CD in the CD-ROM drive.

3. A superuser (usually "root") must mount the CD-ROM. The mount command must contain the name of the CD-ROM drive device. If you are installing from CD-ROM, record the name of the CD-ROM drive device. The mount command must also contain the name of the directory where the CD-ROM is to be mounted. The CD-ROM must be mounted in a subdirectory of the root directory, usually /cdrom. If a directory for the CD-ROM does not exist on your machine, create it now.
   Instructions for Loading from CD-ROM
   
   Mount the CD-ROM with a command like the following (the /cdrom directory must exist before you executing this command):
   
   mount -F hs device_name /cdrom
   
   where device_name is the device name of the CD-ROM drive, and /cdrom is the name of the directory where the CD-ROM is mounted. For example on a RM600E:
   
   mount -F hs /dev/ios0/sdisk000s0 /cdrom
   
   

4. At the UNIX prompt, execute the sybsetup utility:

   /cdrom/sybsetup 

   The sybsetup screen is displayed.

5. Choose Unload Sybase Products from the sybsetup menu.

   The Installation Destination screen is displayed:

6. Verify that the location of the installation directory displayed by sybsetup is where you want to install Sybase software.

   sybsetup displays the value of the SYBASE environment variable, which you should have set as described in "Pre-Unloading Tasks". For new installations, this is the value you want to use. If the SYBASE environment variable is not set, set it now.

   WARNING! <(/)b>If unloading for an upgrade, you must change the installation directory location so that it is different from the value of your current installation. Otherwise, the current installation will be overwritten and the upgrade will fail.

   To install in a location that is different from the location displayed by sybsetup, change the directory location displayed on the sybsetup screen. Changing the installation directory in sybsetup does not reset the SYBASE environment variable on your system.

7. Click continue (the checkmark button).

   The Installation Source Device screen is displayed.

8. Provide the device media and device location:
   1. Select CD-ROM (if not already selected by default).

   2. Enter /cdrom/sybimage as the name of the CD-ROM image.

   3. Select Local (if not already selected by default)

9. Click continue (the checkmark button).

   The Product Selection screen is displayed.

10. At the top of the Product Selection screen, verify the install directory, install device, and install host displayed are correct.

    If any part of this information is incorrect, return to the main menu of sybsetup and begin again.

11. Click on the products you want to install.

    After you make a product selection, the Disk Space Available field indicates the available space remaining in the installation directory.

    If you unload any languages into Adaptive Server in addition to the language you specify as the default, you may need to extend your master database. Each server language requires 2-7MB in the master database.

    Note: , Backup Server and XP Server are unloaded, by default, with Adaptive Server.

12. Click continue.

    The Install Products? dialog box is displayed.

13. Click OK to unload the products.

    sybsetup displays the Installation Status screen, which shows the progress of the unloading process. Unloading the software may take half an hour or more, depending on how many products you are unloading.

14. At the end of the unloading process, the Install sybsetup? screen is displayed. You are asked if you want to install the sybsetup executable in the $SYBASE/bin directory. This allows you to run sybsetup and invoke the setup utilities without remounting the CD.

    WARNING! <(/)b>If you are unloading Monitor Server for SQL Server 11.0.x, do not install sybsetup in $SYBASE/bin, and do not install sybsetup in your 11.0.x directory. If you do, sybsetup will fail and exit with a fatal error. The Monitor Server installation is not affected by this error.
    
    Do not use the UNIX cp command to manually copy sybsetup from the CD to your system. If you do, sybsetup will not work.

15. Click Yes or No, depending on whether you want to install sybsetup in $SYBASE/bin.

    A screen entitled Success is displayed after sybsetup is successfully unloaded.

16. When unloading is complete and you have exited sybsetup, remove the CD from the drive:

    /sbin/umount /cdrom

17. You have successfully unloaded Adaptive Server onto your system; however, you do not yet have a fully functional product. To continue, see "What's Next?".

Unloading Products in a Text Mode Environment

If your UNIX system does not have the X-Windows environment or you choose not to use it, use the sybload utility to unload Adaptive Server product files. When you use sybload to unload Adaptive Server products from a CD into the installation directory, execute sybload directly from the CD.

To unload products from the CD:

1. Verify you are logged in as the "sybase" user and that your environment is set up as described in "Pre-Unloading Tasks".

2. Mount the Adaptive Server product CD as described in "Unloading in an X-Windows Environment".

3. Change to the Sybase installation directory:

   % cd $SYBASE

4. Start the sybload utility:

   /cdrom/sybload -D 

5. sybload prompts you for unloading information. Table 3-3 summarizes the information you need to enter.

   Table 3-3: Summary of sybload prompts for CD-ROM installation

   Prompt	Value
   $SYBASE directory	Confirm that the current directory is the Sybase installation directory, or specify the correct directory path.
   Local or remote installation	Enter "L" to indicate a local installation. Enter "R" to indicate a remote installation.
   Name of disk file of global archive	Enter the CD-ROM disk file (usually /cdrom/sybimage).
   Confirm media device	Enter "Y" to continue. Enter "N" to reenter the media device.
   Customer Authorization String (CAS)	If you are asked to supply a CAS string, use the CAS located in /cdrom/install/CAS.
   Sybase products	Select products to unload from the sybload menu: Enter the number of each product to install. Press Return after each number. Press Return twice to enter a blank line when finished. Note: , By default, Backup Server and XP Server are unloaded with Adaptive Server. Note: , If you unload any languages onto Adaptive Server, in addition to the language you specify as the default, you may need to extend your master database. Each server language requires 2-7MB in the master database.
   Product confirmation	The sybload utility lists the products you have chosen. Enter: "Y" to confirm that the list is correct "Q" to quit Any other character to display the products menu and select additional products

   Note: , Do not interrupt the unload process, which may take 30 minutes or more. When sybload is finished, it displays a list of the products installed.

6. When unloading is complete, remove the CD from the drive:

   /sbin/umount /cdrom 

7. You have successfully unloaded Adaptive Server onto your system; however, you do not yet have a fully functional product. To continue, see "What's Next?".

What's Next?

You have successfully unloaded Adaptive Server and its products onto your system. To determine your next step, see the following table.

To Do This	See
Perform a first-time installation of: Adaptive Server Backup Server Monitor Server XP Server	Chapter 4, "Installing Sybase Servers"
Install client products	Chapter 5, "Installing Sybase PC-Client Products"
Upgrade an existing: Adaptive Server Backup Server Monitor Server XP Server	Chapter 6, "Upgrading Sybase Servers"
Configure and use Historical Server	Sybase Adaptive Server Enterprise Monitor Historical Server User's Guide
Configure and use Monitor Client Library	Sybase Adaptive Server Enterprise Monitor Client Library Programmer's Guide
Configure and use Monitor Server for SQL Server 11.0.x	Release Bulletin for Adaptive Server Enterprise Monitor Version 11.5.1