Home Applications config-copy

config-copy

This application is not supported by InterSystems Corporation. Please be notified that you use it at your own risk.
5
1 reviews
0
Awards
203
Views
12
IPM installs
2
2
Details
Releases  (3)
Reviews  (1)
Issues
Dependencies  (2)
Helper to copy the config from an IRIS instance to another

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(, , )
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")
Made with
Install
zpm install config-copy download archive
Version
1.0.229 Sep, 2021
Category
Solutions
Works with
InterSystems IRISHealthShare
First published
25 Sep, 2021
Last checked by moderator
26 Nov, 2024Works