| |
Home |
![[Table of Contents]](/dwicons/b_toc.gif)
|
Installation Guide Adaptive Server Enterprise for Windows NT |
![[-]](/dwicons/i_colpse.gif)
| Chapter 4 Installing Sybase Servers |
Chapter 4
This chapter provides instructions for installing a new Adaptive Server, Backup Server, and Monitor Server.
The Studio Installer installs the Adaptive Server and related files on to the hard drive. The installation process allows you to install one or more of the following Sybase servers:
Adaptive Server
Backup Server
Monitor Server
EJB Server - 32-bit platforms only.
The basic process for installing Sybase servers is:
Perform the pre-installation tasks as described in "Pre-installation tasks ".
Perform the installation using any of the methods described in "Installation methods".
Perform the post-installation tasks as described in Chapter 5, "Post-Installation Tasks."
In this book, these terms are defined as follows:
Install - to install the Adaptive Server files on to the hard drive.
Configure - to configure attributes to make the Adaptive Server product fully functional.
Upgrade - to configure an existing Adaptive Server to a more recent Adaptive Server version level.
Server - provides a service in client/server computing. Examples include Adaptive Server, Backup Server, Historical Server, Monitor Server, and XP Server.
Client - requests a service in client/server computing. Sybase Central, PowerDynamo, PowerDesigner, SQL Modeler, and end-user applications are clients.
Table 4-1 is a list of the environment variables and their default settings.
Variable | Set to... |
%SYBASE% | C:sybase |
%SYBASE_ASE% | ASE-12_5 |
%SYBASE_EJB% | EJB-12_5 |
%SYBASE_OCS% | OCS-12_5 |
%SYBASE_SYSAM% | SYSAM-1_0 |
%SYBASE_FTS% | FTS-12_5 |
Before installing Sybase servers:
Read the release bulletins for the latest information on the products (Adaptive Server, Monitor Server, and so on) that you are installing. See the "Special Installation Instructions" section in the release bulletin.
Install operating system patches, if required. Required operating system patches are described in the release bulletin for the product.
Your Sybase product shipment includes printed release bulletins; they are also available .
Review the SySAM procedures and plan your client/server configuration using Chapter 3, "Sybase Software Asset Management (SySAM)."
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.
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 installation, upgrade, and setup tasks.
Verify that:
The directory location for the Sybase installation has sufficient space. Include an additional 2.4MB space for the installation program.
Your operating system meets the version-level, RAM, and network-protocol requirements.
The installation directory does not have a space in the directory name. For example, installing Sybase products into the directory Program Files results in unpredictable behavior.
The sybsystemdb database is required to support distributed transaction management (DTM) features. Before installation, make sure you have enough space available on the default segment to support sybsystemdb. See Chapter 2, "Installation Requirements."
Space requirements for Adaptive Server Enterprise products are listed in Chapter 2, "Installation Requirements."
Be sure you have a TEMP environment variable and a temp directory on Windows 98 (for PC-client products only), and a winnt\temp directory on Windows NT. The installation program uses the extra space and directory to write files temporarily during the installation. The installation program frees this space after the installation is complete.
Adjust shared memory segments.
Depending on the number and types of devices you use for backup (dump) and recovery (load), you may need to adjust the shared memory segment parameter in the operating system configuration file to accommodate concurrent Backup Server processes. The default number of shared memory segments available for process attachments is 6.
Determine the location, type, and size of each database device.
You must provide this information during the installation of Adaptive Server. Devices are operating system files or portions of a disk (called raw partitions) used to store databases and database objects. For details, see "Determining the location, type, and size of a database device".
Follow the instructions in this section to install Adaptive Server, Backup Server, and Monitor Server.
Use any of the following methods to install Sybase servers:
Studio Installer - use the Studio Installer to install servers and customize them for a production environment. Fully customizing a server at installation time reduces the need to make changes later. Use this method to license your Adaptive Server optional features during the installation process.
You can access the installation utility syconfig, in the %SYBASE%\%SYBASE_ASE%|bin directory to configure a new server, upgrade your existing server, and change the default language of the server.
Resource file - first, use the Studio Installer to install the server components on to the hard drive, then run the sybatch utility to install Adaptive Server and Backup Server for additional sites that require identical servers. You cannot install Monitor Server and XP Server using resource files.
You can install Sybase software in a NONGUI mode. See the Appendix, "Alternative Installation Methods"
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 environments variables needed for Adaptive Server products. However, the 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:
Log on to your Windows NT-based computer using an account with Windows NT administrator privileges.
Close any open applications or utilities, including currently installed Sybase products, to free system resources and release any Sybase DLLs.
Warning!
If any Sybase executables or DLLs are loaded into memory, and the installation program tries to overwrite any of the files that are in use, the installation program exits without warning.
Insert the Server CD in the CD-ROM drive.
The Studio Installer should start automatically. If it does not, click Start | Run, and enter:
x:\setup.exe
where x: is your CD-ROM drive.
Do not use My Computer to locate and start the setup.exe file. Using this path may result in unexpected behavior.
If you are running the Windows NT Terminal server, the Studio Installer throw a Java exception error. You should be running Windows NT Normal server.
Select the type of installation to be performed.
Standard Install - installs the default components a user needs.
Full Install - installs every component on the CD.
Customized Install - allows you to select the components to install. Certain components are automatically installed if they are required to run other selected components.
Backup Server, Monitor Server, and XP Server are, by default, installed with Adaptive Server.
If you install Adaptive Server on both nodes of a high availability system, you must select the optional component Microsoft Cluster Server Resource Type (MCSRT) under the Customized Install option. This component is not installed by default. If you do not install MCSRT, the software that links Adaptive Server and Microsoft Cluster Server (MSCS) is not installed and the configuration sequence described in the user's guide will not work correctly.
For more information about configuring Adaptive Server in a high availability configuration with MSCS, see Chapter 11, "Configuring Adaptive Server for Failover on Windows NT," in Using Sybase Failover in a High Availability System.
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.
Click Next.
Enter the target directory and click Next to proceed.
Warning!
Some utilities, such as syconfig, do not recognize spaces and require that all files and directories follow the 8-character naming convention. To ensure compatibility with all utilities, do not use spaces or exceed eight characters in the name of the installation directory or its subdirectories.
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.
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.
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")
Warning!
If you are prompted to overwrite any DLLs, select Yes only if the version of the new DLLs is later than the one it is attempting to overwrite.
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.
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".
The Studio Installer prompts: "Do you have a Sybase Software Asset Management Certificate to register?"
Click Yes.
Enter information from the Sybase License Certificate for each Adaptive Server feature you have purchased. Entries are case sensitive.
Order Number: Enter your Sybase order number.
Feature Name: Enter the name of the Adaptive Server feature.
Valid Adaptive Server feature names are:
ASE_SERVER
ASE_JAVA
ASE_EJB
ASE_HA
ASE_DTM
ASE_DIRS
ASE_DIRS
ASE_XFS
Feature Count: Enter your license count number.
Software Version: Enter the Adaptive Server software version.
Warning!
You must enter the licenses exactly as they appear on the certificate.
The license certificates for the base server and some of the options indicate version 12.0, although the software is at version 12.5. The server and all features are considered to belong to the same "Version 12 Product Family." The server and the options expect the license information to be entered exactly as it appears on the certificate.
Authorization Code: Enter the license key for the purchased feature.
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.
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.
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.
When prompted to restart the computer, leave the CD in the CD-ROM drive and select Yes.
You must restart the computer at this time. Failure to do so results in unexpected behavior.
If you encounter problems, check the installation log file to see a record of the installation process. The file is located in%Sybase%\%SYBASE_ASE%\installer.log.
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.
Select Yes when the Studio Installer prompts: "OK to configure component Adaptive Server Enterprise?"
If you select No, the Studio Installer exits. You can complete the installation by invoking %SYBASE%\%SYBASE_ASE%\bin\syconfig.exe.
Select Adaptive Server from the Products icons on the left.
Figure 4-1: Configuring Sybase servers
Click Create Adaptive Server.
The Adaptive Server name is generated and supplied from the server machine ID.
Warning!
Backup and XP Server do not allow hyphens in the name. Since XP and Backup Server names are automatically created from the Adaptive Server name, you must remove any hyphens before proceeding.
Click Continue.
Select the logical page size for this installation. Valid options are 2K, 4K, 8K, and 16K.
Specify the size and location of the master device, master.dat.
The default is based on the logical page size. The minimum allowable size is 25MB.
The default directory is: %SYBASE%\data\master.dat.
Specify the size and location of sybsystemprocs.dat. The default value of 100MB is the minimum required and the recommended size. Because the sybsystemprocs database is constantly increasing in size, this allows enough space on the device for growth.
Select Network Connection and click Add.
Enter a valid IP address, or the server name and port number.
Click Continue.
Provide an error log path name. The default is:
%SYBASE%\%SYBASE_ASE%\install\errorlog
From this window, you must also configure the XP Server. Select Configure Default XP Server.
Figure 4-2: Adaptive Server options
You can select either System Account (default) or This Account. To enable MAIL support in Adaptive Server, you must select This Account, change the NT account from LocalSystem to a valid account, and provide a password. See the Adaptive Server Configuration Guide.
Select Network Address. This launches the network connection information screen.
A valid network IP address or host_name and port_number is required to complete the installation and configuration of Sybase servers. For example:
machine_name port_number
or,
machine_name,port_number
Beginning with version 12.5, Adaptive Server accepts TCP connection formats on Windows platforms. See Chapter 6, "Installing Sybase PC-Client Products ."
Provide an error log path name.
The default is:
%SYBASE%\%SYBASE_ASE%\install\errorlog
From this window, you can also set command-line parameters. Command-line parameters set parameters for every instance of the server.
When you complete the setup process, click Continue.
This returns you to the Configure Sybase Servers screen where you can select Monitor Server or the Backup Server icons to continue the installation process.
You can set up servers to start automatically. For details, see Chapter 7, "Starting and Stopping Servers."
This procedure assumes that you have completed the "Pre-installation tasks ".
Select Backup Server from the icons on the left, and select Create Backup Server. The Backup Server attribute screen displays.
The related Backup Server name is provided by default. It is the same name as the Adaptive Server with the extension "_BS". This is the name of the Adaptive Server that will use this Backup Server.
Click Continue.
Provide an error log path for Backup Server.
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.
Specify the character set you want Backup Server to use.
The default character set is cp850.
Other options are:
cp437: Code Page 437 (United States) character set
mac: Macintosh default character set for Western European locales
ISO 8859-1 (Latin-1) Western European 8-bit character set
UTF-8 character set
Click Network Addresses.
Click Add.
Enter a valid IP address and a unique port number.
Click Continue.
The installer displays the message "The New Backup Server Configuration is Finished." Click Continue.
Do one of the following:
Select Monitor Server from the Server Configuration screen.
Click Exit to exit the configuration utility.
This procedure assumes that you have completed the "Pre-installation tasks ".
Select Monitor Server from the icons on the left, then select Create Monitor Server.
The Monitor Server name is provided by default. It is the same name as the Adaptive Server with the extension "_MS".
Provide an error log path, or accept the default.
If the Monitor Server is created in the same configuration session as Adaptive Server, you do not have to specify additional network addresses.
If you create a new Monitor Server that does not correspond with an Adaptive Server, you must add a network connection. Click Network Addresses.
Click Add.
Enter a valid IP address and a unique port number.
Click Continue.
Click Continue. The installation program:
Creates the %SYBASE%\ directory structure and places files in the appropriate subdirectories
Starts Adaptive Server
Creates the master and system procedures device files
Installs system stored procedures
Installs jConnect metadata and stored procedures
Sets permissions
Installs the language modules
Adds entries to the Windows NT Registry
Shuts down the server
When the process is completed, the FINISHED window displays. The 2.4MB of disk space used by the installation program for temporary files is released when installation is complete.
You can modify the port number in the file, %SYBASE%\%$SYBASE_EJB%\Repository\Listener\EJBServer_iiops.props.
Enter a valid port number, and click Next.
The utility displays the message: "Configuration of Installed Products is Complete." Click OK.
The utility displays the message: "Install Complete." Click OK.
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.
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:
"Initializing Database Devices" and "Creating User Databases" in the System Administration Guide for information about creating an Adaptive Server user database and its devices
Transact-SQL User's Guide to learn how to write queries
For information on developing a backup and recovery plan and backing up and restoring user databases, see the System Administration Guide.
Monitor Server requires some additional configuration after installation. See the Adaptive Server Enterprise Monitor Server User's Guide.
For information on using extended stored procedures, see the Transact-SQL User's Guide.
|
|