The tool for migrating SystemLink data.
Project description
NI-SystemLink-Migration tool nislmigrate
nislmigrate
is a command line utility for migration, backup, and restore of supported SystemLink services.
Installation
Prerequisites
1. SystemLink
- This tool currently supports migration from a SystemLink 2020R1 server, migration between other versions has not been tested.
- We assume the server you are migrating to is clean with no data. Migrating to a server with existing data will result in data loss.
- Not all services are supported yet, see Supported Services for details.
- This tool assumes a single-box SystemLink installation.
- This tool must be run on the same machines as the SystemLink installations.
2. Python
- This tool requires Python 3.8 to run.
- The documentation in this repository assumes Python has been added to your PATH.
Installation
The latest released version of the tool can be installed by running:
pip install nislmigrate
Usage
Backup
To backup the data for a service listed in the Supported Services section run the tool with elevated permissions and the capture
option and the corresponding flag for each of the services you want to back up (e.g. --tags
):
nislmigrate capture --tags
This will backup the data corresponding with each service into the default migration directory (C:\Users\[user]\Documents\migration\
). You can specify a different migration directory using the --dir [path]
option:
nislmigrate capture --tags --dir C:\custom-backup-location
Restore
To restore the data for a service listed in the Supported Services section run the tool with elevated permissions and the restore
option and the corresponding flag for each of the services you want to restore (e.g. --tags
):
nislmigrate capture --tags
This will restore the data corresponding with each service from the default migration directory (C:\Users\[user]\Documents\migration\
). If your captured data is in a different directory that can be specified with the --dir [path]
option:
nislmigrate capture --tags --dir C:\custom-backup-location
Migration
To migrate from one SystemLink server instance (server A) to a different instance (server B):
- Install the migration tool on server A and server B.
- Follow the backup instructions to backup the data from server A.
- Copy the data produced by the backup of server A on server B.
- Ensure server B is a clean SystemLink install with no existing data.
- Follow the restore instructions to restore the backed up data onto server B.
Development
See CONTRIBUTING.MD
for detailed instructions on developing, testing, and releasing the tool.
Supported Services
The following services can be migrated with this utility:
- Tag Ingestion and Tag History:
--tags
There are plans to support the following services in the near future:
- Tag Alarm Rules:
--alarms
- OPCUA Client:
--opc
- File Ingestion:
--files
- Test Monitor:
--tests
- Asset Management:
--assets
- Cannot be migrated between 2020R1 and 2020R2 servers
- Repository:
--repo
- Feeds may require additional updates if servers used for migration have different domain names
- User Data:
--userdata
- Notifications:
--notification
- States:
--states
- Feeds may require additional updates if servers used for migration have different domain names
- Cannot be migrated between 2020R1 and 2020R2 servers
The following list of services is explicitly not supported because of issues that arose when developing and testing migrating the service that will require changes to the service rather than the migration utility to enable support:
- Cloud Connector
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nislmigrate-0.0.19-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 04e679e359385b297a1de8a3a2aa1a2411d467f1108e54652e9ea1a73d2c01e3 |
|
MD5 | 9c47df1ef86d9deb2ab3e44589a59664 |
|
BLAKE2b-256 | 0843e84f19d7221d7f65d6ecd5b8d685ecf67fcaebe4a3421654cee29a33b354 |