v2.4.14 - final

Author: Marcin Przepiorowski

.github/workflows/build.yml

@@ -43,6 +43,34 @@ jobs:
         name: cento7build
         path: ${{ env.FILENAME }}
 
+  docker:
+    needs: [centos7]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v3
+        with:
+          images: pioro/dxtoolkit
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v1
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v1
+      - name: Login to DockerHub
+        uses: docker/login-action@v1
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      - name: Build and push
+        id: docker_build
+        uses: docker/build-push-action@v2
+        with:
+          context: docker/
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+
 
   ubuntu:
     needs: [centos7]
@@ -185,7 +213,7 @@ jobs:
 
   osx:
     needs: [centos7]
-    runs-on: macos-latest
+    runs-on: macos-10.15
 
     steps:
     - name: checkout dxtoolkit code
@@ -213,10 +241,10 @@ jobs:
         #brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/8ff2935985d6da4f2f463ea2666545e6017c4d54/Formula/perl.rb
         brew install pioro/repo/[email protected]
         brew install cpanminus
-        # brew install openssl
+        brew install openssl@1.1
         cpanm Crypt::CBC
         cpanm Crypt::Blowfish
-        export OPENSSL_PREFIX=`brew --prefix openssl`
+        export OPENSSL_PREFIX=`brew --prefix openssl@1.1`
         echo $OPENSSL_PREFIX
         export LIBS="-d=$OPENSSL_PREFIX"
         cpanm --configure-args=$LIBS Filter::Crypto::Decrypt
@@ -229,17 +257,19 @@ jobs:
         cpanm Text::CSV
         cpanm LWP::UserAgent
         cpanm Net::SSLeay
-        cpanm IO::Socket::SSL
+        cpanm Mozilla::CA@20180117
+        cpanm IO::Socket::[email protected]
         cpanm LWP::Protocol::https
         cpanm Term::ReadKey
         cpanm -f Archive::Zip
+        cpanm utf8
         cpanm PAR::Packer
         cpanm List::MoreUtils::PP
 
     - name: Compile
       run: |
           CELL=`brew --prefix pioro/repo/[email protected]`
-          OPENLIB=`brew --prefix openssl`
+          OPENLIB=`brew --prefix openssl@1.1`
           CDIR=`pwd`
           export PP=${CELL}/bin/pp
           export LIBS="-l ${OPENLIB}/lib/libssl.dylib -l ${OPENLIB}/lib/libcrypto.dylib"

CHANGELOG.md

@@ -12,6 +12,8 @@
 - dx_ctl_engine_upgrade apply action fixed - it monitors now a whole upgrade process, including engine reboot
 - [fix for #195](https://github.com/delphix/dxtoolkit/issues/195) - this was generic issue with snapshot paging
 - [fix for #193](https://github.com/delphix/dxtoolkit/issues/193) - dx_get_env creates different envtype than what dx_create_env expects
+- fix for backup metadata in dx_get_db_env
+- fix for printing hierarchy in dx_get_hierarchy for objects with same reference across 2 engines
 
 
 ## 2.4.13

README.md

@@ -2,7 +2,7 @@
 
 ## What is it
 
-Dxtoolkit is a set of scripts, which are delivered by Delphix professional services team. 
+Dxtoolkit is a set of scripts, which are delivered by Delphix professional services team.
 Dxtoolkit scripts look and feel like UNIX executables, following the typical conventions of using flags for arguments.  Dxtoolkit is written in Perl, but no knowledge of Perl is required unless you want to extend it.  In fact, no programming experience whatsoever is required to use the dxtoolkit.
 
 ## What's new
@@ -12,21 +12,24 @@ Please check a [change log](https://github.com/delphix/dxtoolkit/blob/master/CHA
 ## How to get started
 ### Compiled version
 
-**Prerequisites**
-* OpenSSL 1.0 library is required for Solaris Sparc, Solaris x64, Red Hat 6 and Red Hat 7 
-* OpenSSL 0.98 library is required for Red Hat 5
-
-If you don't have required version of OpenSSL library download a version with -openssl- in name, where
-those libraries are embbeded.
-
-Download a compiled version of DxToolkit for required platform from a [releases  page](https://github.com/delphix/dxtoolkit/releases). 
+Download a compiled version of DxToolkit for required platform from a [releases  page](https://github.com/delphix/dxtoolkit/releases).
 Create a configuration file *dxtools.conf* based on dxtools.conf.example or a Wiki page.
 
 Check a [documentation](https://github.com/delphix/dxtoolkit/wiki) for more details
 
-### Known issues
 
-There is no script dx_syslog on Windows and AIX due to lack of support of Log::Syslog::Fast Perl module
+### Docker image
+
+Run dxtoolkit using a docker image:
+1. Create configuration file *dxtools.conf* based on dxtools.conf.example or a Wiki page.
+2. Run a docker image with the following parameters:
+  * path redirection: `-v /path/to/your/configfile:/config`
+  * image name: `pioro/dxtoolkit:develop`
+  * `dxtoolkit_command dxtoolkit_command_params`
+
+
+   ex: `docker run -v /configdir:/config pioro/dxtoolkit:latest dx_get_appliance -d myengine`
+
 
 ### Source version
 
@@ -48,6 +51,30 @@ Perl version 5.16 or higher
 - Term::ReadKey
 - Log::Syslog::Fast
 
+
+### Known issues
+
+There is no script dx_syslog on Windows and AIX due to lack of support of Log::Syslog::Fast Perl module
+
+
+### Support matrix
+
+New releases of dxtoolkit are tested with Delphix Engines, which are in primary or extended support.
+Ex. 2.4.14 release was tested with version 5.3.9 and 6.0.X engines.
+
+Dxtoolkit is designed to support many versions of Delphix Engines, although if a new version is released after dxtoolkit release
+it may stop working due to API changes. To mitigate this issue until next dxtoolkit version will be release, please add
+-dever parameter to your commands with the following values:
+
+|parameter|Delphix Engine version|API version|
+| :---    |     :---:            | :---      |
+| -dever 6.0.11| Delphix Engine 6.0.11 | API 1.11.11|
+| -dever 6.0| Delphix Engine 6.0 | API 1.11.00|
+| -dever 5.3| Delphix Engine 5.3 | API 1.10.00|
+| -dever 5.2| Delphix Engine 5.2 | API 1.9.00|
+
+
+
 ## <a id="contribute"></a>Contribute
 
 1.  Fork the project.