occ-instance-migrator

This tool will copy just the changes from a source instance to a target instance using Oracle Commerce Cloud DCU. A check is made first to see if the target instance is missing extensions installed in the source. If extensions are missing then only the deltas are copied prior to the DCU transferAll executing. There is almost to 70% savings in time including the DCU and PLSU transfer processes. This is still a work in process but has saved me quite some time *Web Content data is currently not supported and coming in a later OCC release. (Dec 2018)

18D (18.6) Transfer issue

There is an isssue with the --transferAll so if you are still on 18C Maintenance Pak (18.5.1) then this will still work for you. In conversation with the support team as to what the issue might be.

1. This installation is tested and working in node version 8.11.1
2. There was an issue with upgrading from High Sierra to MoJave, document here: nodegit/nodegit#1347 (comment) Please reinstall libgcrypt

brew install libgcrypt

** There have been a few users who have reported issues with nodegit and getting the following error:

Error: Cannot find module '../build/Debug/nodegit.node'
I can't simulate this issue. If I have time I can look further, but please try version 2.0.1.0 as it uses the os installed version of git (which you need to have installed) so give that a try and let me know

current version

2.3.1

change log

2.3.1 - error handling for missing options/parameters

2.2.1 - fixes issue with global files not copying

2.1.0 - remove os-installed git dependency for npm nodegit - other bug fixes

2.0.0 - working version with os-git dependency

ATTENTION

REMEMBER, this will use DCU/PLUS transferALL from TARGET to SOURCE instance. PLEASE KNOW WHAT YOU ARE DOING.

status

todo: check if batch can be performed
todo: convert to global node module
todo: parameterize the configuration
todo: check if a widget exists and install it before the transfer so that the instances can be populated.
todo: remove git dependency, replace with nodegit .
todo: test with up and coming DCU 1.0.8 and 18D(v16) release
todo: add SSE transfer
todo: add paymentGateway transfer

Prerequisites

Oracle Commerce Cloud
DCU v1.0.16
node js

Installation

Change directory to your downloaded occ-instance-migrator folder and install the applicaton globally:

$ npm i -g

Instructions to run

Please follow the installation instructions to set up the global DCU node application.

1. Create and "cd" to a folder that will be used for the tasks

$ mkdir a_folder
$ cd a_folder

2. Run oim with the options referenced below.

$ oim [options]

Options

$ oim -help

Usage: oim [options] [command]

Wrapper for DCU  to only deploy instances differences across tool.
Dependencies:
                Oracle DCU -  https://docs.oracle.com/cd/E97801_01/Cloud.18C/ExtendingCC/html/s4305usethedcutograbanduploadsourceco01.html

Options:
  -V, --version                      output the version number
  -s --sourceserver <sourceserver>   Occ Admin url for source instance (from)
  -t --sourcekey <sourcekey>         Occ Admin api key for source instance (from)
  -u --targetserver <targetserver>   Occ Admin url for target instance (to)
  -v --targetkey <targetkey>         Occ Admin api key for target instance (from)
  -L, --includelayouts               Transfer All Layouts [true | false]
  -t, --taskdelay                    Execution delay in milliseconds between tasks.   Defaults to 3000ms
  -h, --help                         output usage information

Commands:
  oim, [sourceserver] [sourcekey] [targetserver] [targetkey]  Execute a dcu transferAll from source to target instance
  help [cmd]                         display help for [cmd]

Transfer Extensions :

$  oim -s {SOURCE_SERVER}
       -t {SOURCE_KEY}
       -u {TARGET_SERVER}
       -v {TARGET_KEY}

Transfer Page Layouts (PLSU) to :

$  oim -s {SOURCE_SERVER}
       -t {SOURCE_KEY}
       -u {TARGET_SERVER}
       -v {TARGET_KEY}
       -L

Disclaimer of Warranty.

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.