config-copy

Downloads6
Subscribe
0
Bookmark
0
This application is not supported by InterSystems Corporation. Please be notified that you use it at your own responsibility.
Details
Releases
Reviews
Issues

What's new in this version

  • Description added in module.xml

iris-config-copy

This a tools to export configuration from an Interystems IRIS instance and import it to another.

How it works

Config-copy must be installed on the source and the target instance.
The target instance perform REST request to get the config from the source instance.

Installation and configuration

Source instance

zpm "install config-copy"

Non ZPM users should import and compile config-copy_for_IRIS.xml or config-copy_for_HealthShare.xml if you use HealthShare and not IRIS yet.

On the source instance we need to create a web application used by the target instance to retrieve the configuration.

Do ##class(lscalese.configcopy.Utils).SetWebApp()

The web application /csp/lscalese/configcopy is now added.

Target instance

Install config-api on a Ensemble enabled namespace. (To enable Ensemble use : Do ##class(%EnsembleMgr).EnableNamespace($namespace) )

zpm "install config-copy"

Non ZPM users should import and compile config-copy_for_IRIS.xml or config-copy_for_HealthShare.xml if you use HealthShare and not IRIS yet.

We must setup ip address (or hostname), port, SSConfig (in case of https usage) and credential to access to the source instance.

Do ##class(lscalese.configcopy.Utils).SetRemoteSettings(<source hostname>, <port>, <sslconfig>)
Do ##class(lscalese.configcopy.Utils).SetCredential("_system","SYS")

Samples

Export configuration from the source instance and import to local instance

Export configuration from the remote instance (source) and import to this local instance (target).

Set sc = ##class(lscalese.configcopy.ImportFromRemote).All()

Export configuration from the local instance to a directory

Set sc = ##class(lscalese.configcopy.LocalExport).All($zu(12,"config-copy-local"))

Export remote instance configuration to a local directory

Set sc = ##class(lscalese.configcopy.RemoteExport).All($zu(12,"config-copy-remote"))

Import configuration from local files.

Adapt the following examples with the path of each configuration files.

Import security

Set sc = ##class(lscalese.configcopy.LocalImport).Security("SecurityExport.xml")

Import globals contain SQL Connections

Set sc = ##class(lscalese.configcopy.LocalImport).Globals("GlobalsExport.xml")

Import CPF configuration data

Set sc = ##class(lscalese.configcopy.LocalImport).CPFData("config-api.json")

Import Tasks

Set sc = ##class(lscalese.configcopy.LocalImport).Tasks("TasksExport.xml")
ZPM installation
zpm "install config-copy"
Rating
5 (1)
Category
Solutions
Works with
InterSystems IRISHealthShare
Tags
Info
Version
1.0.2
Last updated
2021-09-29
Repository
Open
Documentation
Open
License
Link