Installation Guide Replication Server® 15.
DOCUMENT ID: DC32237-01-1500-03 LAST REVISED: November 2006 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. To order additional documents, U.S.
Contents About This Book ............................................................................................................................ v CHAPTER 1 Before You Begin ............................................................................ 1 Introduction ...................................................................................... 1 Replication Server components ................................................ 1 Installation task overview .........................................
Contents Review the log files ........................................................................ Start Adaptive Server for the RSSD ............................................... Start the sample Replication Server............................................... Set environment variables.............................................................. AP PE ND IX A 39 40 40 41 SySAM Administration .................................................................. 43 Managing licenses .................
About This Book Audience This book is for System Administrators and other qualified installers who are familiar with their system’s environment, networks, disk resources, and media devices. How to use this book Before you install Replication Server®, read Chapter 1, “Preparing to Install and Configure Replication Server” in the Replication Server Configuration Guide for UNIX to help you plan your installation. However, the step is unnecessary if you plan to install a sample Replication Server.
vi • What’s New in Replication Server? – describes the new features in Replication Server version 15.0 and the system changes added to support those features. • Administration Guide – contains an introduction to replication systems. This manual includes information and guidelines for creating and managing a replication system, setting up security, recovering from system failures, and improving performance.
About This Book Other sources of information Use the Sybase Getting Started CD, the SyBooks CD, and the Sybase Product 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. It is included with your software.
❖ 2 Either select the product family and product under Search by Base Product; or select the platform and product under Search by Platform. 3 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. 1 Point your Web browser to Technical Documents at http://www.sybase.
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: • Use alter user to change the password for a login name.
• 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] • Square brackets and vertical bars – choose none or only one. [beans | rice | sweet_potatoes] • Square brackets and commas – choose none, one, or more options. If you choose more than one, separate your choices with commas.
About This Book For information about how Sybase supports accessibility, see Sybase Accessibility at http://www.sybase.com/accessibility. The Sybase Accessibility site includes links to information on Section 508 and W3C standards. If you need help Installation Guide for UNIX Each Sybase installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support.
xii Replication Server
CH A PTE R 1 Before You Begin This chapter provides information about system and licensing requirements for installing Replication Server. It also discusses other pre-installation tasks you must complete before you install Replication Server. Topic Introduction Page 1 Sybase Software Asset Management Pre-installation tasks 2 13 Introduction This section describes the components of Replication Server and provides an overview of the tasks involved in installing and setting up Replication Server.
Sybase Software Asset Management • • The Replication Server Administration tool, which consists of: • Sybase Central version 4.3 • Replication Manager plug-in (RM) to Sybase Central Replication Monitoring Services (RMS) Installation task overview The Replication Server Installation Guide for UNIX explains how to unload the Replication Server software from the distribution media to your hard disk.
CHAPTER 1 Before You Begin How SySAM works Replication Server uses SySAM to “check out” a license for product functionality, then checks the license back in when the product is no longer in use. The basic SySAM components are: • Replication Server linked with SySAM libraries • One or more local license files • Optionally, a SySAM network license server When you install the product, you select whether to configure an unserved license or a network license server.
Sybase Software Asset Management Setting up an unserved configuration During Replication Server installation, select the option to use a local license file. When you are activating licenses from the Sybase Software Product Download Center (SPDC) at https://sybase.subscribenet.com, select the “unserved” license format and save the license in the local license directory $SYBASE/SYSAM-2_0/licenses.
CHAPTER 1 Before You Begin Multiple users connect to the network license server to obtain the required license. You can activate several licenses at once, you have full control over license use, and you have access to complete asset management and reporting capabilities. You can use an existing network license server or install a new one. You can install network license server on the same host with Replication Server, or as a standalone system.
Sybase Software Asset Management 2 Replication Server version 15.0 uses a newer version of the SySAM licensing technology and an updated license format. 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.
CHAPTER 1 Before You Begin set SYBASE_LICENSE_FILE=1700@tokyo;1700@chicago Replication Server attempts to use the first server in the list. If that fails for any reason, Replication Server tries to use the second server. Using three-server redundancy To achieve true high availability, you can set up Replication Server to acquire a license that is used in a three-server redundant configuration. The same license is served by all three license servers.
Sybase Software Asset Management Install the network license server on the three selected machines and deploy the license obtained on all three machines. See “Installing a new license server” on page 22 for instructions. To configure Replication Server to use these redundant network servers, specify the addresses for three servers in SYBASE_LICENSE_FILE environment variable as port@host separated by a semicolon.
CHAPTER 1 Before You Begin 3 Shut down the old license server and start the new license server. 4 Copy any new licenses into this new directory. Old and new Sybase software now use this license server. Case 2: If you are using individual license servers for earlier versions of 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.
Sybase Software Asset Management 3 Shut down the earlier individual license servers on each machine and point the software to the new license server. Use the lmpath utility (see “Using 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 ANY VENDOR SYBASE USE_SERVER If you are not using the network license server for Replication Server version 15.
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.
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.
CHAPTER 1 Before You Begin Replication Server continues to operate normally until the issue causing the license failure is fixed, or until the grace period expires. The error message indicates the date and time the grace period is scheduled to end. The error log entry is repeated with increasing frequency while Replication Server operates in the grace period until you fix the issue causing the license failure.
Pre-installation tasks Plan your replication system The Replication Server Configuration Guide for UNIX provides the necessary information, including an installation worksheet and a database setup worksheet to help you plan your replication system. Become familiar with Chapter 1, “Preparing to Install and Configure Replication Server” and the requirements of your replication system before continuing with the installation.
CHAPTER 1 Before You Begin If your operating system requires patches, install them before you install Replication Server components. Note Do not use a patch that is earlier than the version suggested for your operating system. If a patch has been superseded by a newer patch, use the most recent one. Solaris: To list all currently installed patches and display the operating system version level, enter: showrev -p Increase operating system threads HP-UX only – Beginning with version 12.
Pre-installation tasks Configure the operating system for asynchronous I/O HP-UX only – To optimize asynchronous I/O and to prevent the paging of shared memory, you must grant MLOCK permissions before you install Replication Server.
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. rs_init will warn you about the duplicate entry and will use the first instance of SAMPLE_RS found in the interfaces file. Warning! Do not install Replication Server version 15.
Pre-installation tasks Shared components are installed in subdirectories that are separate from component subdirectories. For example, the Replication Server subdirectory is $SYBASE/REP-15_0. However, Open Client is installed in $SYBASE/OCS-15_0, and the Replication Manager plug-in for Sybase Central, RMPlugin.jar and its associated files are installed in $SYBASE/RMP-15_0.
CHAPTER 1 Before You Begin • log.txt – the log of the installation process. • 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. • SYBASE.csh, SYBASE.sh, SYBASE.env – files created by InstallShield that you use to reset environment variables.
Pre-installation tasks • HP-UX – SHLIB_PATH • IBM AIX – LIBPATH Set the environment variable as follows: $SYBASE/$SYBASE_OCS/lib If you do not set this environment variable, dsedit does not start, and an error message reports that a shared library cannot be found. All libraries needed to run dsedit are in the $SYBASE/$SYBASE_OCS/lib directory. Use the SYBASE.csh and SYBASE.sh files to set this environment variable. See “Set environment variables” on page 41 for more information.
CHAPTER 1 Before You Begin 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. If you have already installed other Sybase software, the “sybase” user probably already exists. Verify that you can log in to the machine using this account.
Pre-installation tasks Before you install Replication Server, decide which SySAM configuration to use: • Unserved model using unserved licenses • Network license server using Served licenses If you are going to use a network license server, decide whether to use an existing license server or a new license server. • If you use an existing license server, you must know the server host name and port number.
CHAPTER 1 2 Before You Begin Launch the Sybase installer program by entering: ./setup 3 The Welcome Window displays. Click Next. 4 Accept the license agreement. 5 Enter or select the destination directory. 6 Select the custom installation. 7 Select only SySAM Network License Server for installation. 8 Unselect other components, to install the Net License Server only. 9 Click OK for the installer to install SySAM licensing tools.
Pre-installation tasks The administrator can add new members to the Sybase Product Download Center account at any time. b Select the product for which to activate licenses. c Complete the License Activation wizard to generate required licenses. The generated licenses are displayed when the wizard completes. d Click Save All to save the license file. Make sure you have saved the license file with the extension .lic.
CH A PTE R 2 Installing Replication Server This chapter describes how to install the Replication Server software from a CD using InstallShield. Topic Using InstallShield for installation Page 25 Installing Replication Server Uninstalling Sybase products 27 37 Note When you have completed the installation instructions in this chapter, return to the Replication Server Configuration Guide for UNIX to begin customizing your newly installed Replication Server.
Using InstallShield for installation • Install all Replication Server components. You can choose the installation option that works best for you: • Typical (default) – installs the Replication Server components considered to be useful for most customers. In this type of installation, only the U.S. English language module and its supported character sets are installed. The components that will be installed and the total disk space required display prior to installation.
CHAPTER 2 Installing Replication Server Installing Replication Server Follow the procedures in this section to install Replication Server components. ❖ Installing Replication Server components 1 Choose one of the following installation modes: • Graphical user interface (GUI) – lets you install the components using the InstallShield interface. • Console – lets you install components in a command line environment. • Response file – lets you record or create a response file.
Installing Replication Server The operating system mounts the CD automatically. If you get CD-reading errors, check your operating system kernel to make sure the ISO 9660 option is turned on. Note If your CD shows up as anything other than sybasecd, it means you previously installed a Sybase CD on your system. Perform either of these two options to install your current CD: • • Restart your system. • Delete the sybasecd file in /vol/dsk. HP-UX: a Log out. b Log in as “root.
CHAPTER 2 Installing Replication Server cd /device_name ./setup -is:javahome JVM • HP-UX: cd /cdrom ./setup • Solaris: cd /cdrom/rs150solaris ./setup 2 You might see the following error message: Error writing file = There may not be enough temporary disk space. Try using -is:tempdir to use a temporary directory on a partition with more disk space.
Installing Replication Server will be replaced. Do you want to continue with installation into this directory? Click Yes if you wish to install on top of the previous installation. If the products were previously installed with: 9 • Studio Installer (for example, if you installed a version of Replication Server earlier than 12.6 or a version of Adaptive Server earlier than 12.5.1), InstallShield overwrites common components.
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” on page 22. Enter the host name and the port number of the license server.
Installing Replication Server • Yes – to configure and start a sample Replication Server. InstallShield displays the configuration information for the sample Replication Server. Write this information down. • No – to complete the installation and configure a fully-featured Replication Server manually. If you select No, you can configure and start a sample Replication Server after installation. See “Start the sample Replication Server” on page 40 for more information. 15 Click Next.
CHAPTER 2 ❖ Installing Replication Server Installing in console mode The steps for installing components in an interactive text mode are the same as those described in “Installing in GUI mode” on page 28, except that you execute InstallShield from the command line using the setup -console command, and you enter text to select installation options. 1 At the command line, enter: • HP-UX and Solaris: ./setup -console • IBM AIX: .
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. Note You must provide the absolute path name for the response file you create. To create a response file, do one of the following at the command line: • Enter the following command, where REP.response is name you choose for the response file: • HP-UX and Solaris: .
CHAPTER 2 Installing Replication Server Do not use special characters for the path name, such as blanks or periods. 2 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; these features have been predefined as installed.
Installing Replication Server ./setup -console -options REP.response -W\ SybaseLicense.agreeToLicense=true • IBM AIX: ./setup -console -options REP.response -is:javahome JVM\ -W SybaseLicense.agreeToLicense=true Where: • • REP.response – is the name of the file containing the installation options you chose. -W SybaseLicense.agreeToLicense=true – specifies that you agree with the Sybase License Agreement text. Checking for a valid installation 1 View the $SYBASE/log.txt file and check for errors.
CHAPTER 2 Installing Replication Server The -is:log parameter creates an ERROR.log log file, and the -is:javaconsole parameter causes errors to be written to the screen. Note If you encounter errors during installation, check the installation log file to see a record of the installation process. 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.
Uninstalling Sybase products 3 Select the product you want to remove from the list, then click Next. 4 Verify the summary information, then click Next. The uninstaller removes the files associated with the software. 5 Click Finish. Note You may be prompted to decide whether to remove shared files. Sybase recommends that you do not remove shared files.
CH A PTE R 3 Post-Installation Tasks This chapter describes the post-installation tasks that you need to perform after installing the Replication Server software. For more information, see the Replication Server Configuration Guide for UNIX.
Start Adaptive Server for the RSSD Start Adaptive Server for the RSSD To use the RSSD stored on Adaptive Server Enterprise, install the Adaptive Server Enterprise database, if you have not done so already. For installation instructions, see the Adaptive Server Enterprise Installation Guide for your platform. After successful installation, start Adaptive Server Enterprise.
CHAPTER 3 • Post-Installation Tasks xxx – is the number of that instance of the log on that day. The sample Replication Server is configured using the SAMPLE_RS.res resource file. All files and logs associated with the sample Replication Server are in the directory $SYBASE/REP-15_0/samp_repserver. Table 3-1 contains the sample Replication Server configuration information. Keep this information in a safe place for later reference.
Set environment variables • Use the source command to source SYBASE.sh or SYBASE.csh and update the component’s RUN environment immediately for your current session, before invoking any component, or • Modify the component’s RUN environment permanently using the environment variable values from the shell files. Table 3-2 describes the environment variables.
A P PE N DI X A SySAM Administration Replication Server uses Sybase Software Asset Management (SySAM) to perform license administration and asset management tasks. Topic Managing licenses Starting and stopping network license servers Page 43 46 Borrowing a license to work offline Enabling the network license server REPORTLOG file 48 50 Using SAMreport Using SySAM utilities 50 55 Managing licenses The Sybase Product Download Center is an where you obtain license keys to enable Sybase software.
Managing licenses • If you are going to use a network license server, you need the host ID of the machine where the license server will run. To obtain a host ID, go to $SYBASE/SYSAM-2_0/bin and execute: ./lmutil lmhostid Note If you want to obtain the hostid before installing Replication Server, the lmutil executable binary is available as a standalone download from the Sybase Product Download Center. • The host name for the network license server if you are using a license server.
APPENDIX A • SySAM Administration Obtain updated licenses after renewing support. Note When you renew your software support with Sybase, the SySAM licenses are updated with the new support date. Download updated licenses from the Sybase Product Download Center after renewing support. The designated support contact receives an e-mail message when a support renewal is processed. The support date is checked when you install Replication Server to verify your support is current when the update is posted.
Starting and stopping network license servers Starting and stopping network license servers ❖ Manually starting SySAM servers 1 Go to $SYBASE/SYSAM-2_0/bin. 2 Execute: sysam start ❖ Manually stopping a SySAM server 1 In a Command Prompt window, go to $SYBASE/SYSAM-2_0/bin.
APPENDIX A SySAM Administration >> $SYSAM/log/boot.log" ;; *) echo "Usage: $0 { start | stop }" exit 1 ;; esac exit 0 3 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 4 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 chown root /etc/init.d/sysam.
Borrowing a license to work offline IBM AIX: ln -s /etc/rc.d/init.d/sysam.boot /etc/rc.d/rc2.d/K02sysam HP-UX: ln -s /sbin/init.d/sysam.boot /sbin/rc2.d/K002sysam Note The run number (2 above) should be chosen such that it is lower than that of subsystems required by SySAM such as networking services and higher than the run number of applications that require SySAM such as Adaptive Server Enterprise.
APPENDIX A 3 SySAM Administration Enter: ./lmutil lmborrow SYBASE enddate [ time ] where endate [time] is the desired borrow end date. Note Run lmborrow from the same machine on which licenses are being borrowed, and from the same user that starts Replication Server. For example, the following command sets the end date at 1 p.m. on August 20th, 2005: lmutil lmborrow SYBASE 20-aug-2005 13:00 The maximum borrow time is 30 days.
Enabling the network license server REPORTLOG file 3 Return the currently borrowed license if the lease has not expired. 4 Execute the steps to borrow licenses with a new lease end date. See Chapter 8, “Mobile Licensing,” and Chapter 7, “License Administration Tools,” in the FLEXnet Licensing End User Guide for more details. Enabling the network license server REPORTLOG file The network license server can produce a REPORTLOG file that records license use.
APPENDIX A SySAM Administration The SAMreport install program is on the Replication Server installation media in the /samreport directory. Note The recommended $SAMreport_home location is $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. • High Water Mark – a line graph that shows the maximum number of licenses used during the specified time period.
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: 1 Run the SAMreport installer, located in the samreport directory on the Replication Server version 15.0 installation media.
APPENDIX A SySAM Administration HP-UX: samreport-3_6-hp700_u11.bin -is:javahome JRE directory Solaris: samreport-3_6-sun4_u5.bin -is:javahome JRE directory IBM AIX: samreport-3_6-ppc_u4.bin -is:javahome JRE directory In the above examples, the JRE directory is the JRE directory that was installed in “Installing the Java Runtime Environment” on page 52. If the install program cannot use the JRE, install the JRE that is supplied with the SAMreport installation program. 4 The Welcome screen displays.
Using SAMreport Post-installation tasks for SAMreport Set the following environment variable before launching SAMreport. Perform the following task, each time you start SAMreport. Note SAMreport may not launch without this variable defined. From a C or a Bourne Shell enter the following command, where platform name is “hp700_u11” for HP-UX, “sun4_u5” for Solaris and “ppc_u4” for IBM AIX.
APPENDIX A SySAM Administration Managing and collecting logs SAMreport must access report logs on the SySAM license server on which you want the report. If you are using an unserved license, the report log files must be on the local machine. If you are using a network license server, the report log files must be accessible via a network-mounted server.
Using SySAM utilities • lmswitchr – switches the report log to a new file name. • lmver – reports the FLEXnet licensing version of a library or binary file. 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.
Index A accounts, creating sybase user 20 Adaptive Server for the Replication Server System Database 40 upgrading 40 administration tasks 20 SySAM licenses 46 alternate SySAM license locations 8 automatically starting and stopping a network license server 46 B borrowing SySAM licenses 48 C charsets subdirectory 18 checking for a valid installation 36 check-out options, SySAM 3 choosing appropriate SySAM license server 21 collate subdirectory 18 command line installation mode 33 commands source 42 comple
Index $SCROOT 42 $SYBROOT 42 $SYBASE_SYSAM 42 $SYBASE_UA 42 table of 42 examples style conventions ix existing Adaptive Server Enterprise 12.x (64-bit) directory warning about installing into 25 existing installation directories 29 F files installation log 37 log.txt 19, 37 SYBASE.csh 19, 26, 41 SYBASE.env 19, 41 SYBASE.sh 19, 26, 41 SySAM licenses 3 vpd.
Index L O license agreement 29 license files 3 licenses acquiring SySAM during a grace period 12 administration of SySAM 46 borrowing SySAM to work offline 48 choosing appropriate SySAM license server 21 installing a network license server 22 managing SySAM 43 renewing borrowed 49 returning borrowed 49 usage and enforcement, SySAM 10 limitations network license server SySAM 5 $LM_LICENSE_FILE 42 LM_LICENSE_FILE environment variable 8 lmborrow 48 locales subdirectory 18 location geographic 29 mount comman
Index operating system patches 14 system 14 resetting environment variables 26 response files creating 34 editing 34 installations 27, 34 returning borrowed SySAM licenses 49 reviewing log files after installing 39 RMP-15_0 subdirectory 19 RMS plug-in subdirectory 19 S SAMreport installation 52 post-installation tasks 54 system requirements 51 servers installing a network license server 22 setting environment variables 26, 41 LD_LIBRARY_PATH 19 LIBPATH 20 SHLIB_PATH 20 setting up multiple server SySAM con
Index configuration options 3 description 2 enabling the network license server REPORTLOG file 50 installing a network license server 22 license availability and grace periods 11 license directory 3 licenses files 3 licenses usage and enforcement 10 licensing instruction overview 2 managing and collecting logs 55 managing licenses 43 managing licenses from multiple vendors 10 manually starting a network license server 46 manually stopping a network license server 46 migrating old licenses to a new central l
Index W -W flag and setup 36 warnings installing into existing Adaptive Server Enterprise 12.
