<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<!DOCTYPE stax SYSTEM "/stax.dtd">

<stax>

<function name="createTopology">

<function-prolog>

This function creates the topology required by the Test Group/Suite.

</function-prolog>

<function-map-args>

<function-arg-def name="topologyDescFile"

type="optional"

default="None">

<function-arg-description>

Topology Description file

</function-arg-description>

<function-arg-property name="type" value="filePath"/>

</function-arg-def>

<function-arg-def name="initialiseInstance"

type="optional"

default="False">

<function-arg-description>

Specifies whether the instance should be initialised with

some default data.

</function-arg-description>

<function-arg-property name="type" value="boolean"/>

</function-arg-def>

<function-arg-def name="sharedDataFolder"

type="optional"

default="''">

<function-arg-description>

Specifies a relative folder that holds the shared data for the tests

</function-arg-description>

<function-arg-property name="type" value="string"/>

</function-arg-def>

</function-map-args>

<sequence>

<script>

if not sharedDataFolder and CurrentTestPath.has_key('group'):

sharedDataFolder=CurrentTestPath['group']

</script>

<call function="'prepareInstanceCreation'">

{ 'groupDataDir' : sharedDataFolder }

</call>

<if expr="topologyDescFile == None">

<!-- SINGLE instance deployment: read parameters from config.py (done

<sequence>

<message>

'SINGLE instance deployment: read parameters from config.py'

</message>

<call function="'createInstance'" />

<if expr="RC == 0 and initialiseInstance == True">

<sequence>

<!-- Load the server with default data -->

<import machine="STAF_LOCAL_HOSTNAME"

file="'%s/testcases/quickstart/quickstart.xml' % (TESTS_DIR)" />

<call function="'main_quickstart'"/>

</sequence>

</if>

</sequence>

<else>

<!-- MULTIPLE instance deployment: read parameters from

<sequence>

<message>

'MULTIPLE instance deployment: read parameters from %s' \

% topologyDescFile

</message>

<!-- Parse the topology description file and set

<call function="'readTopology'">

{ 'file' : topologyDescFile }

</call>

<message>

'Number of server instances required by the deployment: %s' \

% len(_topologyServerList)

</message>

<iterate var="server" in="_topologyServerList">

<sequence>

<!-- Create the instance-->

<call function="'createInstance'">

{ 'dsHost' : server.getHostname(),

'dsDir' : server.getDir(),

'dsPort' : server.getPort(),

'dsSslPort' : server.getSslPort(),

'dsJmxPort' : server.getJmxPort(),

'dsBindDN' : server.getRootDn(),

'dsBindPwd' : server.getRootPwd(),

'dsBaseDN' : server.getBaseDn()

}

</call>

</sequence>

</iterate>

</sequence>

</else>

</if>

</sequence>

</function>

<function name="prepareInstanceCreation">

<function-prolog>

This function prepares locally the necessary

files to create an instance: data zip file and OpenDS zip file.

</function-prolog>

<function-map-args>

<function-arg-def name="groupDataDir"

type="optional"

default="''">

<function-arg-description>

Specifies a relative folder that holds the shared data for the test

group

</function-arg-description>

<function-arg-property name="type" value="string"/>

</function-arg-def>

<function-arg-def name="fileExtensions"

type="optional"

default="[]">

<function-arg-description>

Specifies a list of file extension to add to testdata.zip

</function-arg-description>

<function-arg-property name="type" value="list"/>

</function-arg-def>

</function-map-args>

<sequence>

<!-- ON LOCAL HOST: get data ready to copy to remote host -->

<script>

sourceTestsGroupDir='%s/%s' % (source.data,groupDataDir)

localTestsGroupDir ='%s/%s' % (local.data, groupDataDir)

remoteTestsGroupDir='%s/%s' % (remote.data,groupDataDir)

</script>

<call function="'GetEntry'">

{ 'location' : STAXServiceMachine,

'entry' : localTestsGroupDir,

'attribute' : 'TYPE'

}

</call>

<!-- If the test data is already created then don't redo it -->

<if expr="RC == 48">

<sequence>

<!-- Locally copy static data files to temporary staging area -->

<!-- LDIF (.ldif) test data files -->

<message>

'Copy ldif data files locally from %s to %s.' % \

(sourceTestsGroupDir,localTestsGroupDir)

</message>

<call function="'CopyFolderByExtension'">

{ 'location' : STAXServiceMachine,

'srcfolder' : sourceTestsGroupDir,

'destfolder' : localTestsGroupDir,

'extension' : 'ldif'

}

</call>

<if expr="len(fileExtensions) > 0">

<iterate var="ft" in="fileExtensions">

<sequence>

<!-- add file extension test data files -->

<message>

'Copy %s data files locally from %s to %s.' % \

(ft,sourceTestsGroupDir,localTestsGroupDir)

</message>

<call function="'CopyFolderByExtension'">

{ 'location' : STAXServiceMachine,

'srcfolder' : sourceTestsGroupDir,

'destfolder' : localTestsGroupDir,

'extension' : '%s' % ft

}

</call>

</sequence>

</iterate>

</if>

<!-- LDIF (.ldif) files for quickinstall -->

<script>

quickStartGroupDir='%s/quickstart' % (source.data)

quickStartLocalTestsGroupDir='%s/quickstart' % local.data

</script>

<message>

'Copy quickstart ldif data files locally from %s to %s.' % \

(quickStartGroupDir,quickStartLocalTestsGroupDir)

</message>

<call function="'CopyFolderByExtension'">

{ 'location' : STAXServiceMachine,

'srcfolder' : quickStartGroupDir,

'destfolder' : quickStartLocalTestsGroupDir,

'extension' : 'ldif'

}

</call>

<!-- PWD (.pwd) files -->

<message>

'Copy pwd data files locally from %s to %s.' % \

(sourceTestsGroupDir,localTestsGroupDir)

</message>

<call function="'CopyFolderByExtension'">

{ 'location' : STAXServiceMachine,

'srcfolder' : sourceTestsGroupDir,

'destfolder' : localTestsGroupDir,

'extension' : 'pwd'

}

</call>

<!-- Archive (.gz) files -->

<message>

'Copy gz data files locally from %s to %s.' % \

(sourceTestsGroupDir,localTestsGroupDir)

</message>

<call function="'CopyFolderByExtension'">

{ 'location' : STAXServiceMachine,

'srcfolder' : sourceTestsGroupDir,

'destfolder' : localTestsGroupDir,

'extension' : 'gz'

}

</call>

<!-- Archive (.ref) files -->

<message>

'Copy ref data files locally from %s to %s.' % \

(sourceTestsGroupDir,localTestsGroupDir)

</message>

<call function="'CopyFolderByExtension'">

{ 'location' : STAXServiceMachine,

'srcfolder' : sourceTestsGroupDir,

'destfolder' : localTestsGroupDir,

'extension' : 'ref'

}

</call>

<!-- Archive (ldap/.java) files -->

<script>

javaSharedDir='%s/ldap' % source.java

javaLocalDir ='%s/ldap' % local.java

</script>

<message>

'Copy java files locally from %s to %s.' % \

(javaSharedDir,javaLocalDir)

</message>

<call function="'CopyFolderByExtension'">

{

'location' : STAXServiceMachine,

'srcfolder' : javaSharedDir,

'destfolder' : javaLocalDir,

'extension' : 'java'

}

</call>

<!--- Check if ldap java files are already compiled -->

<call function="'listFolderByExtension'" >

{

'location' : STAXServiceMachine,

'foldername' : javaLocalDir,

'extension' : 'class'

}

</call>

<if expr="len(STAXResult) == 0">

<sequence>

<!--- Compile ldap java files on controler host -->

<message>

'Compile Java files under %s on %s' \

% (javaLocalDir, STAXServiceMachine)

</message>

<call function="'compileJava'" >

{

'location' : STAXServiceMachine,

'foldername' : '%s' % javaLocalDir

}

</call>

</sequence>

</if>

<!-- Archive (.security) files -->

<message>

'Copy security data files locally from %s to %s.' % \

(sourceTestsGroupDir,localTestsGroupDir)

</message>

<call function="'CopyFolderByExtension'">

{ 'location' : STAXServiceMachine,

'srcfolder' : sourceTestsGroupDir,

'destfolder' : localTestsGroupDir,

'extension' : 'security'

}

</call>

<!-- Archive (snmp/.java) files -->

<script>

javaSharedDir = '%s/snmp' % source.java

javaLocalDir = '%s/snmp' % local.java

</script>

<message>

'Copy java files locally from %s to %s.' % \

(javaSharedDir,javaLocalDir)

</message>

<call function="'CopyFolderByExtension'">

{

'location' : STAXServiceMachine,

'srcfolder' : javaSharedDir,

'destfolder' : javaLocalDir,

'extension' : 'java'

}

</call>

<!-- Check if 'SNMP_OPENDMK_LIBDIR' exists -->

<call function="'GetEntry'">

{

'location' : STAXServiceMachine,

'entry' : SNMP_OPENDMK_LIBDIR,

'attribute' : 'TYPE'

}

</call>

<!-- 'SNMP_OPENDMK_LIBDIR' exists so we can continue with SNMP -->

<if expr="RC != 48">

<sequence>

<!--- Check if snmp java files are already compiled -->

<call function="'listFolderByExtension'" >

{

'location' : STAXServiceMachine,

'foldername' : javaLocalDir,

'extension' : 'class'

}

</call>

<if expr="len(STAXResult) == 0">

<sequence>

<!--- Install DS Copy zip file -->

<message>

'Copy DS zip archive locally from %s to %s.' % \

(ZIPPATH,TMPDIR)

</message>

<call function="'copyFile'">

{

'srcfile' : '%s/%s' % (ZIPPATH, ZIPNAME),

'destfile' : '%s/%s' % (TMPDIR, ZIPNAME),

'remotehost' : STAXServiceMachine

}

</call>

<!--- Install DS Extract zip file -->

<message>

'Extract locally DS zip archive to %s' % TMPDIR

</message>

<call function="'unZipFile'">

{

'location' : STAXServiceMachine,

'zipfile' : '%s/%s' % (TMPDIR, ZIPNAME),

'unzipdir' : TMPDIR

}

</call>

<call function="'ResolveVar'" >

{

'location' : STAXServiceMachine,

'type' : 'STRING',

'name' : 'STAF/Config/STAFRoot'

}

</call>

<script>

if is_windows_platform(STAXServiceMachine):

jstaf_jarfile='%s\\bin\\JSTAF.jar' % STAFResult

else:

jstaf_jarfile='%s/lib/JSTAF.jar' % STAFResult

</script>

<!--- Compile snmp java files on controler host -->

<message>

'Compile Java files under %s on %s' \

% (javaLocalDir, STAXServiceMachine)

</message>

<script>

opends_jarfile='%s/%s' % (TMPDIR,SNMP_OPENDS_JARFILE)

if is_windows_platform(STAXServiceMachine):

separator=';'

else:

separator=':'

</script>

<call function="'compileJava'" >

{

'location' : STAXServiceMachine,

'foldername' : javaLocalDir,

'classpath' : '%s%s%s%s%s' \

% (opends_jarfile,separator,SNMP_OPENDMK_JARFILE,separator,jstaf_jarfile)

}

</call>

<!-- Delete the DS zip archive -->

<message>

'Delete %s/%s' % (TMPDIR, ZIPNAME)

</message>

<call function="'deleteFile'">

{

'location' : STAXServiceMachine,

'filename' : '%s/%s' % (TMPDIR, ZIPNAME)

}

</call>

<!-- Delete the DS install dir -->

<message>

'Delete %s/%s' % (TMPDIR, OPENDSNAME)

</message>

<call function="'deleteFolder'">

{

'location' : STAXServiceMachine,

'foldername' : '%s/%s' % (TMPDIR, OPENDSNAME)

}

</call>

<!-- Archive SNMP_OPENDMK_JARFILE file -->

<message>

'Copy OpenDMK jar file %s locally to %s.' \

% (SNMP_OPENDMK_JARFILE,javaLocalDir)

</message>

<call function="'copyFile'">

{

'remotehost' : STAXServiceMachine,

'srcfile' : SNMP_OPENDMK_JARFILE,

'destfile' : '%s/jdmkrt.jar' % javaLocalDir,

'remotehost' : STAXServiceMachine

}

</call>

</sequence>

</if>

</sequence>

</if>

<!-- Delete the any existing testdata archive -->

<message>

'Delete %s/testdata.zip' % local.temp

</message>

<call function="'deleteFile'">

{ 'location' : STAXServiceMachine,

'filename' : '%s/testdata.zip' % local.temp

}

</call>

<message>

'Zip up local testdata files to %s/testdata.zip' % local.temp

</message>

<script>

javaLocalDir='%s' % local.java

</script>

<call function="'zipUpFile'">

{ 'location' : STAXServiceMachine,

'zipfile' : '%s/testdata.zip' % local.temp,

'folder' : local.testdata,

'relativeto' : local.directory

}

</call>

</sequence>

<else>

<message>

'Test data for %s group is already created.' % groupDataDir

</message>

</else>

</if>

</sequence>

</function>

<function name="createInstance">

<function-prolog>

This function creates an instance on a given host.

It copies both data and OpenDS zip files onto the host,

unzips them, and configures OpenDS.

</function-prolog>

<function-map-args>

<function-arg-def name="dsHost"

type="optional"

default="DIRECTORY_INSTANCE_HOST">

<function-arg-description>

Hostname where the instance is to be created

</function-arg-description>

<function-arg-property name="type" value="hostname"/>

</function-arg-def>

<function-arg-def name="dsDir"

type="optional"

default="DIRECTORY_INSTANCE_DIR">

<function-arg-description>

Directory where OpenDS will be installed

</function-arg-description>

<function-arg-property name="type" value="filepath"/>

</function-arg-def>

<function-arg-def name="dsPort"

type="optional"

default="DIRECTORY_INSTANCE_PORT">

<function-arg-description>

Directory Server port number

</function-arg-description>

<function-arg-property name="type" value="Port number"/>

</function-arg-def>

<function-arg-def name="dsSslPort"

type="optional"

default="DIRECTORY_INSTANCE_SSL_PORT">

<function-arg-description>

Directory Server SSL port number

</function-arg-description>

<function-arg-property name="type" value="Port number"/>

</function-arg-def>

<function-arg-def name="dsJmxPort"

type="optional"

default="None">

<function-arg-description>

Directory Server JMX port number

</function-arg-description>

<function-arg-property name="type" value="Port number"/>

</function-arg-def>

<function-arg-def name="dsBindDN"

type="optional"

default="DIRECTORY_INSTANCE_DN">

<function-arg-description>

Directory Manager DN

</function-arg-description>

<function-arg-property name="type" value="DN"/>

</function-arg-def>

<function-arg-def name="dsBindPwd"

type="optional"

default="DIRECTORY_INSTANCE_PSWD">

<function-arg-description>

Directory Server SSL port number

</function-arg-description>

<function-arg-property name="type" value="string"/>

</function-arg-def>

<function-arg-def name="dsBaseDN"

type="optional"

default="DIRECTORY_INSTANCE_SFX">

<function-arg-description>

Directory Server base suffix dn

</function-arg-description>

<function-arg-property name="type" value="DN"/>

</function-arg-def>

</function-map-args>

<sequence>

<message>

'Create instance in host %s at directory %s' % (dsHost,dsDir)

</message>

<!-- ON REMOTE HOST: copy files, unzip, configure instance -->

<!--- Delete folder if it exists on remote host-->

<message>

'Delete folder %s/%s on host %s' % (dsDir,OPENDSNAME,dsHost)

</message>

<call function="'deleteFolder'">

{ 'location' : dsHost,

'foldername' : '%s/%s' % (dsDir,OPENDSNAME)

}

</call>

<!--- Create folder on remote host -->

<message>

'Create folder %s on host %s' % (dsDir,dsHost)

</message>

<call function="'createFolder'">

{ 'location' : dsHost,

'foldername' : '%s' % dsDir

}

</call>

<!--- Copy staging data to remote host -->

<message>

'Copy %s/testdata.zip to %s on %s' % (local.testdata,dsDir,dsHost)

</message>

<call function="'copyFile'">

{ 'srcfile' : '%s/testdata.zip' % local.temp,

'destfile' : '%s/testdata.zip' % dsDir,

'remotehost' : dsHost

}

</call>

<!--- Unzip contents of staging data on remote host -->

<message>

'Extract contents of test data %s on %s' % (dsDir,dsHost)

</message>

<call function="'unZipFile'">

{ 'location' : dsHost,

'zipfile' : '%s/testdata.zip' % dsDir,

'unzipdir' : dsDir

}

</call>

<!--- Install DS Copy zip file -->

<message>

'Copy DS zip archive %s/%s to %s' % (local.temp,ZIPNAME,dsHost)

</message>

<call function="'copyFile'">

{ 'srcfile' : '%s/%s' % (ZIPPATH,ZIPNAME),

'destfile' : '%s/%s' % (dsDir,ZIPNAME),

'remotehost' : dsHost

}

</call>

<!--- Install DS Extract zip file -->

<message>

'Extract DS zip archive to %s on %s' % (dsDir,dsHost)

</message>

<call function="'unZipFile'">

{ 'location' : dsHost,

'zipfile' : '%s/%s' % (dsDir,ZIPNAME),

'unzipdir' : dsDir

}

</call>

<!-- fixMe: Windows Services are not enabled -->

<if expr="is_windows_platform(dsHost)">

<script>

enableWindowsService=''

</script>

<else>

<script>

enableWindowsService=''

</script>

</else>

</if>

<!-- configure the coverage dump file -->

<script>

mylog="::coverage - checking for %s/%s/lib/emma.jar\n" % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)

if os.path.exists('%s/%s/lib/emma.jar' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)):

mylog+=" ::coverage on\n"

if not os.path.exists('%s/coverage' % TMPDIR):

os.mkdir('%s/coverage' % TMPDIR)

mylog+=" ::mkdir %s/coverage on\n" % TMPDIR

if not os.path.exists('%s/coverage/%s'

% (TMPDIR,CurrentTestPath['group'])):

os.mkdir('%s/coverage/%s' % (TMPDIR,CurrentTestPath['group']))

mylog+=" ::mkdir %s/coverage/%s on\n" \

% (TMPDIR,CurrentTestPath['group'])

mylog+=" ::writing to %s/%s/classes/emma.properties" \

% (DIRECTORY_INSTANCE_DIR,OPENDSNAME)

coveragefh = open( '%s/%s/classes/emma.properties' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME), 'w' )

coveragefh.write( 'coverage.out.file=%s/coverage/%s/coverage.ec\n' \

% (TMPDIR,CurrentTestPath['group']) )

coveragefh.close()

</script>

<message>mylog</message>

<!--- Set up DS -->

<message>

'Set up DS on %s : %s/%s' % (dsHost,dsDir,OPENDSNAME)

</message>

<call function="'SetUpDsWithScript'">

{ 'location' : dsHost,

'dsPath' : '%s/%s' % (dsDir, OPENDSNAME),

'dsPort' : dsPort,

'dsJmxPort' : dsJmxPort,

'dsBindDN' : dsBindDN,

'dsBindPwd' : dsBindPwd,

'dsBaseDN' : dsBaseDN,

'dsEnableWindowsService' : enableWindowsService,

'dsDoNotStart' : 'true'

}

</call>

<call function="'checkRC'">

{ 'returncode' : RC ,

'result' : STAXResult

}

</call>

<if expr="returncode == 0">

<message>

'Instance created.'

</message>

<else>

<message>

'Failed to create instance.'

</message>

</else>

</if>

</sequence>

</function>

<function name="DEPRECATEDconfigureReplication">

<function-prolog>

This function configures replication in a given server.

</function-prolog>

<function-list-args>

<function-arg-def name="syncserverMap" type="required">

<function-arg-description>

Map containing a Server class instance representing the server to

configure.

</function-arg-description>

<function-arg-property name="type" value="map"/>

</function-arg-def>

</function-list-args>

<sequence>

<script>

syncserver = syncserverMap['instance']

filename = 'replication_conf.ldif'

filePath = '%s/%s' % (local.testdata,filename)

dataDir = '%s/%s' % (syncserver.getDir(),remote.reldatadir)

write_replication_conf_ldif_file(filePath, syncserver)

</script>

<message>

'Configure replication on server on host %s at directory %s' \

% (syncserver.getHostname(),syncserver.getDir())

</message>

<!-- Copy the replication_conf ldif to remote host -->

<message>

'Copy %s file from %s to %s' % (filename,local.testdata,dataDir)

</message>

<call function="'copyFile'">

{ 'srcfile' : filePath,

'destfile' : '%s/%s' % (dataDir,filename),

'remotehost' : syncserver.getHostname()

}

</call>

<!--- Add replication configuration entries to config.ldif in server -->

<script>

remoteFilePath = '%s/%s' % (dataDir, filename)

syncserverPath = '%s/%s' % (syncserver.getDir(),OPENDSNAME)

</script>

<!--- Start DS -->

<call function="'StartDsWithScript'">

{ 'location' : syncserver.getHostname(),

'dsPath' : syncserverPath

}

</call>

<call function="'checkRC'">

{ 'returncode' : RC ,

'result' : STAXResult

}

</call>

<message>

'Add replication configuration entries in %s' % remoteFilePath

</message>

<call function="'addEntry'">

{ 'location' : syncserver.getHostname(),

'dsPath' : syncserverPath,

'dsInstanceHost' : syncserver.getHostname(),

'dsInstancePort' : syncserver.getPort(),

'dsInstanceDn' : syncserver.getRootDn(),

'dsInstancePswd' : syncserver.getRootPwd(),

'entryToBeAdded' : remoteFilePath

}

</call>

<call function="'checkRC'">

{ 'returncode' : RC,

'result' : STAXResult

}

</call>

<!--- Stop DS -->

<call function="'StopDsWithScript'">

{ 'location' : syncserver.getHostname(),

'dsHost' : syncserver.getHostname(),

'dsPath' : syncserverPath,

'dsPort' : syncserver.getPort(),

'dsBindDN' : syncserver.getRootDn(),

'dsBindPwd' : syncserver.getRootPwd()

}

</call>

<call function="'checkRC'">

{ 'returncode' : RC ,

'result' : STAXResult

}

</call>

</sequence>

</function>

<function name="configureReplication">

<function-prolog>

This function configures replication in a given server.

</function-prolog>

<function-list-args>

<function-arg-def name="syncserver" type="required">

<function-arg-description>

Server class instance representing the server to configure.

</function-arg-description>

<function-arg-property name="type" value="Server"/>

</function-arg-def>

</function-list-args>

<sequence>

<!--- Configure replication using dsconfig -->

<message>

'Configure replication on server on host %s at directory %s' \

% (syncserver.getHostname(),syncserver.getDir())

</message>

<script>

syncserverPath = '%s/%s' % (syncserver.getDir(),OPENDSNAME)

</script>

<!--- Start DS -->

<call function="'StartDsWithScript'">

{ 'location' : syncserver.getHostname(),

'dsPath' : syncserverPath

}

</call>

<!-- WORK-AROUND for issue #2201 -->

<call function="'addEntry'">

{ 'location' : syncserver.getHostname(),

'dsPath' : syncserverPath,

'dsInstanceHost' : syncserver.getHostname(),

'dsInstancePort' : syncserver.getPort(),

'dsInstanceDn' : syncserver.getRootDn(),

'dsInstancePswd' : syncserver.getRootPwd(),

'entryToBeAdded' : '%s/%s/replication/workaround-2201.ldif' \

% (syncserver.getDir(),remote.reldatadir)

}

</call>

<message>

'List synchronization providers'

</message>

<call function="'listSyncProviders'">

{ 'location' : syncserver.getHostname(),

'dsPath' : syncserverPath,

'dsInstanceHost' : syncserver.getHostname(),

'dsInstancePort' : syncserver.getPort(),

'dsInstanceDn' : syncserver.getRootDn(),

'dsInstancePswd' : syncserver.getRootPwd()

}

</call>

<script>

replicationServer = syncserver.getChangelogServer()

replicatedSuffixList = syncserver.getSynchronizedSuffixList()

</script>

<if expr="replicationServer">

<sequence>

<message>

'Create replication server listening on port: %s' \

% replicationServer.getPort()

</message>

<call function="'createReplicationServer'">

{ 'location' : syncserver.getHostname(),

'dsPath' : syncserverPath,

'dsInstanceHost' : syncserver.getHostname(),

'dsInstancePort' : syncserver.getPort(),

'dsInstanceDn' : syncserver.getRootDn(),

'dsInstancePswd' : syncserver.getRootPwd(),

'replicationPort' : replicationServer.getPort(),

'replicationServerId' : replicationServer.getId(),

'replicationServerList' : replicationServer.getChangelogServerList()

}

</call>

</sequence>

</if>

<iterate var="suffix" in="replicatedSuffixList" indexvar="i">

<sequence>

<message>

'Create domain name for suffix: %s' % suffix.getSuffixDn()

</message>

<call function="'createMultimasterDomain'">

{ 'location' : syncserver.getHostname(),

'dsPath' : syncserverPath,

'dsInstanceHost' : syncserver.getHostname(),

'dsInstancePort' : syncserver.getPort(),

'dsInstanceDn' : syncserver.getRootDn(),

'dsInstancePswd' : syncserver.getRootPwd(),

'domainName' : 'SUFFIX-%s' % i,

'replicationDn' : suffix.getSuffixDn(),

'serverId' : suffix.getId(),

'replicationServerList' : suffix.getChangelogServerList()

}

</call>

</sequence>

</iterate>

<!--- Stop DS -->

<call function="'StopDsWithScript'">

{ 'location' : syncserver.getHostname(),

'dsHost' : syncserver.getHostname(),

'dsPath' : syncserverPath,

'dsPort' : syncserver.getPort(),

'dsBindDN' : syncserver.getRootDn(),

'dsBindPwd' : syncserver.getRootPwd()

}

</call>

</sequence>

</function>

<!-- Enable replication between servers using dsreplication -->

<function name="enableReplication">

<function-prolog>

This function enables replication between servers using dsreplication.

</function-prolog>

<function-map-args>

<function-arg-def name="location"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Location of target host

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsPath"

type="optional"

default="'%s/%s' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)">

<function-arg-description>

Pathname to installation root

</function-arg-description>

<function-arg-property name="type" value="filepath" />

</function-arg-def>

<function-arg-def name="dsInstanceHost"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsInstancePort" type="required">

<function-arg-description>

Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="dsInstanceDn" type="required">

<function-arg-description>

Bind DN

</function-arg-description>

<function-arg-property name="type" value="DN" />

</function-arg-def>

<function-arg-def name="dsInstancePswd" type="required">

<function-arg-description>

Bind password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="dsReplicationPort"

type="optional"

default="None">

<function-arg-description>

Replication port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="dsSecureReplication"

type="optional"

default="None">

<function-arg-description>

Encrypt communications over dsReplicationPort (secure replication)

</function-arg-description>

<function-arg-property name="type" value="boolean" />

</function-arg-def>

<function-arg-def name="refInstanceHost"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Reference Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="refInstancePort" type="required">

<function-arg-description>

Reference Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="refInstanceDn" type="required">

<function-arg-description>

Reference server Bind DN

</function-arg-description>

<function-arg-property name="type" value="DN" />

</function-arg-def>

<function-arg-def name="refInstancePswd" type="required">

<function-arg-description>

Reference server Bind password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="refReplicationPort"

type="optional"

default="None">

<function-arg-description>

Reference server Replication port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="refSecureReplication"

type="optional"

default="None">

<function-arg-description>

Encrypt communications over refReplicationPort (secure replication)

</function-arg-description>

<function-arg-property name="type" value="boolean" />

</function-arg-def>

<function-arg-def name="replicationDnList" type="required">

<function-arg-description>

DN of the replicated suffix

</function-arg-description>

<function-arg-property name="type" value="DN list" />

</function-arg-def>

<function-arg-def name="adminUID"

type="optional"

default="AdminUID">

<function-arg-description>

Global Administrator UID

</function-arg-description>

<function-arg-property name="type" value="UID" />

</function-arg-def>

<function-arg-def name="adminPswd"

type="optional"

default="AdminPswd">

<function-arg-description>

Global Administrator password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="noSchemaReplication"

type="optional"

default="None">

<function-arg-description>

Do not enable schema replication

</function-arg-description>

<function-arg-property name="type" value="boolean" />

</function-arg-def>

<function-arg-def name="useSecondServerAsSchemaSource"

type="optional"

default="None">

<function-arg-description>

Take the refInstanceHost as the source for the schema initialisation

</function-arg-description>

<function-arg-property name="type" value="boolean" />

</function-arg-def>

<function-arg-def name="expectedRC" type="optional" default="0">

<function-arg-description>

Expected return code value. Default value is 0.

Wildcard 'noCheck' to not check the RC

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

</function-map-args>

<sequence>

<!-- Local variables -->

<script>

STAFCmdParams=''

STAFCmd=''

if dsPath:

dsBinPath='%s/%s' % (dsPath,fileFolder)

STAFCmd='%s/%s%s' % (dsBinPath,DSREPLICATION,fileExt)

STAFCmdParamsList=[]

STAFCmdParamsList.append('enable')

STAFCmdParamsList.append('-n')

STAFCmdParamsList.append('-Q')

if dsInstanceHost:

STAFCmdParamsList.append('--host1 %s' % dsInstanceHost)

if dsInstancePort:

STAFCmdParamsList.append('--port1 %s' % dsInstancePort)

if dsInstanceDn:

STAFCmdParamsList.append('--bindDN1 "%s"' % dsInstanceDn)

if dsInstancePswd:

STAFCmdParamsList.append('--bindPassword1 "%s"' % dsInstancePswd)

if dsReplicationPort:

STAFCmdParamsList.append('--replicationPort1 %s' % dsReplicationPort)

if dsSecureReplication:

STAFCmdParamsList.append('--secureReplication1')

if refInstanceHost:

STAFCmdParamsList.append('--host2 %s' % refInstanceHost)

if refInstancePort:

STAFCmdParamsList.append('--port2 %s' % refInstancePort)

if refInstanceDn:

STAFCmdParamsList.append('--bindDN2 "%s"' % refInstanceDn)

if refInstancePswd:

STAFCmdParamsList.append('--bindPassword2 "%s"' % refInstancePswd)

if refReplicationPort:

STAFCmdParamsList.append('--replicationPort2 %s' % refReplicationPort)

if refSecureReplication:

STAFCmdParamsList.append('--secureReplication2')

if replicationDnList:

for dn in replicationDnList:

STAFCmdParamsList.append('-b "%s"' % dn)

if adminUID:

STAFCmdParamsList.append('-I "%s"' % adminUID)

if adminPswd:

STAFCmdParamsList.append('-w "%s"' % adminPswd)

if noSchemaReplication:

STAFCmdParamsList.append('--noSchemaReplication')

if useSecondServerAsSchemaSource:

STAFCmdParamsList.append('--useSecondServerAsSchemaSource')

STAFCmdParams=' '.join(STAFCmdParamsList)

</script>

<call function="'runCommand'">

{ 'name' : 'Enable Replication',

'location' : location,

'command' : STAFCmd,

'arguments' : STAFCmdParams,

'expectedRC': expectedRC

}

</call>

<return>

STAXResult

</return>

</sequence>

</function>

<!-- Initialize replicated suffix with the contents of a source server using

<function name="initializeReplication">

<function-prolog>

This function initializes replicated suffixes with the contents

of a source server using dsreplication.

</function-prolog>

<function-map-args>

<function-arg-def name="location"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Location of target host

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsPath"

type="optional"

default="'%s/%s' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)">

<function-arg-description>

Pathname to installation root

</function-arg-description>

<function-arg-property name="type" value="filepath" />

</function-arg-def>

<function-arg-def name="dsInstanceHost"

type="optional"

default="None">

<function-arg-description>

Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsInstancePort"

type="optional"

default="None">

<function-arg-description>

Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="sourceInstanceHost"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Source Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="sourceInstancePort" type="required">

<function-arg-description>

Source Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="replicationDnList" type="required">

<function-arg-description>

DN of the replicated suffix

</function-arg-description>

<function-arg-property name="type" value="DN list" />

</function-arg-def>

<function-arg-def name="adminUID"

type="optional"

default="AdminUID">

<function-arg-description>

Global Administrator UID

</function-arg-description>

<function-arg-property name="type" value="UID" />

</function-arg-def>

<function-arg-def name="adminPswd"

type="optional"

default="AdminPswd">

<function-arg-description>

Global Administrator password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="expectedRC" type="optional" default="0">

<function-arg-description>

Expected return code value. Default value is 0.

Wildcard 'noCheck' to not check the RC

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

</function-map-args>

<sequence>

<!-- Local variables -->

<script>

STAFCmdParams=''

STAFCmd=''

if dsPath:

dsBinPath='%s/%s' % (dsPath,fileFolder)

STAFCmd='%s/%s%s' % (dsBinPath,DSREPLICATION,fileExt)

STAFCmdParamsList=[]

if dsInstanceHost:

STAFCmdParamsList.append('initialize')

else:

STAFCmdParamsList.append('initialize-all')

STAFCmdParamsList.append('-n')

STAFCmdParamsList.append('-Q')

if dsInstanceHost:

STAFCmdParamsList.append('-O %s' % dsInstanceHost)

if dsInstancePort:

STAFCmdParamsList.append('--portDestination %s' % dsInstancePort)

if sourceInstanceHost:

STAFCmdParamsList.append('-h %s' % sourceInstanceHost)

if sourceInstancePort:

STAFCmdParamsList.append('-p %s' % sourceInstancePort)

if replicationDnList:

for dn in replicationDnList:

STAFCmdParamsList.append('-b "%s"' % dn)

if adminUID:

STAFCmdParamsList.append('-I "%s"' % adminUID)

if adminPswd:

STAFCmdParamsList.append('-w "%s"' % adminPswd)

STAFCmdParams=' '.join(STAFCmdParamsList)

</script>

<call function="'runCommand'">

{ 'name' : 'Initialize Replication',

'location' : location,

'command' : STAFCmd,

'arguments' : STAFCmdParams,

'expectedRC': expectedRC

}

</call>

<return>

STAXResult

</return>

</sequence>

</function>

<!-- Disable replication for given baseDN on server using dsreplication -->

<function name="disableReplication">

<function-prolog>

This function disables replication for a given baseDN on a server using

dsreplication.

</function-prolog>

<function-map-args>

<function-arg-def name="location"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Location of target host

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsPath"

type="optional"

default="'%s/%s' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)">

<function-arg-description>

Pathname to installation root

</function-arg-description>

<function-arg-property name="type" value="filepath" />

</function-arg-def>

<function-arg-def name="dsInstanceHost"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsInstancePort" type="required">

<function-arg-description>

Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="replicationDnList" type="required">

<function-arg-description>

DN of the replicated suffix

</function-arg-description>

<function-arg-property name="type" value="DN list" />

</function-arg-def>

<function-arg-def name="adminUID"

type="optional"

default="AdminUID">

<function-arg-description>

Global Administrator UID

</function-arg-description>

<function-arg-property name="type" value="UID" />

</function-arg-def>

<function-arg-def name="adminPswd"

type="optional"

default="AdminPswd">

<function-arg-description>

Global Administrator password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="expectedRC" type="optional" default="0">

<function-arg-description>

Expected return code value. Default value is 0.

Wildcard 'noCheck' to not check the RC

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

</function-map-args>

<sequence>

<!-- Local variables -->

<script>

STAFCmdParams=''

STAFCmd=''

if dsPath:

dsBinPath='%s/%s' % (dsPath,fileFolder)

STAFCmd='%s/%s%s' % (dsBinPath,DSREPLICATION,fileExt)

STAFCmdParamsList=[]

STAFCmdParamsList.append('disable')

STAFCmdParamsList.append('-n')

STAFCmdParamsList.append('-Q')

if dsInstanceHost:

STAFCmdParamsList.append('-h %s' % dsInstanceHost)

if dsInstancePort:

STAFCmdParamsList.append('-p %s' % dsInstancePort)

if replicationDnList:

for dn in replicationDnList:

STAFCmdParamsList.append('-b "%s"' % dn)

if adminUID:

STAFCmdParamsList.append('-I "%s"' % adminUID)

if adminPswd:

STAFCmdParamsList.append('-w "%s"' % adminPswd)

STAFCmdParams=' '.join(STAFCmdParamsList)

</script>

<call function="'runCommand'">

{ 'name' : 'Disable Replication',

'location' : location,

'command' : STAFCmd,

'arguments' : STAFCmdParams,

'expectedRC': expectedRC

}

</call>

<return>

STAXResult

</return>

</sequence>

</function>

<function name="readTopology">

<function-prolog>

This function reads the topology from a given file.

It parses the topology description file and sets _topologyServerList, a

list of the servers that form the topology.

</function-prolog>

<function-map-args>

<function-arg-def name="file" type="required">

<function-arg-description>

File containing the topology description.

</function-arg-description>

<function-arg-property name="type" value="filePath"/>

</function-arg-def>

</function-map-args>

<sequence>

<message>

'Parse file %s for topology parameters' % file

</message>

<script>

_topologyServerList = []

f = open(file, 'r')

hostname = None

dir = None

port = None

sslport = None

jmxport = None

rootDn = None

rootPwd = None

baseDn = None

changelogport = None

suffixList = []

changelogList = []

serverId = 1

fileLines = f.readlines()

for line in fileLines:

if line.startswith('#'):

continue

elif line.find('Hostname') != -1:

hostname = line[line.find('Hostname') + 9:].strip()

elif line.find('Directory') !=-1:

dir = line[line.find('Directory') + 10:].strip()

elif line.find('Port') != -1:

port = line[line.find('Port') + 5:].strip()

elif line.find('Sslport') != -1:

sslport = line[line.find('Sslport') + 8:].strip()

elif line.find('Jmxport') != -1:

jmxport = line[line.find('Jmxport') + 8:].strip()

elif line.find('RootDn') != -1:

rootDn = line[line.find('RootDn') + 7:].strip()

elif line.find('RootPwd') != -1:

rootPwd = line[line.find('RootPwd') + 8:].strip()

elif line.find('BaseDn') != -1:

baseDn = line[line.find('BaseDn') + 7:].strip()

elif line.find('Changelogport') != -1:

changelogport = line[line.find('Changelogport') + 14:].strip()

elif line.find('SynchronizedSuffix') != -1:

suffixList.append( line[line.find('SynchronizedSuffix') + 19:].strip() )

elif line.find('ChangelogServer') != -1:

changelogList.append( line[line.find('ChangelogServer') + 16:].strip() )

elif (line.isspace()) or (len(line) == 0):

server = Server(hostname, dir, port, sslport, jmxport, rootDn,

rootPwd, baseDn)

if changelogport != None:

changelogServer = ChangelogServer(changelogport, serverId)

for item in changelogList:

srv = item[:item.find(':')]

prt = item[item.find(':') + 1:]

changelogServer.addChangelogServer(srv, prt)

server.addChangelogServer(changelogServer)

for suffix in suffixList:

synchroSuffix = SynchronizedSuffix(suffix, serverId)

for item in changelogList:

srv = item[:item.find(':')]

prt = item[item.find(':') + 1:]

synchroSuffix.addChangelogServer(srv, prt)

server.addSynchronizedSuffix(synchroSuffix)

_topologyServerList.append(server)

hostname = None

dir = None

port = None

sslport = None

jmxport = None

rootDn = None

rootPwd = None

baseDn = None

changelogport = None

suffixList = []

changelogList = []

serverId += 1

if hostname != None:

server = Server(hostname, dir, port, sslport, jmxport, rootDn,

rootPwd, baseDn)

if changelogport != None:

changelogServer = ChangelogServer(changelogport, serverId)

for item in changelogList:

srv = item[:item.find(':')]

prt = item[item.find(':') + 1:]

changelogServer.addChangelogServer(srv, prt)

server.addChangelogServer(changelogServer)

for suffix in suffixList:

synchroSuffix = SynchronizedSuffix(suffix, serverId)

for item in changelogList:

srv = item[:item.find(':')]

prt = item[item.find(':') + 1:]

synchroSuffix.addChangelogServer(srv, prt)

server.addSynchronizedSuffix(synchroSuffix)

_topologyServerList.append(server)

f.close()

</script>

</sequence>

</function>

<function name="removeInstance">

<function-prolog>

This function removes an instance on a given host.

</function-prolog>

<function-map-args>

<function-arg-def name="dsHost"

type="optional"

default="DIRECTORY_INSTANCE_HOST">

<function-arg-description>

Hostname where the instance is to be created

</function-arg-description>

<function-arg-property name="type" value="hostname"/>

</function-arg-def>

<function-arg-def name="dsDir"

type="optional"

default="DIRECTORY_INSTANCE_DIR">

<function-arg-description>

Directory where OpenDS will be installed

</function-arg-description>

<function-arg-property name="type" value="filepath"/>

</function-arg-def>

</function-map-args>

<sequence>

<message>

'Removing instance %s/%s on host %s' % (dsDir,OPENDSNAME,dsHost)

</message>

<!-- ON REMOTE HOST: remove files and folders -->

<!--- Delete staging data file on remote host-->

<message>

'Delete staging data file %s/testdata.zip' % dsDir

</message>

<call function="'deleteFile'">

{ 'location' : dsHost,

'filename' : '%s/testdata.zip' % dsDir

}

</call>

<!--- Delete staging data folder on remote host -->

<message>

'Delete staging data folder %s/shared' % dsDir

</message>

<call function="'deleteFolder'">

{ 'location' : dsHost,

'foldername' : '%s/shared' % dsDir

}

</call>

<!--- Delete OPENDS zip file on remote host-->

<message>

'Delete OPENDS zip file %s/%s' % (dsDir,ZIPNAME)

</message>

<call function="'deleteFile'">

{ 'location' : dsHost,

'filename' : '%s/%s' % (dsDir,ZIPNAME) }

</call>

<call function="'checkRC'">

{ 'returncode' : RC ,

'result' : STAXResult

}

</call>

<if expr="returncode == 0">

<message>

'Instance removed.'

</message>

<else>

<message>

'Failed to remove instance.'

</message>

</else>

</if>

</sequence>

</function>

<function name="removeTopology">

<function-prolog>

This function removes the topology created for the Test Group/Suite.

</function-prolog>

<function-map-args>

<function-arg-def name="multipleInstanceTopology"

type="optional"

default="False">

<function-arg-description>

Tells whether it is a single (i.e. parameters read from config.py) or

a multiple-instance topology (i.e. parameters read from topology desc

file).

</function-arg-description>

<function-arg-property name="type" value="boolean"/>

</function-arg-def>

</function-map-args>

<sequence>

<if expr="multipleInstanceTopology == False">

<!-- SINGLE instance deployment: parameters read from config.py (done by

<call function="'removeInstance'" />

<else>

<!-- MULTIPLE instance deployment: parameters read from

<iterate var="server" in="_topologyServerList">

<call function="'removeInstance'">

{ 'dsHost' : server.getHostname(),

'dsDir' : server.getDir()

}

</call>

</iterate>

</else>

</if>

</sequence>

</function>

<!-- Prepare instance(s) for external re-initialisation of replicated suffix

<function name="preInitializeReplication">

<function-prolog>

This function prepares one or all instances in a topology for the external

re-initialisation of replicated suffixes using dsreplication.

</function-prolog>

<function-map-args>

<function-arg-def name="location"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Location of target host

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsPath"

type="optional"

default="'%s/%s' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)">

<function-arg-description>

Pathname to installation root

</function-arg-description>

<function-arg-property name="type" value="filepath" />

</function-arg-def>

<function-arg-def name="dsInstanceHost"

type="optional"

default="None">

<function-arg-description>

Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsInstancePort"

type="optional"

default="None">

<function-arg-description>

Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="localOnly"

type="optional"

default="None">

<function-arg-description>

Only the contents of the specified server will be initialised.

</function-arg-description>

<function-arg-property name="type" value="boolean" />

</function-arg-def>

<function-arg-def name="replicationDnList" type="required">

<function-arg-description>

DN of the replicated suffix

</function-arg-description>

<function-arg-property name="type" value="DN list" />

</function-arg-def>

<function-arg-def name="adminUID"

type="optional"

default="AdminUID">

<function-arg-description>

Global Administrator UID

</function-arg-description>

<function-arg-property name="type" value="UID" />

</function-arg-def>

<function-arg-def name="adminPswd"

type="optional"

default="AdminPswd">

<function-arg-description>

Global Administrator password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="expectedRC" type="optional" default="0">

<function-arg-description>

Expected return code value. Default value is 0

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

</function-map-args>

<sequence>

<message>

'Preparing instance %s:%s for external initialization' \

% (dsInstanceHost,dsInstancePort)

</message>

<!-- Local variables -->

<script>

STAFCmdParams=''

STAFCmd=''

if dsPath:

dsBinPath='%s/%s' % (dsPath,fileFolder)

STAFCmd='%s/%s%s' % (dsBinPath,DSREPLICATION,fileExt)

STAFCmdParamsList=[]

STAFCmdParamsList.append('pre-external-initialization')

STAFCmdParamsList.append('-n')

STAFCmdParamsList.append('-Q')

if dsInstanceHost:

STAFCmdParamsList.append('-h %s' % dsInstanceHost)

if dsInstancePort:

STAFCmdParamsList.append('-p %s' % dsInstancePort)

if localOnly:

STAFCmdParamsList.append('-l')

if replicationDnList:

for dn in replicationDnList:

STAFCmdParamsList.append('-b "%s"' % dn)

if adminUID:

STAFCmdParamsList.append('-I "%s"' % adminUID)

if adminPswd:

STAFCmdParamsList.append('-w "%s"' % adminPswd)

STAFCmdParams=' '.join(STAFCmdParamsList)

</script>

<call function="'runCommand'">

{ 'name' : 'Pre-Initialize Replication',

'location' : location,

'command' : STAFCmd,

'arguments' : STAFCmdParams

}

</call>

<script>

STAXCode=RC

STAXReason=STAXResult

</script>

<call function="'checktestRC'">

{ 'returncode' : STAXCode,

'result' : STAXReason,

'expected' : expectedRC

}

</call>

<return>

STAXReason

</return>

</sequence>

</function>

<!-- End process of instance(s) external re-initialisation of replicated

<function name="postInitializeReplication">

<function-prolog>

This function ends the process of the external re-initialisation of

replicated suffixes in one or all instances in a topology using

dsreplication.

</function-prolog>

<function-map-args>

<function-arg-def name="location"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Location of target host

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsPath"

type="optional"

default="'%s/%s' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)">

<function-arg-description>

Pathname to installation root

</function-arg-description>

<function-arg-property name="type" value="filepath" />

</function-arg-def>

<function-arg-def name="dsInstanceHost"

type="optional"

default="None">

<function-arg-description>

Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsInstancePort"

type="optional"

default="None">

<function-arg-description>

Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="replicationDnList" type="required">

<function-arg-description>

DN of the replicated suffix

</function-arg-description>

<function-arg-property name="type" value="DN list" />

</function-arg-def>

<function-arg-def name="adminUID"

type="optional"

default="AdminUID">

<function-arg-description>

Global Administrator UID

</function-arg-description>

<function-arg-property name="type" value="UID" />

</function-arg-def>

<function-arg-def name="adminPswd"

type="optional"

default="AdminPswd">

<function-arg-description>

Global Administrator password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="expectedRC" type="optional" default="0">

<function-arg-description>

Expected return code value. Default value is 0

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

</function-map-args>

<sequence>

<message>

'Post-processing external initialization of instance %s:%s' \

% (dsInstanceHost,dsInstancePort)

</message>

<!-- Local variables -->

<script>

STAFCmdParams=''

STAFCmd=''

if dsPath:

dsBinPath='%s/%s' % (dsPath,fileFolder)

STAFCmd='%s/%s%s' % (dsBinPath,DSREPLICATION,fileExt)

STAFCmdParamsList=[]

STAFCmdParamsList.append('post-external-initialization')

STAFCmdParamsList.append('-n')

STAFCmdParamsList.append('-Q')

if dsInstanceHost:

STAFCmdParamsList.append('-h %s' % dsInstanceHost)

if dsInstancePort:

STAFCmdParamsList.append('-p %s' % dsInstancePort)

if replicationDnList:

for dn in replicationDnList:

STAFCmdParamsList.append('-b "%s"' % dn)

if adminUID:

STAFCmdParamsList.append('-I "%s"' % adminUID)

if adminPswd:

STAFCmdParamsList.append('-w "%s"' % adminPswd)

STAFCmdParams=' '.join(STAFCmdParamsList)

</script>

<call function="'runCommand'">

{ 'name' : 'Post-Initialize Replication',

'location' : location,

'command' : STAFCmd,

'arguments' : STAFCmdParams

}

</call>

<script>

STAXCode=RC

STAXReason=STAXResult

</script>

<call function="'checktestRC'">

{ 'returncode' : STAXCode,

'result' : STAXReason,

'expected' : expectedRC

}

</call>

<return>

STAXReason

</return>

</sequence>

</function>

<!-- Reset replicated suffix with the backup of a source server using

<function name="resetReplicationData">

<function-prolog>

This function resets the data in a replicated suffix with the backup

of a source server and re-initialises the topology using dsreplication.

</function-prolog>

<function-map-args>

<function-arg-def name="location"

type="optional"

default="STAF_REMOTE_HOSTNAME">

<function-arg-description>

Location of target host

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="dsPath"

type="optional"

default="'%s/%s' % (DIRECTORY_INSTANCE_DIR,OPENDSNAME)">

<function-arg-description>

Pathname to installation root

</function-arg-description>

<function-arg-property name="type" value="filepath" />

</function-arg-def>

<function-arg-def name="sourceInstanceHost"

type="optional"

default="None">

<function-arg-description>

Directory server hostname or IP address

</function-arg-description>

<function-arg-property name="type" value="hostname" />

</function-arg-def>

<function-arg-def name="sourceInstancePort"

type="optional"

default="None">

<function-arg-description>

Directory server port number

</function-arg-description>

<function-arg-property name="type" value="Port number" />

</function-arg-def>

<function-arg-def name="sourceInstanceDn" type="required">

<function-arg-description>

Bind DN

</function-arg-description>

<function-arg-property name="type" value="DN" />

</function-arg-def>

<function-arg-def name="sourceInstancePswd" type="required">

<function-arg-description>

Bind password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="backupDir" type="required">

<function-arg-description>

The name of the backup directory

</function-arg-description>

<function-arg-property name="type" value="pathname"/>

</function-arg-def>

<function-arg-def name="suffixDn" type="required">

<function-arg-description>

DN of the replicated suffix

</function-arg-description>

<function-arg-property name="type" value="DN" />

</function-arg-def>

<function-arg-def name="adminUID"

type="optional"

default="AdminUID">

<function-arg-description>

Global Administrator UID

</function-arg-description>

<function-arg-property name="type" value="UID" />

</function-arg-def>

<function-arg-def name="adminPswd"

type="optional"

default="AdminPswd">

<function-arg-description>

Global Administrator password

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

<function-arg-def name="expectedRC"

type="optional"

default="0">

<function-arg-description>

Expected return code value. Default value is 0

</function-arg-description>

<function-arg-property name="type" value="string" />

</function-arg-def>

</function-map-args>

<sequence>

<message>

'Resetting %s data in replication topology using backup %s on instance \

%s:%s' % (suffixDn,backupDir,sourceInstanceHost,sourceInstancePort)

</message>

<!-- Pre-initialise the servers in the topology -->

<call function="'preInitializeReplication'">

{ 'location' : location,

'dsPath' : dsPath,

'dsInstanceHost' : sourceInstanceHost,

'dsInstancePort' : sourceInstancePort,

'localOnly' : False,

'replicationDnList' : [suffixDn],

'adminUID' : adminUID,

'adminPswd' : adminPswd

}

</call>

<script>

import random

import java.util.Date

random.seed(java.util.Date().getTime())

resetCounter = '%s#%d' \

% (strftime('%Y-%m-%d %H:%M:%S',localtime()),random.randint(0,999))

</script>

<!-- Restore the data in the server -->

<call function="'restoreTask'">

{ 'location' : location,

'dsPath' : dsPath,

'dsInstanceHost' : sourceInstanceHost,

'dsInstancePort' : sourceInstancePort,

'dsInstanceDn' : sourceInstanceDn,

'dsInstancePswd' : sourceInstancePswd,

'taskID' : 'restore task - %s' % resetCounter,

'backupDir' : backupDir

}

</call>

<!-- Post-initialise the servers in the topology -->

<call function="'postInitializeReplication'">

{ 'location' : location,

'dsPath' : dsPath,

'dsInstanceHost' : sourceInstanceHost,

'dsInstancePort' : sourceInstancePort,

'replicationDnList' : [suffixDn],

'adminUID' : adminUID,

'adminPswd' : adminPswd

}

</call>

<!-- Initialise the servers in the topology -->

<call function="'initializeReplication'">

{ 'location' : location,

'dsPath' : dsPath,

'sourceInstanceHost' : sourceInstanceHost,

'sourceInstancePort' : sourceInstancePort,

'replicationDnList' : [suffixDn],

'adminUID' : adminUID,

'adminPswd' : adminPswd

}

</call>

<script>

STAXCode=RC

STAXReason=STAXResult

</script>

<call function="'checktestRC'">

{ 'returncode' : STAXCode,

'result' : STAXReason,

'expected' : expectedRC

}

</call>

<return>

STAXReason

</return>

</sequence>

</function>

</stax>