Programming Guides › Programming Guide for Perl › Policy Management Operations › Policy Store Object Migration › Import Realm Objects

Import Realm Objects

Some points to note about importing realm objects:

• At the South site, the exported files Data.smdif (containing the object information) and NorthEnv.cfg (containing North site configuration information) have been placed in the same directory as the import script.
• A $datamgr object is created for the import operation. The object references the two files generated during the export.
• A single Import() call imports all the exported realms and their dependencies from the Data.smdif file.

  Note that the Import() call references the target-site-specific configuration file. This file is used in place of the source-site configuration file referenced in the $datamgr object.

• Neither of the default import flags has been changed:
  • An existing realm with the same name as an imported realm will be overwritten. Call OverwriteObjects(0) to protect realms from being overwritten.
  • The realms and their dependencies are imported. You can import just the realms with IncludeDependencies(0).

Example:

use Netegrity::PolicyMgtAPI;

$policyapi = Netegrity::PolicyMgtAPI‑>New();
$session = $policyapi‑>CreateSession("adminsouth", "adminpwd");
$datamgr = $session‑>CreateDataManager("Data.smdif",NorthEnv.cfg);
die "FATAL: Data manager creation failed.\n" unless($datamgr!=undef);

print "\nData manager creation was successful.";
$domain = $session‑>GetDomain("Acme North Domain");
$result=$datamgr‑>Import("SouthEnv.cfg",$domain);
print "\nResult of import: " . $result . "\n";

When importing objects from multiple data files, you need a PolicyMgtDataMgr object for each file.

Example:

The following script imports realm objects to the policy store at a company's South site from two other sites—a North site and a West site. At the South site, the data and configuration files generated from each export are placed in the same directory as the import script. The South-site configuration file is also located there:

use Netegrity::PolicyMgtAPI;

$policyapi = Netegrity::PolicyMgtAPI‑>New();
$session = $policyapi‑>CreateSession("adminsouth", "adminpwd");

$domain = $session‑>GetDomain("Acme South Domain");

#create data manager for North site file
$mNorth=$session‑>CreateDataManager("DataNorth.smdif","NorthEnv.cfg");
if ($mNorth == undef) {
   print "\nData manager creation for North site file failed.\n";
}
else {
   print "\nData manager creation for North site file successful.\n";
   #Import realms from North site file
   $result=$mNorth‑>Import("SouthEnv.cfg",$domain);
   print "\nResult of import of North site realms: ".$result."\n";
}

#create data manager for West site file
$mWest=$session‑>CreateDataManager("DataWest.smdif","WestEnv.cfg");
if ($mWest == undef) {
   print "\nData manager creation for West site file failed.\n";
}
else {
   print "\nData manager creation for West site file successful.\n";
   #Import realms from West site file
   $result=$mWest‑>Import("SouthEnv.cfg",$domain);
   print "\nResult of import of West site realms: ".$result."\n";
}