Sybase 15 manual

Inst allation Gu ide Replication Server ® 15.0 [ UNIX ][...]

DOCUMENT ID: DC32237 -01-150 0-03 LAST REVISED: November 2 006 Copyright © 19 92-2006 by Sybase, I nc. All righ ts reserved. This publicatio n pertai ns to Sybase sof tware and to any sub sequent relea se until othe rwise indica ted in new e ditions or technic al not es. Information in thi s document is subject to change wi thout noti ce. T he sof[...]

Content s Insta llation Gui de for UNIX iii About This B ook ................................................................................................................ ............ v CHAPTER 1 Before You Be gin .......................... ............. ............. ............. ........... 1 Introduction .....................................[...]

Contents iv Repli cation Serve r Review the log files .............. .......................................................... 39 Start Adaptive Server for the RSSD ............................................... 40 Start the sample Replication Server ............................................... 40 Set environment variables ....................[...]

Insta llation Gui de for UNIX v About This Book Audience This book is for Syst em Adminis trators and o ther quali fied ins tallers who are familiar with their system’ s environment, networks, disk resources, and media devices . How to use this book Before you instal l Rep licatio n Server ®, read Chapter 1, “Prep aring to Install and Configur[...]

vi Repli cation Ser ver • What’ s New in Replicatio n Server? – describes t he new features in Replicat ion S erv er ver sion 15.0 an d t he s yst em chan ges add ed t o s up por t those features. • Administration Guid e – cont ains an intr odu ction to replication sy stems. This manual includes information and gu idelines for creating an[...]

About This Book Insta llation Gui de for UNIX vii Other source s of information U se the Sybas e Getting S tart ed CD, the SyBo oks CD, and t he Sybase Pro duct Manuals W eb site to learn more about y our produ ct: • The Getting Started CD contains release bulletin s an d installation guides in PDF format, and may also contain other docu ment s o[...]

viii Repli cation Ser ver 2 Either s elect the pr oduct family an d product un der Search by Base Product; o r select the plat form and prod uct under Search by Platform. 3 Select Search to display the availability and certification report for the selection. ❖ Creating a p ersonalized view of the Syba se We b site (includ ing support pa g e s ) S[...]

About This Book Insta llation Gui de for UNIX ix Examples that show the u se of Replication Server co mmands are printed as follows: alter user louise set password hFE5t verify password hFE5t Command names , command opt ion names, pr ogram name s, program f lags, keyw ord s, c onf i gur a tio n p ar amet ers , fu ncti ons, and st or e d pr oc ed u [...]

x Repli cation Ser ver • Curly brace s and commas – choose o ne or more op tions. If you choose more than o ne, separate your cho ices with commas. {cash, check, credit} Optional choices • One item in square brackets – choo se it o r om it it. [anchovies] • Square brackets and vertical bars – ch oose none or on ly one. [beans | rice | s[...]

About This Book Insta llation Gui de for UNIX xi For information about how Sybase suppo rts access ibility , see Sybase Accessibilit y at http ://www .sybase .com/ac cessibility . The Sybase Accessibility site includes link s to info rmation on Section 508 and W3C standards . If you need help Each Sybase i nstallation that has pu rchased a support [...]

xii Repli cation Ser ver[...]

Insta llation Gui de for UNIX 1 CHAPTER 1 Before Y ou Begin This chapter p rovides information about system and licens ing requirements fo r installin g Replicatio n Server . It also discusses other pre-installation task s you must complete be fore you install Replication Server . Intr oduct ion This section describes the components of Re plic atio[...]

Sybase Software Asset Management 2 Repli cation Ser ver • The Replication Server Adm inistration tool, which co ns ists of: • Sybase Centr al version 4.3 • Replicat ion Manager plug-in (RM) t o Sybase Central • Replication Monitor ing Ser vi ces ( RMS) Inst allation task overview The Replication Server Inst allation Gu ide for UNIX explains[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 3 How SySAM works Replication Server uses SySAM to “check out” a license for prod uct functionality , then checks the license back in when the product is no longer in use. The basic Sy SAM components are: • Replication Server linked with S yS AM libraries • One or more local license f[...]

Sybase Software Asset Management 4 Repli cation Ser ver Setting up an unserved configuration During Replication Server installation , select the option to use a local license file. When yo u are activating licenses fro m the Syb ase Software Pro duct Download Ce nter (SP DC) at ht tps://sybase.s ubscribe net.com , select the “unserved” license [...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 5 Multiple users connect to the netwo rk licen se ser v er to obtain the required license. Y ou can activate several licenses at once, you have full control over license use, an d you hav e acces s to co mplete as se t man agement and repo rting capabilities. Y ou can use an ex isting network[...]

Sybase Software Asset Management 6 Repli cation Ser ver 2 Replication Server v ersion 15.0 uses a newer version of the Sy SAM licensing techn ology and an up dated license for mat. On any one mach ine, you can hav e only one instan ce of a license server run ning. Y o u must make some adjustmen ts to use earlier vers ions with Replication Server 1 [...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 7 set SYBASE_LICENSE_FILE=1700@tokyo;1700@chica go Replication Server attemp ts to use the first server in the list. If that fails for any reason, Replicatio n Serv er trie s to use the second server . Using three-server r edundancy T o achieve true high av ailability , you can set u p Replic[...]

Sybase Software Asset Management 8 Repli cation Ser ver Install the network license server on th e three selected machines and de ploy the license obtained on a ll three machines. See “Install ing a ne w li ce nse serv er” on page 22 for instruct ions. T o configure Replication Server to u se these redundant network servers, specify the address[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 9 3 Shut down the old license server and start the new license server . 4 Copy any n ew licenses int o this new di rectory . Old and new Sybase so ftware now use this license server . Case 2: If y ou are using individual license ser vers for earlier versions o f Replication Server , with each[...]

Sybase Software Asset Management 10 Repli cation Ser ver 3 Shut down the earlier ind ividual license servers on each mach ine and point the software to the new license s erver . Use the lmpath uti lity (see “ Usi ng SySAM utilities” on page 55) to do this , or edit the license.d at file on each installation by adding these lines at the beginnin[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 11 Some W indows and L inux machines u se technologi es such as “Hyper Threading” which presents o ne physical CPU as two logical CPUs. This is still considered one CPU for counting licenses. License availability and grace perio ds If Replication Serv er cannot obtain a suitable licens e,[...]

Sybase Software Asset Management 12 Repli cation Ser ver If Replication Server cannot obtain a license, SySAM evaluates whether the license can be issued u nder a grace per iod. The grace periods evalu ated are descr ibed in “License availability and grace pe riod s” on page 11. If a SySAM license cannot be acquired If the license cannot be iss[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 13 Replication Server contin ues to operate normally until the iss ue causin g the license failure is fix ed, or until the grace period exp ires. The error message indicates the date an d time the g race peri od is scheduled to end . The error log entry is repeated with increasing f requ e nc[...]

Pre-installation tas ks 14 Repli cation Ser ver Plan your replication sys tem The Replication Ser ver Configur ation Guide for U NIX provides th e necessary inform ation, includi ng an instal lation works heet and a dat abase setup worksheet to help you plan your replicatio n s ystem . Become f am iliar with Chapter 1, “Preparing to Install and C[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 15 If your op erating sy stem requi res pat ches, ins tall them bef ore you i nstall Replication Server componen ts. Note Do n ot use a pat ch that is ear lier than the version suggested f or y our operating sy stem. If a patch has been supers eded by a newer p atch, use the most recent one. [...]

Pre-installation tas ks 16 Repli cation Ser ver Configure the opera ting system for asynchronous I/O HP-UX onl y – T o optimize as ynchronous I /O and to prevent the pagi ng of shared mem ory , you must grant MLOCK pe rmissions b efore you ins tall Replication S erver . T o grant MLOCK p ermissions to a group , enter: /etc/privgrp add mlock <g[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 17 Y ou can install Replication Server 15.0 on top of Replication Serv er 12.6, in the same $SYBASE director y . Installing 15.0 on to p of Replicati on Server 12. 6 will create a duplicate entry in the in terfaces file for SAMPLE_RS, which is the sample Replicatio n Server . rs_init wi ll wa[...]

Pre-installation tas ks 18 Repli cation Ser ver Shared compo nents are in stalled in subdirectories that are s eparate from component subd irectories. For example, the Replication Server subdirecto r y is $SYBASE/RE P-15_0 . However , Open Client is installed in $SYBASE/OCS-1 5_0 , and the Repl ication Manager plug-in for Sybase Cent ral, RMPlugi n[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 19 • log.txt – the log of the installat ion process . • OCS-15_ 0 – Open Client and Open Server files, including bin , config , devlib , include , lib , lib3p , samp le , sybhel p , and xappdef aults . • REP-15_0 – Replication Server 15.0 files, i ncluding ASA9, bin , certificates[...]

Pre-installation tas ks 20 Repli cation Ser ver • HP-UX – SHLI B_P A TH • IBM AIX – LIBP A TH Set the environment variable as follows: $SYBASE/$SYBASE_OCS/lib If you d o not set th is environmen t variable, dse dit does not start, and an error message repor ts that a shared library ca nnot be foun d. All librar ies needed to run ds edit are[...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 21 T o create a Sybase System Administra tor account, choose an existing account, or create a new account and assign a user ID, group ID, and password f or it. This account is s ometimes called the “sybas e” user account. See y our operating system documentation for instructi ons on creat[...]

Pre-installation tas ks 22 Repli cation Ser ver Before you install Repl icatio n Server , decide which SySAM configuration to use: • Uns er ve d mo de l usin g uns erv ed lice nse s • Network license server using Served licenses If you ar e go ing to us e a n etwork licen se serv er , decide whether to us e an existing license server or a n ew [...]

CHAPTER 1 Before You Begin Insta llation Gui de for UNIX 23 2 Launch the Sybase installe r pro gram by enteri ng : ./setup 3 The W elcome W indow displays . Click Next . 4 Accept the license agreement. 5 Enter or select the destination directo ry . 6 Select the custom installation. 7 Select only SySAM Network Li cense Server fo r installation. 8 Un[...]

Pre-installation tas ks 24 Repli cation Ser ver The administrato r can add new memb ers to the Sybase Pr oduct Download Center accoun t at any time. b Select the product for which to activate licenses. c Complete the Licens e Activation wizard to gener ate required licenses. The gener ated licenses are displayed when the wizard completes. d Click S[...]

Insta llation Gui de for UNIX 25 CHAPTER 2 Inst alli ng Replication Server This chapter de scribes how t o install the Repl ication Server software from a CD using InstallShiel d. Note When you have compl eted the installation in structions in this chapter , retur n to the Replication S erver Configuratio n Guide for UN IX to begin cu stomizin g yo[...]

Using InstallShiel d for installation 26 Repli cation Ser ver • Install all R eplication Serv er components. Y ou can cho ose the ins tallation option t hat work s bes t for you: • T ypical (default) – instal ls th e Replication Server components considered to be useful for most customers. In this typ e of installation, only the U.S. Engl ish[...]

CHAPTER 2 Installing Replication Server Insta llation Gui de for UNIX 27 Inst alling Replication Server Follow the proced ures in this sectio n to install Replicatio n Server components. ❖ Inst alling Replica tion Server component s 1 Choose on e of the follo wing inst allation m odes: • Graphical user interface ( GUI) – lets you ins tall the[...]

Installing Replic ation Server 28 Repli cation Ser ver The operating system mounts the CD automatically . If you get CD-reading erro rs , check you r oper ating system ker nel to make sure the ISO 9660 opti on is turned on. Note If yo ur CD shows up as anything other th an sybasecd , it means you previ ously inst alled a Syba se CD on your system. [...]

CHAPTER 2 Installing Replication Server Insta llation Gui de for UNIX 29 cd / device_name ./setup -is:javahome JVM •H P - U X : cd / cdrom ./setup •S o l a r i s : cd / cdrom /rs150solaris ./setup 2 Y ou might see the follo wing error message: Error writing file = There may not be enough temporary disk space. Try using -is:tempdir to use a temp[...]

Installing Replic ation Server 30 Repli cation Ser ver will be replaced. Do you want to co ntinue with installation into this directory? Click Y es if you wish to inst all on top of the previo us ins tallatio n. If the products were previously installed with: • S tudio Installer (for example, if yo u installed a version of Replication Server earl[...]

CHAPTER 2 Installing Replication Server Insta llation Gui de for UNIX 31 next to continue the wizard. 12 The SySAM Li cense Server w indow opens and displ ays this pro mpt: Will licenses be obtained from the License Se rver? • Select Y es if you hav e a preexisting SySAM network license s erver installed or install ed a new licens e server us ing[...]

Installing Replic ation Server 32 Repli cation Ser ver • Y es – to configure and start a sample Replication Server . InstallShield displays the con figuration inform ation for the sample Repl ication Server . W rite this informatio n down . • No – to comp lete the installation and conf igure a fully-featur ed Replicat ion Serv er manually .[...]

CHAPTER 2 Installing Replication Server Insta llation Gui de for UNIX 33 ❖ Inst alling in console mo de The steps for in stalling comp onents in an interactiv e text mode ar e the same as those de scribed in “Installing in GUI m ode” on pag e 28, except t hat you execute InstallShield from the command line using the setup -c onsole command, a[...]

Installing Replic ation Server 34 Repli cation Ser ver Inst alli ng with a respons e file Y o u can ins tall Replicati on Server usi ng a resp onse file in combinatio n with a console or s ilent installation. Y o u must first create the respon se file. Note Y ou must p rovide the absolute path n ame for the respon se file you create. T o create a r[...]

CHAPTER 2 Installing Replication Server Insta llation Gui de for UNIX 35 Do not us e special characters for the p a th name, such as blanks or per iods. 2 Specify the setup typ e, where installation _type specifies the type of installation (Fu ll, T ypical, or Cu sto m): -W setupTypes.selectedSetupTypeId= installatio n_type If you specify either th[...]

Installing Replic ation Server 36 Repli cation Ser ver ./setup -console -options REP.respo nse -W SybaseLicense.agreeToLicense=true • IBM AIX: ./setup -console -options REP.respo nse -is:javahome JVM -W SybaseLicense.agreeToLicense=true Where: • REP .response – is the name o f the file contain in g the installati on options you chose. • -[...]

CHAPTER 2 Installing Replication Server Insta llation Gui de for UNIX 37 The -is:log parameter creates an ERROR.log log file, and the -is:javaconsole parameter causes errors to b e written to the screen. Note If you encounter errors d uring installation, ch eck the installation l og file to see a record of the installatio n pr ocess. The log file i[...]

Uninstalling Sybase products 38 Repli cation Ser ver 3 Select the p roduct you wan t to remove from the list, th en click Next. 4 V erify the summary information, then click Next. The uninstaller removes the files associated w ith the software. 5 Cli ck Finish . Note Y ou may be prompt ed to decide w hether to remove s hared files. Sybase recommend[...]

Insta llation Gui de for UNIX 39 CHAPTER 3 Post-Inst allation T asks This chapter describ es the post-in stallation ta sks that yo u need to perform after installing the Rep licati on Server softwar e. For more information, see the Replication Server C onfiguration Guide for UNIX . Review the log file s Information ab out the configur ation of Repl[...]

Start Adaptive Server for the RSSD 40 Repli cation Ser ver S t art Adaptive Server for the RSSD T o use the RSSD stored on Adaptive Se rver Enterprise, install the Adaptive Server En terprise datab ase, if yo u have not do ne so already . For install ation instructions, see the Adaptive Server Ente rp rise Installatio n Guide for your plat for m. A[...]

CHAPTER 3 Post-Installation Tasks Insta llation Gui de for UNIX 41 • xxx – is the numb er of that instance of th e log on that day . The sample Replication Se rver is configured using the SAMPLE_RS.r es resource file. All files and logs associated with the sample Replication Server are in the directory $SYBAS E/REP-15 _0/samp_r epserver . T abl[...]

Set environment variables 42 Repli cation Ser ver •U s e t h e sourc e command to source SYB ASE. sh or SYB ASE.c sh and update the compon ent’ s RUN env ironment immediately for you r current session, befor e invoking any component , or • Modify the com ponent’ s RUN environment permanen tly using the environmen t variable values from the [...]

Insta llation Gui de for UNIX 43 APPENDIX A SySAM Administration Replicat ion Server uses Sybase S oftware Asset Managemen t (SySAM) to perf o rm li c ense admi nis tra t i o n an d asse t ma na gem ent task s. Managing licens es The Sybase P roduct Downl oad Center i s an where you ob tain license key s to enable Sybase software. When you purchase[...]

Managing licenses 44 Repli cation Ser ver • If you are going to use a network license server , you need the host ID of the machin e where th e license ser ver will ru n. T o obtain a host ID, go t o $SYBASE/SY SAM-2_0/ bin and execu te: ./lmutil lmhostid Note If yo u want to obtain t he hostid before installi ng Replication Server, the lmut il ex[...]

APPENDIX A SySAM Admi nistration Insta llation Gui de for UNIX 45 • Obtain updat ed licenses aft er renewin g support. Note When you renew yo ur softwar e support with Sybase, the SySAM licenses are updated with th e new support date. Downlo ad updated licenses f rom the Sybase P roduct Downlo ad Center afte r renewing support. The designated sup[...]

Starting and stopping network license servers 46 Repli cation Ser ver S t arting and stopping network licens e servers ❖ Manuall y st arting SySAM servers 1G o t o $SYBA SE/ SYS AM-2_ 0/ bin . 2 Execute: sysam start ❖ Manuall y stopping a SySAM server 1 In a Comm and Prompt w indow , go to $SYB ASE/SYSAM-2 _0/bin . 2E n t e r : sysam stop ❖ S[...]

APPENDIX A SySAM Admi nistration Insta llation Gui de for UNIX 47 >> $SYSAM/log/boot.log" ;; *) echo "Usage: $0 { start | stop }" exit 1 ;; esac exit 0 3 Save the script to the file name appropriate f or your operating system. Sol aris: /etc/init.d/sysam.boot IBM AIX: /etc/rc.d/init.d/sysam.boot HP-UX: /sbin/init.d/sysam.boot 4[...]

Borrowing a license to work offline 48 Repli cation Ser ver 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 s uch that it is lower than that of s ubsystems req uired by Sy SAM such as networking se rvices and higher than the[...]

APPENDIX A SySAM Admi nistration Insta llation Gui de for UNIX 49 3E n t e r : ./lmutil lmborrow SYBASE enddate [ time ] where enda te [time] is th e des ir e d bor row end da te. Note Ru n lm borrow from the same machine on which licenses are being borrowed, and from the same us er that starts Replication Server . For example, th e following comma[...]

Enabling the network licens e server REPORTLOG file 50 Repli cation Ser ver 3 Return the curren tly borrowed license if the lease has not expire d. 4 Execute the steps to borrow licenses with a new lease en d date. See Chapter 8, “ Mobile Licensing,” an d Chap ter 7, “L i cen se Ad mini s tr a tio n T ools,” in the FLEXnet Licensing End Use[...]

APPENDIX A SySAM Admi nistration Insta llation Gui de for UNIX 51 The SAMreport install program is on th e Replication Server installation media in the /samr eport dir ectory . Note The recommended $SAM r epor t_ home location is $SYBASE/ SYSAM-2_0/ samr eport . The repor t types provi ded by SAMrepo rt are: • Usage Over T ime – a line graph th[...]

Using SAMreport 52 Repli cation Ser ver Inst alling the Java Runtim e Environment Before you instal l SAMreport, you may need to install t he Java R untime Enviro nment (JRE), specific to y our platfor m. Refer to you r platform docu men t atio n or web s ite f or m ore de ta ils. T o install the JRE, follow the instructions that co me with the pro[...]

APPENDIX A SySAM Admi nistration Insta llation Gui de for UNIX 53 HP-UX: samrep ort- 3_6-hp 700_u1 1.bin -i s:java home JRE dire ctor y Sol aris: samrep ort- 3_6-su n4_u5. bin -is: javaho me JRE di rect ory IBM AIX: samrep ort- 3_6-pp c_u4.b in -is :javah ome JR E direct ory In the above ex amples, the JRE direct ory is the JRE direct ory that was [...]

Using SAMreport 54 Repli cation Ser ver Post-inst allation tasks for SAMreport Set the f ollowing envi ronment vari able befor e launching S AMreport. Perf orm the following task, each time yo u start SAMreport. Note SAMrepo rt may not lau nch without th is variable def ined. From a C or a Bourn e Shell ente r the following command , where platfor [...]

APPENDIX A SySAM Admi nistration Insta llation Gui de for UNIX 55 Managing and collec ting logs SAMreport mus t access repor t logs on the SySAM license server on which you want the report. If you are using an uns erved license, the report log f iles must be on the local machin e. If you are using a n etwork license server , the report log files mu[...]

Using SySAM utilities 56 Repli cation Ser ver • lmswitchr – swi tches the report log to a new file name. • lmver – reports the F LEXnet licensing version of a library or bi nary file. For more information, see Chapter 7 in th e FLEXnet L icensing En d-User Guide . The sysam script located in $SYBAS E/SYSAM-2_ 0/bin provides a wrapper for th[...]

Inst allation G uide for UNIX 57 A account s, cre ating sy base user 20 Adap tiv e Se rver for the Replication Serv er Sy stem Data ba s e 40 upgrad ing 40 administration task s 20 SySAM l i censes 46 alternate SySAM lic ense locations 8 automa tic ally sta rtin g an d stop pin g a networ k licen se server 46 B borrowi ng Sy SAM lic ense s 48 C cha[...]

Index 58 Replicatio n Server $SCROOT 42 $SYBROOT 42 $SYBAS E_SYSAM 42 $SYBASE_ UA 42 table of 42 examples style conven tions ix existing Adaptive Server En terprise 12.x (64-bit) directory warning a bout installin g into 25 existing insta lla ti on directo rie s 29 F files installatio n log 37 log. txt 19, 37 SYBAS E.csh 19, 26 , 41 SYB ASE.env 19,[...]

Index Inst allation G uide for UNIX 59 L li ce n s e agre emen t 29 li ce n s e file s 3 li cens es acquiri ng SySAM during a grace per i od 12 admi nistratio n of Sy SAM 46 borr owing Sy SAM to wo rk off line 48 choosing ap prop riate SySAM l icense serve r 21 installing a network license server 22 mana ging S ySAM 43 renewin g borr owe d 49 retur[...]

Index 60 Replicatio n Server operat i ng system pa tc hes 14 system 14 resetting en viro nment var i ables 26 response files creating 34 editin g 34 installatio ns 27, 34 returni ng bo rrowed Sy SAM li cense s 4 9 reviewing log files a fter installing 39 RMP- 15_ 0 subdirec tory 19 RMS plu g-i n subdir e c tory 19 S SAMr epor t installatio n 52 pos[...]

Index Inst allation G uide for UNIX 61 configur atio n optio ns 3 descript ion 2 enabling the network li cense server REPORT LOG file 50 installing a network license server 22 licens e availability and grace p eriods 11 lice n se dire cto r y 3 li ce n s es fi le s 3 licenses usag e and enfo rceme nt 10 licensi ng i nst ruc t ion ov ervie w 2 mana [...]

Index 62 Replicatio n Server W -W flag and se tu p 36 warnings installi ng into existin g Adapt ive Server En terprise 12 .x (64-b i t) dir e ctor y 25[...]