src/game/server/database/build/linux/copy_buildcluster.readme

   1 Function: Copies build cluster data and underlying schema structure to a user schema of your choice
   2
   3 Reason for existence:
   4
   5 Copying data from the build cluster is not possible if the underlying schema structures
   6 between source and destination schemas is different. So when someone wants the build
   7 cluster data but there schema has changed or visa versa, they can't get it and
   8 DBA intervention is required. This tools automates the DBA processes
   9 and copies the entire schema structure data and all.
  10
  11 Requirements:
  12
  13 Needs oracle client with import and export utilities (verifying this is installed)
  14 Perl Bash/Cygwin bash
  15 User schema must have EXP_FULL_DATABASE and IMP_FULL_DATABASE permissions (they all do now on swodb)
  16
  17 Location:
  18
  19 on current in ../src/game/server/database/build/linux
  20 and this utility must be run from this directory
  21
  22 Usage:
  23
  24 The following line will perform the whole process:
  25
  26 make copy_buildcluster
  27
  28 OR
  29
  30 perl copy_buildcluster.pl --copybuildcluster --username=testuser --password=changeme --service=swodb
  31
  32 There are other options available (see below) but they are just the
  33 individual steps and the casual DB user should never have to use them
  34
  35 $ perl copy_buildcluster.pl
  36 Usage: copy_buildcluster.pl [COMMAND] [OPTION]...
  37 Copy buildcluster using Oracle export/import.
  38
  39 ******************* WARNING *******************.
  40 * This utility will delete all existing user  *
  41 *            objects in your schema           *
  42 ***********************************************.
  43
  44 Commands:
  45   --copybuildcluster    Perform complete buildcluster copy to user schema.
  46   --exportbuildcluster  Export buildcluster to file using direct path.
  47   --importbuildcluster  Import buildcluster from file using direct path.
  48   --createtypes         Recreate oracle typedefs.
  49   --wipeschema          Delete all objects from users schema.
  50   --recompilepackages   Recompile user database packages.
  51   --help                Display these options.
  52
  53 Options:
  54   --username=NAME       Specify the database user name. (Defaults to $USER.)
  55   --password=PASSWORD   Specify the database password.  (Defaults to "changeme".)
  56   --service=NAME        Specify the database service name.  (Defaults to "swodb".)
  57
  58 NOTES:
  59
  60 Just running this utility will not guarantee you a server that runs.
  61 Once the tool has exited successfully, you must sync your code to the revision you wish to test on and run database_update.pl --delta.
  62 If the delta between the build cluster DB version and your codes DB version is large, there is still a potential for problems.
  63 In this case, please contact one of the SWG DB guys.
  64
  65