The following information applies to cirrus migrate cloud version 2.8.0 and above (released October 2021). HTTPS proxy supported for both installation and operation in older versions, but manual procedure is required to modify system environment variables. Please contact support for assistance if needed.

Cirrus Migrate Cloud automatically honors environment variable HTTPS_PROXY and NO_PROXY during installation and when initially registering to Cirrus Data Cloud.

WARNING: If system-wide HTTPS_PROXY is used, loopback address 127.0.0.1 must be part of the NO_PROXY list in order for Cirrus Migrate Cloud to operate properly.

Linux

When using the provided curl command to install cirrus migrate cloud, ensure that the two supported environment variables are set and exported. This can be achieved in multiple ways including modify /etc/profile or .bashrc files.

If proxy is not enabled system-wide, you can simply export it in shell before running the provided curl command. For example:

export HTTPS_PROXY=proxy_ip:proxy_port
curl get.cirrusdata.cloud/install-gm | bash -s -- -rgc XXXXXXXXX....


If proxy is used with installation command, the same settings will automatically be copied to the cirrus migrate configuration file /opt/CirrusData/galaxy-migrate/etc/config.yaml and the same setting will automatically be used for communication with cirrus data cloud.

If proxy settings need to be modified in the future, the aforementioned config.yaml file can be modified directly. Service restart will be needed for the new setting to take effect.

Windows

Before running the provided PowerShell command to install, ensure that the two supported environment variables are configured. This can be done the following methods:

Configure via UI
Navigating to to Control Panel > System and Security > System > Advanced system settings > Environment Variables_ and click New... under System variables.

Configure via CLI
Confirm existing setting by running echo $env:HTTPS_PROXY and echo $env:NO_PROXY
Open cmd.exe and run the following commands:
setx "HTTPS_PROXY" "http://YOUR_PROXY:PORT" /m`` 
setx "NO_PROXY" "127.0.0.1" /m

Close all existing cmd and PowerShell sessions.
Open new PowerShell window and confirm that the new settings have now taken effect.

Once the HTTPS_PROXY and NO_PROXY setting is confirmed, run the provided PowerShell command to proceed with installation.

On certain older Microsoft Windows versions, proxy environment variables are not honored correctly. If you encounter errors, a -Proxy flag may have to be added to the Invoke-RestMethod cmdlet (irm). E.g. iex "& { $(irm -Proxy http://YOUR_PROXY:PORT https://get.cirrusdata.cloud/install-gm-win) } -rgc XXXXXXXXXXXXXXXXXXX

If proxy is used with installation command, the same settings will automatically be copied to the cirrus migrate configuration file C:\Program Files\CirrusData\galaxy-migrate\config.yaml and the same setting will automatically be used for communication with cirrus data cloud.

If proxy settings need to be modified in the future, the aforementioned config.yaml file can be modified directly. Service restart will be needed for the new setting to take effect.

#app-hint:deploy-cirrus-migrate
Was this article helpful?
Cancel
Thank you!