Prerequisites:
One of the following Oses:
Red Hat Enterprise Linux Server release 7.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
A supported version of OpenSSL
Root and/or Wheel Group access
350 MB persistent storage
The Install script requires wget to retrieve content, and curl to test/verify access to our data collection servers:
For assessments on app.cloudamize.com or dashboard.cloudamize.com our data collection servers are at 104.197.11.97 for US infrastructure and 35.198.133.35 for EU infrastructure over port 443, either directly or through a corporate proxy
For assessments on console.cloudamize.com or dashboard-partners.cloudamize.com our data collection servers are at am.cloudamize.com for US infrastructure and am-de.cloudamize.com for EU infrastructure over port 443, either directly or through a corporate proxy. If you are unable to whitelist DNS addresses, please instead whitelist the appropriate static IP: 35.171.170.26 (US infrastructure) or 18.194.12.63 (EU infrastructure).
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.
Code Block |
---|
export CLOUDAMIZE_CUSTOMER_KEY=<YOUR CUSTOMER KEY> |
Step 2: Execute the command listed in the assessment portal, eg:
Code Block |
---|
sh <(curl -s https://agentmanager1.cloudamize.com/cxf/downloadFile/installCloudamizeAgentV2.sh) |
This will differ if your assessment is on console.cloudamize.com, and will include your customer key:
Code Block |
---|
%> sh <(curl -X POST https://am.cloudamize.com/cxf/downloadFileV3 -H 'content-type: multipart/form-data' -F custkey=<YOUR CUSTOMER KEY> -F filename=installCloudamizeAgentV2.sh) |
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 for app.cloudamize.com assessments (console.cloudamize.com assessments have the command listed in the portal):
Code Block |
---|
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> |
If you want to use your own proxy server and the server requires authentication, click the designated checkbox and use the following, updated command.
Code Block |
---|
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> |
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:
tar xf cloudamize_agent.tgz
cd cloudamize_agent
CLOUDAMIZE_CUSTOMER_KEY=xxxx bash install.sh
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.
export CLOUDAMIZE_CUSTOMER_KEY=xxxx
dpkg -i cloudamize_agent.debCLOUDAMIZE_CUSTOMER_KEY=xxxx dpkg -i cloudamize_agent.deb
sudo CLOUDAMIZE_CUSTOMER_KEY=xxxx dpkg -i cloudamize_agent.deb
curl https://agentmanager1.cloudamize.com/cxf/downloadFile/installCloudamizeAgentV2.sh | sudo CLOUDAMIZE_CUSTOMER_KEY=xxxx bash
CLOUDAMIZE_CUSTOMER_KEY=xxxx /usr/local/cloudamize/bin/configure.sh
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.