Installation Instructions

Prerequisites:

  • One of the following Oses:
    • Red Hat Enterprise Linux Server release 6.0 or higher
    • Oracle Linux 6.5 or higher
    • Ubuntu 16.04 or higher
    • CentOS release 7 or higher
    • Debian GNU/Linux 8.0 or higher
    • Amazon Linux AMI release 2013.03 or higher
    • Fedora release 12 or higher
    • Suse Linux 11 or higher
  • OpenSSL v1.1.1 or higher
  • Root access
  • The Install script requires wget to retrieve content, and curl to test/verify access to our data collection servers in the US at IP address 104.197.11.97 or in the EU at 35.198.133.35 over port 443, either directly or through a corporate proxy.

Note: The Linux agent/agentless approach requires a user with root permissions to get PID-to-network mapping, certain hardware details, and data on logical/physical disk volumes. Become root user either through "sudo -s" or "su", most systems use sudo.  

Procedure:

Launch the application from your Partner Dashboard or login directly here. Open the Settings page by clicking the username in the upper right-hand corner and select Settings. Navigate to Agent Setup > Assess and select the Linux tab. 

Note: the commands below represent our US infrastructure. If you are using our EU infrastructure copy and paste the commands directly from your assessment. 

Step 1:  Export your customer key.

export CLOUDAMIZE_CUSTOMER_KEY=<YOUR CUSTOMER KEY>

Step 2:  Execute the following command to install an agent.

sh <(curl -s https://agentmanager1.cloudamize.com/cxf/downloadFile/installCloudamizeAgentV2.sh)

If FQDN resolution is not permitted use the command below.

sh <(curl -s -k https://104.197.11.97/cxf/downloadFile/installCloudamizeAgentV2.sh)

linux-installation.PNG 

If you want to route the data through your own proxy server, click the checkbox as shown in the image below, and use the following command.

sh <(curl --proxy https://www.yourproxy.com:proxy_port -s https://agentmanager1.cloudamize.com/cxf/downloadFile/installCloudamizeAgentV2.sh) <https://www.your_own_proxy.com> <proxy_port>

linux-proxy.png

If you want to use your own proxy server and the server requires authentication, click the designated checkbox and use the following, updated command.

sh <(curl --proxy https://www.yourproxy.com:proxy_port --proxy-user username:password -s https://agentmanager1.cloudamize.com/cxf/downloadFile/installCloudamizeAgentV2.sh) <https://www.your_own_proxy.com> <proxy_port> <user_name> <password>

linux-authentication.PNG

Deploy from Central Repository:

Installation of Agent

The customer should decide rpm/deb, but in general, rpms are used by Red Hat, CentOS, SuSE, Oracle Linux and deb is used by Debian and Ubuntu.

  • RPM URL: 
    • https://agentmanager1.cloudamize.com/cxf/downloadFile/cloudamize_agent.rpm (US)
    • https://agentmanager-de.cloudamize.com/cxf/downloadFile/cloudamize_agent.rpm (EU)
  • RPM Install: CLOUDAMIZE_CUSTOMER_KEY=xxxx rpm -i cloudamize_agent.rpm
  • DEB URL:
    • https://agentmanager1.cloudamize.com/cxf/downloadFile/cloudamize_agent.deb
    • https://agentmanager-de.cloudamize.com/cxf/downloadFile/cloudamize_agent.deb (EU)
  • DEB Install: CLOUDAMIZE_CUSTOMER_KEY=xxxx dpkg -i cloudamize_agent.deb
  • TGZ URL:
    • https://agentmanager1.cloudamize.com/cxf/downloadFile/cloudamize_agent.tgz (US)
    • https://agentmanager-de.cloudamize.com/cxf/downloadFile/cloudamize_agent.tgz (EU)

TGZ Install:

  1. tar xf cloudamize_agent.tgz
  2. cd cloudamize_agent
  3. CLOUDAMIZE_CUSTOMER_KEY=xxxx bash install.sh
  4. cd .. && rm -Rf cloudamize_agent cloudamize_agent.tgz

Note: If for some reason environment variables cannot be used during the install, the customer can configure later by running /usr/local/cloudamize/bin/configure.sh

Configuration of Agent

The agent can be configured while installed or after. The following environment variables are used to configure. If they are set during install, they will be used to configure. Otherwise, the customer must run /usr/local/cloudamize/bin/configure.sh

Environment variables can be set using the “export” command in bash, or when running a command. Placement of env set is important when running during command. Note, sudo usually clears env variables.

Available options are:

Env Variable

Parameter*

Description

CLOUDAMIZE_CUSTOMER_KEY

--customer-key

REQUIRED. The customer key to register with.

PROXY_SERVER

--proxy-server

Customer proxy server address to use with curl.

PROXY_PORT

--proxy-port

Customer proxy port.

PROXY_UNAME

--proxy-user

Customer proxy user name.

PROXY_PSWD

--proxy-pass

Customer proxy user password.

 

Click here for steps to troubleshoot installation issues. 

Click here for instructions on how to uninstall the linux agents.

 

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.