Skip to main content
McAfee Enterprise MVISION Cloud

Install Cloud Connector on Windows

MVISION Cloud Connector can be installed on a physical server or a virtual machine running on Windows. 

NOTE: As of MVISION Cloud Connector 4.1.2, registering a Symbolic Server Name during installation is mandatory. The option to skip this step in the Cloud Connector wizard has been removed.   

Important Notes

IMPORTANT: As of MVISION Cloud Connector 5.2.0, Cloud Connector cannot be installed without the Cloud Connector User role configured in your account. Make sure you have the Cloud Connector User role granted to your account before you install the latest Cloud Connector.

IMPORTANT: TLS certificate validation happens at installation and when Cloud Connector is running. During install, if the server certificate validation is successful, no console messages are displayed. If you use a proxy server with SSL termination to connect Cloud Connector to the McAfee Enterprise MVISION Cloud backend, the proxy server’s certificate MUST be provided at install time using the parameter -Vcertificates=<server file path1>:<server file path2>
Only digitally signed certificates in CRT/Base64 format are supported. 
If you perform an upgrade for one release using the -Vcertificates=<server file path1>:<server file path2> option, you must use it again for all subsequent upgrades.

IMPORTANT: As of Cloud Connector 3.5, the installer parameter -Venv=<environment_url> is no longer supported. 

IMPORTANT: Do not install Cloud Connector to a directory that uses spaces in the name, such as “c:\Program Files\shnlp”. 

NOTES:

  • If you want to change the Java KeyStore (JKS) password, contact MVISION Cloud Support for assistance. 
  • From Cloud Connector 5.4.1 onwards, endpoints are accessed using token-based authentication instead of basic authentication.

Prerequisites

Before you begin, review the required MVISION Cloud Connector Prerequisites

Install Cloud Connector on Windows

To install the application, right-click the executable file, and select Run as administrator.
cc_install_windows_run_as_admin.png

  1. On the Welcome to the Log Processor Setup Wizard screen, click Next.
    cc_install1_4.1.2.png
  2. Select the destination directory to install Cloud Connector. Click Next
    cc_install2_4.1.2.png
  3. Activate the Create a Start Menu folder checkbox. Click Next
    cc_install3_4.1.2.png
  4. Select the connection status based on your internet connection. If you use a proxy to connect to the network, you are prompted for your proxy login information. Click Next.
    cc_install4_4.1.2.png
  5. Enter your McAfee Enterprise MVISION Cloud account credentials, then click Next:
    • Username and Password. The login credentials for access to the MVISION Cloud dashboard and Cloud Connector might be different. The Cloud Connector role allows configuration, installation, and configuration changes to CC, and might not allow access to the MVISION Cloud user interface. Contact your administrator to confirm that your credentials work for both interfaces.
    • Environment. MVISION Cloud gives you the name of the environment with your login credentials. Do not change this setting unless asked by McAfee Enterprise Support.
    • Salt. The unique Salt for tokenization.
    • Custom Environment URL. Do not change this URL unless asked by MVISION Cloud Support.
      clipboard_ea6f94aa4b29ae5832a274e4ec252e8e9.png 
  6. Select the MVISION Cloud tenant you want to install Cloud Connector to. 
    cc_select_tenant_5.0.1.png

NOTE: This screen is displayed only when your user ID exists on more than one tenant, so you can select the tenant you want to login to. 

  1. Select an IP address from the list where Cloud Connector binds and listens to port 8443. Do not change any of the other settings unless instructed by MVISION Cloud. Then click Next. (The Symbolic Server Name is registered in the MVISION Cloud DNS servers, which are publicly accessible, so mapping to the de-tokenization server happens automatically.)

NOTE: As of MVISION Cloud Connector 4.1.2, registering a Symbolic Server Name during installation is mandatory. The option to skip this step in the Cloud Connector wizard has been removed.   

​​​cc_setup_log_processor_5.0.1.png

  1. Select the configuration to be used by this Cloud Connector installation. Select the McAfee Enterprise Default Log Processor configuration to create a default (blank) configuration and proceed, or contact MVISION Cloud Support for information about which configuration is right for your deployment. Click Next
    ccinstall7_4.3.2.png
  2. Configure the Windows service by entering your Windows login credentials. Accept the defaults and let the service bound to the built-in Windows account "Local Service". This account does not need a password to be configured. Only if the Cloud Connector needs access to a network share for log processing or if you install it into an active-active deployment, use a domain account that has access rights to the remote network share. Click Next
    cc_install8_4.1.2.png
  3. Installation is complete. Click Finish to complete the Setup Wizard.
    cc_install9_4.1.2.png
  4. To make sure that the Cloud Connector is running, go to the Microsoft Management Console or services.msc and select Skyhigh Log Processor.
    ec_install10_3.9.2.png
  5. Click Start to initiate the service. Then click OK. 
    ec_install11_3.9.2.png
  6. About one minute after starting the service, you can then connect to the Cloud Connector web interface on port 8443 by navigating to the URL
    https://<Symbolic Server Name>:8443.

NOTE: Make sure that the Log Processor service is running on Windows Task Manager by looking for a task with the Image Name shnlps.exe.
11m.png

Cloud Connector Installer Errors on Windows

MVISION Cloud checks for hardware and software requirements prior to CC installation. If the prerequisites are not met, then the CC installation is stopped with the installer errors. Once the prerequisites are met, you will have a successful CC installation. 

Click the MVISION Cloud Connector Prerequisites link to avoid the following installation errors. This links redirects to MVISION Cloud Connector Prerequisites documentation.
clipboard_eb1441d74e91f66eac3898cb96335409a.png

Installer Error Messages

The following error messages can be seen when Cloud Connector Prerequisites are not met.

  • Make sure you have an account that has administrator rights, before installing Cloud Connector.
    clipboard_e039092d1cbbf473283e4a56cb8a0ae7e.png
  • Cloud Connector supports Windows 64-bit operating system.
    clipboard_e54c9b5024ba53e271ca6e74b5e2fcfc2.png
  • Install the supported version of Visual C++ using the MVISION Cloud Connector Prerequisites link.
    clipboard_e52f67f84062132695ac91849e1e5aee8.png
  • If RocksDB is failed in Linux, you cannot access the if / temp folder.
    clipboard_e083efde1f7197d8bbc12a45282fe09ac.png
  • If RAM and CPU Capacity is lower than a recommended number, then it may impact your CC performance. 
    clipboard_e64b5d02007c7a47ceec267560618a5ac.png
  • Make sure to meet the recommended number of memory for RAM.
    clipboard_efa1c0056baed70b3a714d56e39766db8.png
  • Make sure to meet the recommended number of cores for CPU Capacity.
    clipboard_e7aab1c33b6496d9396652042f10b1fad.png
  • Make sure at least 2 GB of free disk space is available in the selected folder.
    clipboard_e1576eb5cca5f513020cfe1f69cacf39d.png
  • Cloud Connector cannot be installed without the Cloud Connector User role configured in your account. Make sure you have the Cloud Connector User role granted to your account before you install the Cloud Connector.
    clipboard_ed2b3cec2728c61d46bdef1e4a454fd7a.png
  • Was this article helpful?