1. Manuals
  2. Brands
  3. Sybase Manuals
  4. Software
  5. Replication Server 15
  6. Installation manual

Sybase Replication Server 15 Installation Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Installation Guide
®
Replication Server
15.0
[ UNIX ]

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Replication Server 15 and is the answer not in the manual?

Questions and answers

Related Manuals for Sybase Replication Server 15

Summary of Contents for Sybase Replication Server 15

  • Page 1 Installation Guide ® Replication Server 15.0 [ UNIX ]...
  • Page 2 Copyright © 1992-2006 by Sybase, Inc. All rights reserved. This publication pertains to Sybase software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement.

  • Page 3: Table Of Contents

    Before You Begin ................1 Introduction ..................1 Replication Server components ..........1 Installation task overview ............2 Sybase Software Asset Management ..........2 How SySAM works ..............3 Using an unserved license ............3 Using a network license server ..........4 Using multiple network license servers ........
  • Page 4 Contents Review the log files ................ 39 Start Adaptive Server for the RSSD ..........40 Start the sample Replication Server..........40 Set environment variables.............. 41 SySAM Administration ..............43 AP PE ND IX A Managing licenses ................. 43 Using the options file to manage licenses ....... 45 Starting and stopping network license servers.......

  • Page 5: About This Book

    Related documents The Sybase® Replication Server documentation set consists of: • The release bulletin for your platform – contains last-minute information that was too late to be included in the books.
  • Page 6 Reference Manual – contains the syntax and detailed descriptions of Replication Server commands in the Replication Command Language (RCL); Replication Server system functions; Sybase Adaptive Server® commands, system procedures, and stored procedures used with Replication Server; Replication Server executable programs; and Replication Server system tables.
  • Page 7 About This Book Other sources of Use the Sybase Getting Started CD, the SyBooks CD, and the Sybase Product information Manuals Web site to learn more about your product: • The Getting Started CD contains release bulletins and installation guides in PDF format, and may also contain other documents or updated information not included on the SyBooks CD.
  • Page 8 Product; or select the platform and product under Search by Platform. Select Search to display the availability and certification report for the selection. Creating a personalized view of the Sybase Web site (including support pages) Set up a MySybase profile. MySybase is a free service that allows you to create a personalized view of Sybase Web pages.
  • Page 9 About This Book Examples that show the use of Replication Server commands are printed as follows: alter user louise set password hFE5t verify password hFE5t Command names, command option names, program names, program flags, keywords, configuration parameters, functions, and stored procedures are printed as follows: •...
  • Page 10 • Curly braces and commas – choose one or more options. If you choose more than one, separate your choices with commas. {cash, check, credit} Optional choices • One item in square brackets – choose it or omit it. [anchovies] •...
  • Page 11 Section 508 and W3C standards. If you need help Each Sybase installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support. If you cannot resolve a problem using the manuals or online help, please have the designated person contact Sybase Technical Support or the Sybase subsidiary in your area.
  • Page 12 Replication Server...

  • Page 13: Chapter 1 Before You Begin

    Replication Server. Topic Page Introduction Sybase Software Asset Management Pre-installation tasks Introduction This section describes the components of Replication Server and provides an overview of the tasks involved in installing and setting up Replication Server.

  • Page 14: Installation Task Overview

    • Start and stop Replication Server or RepAgent Sybase Software Asset Management Replication Server version 15.0 includes a new Sybase Software Asset Management System (SySAM) implementation. SySAM configuration is no longer optional, which results in installation and configuration changes. SySAM product licensing software allows you to: •...

  • Page 15: How Sysam Works

    Replication Server in $SYBASE/SYSAM-2_0/licenses. When you start Replication Server, the product searches for a license in the default location—$SYBASE/SYSAM- 2_0/licenses—looking at all files with a .lic extension. The local license file contains the actual licenses or a pointer to a SySAM network license server.

  • Page 16: Using A Network License Server

    $SYBASE/SYSAM-2_0/licenses. Using a network license server When you configure a network license server, the server uses two daemons— FLEXlm daemon and the vendor (SYBASE) daemon—to handle lmgrd license check-in and check-out for licensed products. Using the pointer in the local license file, Replication Server connects to the network license server and attempts to check out a license (REP_SERVER).
  • Page 17 To configure Replication Server to use the network server, specify the network server host name and port number during installation. Specify the host ID for the network license server host when you obtain a license from the Sybase Software Product Download Center. After installation, you can edit the SYBASE.lic file in $SYBASE/SYSAM-2_0/licenses and change the network...

  • Page 18: Using Multiple Network License Servers

    On any one machine, you can have only one instance of a license server running. You must make some adjustments to use earlier versions with Replication Server 15.0. See “Co-existing with earlier versions of SySAM” on page 8.

  • Page 19: Using Three-Server Redundancy

    To implement load- balancing, see “Setting up multiple network servers” on page 6. Because Sybase provides grace periods for any licensing issues, setting Note up the license servers for failover may be unnecessary. Replication Server operations are not compromised as long as license server issues are fixed within the grace period.

  • Page 20: Using Alternative License File Locations

    Sybase products with Replication Server 15.0. Case 1: If you are using a central network server for Replication Server 15.0, and a network license server-based SySAM license for earlier versions of the product, migrate to Replication Server version 15.0: Update the network license software with the version provided in Replication Server 15.0.

  • Page 21: Migrating Old Licenses To A New Central License

    Case 2: Replication Server, with each machine running earlier Sybase software hosting a local license server, Sybase recommends that you move to a single network license server model to migrate to Replication Server version 15.0. Using a central license server only for new licenses...

  • Page 22: License Usage And Enforcement

    Sybase Software Asset Management Shut down the earlier individual license servers on each machine and point the software to the new license server. Use the utility (see “Using lmpath SySAM utilities” on page 55) to do this, or edit the license.dat file on each installation by adding these lines at the beginning of the file: SERVER <network license server hostname>...

  • Page 23: License Availability And Grace Periods

    CHAPTER 1 Before You Begin Some Windows and Linux machines use technologies such as “Hyper Threading” which presents one physical CPU as two logical CPUs. This is still considered one CPU for counting licenses. License availability and grace periods If Replication Server cannot obtain a suitable license, the product does not run. A license is considered unavailable if it cannot be checked out, or if the license cannot be issued during a grace period.
  • Page 24 Sybase Software Asset Management If Replication Server cannot obtain a license, SySAM evaluates whether the license can be issued under a grace period. The grace periods evaluated are described in “License availability and grace periods” on page 11. If a SySAM license cannot be acquired If the license cannot be issued during the grace period, Replication Server does not start and errors are reported in the error log file.

  • Page 25: Pre-Installation Tasks

    Before you install Replication Server, follow the steps outlined in this section. Read the release bulletin The release bulletin contains last-minute information about installing and upgrading Replication Server software. Your Sybase products shipment includes printed release bulletins. They are also available on the Product Manuals Web page at http://www.sybase.com/support/manuals...

  • Page 26: Plan Your Replication System

    • 400MB for the Replication Server software, supporting files, and log files. • An additional 20MB for each Replication Server disk partition. The disk partition may be on a different disk than your Sybase software. • One of the following: •...
  • Page 27 CHAPTER 1 Before You Begin If your operating system requires patches, install them before you install Replication Server components. Do not use a patch that is earlier than the version suggested for your Note operating system. If a patch has been superseded by a newer patch, use the most recent one.

  • Page 28: Understand The Installation Directory Structure

    (for Replication Server) or OCS (for Open Client™ and Open Server™), and the software release version, such as 15_0. Replication Server 15.0 includes a new version of Replication Server and many of its supporting components. Other Sybase products may contain earlier versions of the same components.
  • Page 29 CHAPTER 1 Before You Begin You can install Replication Server 15.0 on top of Replication Server 12.6, in the same $SYBASE directory. Installing 15.0 on top of Replication Server 12.6 will create a duplicate entry in the interfaces file for SAMPLE_RS, which is the sample Replication Server.
  • Page 30 A diagnostic server REP-15_0/bin/repserver.diag is installed to capture and display information about internal processes. Do not delete this program as you may need to use it at the direction of Sybase Technical Support, to diagnose and resolve Replication Server problems.

  • Page 31: Set The Required Environment Variable For Dsedit Utility

    OCS-15_0 – Open Client and Open Server files, including bin, config, devlib, include, lib, lib3p, sample, sybhelp, and xappdefaults. • REP-15_0 – Replication Server 15.0 files, including ASA9, bin, certificates, doc, init, install, samp_repserver, scripts, sysam, ThirdPartyLegal, and upgrade. •...

  • Page 32: Perform Administrative Tasks

    Verify that your network software is configured. Sybase software uses network software, even if Replication Server and Sybase client applications are installed on a machine that is not connected to a network. If you are using an RSSD, verify that Adaptive Server Enterprise is up and running.

  • Page 33: Sysam Pre-Installation Tasks

    To create a Sybase System Administrator account, choose an existing account, or create a new account and assign a user ID, group ID, and password for it. This account is sometimes called the “sybase” user account. See your operating system documentation for instructions on creating a new user account.

  • Page 34: Installing A New License Server

    • To create a new license server before installing Replication Server, see “Installing a new license server” on page 22. Note Sybase recommends that you obtain the license files from the Sybase before you Product Download Center (SPDC) at https://sybase.subscribenet.com begin installation.
  • Page 35 12 Get the license you want to install. Log in to your account. When you place an order for Sybase software, the Sold To and Ship To contacts become members of the Sybase Product download Center account, and their e-mail addresses are automatically added as a login.
  • Page 36 Pre-installation tasks The administrator can add new members to the Sybase Product Download Center account at any time. Select the product for which to activate licenses. Complete the License Activation wizard to generate required licenses. The generated licenses are displayed when the wizard completes.

  • Page 37: Chapter 2 Installing Replication Server

    Sybase products. When you install Replication Server using InstallShield, its software and support files are stored in the Sybase installation directory. You can install all Sybase software in the same installation directory. Warning! Do not install Replication Server into an existing Adaptive Server Enterprise 12.x (64-bit) directory.
  • Page 38 Uninstall all Replication Server 15.0 components. In addition, InstallShield: • Creates the SYBASE.csh or SYBASE.sh script files. You can later use these files to reset environment variables after exiting InstallShield and before configuring Replication Server. See “Set environment variables” on page •...

  • Page 39: Installing Replication Server

    Note If you encounter problems during installation, check the installation log file to see a record of the installation process. The file is located in $SYBASE/log.txt, where $SYBASE is the Replication Server installation directory. Mount the Replication Server CD: •...
  • Page 40 If you cannot mount the CD drive, consult your operating system documentation or contact your operating system administrator. Verify that you are logged in as the “sybase” user with “root” privileges. Installing in GUI mode At the UNIX prompt, enter the following, where cdrom is the directory you specified when mounting the CD drive, and ./setup unloads the...
  • Page 41 Choose your geographic location in the license and copyright agreement window. Read the Sybase license agreement and select “I agree.” Click Next. You must agree to the license and copyright before you can continue. In the install directory window, click Next to accept the default directory for the installation ($SYBASE or /opt/sybase), or enter a different directory name.
  • Page 42 Language Modules – Connectivity • Shared • Replication Monitoring Services • Replication Server Administration Tools – Sybase Central and Replication Manager Plugin • Sybase Software Asset Management • If you choose Custom, select the components to install. Certain components are automatically installed if they are required to run your selected components.
  • Page 43 CHAPTER 2 Installing Replication Server next to continue the wizard. 12 The SySAM License Server window opens and displays this prompt: Will licenses be obtained from the License Server? • Select Yes if you have a preexisting SySAM network license server installed or installed a new license server using “Installing a new license server”...
  • Page 44 The installer has updated the appropriate interfaces file or sql.ini file. All files and logs associated with the sample Replication Server will be located in the directory $SYBASE/REP-15_0/samp_repserver. The sample Replication Server will be configured using the file $SYBASE/REP-15_0/samp_repserver/SAMPLE_RS.res. 16 Click Next. The Configure New Replication Server window displays the progress of the server configuration.

  • Page 45: Installing In Command Line Mode

    This section discusses the various installation methods available to you from the command line. Note If the environment variable $SYBASE is set, the installer uses it as the default directory for installation. However, you can explicitly specify a different directory during the installation process to override $SYBASE.
  • Page 46 Installing Replication Server Installing with a response file You can install Replication Server using a response file in combination with a console or silent installation. You must first create the response file. You must provide the absolute path name for the response file you create. Note To create a response file, do one of the following at the command line: •...

  • Page 47: Installing In Silent Mode

    CHAPTER 2 Installing Replication Server Do not use special characters for the path name, such as blanks or periods. Specify the setup type, where installation_type specifies the type of installation (Full, Typical, or Custom): -W setupTypes.selectedSetupTypeId=installation_type If you specify either the Full or Typical installation, you do not need to uncomment the individual features;...

  • Page 48: Troubleshooting Installation

    Sybase License Agreement text. Checking for a valid installation View the $SYBASE/log.txt file and check for errors. Verify that the vpd.properties file has been written in the $SYBASE directory. Check that the date of the vpd.properties file reflects the date of this current installation.

  • Page 49: Uninstalling Sybase Products

    The log file is located in $SYBASE/Iog.txt. If this is the first time you have installed a Sybase product on this machine, InstallShield creates a Sybase installation directory. This directory contains the support files for all Sybase products.
  • Page 50 Edition, unregister the Replication Manager plug-in in Sybase Central. See the Replication Manager plug-in online help for more information. Uninstalling in console mode To uninstall the products in console mode, first source the SYBASE.csh or SYBASE.sh as appropriate, then execute the following at the command line:...

  • Page 51: Chapter 3 Post-Installation Tasks

    Information about the configuration of Replication Server is stored in the following log files: • InstallShield error log file: $SYBASE/log.txt • Adaptive Server Anywhere error logs: $SYBASE_REP/samp_repserver/errorlog/ • log file: rs_init $SYBASE/$SYBASE_REP/init/logs/logmmdd.xxx For example: $SYBASE/$SYBASE_REP/init/logs/log1106.001 • Replication Server log file: $SYBASE/$SYBASE_REP/install/rs_name.log For example: $SYBASE/$SYBASE_REP/install/REP_redtail.log Installation Guide for UNIX...

  • Page 52: Start Adaptive Server For The Rssd

    During installation, InstallShield asks if you want to configure and start a sample Replication Server. InstallShield creates a resource file, $SYBASE/REP-15_0/samp_repserver/SAMPLE_RS.res, for the sample Replication Server and updates the interfaces file regardless of your choice. If you select No, you can still configure and start the sample Replication Server after installation using this resource file.

  • Page 53: Set Environment Variables

    • $SYBASE/SYBASE.csh • $SYBASE/SYBASE.env After you exit InstallShield, you may need to reset environment variables, for example, if someone other than the Sybase administrator must use the software. To set these environment variables, you can either: Installation Guide for UNIX...

  • Page 54: Description

    The subdirectory path to the Unified Agent Framework and Replication Monitoring Services. $SCROOT The subdirectory path to Sybase Central. $SYBROOT The parent directory of $SCROOT. If Sybase Central is installed in the same directory as Replication Server, $SYBASE and $SYBROOT will be the same. Replication Server...

  • Page 55: Ap Pe Nd Ix A Sysam Administration

    Enabling the network license server REPORTLOG file Using SAMreport Using SySAM utilities Managing licenses The Sybase Product Download Center is an where you obtain license keys to enable Sybase software. When you purchase software from Sybase, go to the download site at .
  • Page 56 Complete the remaining fulfilment for an order. • Rehost a license. To change the machine where a license is located, you must generate a new license file at the Sybase Product Download Center. • View a history of fulfilled licenses and re-download the licenses.

  • Page 57: Using The Options File To Manage Licenses

    The Sybase Product Download Center keeps a record of the license keys you have activated, and allows you access the records of the software for which you are licensed.

  • Page 58: Starting And Stopping Network License Servers

    License Manager with root privileges, as these are not required. The following example script assumes that the SySAM License Manager will be run as the user sybase, and was installed into /opt/sybase. Change these parameters to match your specific installation: #!/bin/sh...
  • Page 59 APPENDIX A SySAM Administration >> $SYSAM/log/boot.log" echo "Usage: $0 { start | stop }" exit 1 esac exit 0 Save the script to the file name appropriate for your operating system. Solaris: /etc/init.d/sysam.boot IBM AIX: /etc/rc.d/init.d/sysam.boot HP-UX: /sbin/init.d/sysam.boot Change the permissions, ownership, and group for the script. For example, assuming the script was stored as /etc/init.d/sysam.boot enter: chmod 744 /etc/init.d/sysam.boot...

  • Page 60: Borrowing A License To Work Offline

    You cannot borrow a license when you are use local license files. Note Borrowing a license using lmborrow Before disconnecting from the network, shut down Replication Server. Go to $SYBASE/SYSAM-2_0/bin. Replication Server...
  • Page 61 APPENDIX A SySAM Administration Enter: ./lmutil lmborrow SYBASE enddate [ time ] where is the desired borrow end date. endate [time] from the same machine on which licenses are being Note lmborrow borrowed, and from the same user that starts Replication Server.

  • Page 62: Enabling The Network License Server Reportlog File

    The report log is enabled by adding this command in the options file: REPORTLOG [+]report_log_path where report_log_path is the report log file for this vendor daemon. Sybase recommends that you prepend the report_log_path with a plus (+) character to append logging entries, otherwise, the file is overwritten each time the daemon starts.

  • Page 63: Samreport System Requirements

    The SAMreport install program is on the Replication Server installation media in the /samreport directory. The recommended $SAMreport_home location is Note $SYBASE/SYSAM-2_0/samreport. The report types provided by SAMreport are: • Usage Over Time – a line graph that shows the maximum number of licenses in use over a period of time.

  • Page 64: Installing The Java Runtime Environment

    Using SAMreport Installing the Java Runtime Environment Before you install SAMreport, you may need to install the Java Runtime Environment (JRE), specific to your platform. Refer to your platform documentation or web site for more details. To install the JRE, follow the instructions that come with the program. Installing SAMreport To install SAMreport as a new installation: Run the SAMreport installer, located in the samreport directory on the...
  • Page 65 If the install program cannot use the JRE, install the JRE that is supplied with the SAMreport installation program. The Welcome screen displays. Click Next. Choose an installation location. Sybase recommends that you install SAMreport in $SYBASE/SYSAM-2_0/samreport. SAMreport is installed in a v3.6 directory under the specified directory. A symbolic link to a directory named current is created in the installation directory in the v3.6...

  • Page 66: Post-Installation Tasks For Samreport

    Using SAMreport Post-installation tasks for SAMreport Set the following environment variable before launching SAMreport. Perform the following task, each time you start SAMreport. SAMreport may not launch without this variable defined. Note From a C or a Bourne Shell enter the following command, where platform name is “hp700_u11”...

  • Page 67: Managing And Collecting Logs

    Note automate collection of such logs, see Appendix A of the SAMreport User’s Guide. To access this guide, go to the Sybase Product Manuals Web site at Product Manuals at http://www.sybase.com/support/manuals/ Portions of the FLEXnet Licensing End User Guide and the SAMreport User’s Guide are included with permission of Macrovision Corporation.
  • Page 68 For more information, see Chapter 7 in the FLEXnet Licensing End-User Guide. The sysam script located in $SYBASE/SYSAM-2_0/bin provides a wrapper for the most frequently used FLEXlm utilities. To display the help text, which provides complete instructions, enter the following command in a Command...

  • Page 69: Index

    Index syntax statements creating accounts, creating sybase user response files Adaptive Server sybase user accounts 20, 21 for the Replication Server System Database custom installation 26, 30 upgrading administration tasks SySAM licenses alternate SySAM license locations automatically starting and stopping a network license...

  • Page 70: File

    Adaptive Server Enterprise 12.x (64-bit) directory installation directories warning about installing into contents existing installation directories existing Sybase installation log file installation methods console with response file files installation log response file log.txt 19, 37 silent SYBASE.csh...

  • Page 71: Managing And Collecting Logs

    Index license agreement OCS-15_0 subdirectory license files operating system licenses patch requirements acquiring SySAM during a grace period threads, increasing in HP-UX administration of SySAM operating systems borrowing SySAM to work offline requirements choosing appropriate SySAM license server options file installation. See response file installation installing a network license server overview managing SySAM...

  • Page 72: Server

    $SYBASE environment variable SAMreport Sybase installation directories installation contents post-installation tasks Sybase Product Download Center system requirements Sybase Software Asset Management System. See servers SySAM installing a network license server sybase user 20, 28 setting environment variables 26, 41 creating accounts...
  • Page 73 GUI mode renewing borrowed licenses Sybase products returning borrowed licenses unserved configuration, SySAM 3, 21 setting up a network license server setting up setting up a three-server redundancy configuration...
  • Page 74 Index flag and setup warnings installing into existing Adaptive Server Enterprise 12.x (64-bit) directory Replication Server...

This manual is also suitable for:

Replication server 15.0

Table of Contents