2.0 installation guide solaris™ os, hp-ux™, aix™ · since the bab stores changes made to the...

32
2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™

Upload: others

Post on 07-Nov-2019

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

2.0

Installation Guide

Solaris™ OS, HP-UX™, AIX™

Page 2: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate
Page 3: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

i

Preface Purpose

This manual explains the installation and configuration of Softek TDMF Open Systems Edition (referred to

as Softek TDMF henceforth) on Solaris™ operating system, HP-UX™ and AIX™.

Audience

This manual is targeted at system administrators responsible for managing and maintaining business

critical applications and their related data.

Organization

This manual is organized as follows:

• Chapter 1 Installation

This chapter describes the procedure for installing Softek TDMF.

• Chapter 2 Upgrade

This chapter describes the procedure for upgrading Softek TDMF.

• Chapter 3 Removing

This chapter describes the procedure for removing Softek TDMF.

Related Manuals

The set of manuals related to Softek TDMF are as follows:

• Softek TDMF Open Systems Edition Installation Guide (this manual)

This manual explains the process of installation and configuration of Softek TDMF.

• Softek TDMF Open Systems Edition Adminstrator Guide

This manual explains the process of disk mirroring during normal operations of Softek TDMF.

• Softek TDMF Open Systems Edition Messages Guide

This manual explains the messages of Softek TDMF.

A Note Regarding Descriptions

• Softek TDMF Open Systems Edition is referred to as Softek TDMF.

• The symbol NOTE is used to describe items related to actual working of the system, points to note,

actions not to be taken and items which are strongly recommended for smooth operations.

Trademarks

• Solaris, Sun, Sun Microsystems, Java and all other items related to Java along with the logo are

registered trademarks of Sun Microsystems, inc. in the United States and other countries.

• HP-UX is a registered trademark of the Hewlett-Packard Company.

• AIX is a registered trademark of International Business Machines Corporation in the United States

and other countries.

• UNIX is a registered trademark exclusively licensed for X/Open Company Limited.

• All other mentioned services and/or products are registered trademarks of other companies as the

case maybe.

COPYRIGHT

Copyright (C) 2002-2005 FUJITSU LIMITED. All rights reserved.

Copyright (C) 2004-2005 Softek Storage Solutions Corporation. All rights reserved.

The information contained in this manual is the licensed property of FUJITSU LIMITED and Softek Storage

Solutions Corporation. Use of the information contained herein is restricted pursuant to the terms and

Page 4: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

ii

conditions of a license agreement.

Page 5: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

iii

Contents

Preface................................................................................................................................................. i 1 Installation ..................................................................................................................................1 1.1 System Requirements...........................................................................................................................1

1.1.1 Common Requirements for AIX, HP-UX and Solaris ................................................................................1 1.1.2 AIX System Requirements....................................................................................................................................1 1.1.3 HP-UX System Requirements ............................................................................................................................2 1.1.4 Solaris System Requirements .............................................................................................................................2

1.2 Recommended Operating Parameters ............................................................................................3 1.3 Preparing to Install for AIX, HP-UX, and Solaris ........................................................................4

1.3.1 Backing up the System ..........................................................................................................................................4 1.3.2 How to Size the System........................................................................................................................................4 1.3.3 How to Size the BAB..............................................................................................................................................4 1.3.4 How to size the Pstore ..........................................................................................................................................5 1.3.5 How to Size the Journal File Directories.......................................................................................................5

1.4 How to Install Softek TDMF on AIX ................................................................................................7 1.5 How to Install Softek TDMF on HP-UX.........................................................................................9 1.6 How to Install Softek TDMF on Solaris....................................................................................... 11 1.7 Licensing................................................................................................................................................. 13

1.7.1 Acquiring the Host ID Information.................................................................................................................. 13 1.7.2 Application for the License Key...................................................................................................................... 13 1.7.3 Setting the License Key ..................................................................................................................................... 13 1.7.4 Confirming the License Key .............................................................................................................................. 14

2 Upgrading Softek TDMF..................................................................................................... 15 2.1 How to Upgrade Softek TDMF on AIX......................................................................................... 15 2.2 How to Upgrade Softek TDMF on HP-UX ................................................................................. 16 2.3 How to Upgrade Softek TDMF on Solaris .................................................................................. 17

3 Removing Softek TDMF..................................................................................................... 19 3.1 How to Remove Softek TDMF on AIX......................................................................................... 19 3.2 How to Remove Softek TDMF on HP-UX.................................................................................. 21 3.3 How to Remove Softek TDMF on Solaris................................................................................... 23

Page 6: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate
Page 7: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

1

1 Installation

This document contains installation instructions for Softek TDMF, Open Systems Edition, on HP-UX,

Solaris, and AIX versions. Once you have installed or upgraded the software, refer to the Softek TDMF,

Open Systems Adminstrator’s Guide AIX, HP-UX, and Solaris, for information on starting and configuring

the software.

1.1 System Requirements Before installing Softek TDMF, verify the following conditions on all primary and secondary servers in

the company.

1.1.1 Common Requirements for AIX, HP-UX and Solaris

The following resources are required to install Softek TDMF on Unix systems.

One or more Primary systems. These will become the mirroring source.

One or more Secondary systems. These will become the mirroring target.

LAN or WAN IP network(s) between primary and secondary systems.

Local data devices(on primary).

Phsyical memory allocated exclusively to Softek TDMF for the Big Asynchronous Buffer(BAB)

(on primary).

Disk partition or volume for pstore (on primary)

Mirror devices (on secondary). The size of this device should be at least equal to the size of the

primary device.

Journal file directory (on secondary).

Softek TDMF supports up to 100 logical groups, and a total maximum of 500 dtc devices on a system.

An effective means of configuring an efficient system is to create logical groups based on business

applications.

NOTE In case of multiple logical groups configuration, the total number of dtc devices across all logical groups

should exceed 500. Again in case of an N:1 configuration, the total number of dtc devices across all systems

should exceed 500. (The number of devices on the secondary should exceed 500.)

NOTE The upper limit of 500 dtc devices is at best a logical limit. However if the number of devices were to exceed

100, then this could affect the performance of the monitoring tool or the performance of the mirroring

process. Hence it is important to grasp the practical limitations of the actual system being used before

setting up mirroring for normal operations.

1.1.2 AIX System Requirements

AIX 5.1(32bit/64bit) or AIX5.2(32bit/64bit) operating systems are installed. It is required that

you install the same operating system version on both primary and secondary systems.

On both the primary and secondary systems, free space of 25MB under /usr, 500KB under /etc

and 1MB under /var is required.

An X-windows environment – for example CDE – must be installed to use the dtcperftool,

dtcconfigtool and dtcmonitortool.

Enough physical memory available to be allocated exclusively to Softek TDMF for the BAB (32

MB or more) on the primary system.

Page 8: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

2

1.1.3 HP-UX System Requirements

HP-UX 11.0 or 11i operating systems are installed. It is required that you install the same

operating system version on both primary and secondary systems.

On both the primary and secondary systems, free space of 14.5MB under /opt, 500KB under

/etc/opt and 1MB under /var/opt is required.

An X-windows environment – for example CDE – must be installed to use the dtcperftool,

dtcconfigtool and dtcmonitortool.

Enough physical memory available to be allocated exclusively to Softek TDMF for the BAB (32

MB or more) on the primary system.

1.1.4 Solaris System Requirements

SPARC Solaris 7 or Solaris 8 or Solaris 9 operating systems are installed. It is required that you

install the same operating system version on both primary and secondary systems.

On both the primary and secondary systems, free space of 14.5MB under /opt, 500KB under

/etc/opt and 1MB under /var/opt is required.

An X-windows environment – for example OpenWindows, X11R6, CDE – must be installed to use

the dtcperftool, dtcconfigtool and dtcmonitortool.

Enough physical memory available to be allocated exclusively to Softek TDMF for the BAB (32

MB or more) on the primary system.

NOTE Softek TDMF does not support Solaris 2/x86(Intel platform version).

Page 9: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

3

1.2 Recommended Operating Parameters This section describes guidelines for configuring Softek TDMF to run optimally.

For more information on configuring the parameters below please refer to the Softek TDMF Open

Systems Edition Administrator’s Guide.

Softek TDMF Recommended Configuration

Minimum BAB Memory 32MB

Maximum BAB Memory

1547MB (However there may be limitations

depending on the OS. For further details refer

to [1.3.3 How to Size the BAB])

Minimum # of dtc devices 1

Maximum # of dtc devices 500

Minimum # of logical groups 1

Maximum # of logical groups 100

Minimum pstore size 40MB

Minimum # of pstore 1

Maximum # of pstore 10

NOTE In the dtcconfigtool, even though a BAB size of 1 MB can be set, please ensure that at least 32 MB or more

of BAB memory is setup.

Page 10: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

4

1.3 Preparing to Install for AIX, HP-UX, and Solaris This section describes the steps in planning a Softek TDMF installation.

1.3.1 Backing up the System

Normally, when software or hardware is installed, the system is backed up completely. Please ensure the

same is done before devices are added or Softek TDMF is installed. In case files which cannot be

replaced on the system exist, it is necessary to back up the system before installing Softek TDMF.

1.3.2 How to Size the System

Sizing of certain components such as the BAB or Pstore should be completely thought out before

starting the installation. The following rules can be helpful when sizing and allocating resources:

Mirror devices on the secondary should be at least as large as local data devices. However in

cases of disaster recovery, when the local data devices on the primary are used as secondary

devices temporarily, it is necessary that the disk sizes must be equal.

Use tools like iostat (or volstat and sar on Solaris) or commercial systems management

performance tools to profile the I/O characteristics and demands on your system.

Try to collect the following information:

Peak I/O update activity over time. Don’t ignore quarter-end or year-end processing

requirements.

Ratio of “reads” to “writes”.

Number of disk blocks updated over a measurable amount of time. This data is especially useful

when determining the appropriate size for the journal file directory on the secondary system(s),

and the amount of memory for the BAB.

The peak rate of data to be sent over the network and the time for which the BAB will not

overflow in case the network shuts down. If the BAB overflows, Softek TDMF will change to

TRACKING mode, and to achieve data parity between primary and secondary, a differential copy

will be executed automatically.

If possible, perform an iterative implementation on Softek TDMF and monitor operations. Pay attention

to incidents such as network connection being lost, the secondary system going down, or unanticipated

bursts in I/O activity.

1.3.3 How to Size the BAB

It is recommended that additional physical memory be installed on any primary system where Softek

TDMF resides for the BAB. The BAB is in physical memory, not virtual memory.

Minimum and Maximum BAB size

The minimum BAB size should be 32MB. The maximum BAB size can go upto 1547 MB. However due to

OS limitations, the maximum size that can be acquired on each OS is as follows:

Maximum possible BAB sizes

Solaris 1547MB

HP-UX 1547MB

5.1(32bit)

5.2(32bit) 200~300MB

AIX 5.1(64bit)

5.2(64bit) 1547MB

Page 11: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

5

A Recommendation for BAB size

Apart from considerations like available kernel memory or volume of data I/O, the following standard

BAB size can be considered.

<If the number of devices to be mirrored are less than 10> BAB Size=256MB

<If the number of devices to be mirrored are more than 10 > BAB Size=512MB

Other considerations

Since the BAB stores changes made to the primary data, the following variables are important in

determining the appropriate size:

Amount of data changed during a measurable period of time (burst of data)

Speed of network and how fast entries are removed from the BAB.

How long you can tolerate a network outage.

During configuration with dtcconfigtool, if the dtc driver is unable to allocate all of the requested

memory, a message prompts you to reboot the system. The reboot allows the dtc device driver to obtain

the requested memory. The amount of memory actually allocated to the BAB is shown when the dtc driver

is added to the system. You can also determine this value with the dtcinfo –a command after the driver

has been added.

1.3.4 How to size the Pstore

The Pstore is an area where the state information, definition of the tunable parameters and the update

bitmap is stored and hence a dedicated volume or slice is required for the same. The minimum size is 40

MB. The maximum size is 140 MB. It is recommended to use the maximum size of 140 MB for the Pstore.

1.3.5 How to Size the Journal File Directories

To use Softek TDMF it is necessary to prepare a journal directory on the secondary.

What is a Journal Directory?

The journal directory is an area that must be prepared on the Secondary side. For Softek TDMF, in the

following cases, journal files are created under the journal directory:

During Smart Refresh (Journal files are not created during Full Refresh) Journals are created

in this case only if the logical group has been set to use the journal. For further details please

refer to Softek TDMF Open Systems Edition Administrator Guide.

During Checksum Refresh. Journals are created in this case only if the logical group has been

set to use the journal. For further details please refer to Softek TDMF Open System Edition

Administrator Guide.

When the checkpoint state is on.

When Smart Refresh/Checksum Refresh is completed or when checkpoint state is turned off, the

journal files are deleted after the data is applied to the secondary device.

Hence, journal directory is an area which is used temporarily by Softek TDMF.

A Recommendation for Determining Journal Directory Size

Even though the size depends on the amount of data that is updated during the checkpoint ON state, it

is desirable to keep the journal directory area as large as the original mirror disk. If for whatever reasons, it

is difficult to prepare an area of the same size as that of the original mirror disk, then the following is the

recommended size of the journal directory.

Page 12: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

6

Journal directory size = Original mirror disk size x 0.25

Page 13: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

7

1.4 How to Install Softek TDMF on AIX In this section, the procedure to install Softek TDMF on AIX is explained. Install Softek TDMF, first on

the primary system and then on the secondary system. Softek TDMF is installed on AIX as follows:

1. Login as root.

2. Load the Softek TDMF CD-ROM and mount the CD as follows:

mount –r –rv cdrfs /dev/cd0 /cdrom

If you don’t know the CD-ROM device name, you should use the following command.

lsdev –C –c cdrom

3. Move to the directory/cdrom/Softek_TDMF/AIX/[5.2|5.1].

4. Execute the following commands:

mkdir /var/dtc

installp –a –V 4 –e /var/dtc/dtc_install.log –d . dtc.rte

The following text will display: installp: No action was indicated. The -a (apply) flag is being assumed. +-----------------------------------------------------------------------------+ Pre-installation Verification... +-----------------------------------------------------------------------------+ Verifying selections...done Verifying requisites...done Results... SUCCESSES --------- Filesets listed in this section passed pre-installation verification and will be installed. Selected Filesets ----------------- dtc.rte 2.0.0.1 # TDMF dtc.rte.doc 2.0.0.1 # TDMF << End of Success Section >> . . . please inspect /etc/services. the following line has been added: in.dtc 575/tcp Starting Softek TDMF daemons [2005/xx/xx 18:35:56] dtc: dtc.rte.config: Driver ODM PdDv and CuDv defined. [2005/xx/xx 18:35:56] dtc: dtc.rte.config: System boot file /etc/rc customized. [2005/xx/xx 18:35:56] dtc: dtc.rte.config: dtc daemons started. Finished processing all filesets. (Total time: 19 secs). +-----------------------------------------------------------------------------+ Summaries: +-----------------------------------------------------------------------------+ Installation Summary -------------------- Name Level Part Event Result ------------------------------------------------------------------------------- dtc.rte.doc 2.0.0.1 USR APPLY SUCCESS dtc.rte 2.0.0.1 USR APPLY SUCCESS dtc.rte 2.0.0.1 ROOT APPLY SUCCESS

5. To verify the installation execute the following command at the prompt:

lslpp –l | grep dtc

You will get the following output:

Page 14: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

8

dtc.rte 2.0.0.1 COMMITTED TDMF dtc.rte.doc 2.0.0.1 COMMITTED TDMF dtc.rte 2.0.0.1 COMMITTED TDMF

6. Repeat the above steps to install TDMF on all the target systems.

7. Add /usr/dtc/bin to the PATH environment variable for the user root. 8. In order to enable Softek TDMF, create the file /etc/dtc/lib/DTC.lic and enter the license key.

Softek TDMF Directory Structure on AIX

Directory Contains…

/usr/dtc/bin

/usr/sbin/dtcstop

/usr/sbin/dtcstart

Executable programs

/etc/dtc/lib Configuration and License files

/var/dtc Performance and Error logs

/etc/dtc/r3.d/S24dtc-chkpt_boot

/etc/dtc/r3.d/S25dtc-startdaemons

Boot Scripts

/lpp/dtc.rte

/usr/lpp/dtc.rte*

/usr/sys/inst.images/dtc.rte*

Installation files used by installp and lpp

/usr/lib/drivers/dtc* Drivers

/usr/dtc/lib/ Libraries

/usr/lib/methods/dtc* Methods

NOTE The JFS file system uses a log device to record the changes to the file system and its meta data. Multiple

JFS file systems can share the same log device. To obtain better performance, it is recommended to keep a

separate log device for each JFS file system. (For further details please refer to the AIX Performance Guide.)

Each log device must have a corresponding dtc device. The corresponding dtc devices for the JFS file system

and log device must be defined in the same logical group for mirroring purposes.

NOTE After installation, when the configuration tool is started to set the BAB size, please give careful

consideration to what size the BAB needs to be set to. This should be based on the actual physical memory

available and load on the system. Please avoid selecting the default value which is 512 MB.

Page 15: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

9

1.5 How to Install Softek TDMF on HP-UX In this section, the procedure to install Softek TDMF on HP-UX is explained. Install Softek TDMF, first

on the primary system and then on the secondary system. Use the HP-UX swinstall command to install

Softek TDMF. Softek TDMF is installed on HP-UX as follows:

1. Login as root.

2. Load the Softek TDMF CD-ROM and mount the CD as follows:

mount CD-ROM device name /cdrom

If you don’t know the CD-ROM device name, you should use the following command.

ioscan –funC disk | pg

3. Type the following command and start swinstall.

swinstall –s /cdrom/Softek_TDMF/HPUX/[11.0|11i] DTC

The following message indicates that the installation completed successfully.

======= xx/xx/xx xx:xx:xx JST BEGIN swinstall SESSION

(non-interactive) (jobid=hpuxv1-1-0118)

* Session started for user "root@hpuxv1-1".

* Beginning Selection

* Target connection succeeded for "hpuxv1-1:/".

* "hpuxv1-1:/cdrom/Softek_TDMF/HPUX/11i": Cannot open the

logfile on this target or source. Possibly the media is

read-only or there is a permission problem. Check the daemon

logfile and "/var/tmp/swagent.log" on this host for more

information.

* Source: /cdrom/Softek_TDMF/HPUX/11i

* Targets: hpuxv1-1:/

* Software selections:

DTC.Documentation,r=2.0.0-i,a=HP-UX_B.11.11_800

DTC.Programs,r=2.0.0-i,a=HP-UX_B.11.11_800

* Selection succeeded.

* Beginning Analysis and Execution

* Session selections have been saved in the file

"/.sw/sessions/swinstall.last".

* The analysis phase succeeded for "hpuxv1-1:/".

* The execution phase succeeded for "hpuxv1-1:/".

* Analysis and Execution succeeded.

NOTE: More information may be found in the agent logfile using the

command "swjob -a log hpuxv1-1-0118 @ hpuxv1-1:/".

======= xx/xx/xx xx:xx:xx JST END swinstall SESSION (non-interactive)

(jobid=hpuxv1-1-0118)

4. Repeat the above steps to install TDMF on all the target systems.

5. Add /opt/SFTKdtc/bin to the PATH environment variable for the user root. 6. In order to enable Softek TDMF, create the file /etc/opt/SFTKdtc/DTC.lic and enter the license key.

Page 16: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

10

Softek TDMF Directory Structure on HP-UX

Directory Contains…

/etc/opt/SFTKdtc Licensing Files, configuration files, template rc

scripts

/opt/SFTKdtc/bin User executables

/opt/SFTKdtc/lib Supporting libraries

/sbin/init.d

/sbin/rc0.d

/sbin/rc1.d

/sbin/rc3.d

Startup scripts

/usr/conf Driver files

/usr/local/bin Symbolic link to User Executables

/var/opt/SFTKdtc Dtcerror.log, performance logs, configuration files

from previous version.

NOTE After installation, when the configuration tool is started to set the BAB size, please give careful consideration

to what size the BAB needs to be set to. This should be based on the actual physical memory available and

load to the system. Please avoid selecting the default value is 512 MB.

Page 17: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

11

1.6 How to Install Softek TDMF on Solaris In this section, the procedure to install Softek TDMF on Solaris is explained. Install Softek TDMF, first

on the primary system and then on the secondary system. Use the Solaris pkgadd command to install

Softek TDMF. Softek TDMF is installed on HP-UX as follows:

1. Login as root.

2. Load the Softek TDMF CD-ROM and mount the CD In case the vold process is running the CD-

ROM will be automatically mounted.

3. Move to the directory/cdrom/cdrom0/softek_tdmf/Solaris/[7|8|9] as the case may be.

4. If the command /usr/sbin/pkgadd -d is entered, then the following message is displayed.

Select package(s) you wish to process (or ‘all’ to process all packages (default:all) [?,??,q]: Softek TDMF(SFTKdtc Softek TDMF (sparc) 2.0.0

5. Since all packages will be installed please press Enter as default

6. The license agreement appears. Type y to proceed with installation when prompted:

Do you accept the above license terms? [ y, n, ?] 7. Accept the default port number – 575 – for the Softek TDMF master daemon to listen on. Otherwise,

enter another available port number.

Port for Softek TDMF master daemon to listen on? [575] [1-65535, ?] 8. A message confirming if installation should continue is displayed. Enter y to continue.

Do you want to continue with the installation of <SFTKdtc> [y,n,?] The following message indicates that the installation completed successfully.

Installing TDMF as <SFTKdtc>

## Executing preinstall script.

## Installing part 1 of 1.

/etc/init.d/SFTKdtc-chkpt_boot

/etc/init.d/SFTKdtc-scan

/etc/init.d/SFTKdtc-startagent

.

.

.

/etc/rc3.d/S24SFTKdtc-chkpt_boot <linked pathname>

/etc/rc3.d/S25SFTKdtc-startdaemons <linked pathname>

/etc/rc3.d/S26SFTKdtc-startagent <linked pathname>

/etc/rcS.d/S89SFTKdtc-scan <linked pathname>

## Executing postinstall script.

Restoring previously saved SFTKdtc license key file.

Starting Softek TDMF daemons

Installation of <SFTKdtc> was successful.

Page 18: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

12

9. pkgadd prompts you to install another package; enter q to quit.

10. Repeat the above steps to install TDMF on all the target systems. 11. Add /opt/SFTKdtc/bin to the PATH environment variable for the user root 12. In order to enable Softek TDMF, create the file /etc/opt/SFTKdtc/DTC.lic and enter the license key.

Softek TDMF Directory Structure on Solaris

Directory Contains…

/etc/opt/SFTKdtc Licensing Files, configuration files, template rc

scripts

/opt/SFTKdtc/bin User executables

/opt/SFTKdtc Supporting libraries

/etc/init.d

/etc/rc3.d

/etc/rcS.d

/usr/sbin

Startup and Shutdown Scripts

/usr/local/bin Symbolic Links to User Executables

/var/opt/SFTKdtc Dtcerror.log, performance logs, configuration files

from previous version.

NOTE If a port number other than 575 has been entered, this value will not be displayed in the Configuration Tool

Systems menu of dtcconfigtool. It is necessary to enter the value for the port number again in this menu. For

further details refer to Softek TDMF Open Systems Edition Administrator Guide.

NOTE In order to enable TCP/IP communication on the selected port number over a WAN environment,firewall or

proxy settings are required.

NOTE After installation, when the configuration tool is started to set the BAB size, please give careful consideration

to what size the BAB needs to be set to. This should be based on the actual physical memory available and

load to the system. Please avoid selecting the default value which is 512 MB.

Page 19: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

13

1.7 Licensing In order to start normal mirroring operations with Softek TDMF a license key is required. Fujitsu will

provide this license key. In order to obtain the license key, the host id information of the machine on which

Softek TDMF is installed is required.

1.7.1 Acquiring the Host ID Information

To obtain the host id for the machines on which Softek TDMF is installed please execute the following

command on each machine.

[AIX]

/usr/dtc/bin/dtchostinfo

[HP-UX 、Solaris]

/opt/SFTKdtc/bin/dtchostinfo

Please make a note of the 8 digit number displayed.

1.7.2 Application for the License Key

Please use the license key application form which you received along with the Softek TDMF product CD.

Enter the necessary information along with the information obtained in 1.7.1 above and send the completed

application form to the Fujitsu Licensing and Password Issuing Center.

NOTE In case the machine on which TDMF is installed is changed, then since the host id for the new machine will be

different, it will become necessary to re-apply for the license.

NOTE Re-applying for the license is not required if Softek TDMF is upgraded on the same machine.

1.7.3 Setting the License Key

Once the license key is received, set the license key as follows:

1. On both the primary and the secondary machines, please create a file DTC.lic under the following

directories:

[AIX]

/etc/dtc/lib

[HP-UX 、Solaris]

/etc/opt/SFTKdtc

2. Using a standard text editor, please enter the 24 character alpha-numeric license number for each

system.

Sample DTC.lic File

G8A9 G5PG N9G1 NBC4 F2B5 FAB7

NOTE The license key corresponds to the host id of the machine on which Softek TDMF is installed. Hence a

license key is required for each machine on which Softek TDMF is installed. In the case of cluster systems,

a license key is required for each node in the cluster.

NOTE Please note that the license key is case-sensitive.

Page 20: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

14

1.7.4 Confirming the License Key

After entering the license key please confirm if it has been entered correctly. Use the following steps

to confirm the correctness of the license key.

[AIX]

/usr/dtc/bin/dtclicinfo

[HP-UX 、Solaris]

/opt/SFTKdtc/bin/dtclicinfo

If the correct license is installed the following message will be displayed.

Permanent license is valid for this system

Page 21: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

15

2 Upgrading Softek TDMF To upgrade Softek TDMF you must remove the current product version before upgrading. For further

information, please refer [3 Removing Softek TDMF].

2.1 How to Upgrade Softek TDMF on AIX Upgrade Softek TDMF as per the following steps:

1. To prepare for any emergency, please copy all the information under /etc/dtc/lib to a separate

location.

2. Using step numbers 1 to 5 under section [3.1 How to Remove Softek TDMF on AIX] uninstall Softek

TDMF. The uninstallation process of Softek TDMF saves the configuration files, license files and

checkpoint scripts under the /var/dtc directory. In case a new configuration is required please

delete the configuration file. Then go to the next step.

3. Using step numbers 1 to 5 under section 「1.1 How to Install Softek TDMF on AIX」 install Softek

TDMF.

4. If the dtcconfigtool is started, a notice informing that the latest information will be restored is

displayed. If there are no problems in upgrading , click on Yes.

5. Please repeat the above steps for all machines.

Page 22: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

16

2.2 How to Upgrade Softek TDMF on HP-UX Upgrade Softek TDMF as per the following steps:

1. To prepare for any emergency, please copy all the information under /etc/opt/SFTKdtc to a

separate location.

2. Using step numbers 1 to 5 under section [3.2 How to Remove Softek TDMF on HP-UX」uninstall

Softek TDMF. The uninstallation process of Softek TDMF saves the configuration files, license files

and checkpoint scripts under the /var/opt/SFTKdtc directory. In case a new configuration is

required please delete the configuration file. Then go to the next step.

3. Using step numbers 1 to 5 under section [1.5 How to Install Softek TDMF on HP-UX」 install Softek

TDMF.

4. If the dtcconfigtool is started, a notice informing that the latest information will be restored is

displayed. If there are no problems in upgrading , click on Yes.

5. Please repeat the above steps for all machines.

NOTE In case after rebooting of the server the Logical Volume cannot be seen any more, please confirm that

“AUTO_VG_ACTIVATE=1” is set in the /etc/lvmrc file.

Page 23: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

17

2.3 How to Upgrade Softek TDMF on Solaris Upgrade Softek TDMF as per the following steps:

1. To prepare for any emergency, please copy all the information under /etc/opt/SFTKdtc to a

separate location.

2. Using step numbers 1 to 6 under section [3.3 How to Remove Softek TDMF on Solaris」uninstall

Softek TDMF. The uninstallation process of Softek TDMF saves the configuration files, license files

and checkpoint scripts under the /var/opt/SFTKdtc directory. In case a new configuration is

required please delete the configuration file. Then go to the next step.

3. Using step numbers 1 to 5 under section [1.6 How to Install Softek TDMF on Solaris] install Softek

TDMF.

4. If the dtcconfigtool is started, a notice informing that the latest information will be restored is

displayed. If there are no problems in upgrading , click on Yes.

5. Please repeat the above steps for all machines.

Page 24: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate
Page 25: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

19

3 Removing Softek TDMF This section explains how Softek TDMF can be uninstalled.

3.1 How to Remove Softek TDMF on AIX Use the following steps to remove Softek TDMF. Softek TDMF can be removed with the install –p

command.

1. Make sure that no dtc devices are currently installed or in use. Use the /usr/sbin/mount command

to display all devices that have file systems mounted.

2. Umount all dtc devices and remove the relevant entries from /etc/filesystems.

3. On the primary system execute the following commands to stop all the PMDs and groups. This is not

required on the secondary system.

# killpmds –a

# dtcstop -a

4. On the primary and secondary execute the following command.

# killdtcmaster

5. To remove the software and documentation on both the primary and the secondary systems, type:

# installp –u dtc.rte

The following text will display:

+-----------------------------------------------------------------------------+

Pre-deinstall Verification...

+-----------------------------------------------------------------------------+

Verifying selections...done

Verifying requisites...done

Results...

SUCCESSES

---------

Filesets listed in this section passed pre-deinstall verification

and will be removed.

Selected Filesets

-----------------

dtc.rte 2.0.0.1 # TDMF

dtc.rte.doc 2.0.0.1 # TDMF

<< End of Success Section >>

FILESET STATISTICS

------------------

2 Selected to be deinstalled, of which:

2 Passed pre-deinstall verification

----

2 Total to be deinstalled

+-----------------------------------------------------------------------------+

Deinstalling Software...

+-----------------------------------------------------------------------------+

.

.

.

Page 26: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

20

installp: DEINSTALLING software for:

dtc.rte.doc 2.0.0.1

Finished processing all filesets. (Total time: 10 secs).

+-----------------------------------------------------------------------------+

Summaries:

+-----------------------------------------------------------------------------+

Installation Summary

--------------------

Name Level Part Event Result

-------------------------------------------------------------------------------

dtc.rte 2.0.0.1 ROOT DEINSTALL SUCCESS

dtc.rte 2.0.0.1 USR DEINSTALL SUCCESS

dtc.rte.doc 2.0.0.1 USR DEINSTALL SUCCESS

Configuration information of Softek TDMF is stored under /var/dtc directory.

6. In order to completely remove the configuration related files, checkpoint shell scripts and license file,

use the following commands:

# rm -rf /dev/dtc

# rm -rf /usr/dtc

# rm -rf /etc/dtc

# rm –rf /var/dtc

NOTE In case after uninstallation, you would like to re-install Softek TDMF and would like to reuse the previous

configuration, please ensure that you do not perform step 6 above. Else the configuration files will get deleted.

Page 27: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

21

3.2 How to Remove Softek TDMF on HP-UX Use the following steps to remove Softek TDMF. Softek TDMF can be removed with the swremove

command.

1. Make sure that no dtc devices are currently installed or in use. Use the /usr/sbin/mount command

to display all devices that have file systems mounted.

2. Umount all dtc devices and remove the relevant entries from /etc/fstab.

3. On the primary system execute the following commands to stop all the PMDs and groups. This is not

required at the secondary system.

# killpmds –a

# dtcstop -a

4. On the primary and secondary execute the following command.

# killdtcmaster

5. To remove the software and documentation on both the primary and the secondary systems, type:

# cd /

# swremove –x mount_all_filesystems=false DTC

The following text will display:

======= xx/xx/xx xx:xx:xx JST BEGIN swremove SESSION

(non-interactive) (jobid=hpuxv1-2-0075)

* Session started for user "root@hpuxv1-2".

* Beginning Selection

* Target connection succeeded for "hpuxv1-2:/".

* Software selections:

DTC.Documentation,l=/etc/opt/SFTKdtc,r=2.0.0-i,a=HP-UX_B.11.11_800

DTC.Programs,l=/etc/opt/SFTKdtc,r=2.0.0-i,a=HP-UX_B.11.11_800

* Selection succeeded.

* Beginning Analysis

* Session selections have been saved in the file

"/.sw/sessions/swremove.last".

* "hpuxv1-2:/": There will be no attempt to mount filesystems

that appear in the filesystem table.

* Analysis succeeded.

* Beginning Execution

* The execution phase succeeded for "hpuxv1-2:/".

* Execution succeeded.

NOTE: More information may be found in the agent logfile using the

command "swjob -a log hpuxv1-2-0075 @ hpuxv1-2:/".

======= xx/xx/xx xx:xx:xx JST END swremove SESSION (non-interactive)

(jobid=hpuxv1-2-0075)

Configuration information of Softek TDMF is stored under /var/opt/SFTKdtc directory.

Page 28: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

22

6. In order to completely remove the configuration related files, checkpoint shell scripts and license file

use the following commands:

# rm –rf /dev/dtc

# rm –rf /var/opt/SFTKdtc

# rm -rf /etc/opt/SFTKdtc

# rm -rf /opt/SFTKdtc

NOTE In case after uninstallation, you would like to re-install Softek TDMF and would like to reuse the previous

configuration, please ensure that you do not perform step 6 above. Else the configuration files will get deleted.

Page 29: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

23

3.3 How to Remove Softek TDMF on Solaris Use the following steps to remove Softek TDMF. Softek TDMF can be removed with the pkgrm

command.

1. Make sure that no dtc devices are currently installed or in use. Use the /usr/sbin/mount command

to display all devices that have file systems mounted.

2. Umount all dtc devices and remove the relevant entries from /etc/vfstab.

3. On the primry system execute the following commands to stop all the PMDs and groups. This is not

required at the secondary system.

# killpmds –a

# dtcstop -a

4. On the primary and secondary execute the following command.

# killdtcmaster

5. Remove the dtc device driver by entering the following. If the driver is in use then rem_drv will fail.

# cd /

# /usr/sbin/rem_drv dtc

6. To remove the software and documentation on both the primary and the secondary systems,

execute:

# pkgrm SFTKdtc

The following text will display:

The following package is currently installed:

SFTKdtc TDMF

(sparc) 2.0.0

Do you want to remove this package? [y,n,?,q] y

## Removing installed package instance <SFTKdtc>

This package contains scripts which will be executed with super-user

permission during the process of removing this package.

Do you want to continue with the removal of this package [y,n,?,q] y

## Verifying package dependencies.

## Processing package information.

## Executing preremove script.

Stop Softek TDMF Agent daemons

TDMF Agent is not running

No TDMF PMD daemons were running.

No TDMF RMD daemons were running.

in.dtc master TDMF daemon is not running

throtd TDMF throttle daemon is not running

Driver (dtc) not installed.

.

.

.

## Executing postremove script.

Removing TDMF device tree: /dev/dtc

Removing temporary files from /var/opt/SFTKdtc

Removing TDMF master daemon from /etc/inet/services

## Updating system information.

Removal of <SFTKdtc> was successful.

Page 30: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate

24

Configuration information of Softek TDMF is stored under /var/opt/SFTKdtc directory.

7. In order to completely remove the configuration related files, checkpoint shell scripts and license file

use the following commands:

# rm –rf /dev/dtc

# rm -rf /var/opt/SFTKdtc

# rm -rf /etc/opt/SFTKdtc

# rm -rf /opt/SFTKdtc

NOTE In case after uninstallation, you would like to re-install Softek TDMF and would like to reuse the previous

configuration, please ensure that you do not perform step 7 above. Else the configuration files will get deleted.

Page 31: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate
Page 32: 2.0 Installation Guide Solaris™ OS, HP-UX™, AIX™ · Since the BAB stores changes made to the primary data, the following variables are important in determining the appropriate