This function configures a Directory Server using a script Location of target host Pathname to installation root Directory server port number Base DN (only single base DN supported). Bind DN Bind password Bind password file Help option '%s %s' % (STAFCmd, STAFCmdParams) '%s' % location '%s' % STAFCmd '%s' % STAFCmdParams '%s/bin' % dsPath ['PATH=/bin:/usr/bin:%s/bin' % dsPath, 'JAVA_HOME=%s' % JAVA_HOME] { 'returncode' : RC , 'result' : STAXResult } This function starts a Directory Server Location of target host Pathname to installation root Directory server port number Directory server version Directory server system info Do not detach directory server from process Help option '%s %s' % (STAFCmd, STAFCmdParams) '%s' % location '%s' % STAFCmd '%s' % STAFCmdParams '%s/bin' % dsPath ['PATH=/bin:/usr/bin:%s/bin' % dsPath, 'JAVA_HOME=%s' % JAVA_HOME] { 'returncode' : RC , 'result' : STAXResult } This function starts a Directory Server using the script Location of target host Pathname to installation root Directory server hostname or IP address Directory server port number Use SSL for secure communication with the server Use StartTLS for secure communication with the server Bind DN Bind password Bind password file SASL bind options Use the proxied authorization control with the given authorization ID Reason the server is being stopped or restarted Attempt to automatically restart the server once it has stopped Time to begin the shutdown in YYYYMMDDhhmmss format (local time) Trust all server SSL certificates Certificate keystore path Certificate keystore PIN Certificate keystore PIN file Certificate trust store path Certificate trust store PIN Certificate trust store PIN file Help option '%s %s' % (STAFCmd, STAFCmdParams) '%s' % (location) '%s' % (STAFCmd) '%s' % (STAFCmdParams) '%s/bin' % dsPath ['PATH=/bin:/usr/bin:%s/bin' % dsPath, 'JAVA_HOME=%s' % JAVA_HOME] { 'returncode' : RC , 'result' : STAXResult } This function generates a server jks certificate '%s' % (STAF_REMOTE_HOSTNAME) '%s/bin/keytool' % JAVA_HOME '-genkey -alias server-cert -keyalg rsa -dname "cn=client,O=Sun Microsystems,C=US" -keystore "keystore" -storepass "servercert" -keypass "servercert"' '%s/../config' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : RC , 'result' : STAXResult } This function generates a server PKCS12 certificate '%s' % (STAF_REMOTE_HOSTNAME) '%s/bin/keytool' % JAVA_HOME '-genkey -alias server-cert -keyalg rsa -dname "cn=client,O=Sun Microsystems,C=US" -keystore "keystore" -storepass "servercert" -keypass "servercert" -storetype "PKCS12"' '%s/../config' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : RC , 'result' : STAXResult } This function self-signs a server JKS certificate '%s' % (STAF_REMOTE_HOSTNAME) '%s/bin/keytool' % JAVA_HOME '-selfcert -alias server-cert -keystore "keystore" -storepass "servercert"' '%s/../config' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : RC , 'result' : STAXResult } This function self-signs a server PKCS12 certificate '%s' % (STAF_REMOTE_HOSTNAME) '%s/bin/keytool' % JAVA_HOME '-selfcert -alias server-cert -keystore "keystore" -storepass "servercert" -storetype "PKCS12"' '%s/../config' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : RC , 'result' : STAXResult } This function performs an offline import of an ldif file The name of the ldif file The name of the database backend Optional extra parameters for specific test cases 'import-ldif%s -l %s -n %s %s' % (fileExt,ldifFile,backEnd,extraParams) '%s' % (STAF_REMOTE_HOSTNAME) '%s/import-ldif%s' % (OPENDS_BINPATH,fileExt) '-l %s -n %s %s' % (ldifFile,backEnd,extraParams) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : importRC , 'result' : importResult } importRC This function performs an on line import task of an ldif file Directory Server host name Directory Server port number Directory Server Manager DN Directory Server Manager Password The identifier for the task The name of the ldif file Optional the name of the database backend Optional imported ldif data file compressed Optional imported ldif data file encrypted Optional name of rejects file Optional name of rejects file Optional append imported ldif data Optional don't do schema validation on import Optional replace existing data Optional exclude branches Optional include branches Optional exclude attributes Optional include attributes Optional exclude filters Optional include filters 'Copy import task ldif (import-task.ldif) file from %s to %s' % (TMP_DATA_DIR,STAGED_DATA_DIR) { 'location' : STAXServiceMachine, 'srcfile' : '%s/import-task.ldif' % TMP_DATA_DIR, 'destfile' : '%s/import-task.ldif' % STAGED_DATA_DIR, 'remotehost' : STAF_REMOTE_HOSTNAME } 'ldapmodify%s -a -h %s -p %s -D "%s" -w %s' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapmodify%s' % (OPENDS_BINPATH,fileExt) '-a -h %s -p %s -D "%s" -w %s' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] '%s/import-task.ldif' % STAGED_DATA_DIR { 'returncode' : importTaskRC , 'result' : importTaskResult } 'ldapsearch%s -h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapsearch%s' % (OPENDS_BINPATH,fileExt) '-h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] 'No match on ds-task-state.' { 'returncode' : searchRC , 'result' : searchResult } { 'sleepForMilliSeconds' : '2000' } loopRC This function verifies an import of an ldif file Entries expected to be present after import Optional entries expected to be present after import Optional attributes expected to be present after import Optional attributes expected to be present after import Optional main suffix for the import Optional start the Directory Server after import { 'location' : STAF_REMOTE_HOSTNAME } { 'noOfLoops' : 5 , 'noOfMilliSeconds' : 2000 } { 'dsInstanceHost' : DIRECTORY_INSTANCE_HOST , 'dsInstancePort' : DIRECTORY_INSTANCE_PORT , 'dsInstanceDn' : DIRECTORY_INSTANCE_DN , 'dsInstancePswd' : DIRECTORY_INSTANCE_PSWD , 'dsBaseDN' : '%s' % expectedEntry , 'dsFilter' : 'objectclass=*' } { 'returncode' : RC , 'result' : STAXResult } { 'dsInstanceHost' : DIRECTORY_INSTANCE_HOST , 'dsInstancePort' : DIRECTORY_INSTANCE_PORT , 'dsInstanceDn' : DIRECTORY_INSTANCE_DN , 'dsInstancePswd' : DIRECTORY_INSTANCE_PSWD , 'dsBaseDN' : '%s' % missingEntry , 'dsFilter' : 'objectclass=*' } { 'returncode' : RC , 'result' : STAXResult, 'expected' : 32 } { 'location' : STAF_REMOTE_HOSTNAME, 'dsHost' : DIRECTORY_INSTANCE_HOST, 'dsPort' : DIRECTORY_INSTANCE_PORT, 'dsBindDN' : DIRECTORY_INSTANCE_DN, 'dsBindPwd' : DIRECTORY_INSTANCE_PSWD } This function performs an export to an ldif file on or off line The name of the ldif file to be written The name of the database backend Optional extra parameters for specific test cases 'export-ldif%s -l %s -n %s %s' % (fileExt,ldifFile,backEnd,extraParams) '%s' % (STAF_REMOTE_HOSTNAME) '%s/export-ldif%s' % (OPENDS_BINPATH,fileExt) '-l %s -n %s %s' % (ldifFile,backEnd,extraParams) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : exportRC , 'result' : exportResult } exportRC This function performs an on line export task of an ldif file Directory Server host name Directory Server port number Directory Server Manager DN Directory Server Manager Password The identifier for the task The name of the ldif file Optional the name of the database backend Optional exported ldif data file compressed Optional exported ldif data file encrypted Optional append exported ldif data Optional exclude branches Optional include branches Optional exclude attributes Optional include attributes Optional exclude filters Optional include filters Optional generate a signed hash of the export data 'Copy export task ldif file.' { 'location' : STAXServiceMachine, 'srcfile' : '%s/export-task.ldif' % TMP_DATA_DIR, 'destfile' : '%s/export-task.ldif' % STAGED_DATA_DIR, 'remotehost' : STAF_REMOTE_HOSTNAME } 'ldapmodify%s -a -h %s -p %s -D "%s" -w %s' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapmodify%s' % (OPENDS_BINPATH,fileExt) '-a -h %s -p %s -D "%s" -w %s' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] '%s/export-task.ldif' % STAGED_DATA_DIR { 'returncode' : exportTaskRC , 'result' : exportTaskResult } 'ldapsearch%s -h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapsearch%s' % (OPENDS_BINPATH,fileExt) '-h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] 'No match on ds-task-state.' { 'returncode' : searchRC , 'result' : searchResult } { 'sleepForMilliSeconds' : '2000' } loopRC This function performs an on line backup The directory where the backup files will be placed The name of the database backend Optional extra parameters for specific test cases 'backup%s -n %s -d %s %s' % (fileExt,backEnd,backupDir,extraParams) '%s' % (STAF_REMOTE_HOSTNAME) '%s/backup%s' % (OPENDS_BINPATH,fileExt) '-d %s -n %s %s' % (backupDir,backEnd,extraParams) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : backupRC , 'result' : backupResult } backupRC This function performs an on line backup task Directory Server host name Directory Server port number Directory Server Manager DN Directory Server Manager Password The identifier for the task Path to the target directory for the backup file(s) Optional the name of the database backend Optional back up all backends in the server Optional perform an incremental backup rather than a full backup Optional use the provided identifier for the backup Optional backup contents compressed Optional backup contents encrypted Optional generate a signed hash of the backup data Optional generate a hash of the backup data 'Copy backup task ldif file.' { 'location' : STAXServiceMachine, 'srcfile' : '%s/backup-task.ldif' % TMP_DATA_DIR, 'destfile' : '%s/backup-task.ldif' % STAGED_DATA_DIR, 'remotehost' : STAF_REMOTE_HOSTNAME } 'ldapmodify%s -a -h %s -p %s -D "%s" -w %s' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapmodify%s' % (OPENDS_BINPATH,fileExt) '-a -h %s -p %s -D "%s" -w %s' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] '%s/backup-task.ldif' % STAGED_DATA_DIR { 'returncode' : backupTaskRC , 'result' : backupTaskResult } 'ldapsearch%s -h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapsearch%s' % (OPENDS_BINPATH,fileExt) '-h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] 'No match on ds-task-state.' { 'returncode' : searchRC , 'result' : searchResult } { 'sleepForMilliSeconds' : '2000' } loopRC This function performs an off line restore Path to the directory containing the backup file(s) Optional extra parameters for specific test cases 'Stopping OpenDS' { 'location' : STAF_REMOTE_HOSTNAME, 'dsHost' : DIRECTORY_INSTANCE_HOST, 'dsPort' : DIRECTORY_INSTANCE_PORT, 'dsBindDN' : DIRECTORY_INSTANCE_DN, 'dsBindPwd' : DIRECTORY_INSTANCE_PSWD } { 'returncode' : RC , 'result' : STAXResult } 'restore%s -d %s %s' % (fileExt,backupDir,extraParams) '%s' % (STAF_REMOTE_HOSTNAME) '%s/restore%s' % (OPENDS_BINPATH,fileExt) '-d %s %s' % (backupDir,extraParams) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] { 'returncode' : restoreRC , 'result' : restoreResult } 'Starting DS' { 'location' : STAF_REMOTE_HOSTNAME } { 'returncode' : RC , 'result' : STAXResult } restoreRC This function performs an on line restore task of a backup file Directory Server host name Directory Server port number Directory Server Manager DN Directory Server Manager Password The identifier for the task The name of the backup directory Optional the name of the backupId Optional verify the contents of the backup but do not restore it 'Copy restore task ldif file.' { 'location' : STAXServiceMachine, 'srcfile' : '%s/restore-task.ldif' % TMP_DATA_DIR, 'destfile' : '%s/restore-task.ldif' % STAGED_DATA_DIR, 'remotehost' : STAF_REMOTE_HOSTNAME } 'ldapmodify%s -a -h %s -p %s -D "%s" -w %s' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapmodify%s' % (OPENDS_BINPATH,fileExt) '-a -h %s -p %s -D "%s" -w %s' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] '%s/restore-task.ldif' % STAGED_DATA_DIR { 'returncode' : restoreTaskRC , 'result' : restoreTaskResult } 'ldapsearch%s -h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (fileExt,dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (STAF_REMOTE_HOSTNAME) '%s/ldapsearch%s' % (OPENDS_BINPATH,fileExt) '-h %s -p %s -D "%s" -w %s -s base -b "%s" "objectclass=*" ds-task-state' % (dsInstanceHost,dsInstancePort,dsInstanceDn,dsInstancePswd,taskDN) '%s' % (OPENDS_BINPATH) ['PATH=/bin:/usr/bin:%s' % (OPENDS_BINPATH), 'JAVA_HOME=%s' % (JAVA_HOME)] 'No match on ds-task-state.' { 'returncode' : searchRC , 'result' : searchResult } { 'sleepForMilliSeconds' : '2000' } loopRC