...
Info |
---|
The inventory file provided by default with the EAM installation package (also available in the example files section) is intended to be used in AIO (All In One)-type of deployments -i.e., all components running in a single server and communications using HOSTS file. If you have specific requirements for your deployment scenario -e.g., full high-availability-, please refer to the Generic deployment guidelines section for specific instructions to address your needs. |
...
Ensure the host can connect to public URLs on the Internet.
Ensure you can access through SSH the host using its main service IP address. It should be also possible to open an SSH connection from the same host using that IP address.
Download the Devo domain certs:
Connect to your Devo domain web interface.
Access to Administration → Credentials in the left pane.
Select X.509 certificates in the upper menu
Select your certificate, download them and rename them as:
Click on CHAIN CA in the upper right corner ->
chain.crt
Click on certificate on the certificate row ->
domain.crt
Click on private key on the certificate row ->
domain.key
Copy the files to
$HOME/devo-ea-deployer/domain-certs
...
The inventory is the base of the deployment process and will define the topology of the deployment. For more information on the ansible inventory, check this article.
The inventory file can be created using the inventory creation wizard or using the example files provided with the packages and editing them manually. Remember to have the virtual environment activated (step 4 in “Requirements Installation”).
...
Execute the inventory creation wizard specifying the inventory output file. The wizard will create the inventory file based on your inputs to a series of questions. To get more info, check this article.
Code Block python tools/cookiecutinvt.py -o inventories/deployment_inventory.yaml
...
Copy the example
inventories/1host-example.yaml
and save it asinventories/deployment_inventory.yaml
Edit the file based in the particular requirements of the installation. Refer to this article to create a proper inventory for your environment in a production deployment. Minimal configuration for a standard lab and PoC deployment in a single server is depicted in steps 7 and 8.
Set the following properties under
all.hosts.devo-ea-manager
yaml section:ansible_host
: Devo Endpoint Agent Manager IP.ansible_user
: User that will run Devo EAM. Same as the user that has been configured previously in sudoersansible_ssh_password:
User SSH Password that runs Devo EAM User (ansible_user)Enable the packs that you want to deploy, for more info check this article.
If you want to use a private key instead of user and password, please check this article.
Set the property
ansible_python_interpreter
according to your python interpreter:For Red Hat 7 / Centos 7:
/usr/bin/python
For other distros:
/usr/bin/python3
Set the following properties under
all.vars
yaml section:deam_relay_entrypoint
:tcp://FQDN_CENTRAL_RELAY:443
. WhereFQDN_CENTRAL_RELAY
is the FQDN of your central Devo relay :If your domain is deployed in the US Cloud (us.devo.com):
tcp://us.elb.relay.logtrust.net:443
If your domain is deployed in the EU Cloud (eu.devo.com):
tcp://eu.elb.relay.logtrust.net:443
If your domain is deployed in a different cloud, contact your Devo representative to know your entrypoint.
To send the data via a Devo Relay instead of sending it directly to Devo check here.
Inventory verification
Run the Deployment Inventory Checker Script and check that no errors or relevant warnings are showing by running:
Code Block python tools/checkinvt.py -i inventories/deployment_inventory.yaml
Deployment Inventory Checker Script will run validations on the inventory and report back if an issue is found. For more info on the Deployment Inventory Checker Script, see this article.
Run the pre-requisites playbook to ensure that all external connectivity and requirements are in place. The playbook will output a summary with all the URLs connectivity that has been checked. If there is any error there, please fix it before moving ahead with the deployment. Deployment playbook will verify again these requirements and stop if they are not satisfied.
Code Block ansible-playbook -i inventories/deployment_inventory.yaml playbooks/dea-pre-checks.yaml
...
Now you can connect to the server app using https://DEAM_IP:8080, where DEAM_IP
is the Devo Endpoint Agent Manager IP. E-mail and password were configured in your inventory file. Note that from EA 1.3 onwards, login into the platform is done using e-mail instead of username. (More info)
...
Upon agent installation, all monitored endpoints (please refer to Endpoint Agent Deployment) should be automatically detected and listed as an active host. If the website was already opened before adding the host, a page refresh is required. This is an example screenshot:
...