Proxy server settings

The protection agents can transfer data through an HTTP/HTTPS proxy server. The server must work through an HTTP tunnel without scanning or interfering with the HTTP traffic. Man-in-the-middle proxies are not supported.

Because the agent registers itself in the cloud during the installation, the proxy server settings must be provided during the installation or in advance.

In Windows

If a proxy server is configured in Windows (Control panel > Internet Options > Connections), the setup program reads the proxy server settings from the registry and uses them automatically. Also, you can enter the proxy settings during the installation, or specify them in advance by using the procedure described below. To change the proxy settings after the installation, use the same procedure.

To specify the proxy settings in Windows

1. Create a new text document and open it in a text editor, such as Notepad.

2. Copy and paste the following lines into the file:

   Windows Registry Editor Version 5.00
   
   [HKEY_LOCAL_MACHINE\SOFTWARE\Acronis\Global\HttpProxy]
   "Enabled"=dword:00000001
   "Host"="proxy.company.com"
   "Port"=dword:000001bb
   "Login"="proxy_login"
   "Password"="proxy_password"

3. Replace proxy.company.com with your proxy server host name/IP address, and 000001bb with the hexadecimal value of the port number. For example, 000001bb is port 443.

4. If your proxy server requires authentication, replace proxy_login and proxy_password with the proxy server credentials. Otherwise, delete these lines from the file.

5. Save the document as proxy.reg.

6. Run the file as an administrator.

7. Confirm that you want to edit the Windows registry.

8. If the protection agent is not installed yet, you can install it now.

9. Open file %programdata%\Acronis\Agent\etc\aakore.yaml in a text editor.

10. Locate the env section or create it and add the following lines:

    env:
        http-proxy: proxy_login:proxy_password@proxy_address:port
        https-proxy: proxy_login:proxy_password@proxy_address:port

11. Replace proxy_login and proxy_password with the proxy server credentials, and proxy_address:port with the address and port number of the proxy server.

12. In the Start menu, click Run, type: cmd, and click OK.

13. Restart the aakore service by using the following commands:

    net stop aakore
    net start aakore

14. Restart the agent by using the following commands:

    net stop mms
    net start mms

In Linux

Run the installation file with the parameters --http-proxy-host=ADDRESS --http-proxy-port=PORT --http-proxy-login=LOGIN--http-proxy-password=PASSWORD. To change the proxy settings after the installation, use the procedure described below.

To change the proxy settings in Linux

1. Open the file /etc/Acronis/Global.config in a text editor.

2. Do one of the following:

   • If the proxy settings were specified during the agent installation, find the following section:

     <key name="HttpProxy">
         <value name="Enabled" type="Tdword">"1"</value>
         <value name="Host" type="TString">"ADDRESS"</value>
         <value name="Port" type="Tdword">"PORT"</value>
         <value name="Login" type="TString">"LOGIN"</value>
         <value name="Password" type="TString">"PASSWORD"</value>
     </key>

   • Otherwise, copy the above lines and paste them into the file between the <registry name="Global">...</registry> tags.

3. Replace ADDRESS with the new proxy server host name/IP address, and PORT with the decimal value of the port number.

4. If your proxy server requires authentication, replace LOGIN and PASSWORD with the proxy server credentials. Otherwise, delete these lines from the file.

5. Save the file.

6. Open file /opt/acronis/etc/aakore.yaml in a text editor.

7. Locate the env section or create it and add the following lines:

   env:
       http-proxy: proxy_login:proxy_password@proxy_address:port
       https-proxy: proxy_login:proxy_password@proxy_address:port

8. Replace proxy_login and proxy_password with the proxy server credentials, and proxy_address:port with the address and port number of the proxy server.

9. Restart the aakore service by using the following command:

   sudo service aakore restart

10. Restart the agent by executing the following command in any directory:

    sudo service acronis_mms restart

In macOS

You can enter the proxy settings during the installation, or specify them in advance by using the procedure described below. To change the proxy settings after the installation, use the same procedure.

To specify the proxy settings in macOS

1. Create the file /Library/Application Support/Acronis/Registry/Global.config and open it in a text editor, such as Text Edit.

2. Copy and paste the following lines into the file

   <?xml version="1.0" ?>
   <registry name="Global">
       <key name="HttpProxy">
           <value name="Enabled" type="Tdword">"1"</value>
           <value name="Host" type="TString">"proxy.company.com"</value>
           <value name="Port" type="Tdword">"443"</value>
           <value name="Login" type="TString">"proxy_login"</value>
           <value name="Password" type="TString">"proxy_password"</value>
       </key>
   </registry>

3. Replace proxy.company.com with your proxy server host name/IP address, and 443 with the decimal value of the port number.

4. If your proxy server requires authentication, replace proxy_login and proxy_password with the proxy server credentials. Otherwise, delete these lines from the file.

5. Save the file.

6. If the protection agent is not installed yet, you can install it now.

7. Open file /Library/Application Support/Acronis/Agent/etc/aakore.yaml in a text editor.

8. Locate the env section or create it and add the following lines:

   env:
       http-proxy: proxy_login:proxy_password@proxy_address:port
       https-proxy: proxy_login:proxy_password@proxy_address:port

9. Replace proxy_login and proxy_password with the proxy server credentials, and proxy_address:port with the address and port number of the proxy server.

10. Go to Applications > Utilities > Terminal

11. Restart the aakore service by using the following commands:

    sudo launchctl stop aakore
    sudo launchctl start aakore

12. Restart the agent by using the following commands:

    sudo launchctl stop acronis_mms
    sudo launchctl start acronis_mms

In bootable media

When working under bootable media, you may need to access the cloud storage via a proxy server. To specify the proxy server settings, click Tools > Proxy server, and then specify the proxy server host name/IP address, port, and credentials.