cancel
Showing results for 
Search instead for 
Did you mean: 
aLTeReGo
Level 21

Linux Agent Deployment

Linux Agent Deployment

Add Node Wizard - Push Deployment

Deploying the Linux Agent to an individual machine is as simple as adding the node to Orion via the Add Node Wizard. To begin, navigate to [Settings -> All Settings -> Add Node], enter the IP address or fully qualified host name of the Linux host you'd like managed in the "Polling Hostname or IP Address" field, and select the "Windows Servers: Agent" radio button from the available "Polling Method" options. Next, enter the credentials that will be used to both connect to the Linux host and install the agent software. The credentials provided here should have 'root' or equivalent level permissions. Note that the credentials provided here are used only for initial deployment of the agent. Future password changes of the account credentials provided here will have no impact on the agent once it is deployed.

The Agent is deployed to the Linux host using a combination of SSH and SFTP requiring TCP port 22 be open from the Orion server (or additional polling engine) to the Linux endpoint you wish to manage for push deployment to function properly.

Agent Deployment Add Node.png

Once credentials are provided click "Next" at the bottom of the page. You will then be prompted to start the installation of the Linux Agent. Click "Start Install" and the progress indicator will appear. When finished, you will be taken through the rest of the Add Node Wizard flow where you can select which resources you wish to monitoring on the host.

Install Agent PromptInstalling Agent Progress IndicatorList Resources
Install Agent Software.pngInstalling Agent Software.pngList Resources.png

Manual - Pull Deployment

In some scenarios it may not be possible for the Orion server to push the agent to the Linux host over SSH. This is not uncommon when the host you wish to manage resides behind a NAT or is hosted in the cloud. While firewall policy changes, port forwarding, or one-to-one address translations could be made to facilitate push deployment of the agent, in many cases it may be far easier to perform a manual deployment of the agent to those hosts.

The Linux Agent can be downloaded from the Orion web interface to the Linux host by going to [Settings -> All Settings -> Agent Settings -> Download Agent Software] and selecting "Linux" from the options provided and clicking "Next". In the following step of the Wizard select "Manual Install" and click "Next". Finally, In the third and final step of the wizard is where you will select the Linux distribution you will be installing the Agent on, as well as bitness of the OS (32 or 64bit). Here you can also configure any advanced options the agent will use when it is installed, such as which polling engine the Agent should be associated with in Agent Initiated (Active) mode, or the listening port the Agent will use when running in Server Initiated (Passive) mode.

Select Agent TypeSelect Deployment MethodChoose Agent Settings & Distribution
Select Agent Type.pngAgent Deployement Type.pngAgent Distribution.png

Once selecting all the appropriate configuration options, click the "Generate Command" button at the bottom of the page. This will generate a dynamic installation command based upon the the settings chosen above, which can then be copied and pasted into an SSH or X-Windows session on the Linux host. The Linux machine will then download and install the appropriate agent software from the Orion server using those pre-configured options.

Copy Install Command.png

Paste the generated command into your Linux terminal session and press 'enter' to start the download and install process.

Console Session Install Agent.pngThe command will begin downloading, then installing the Agent onto the machine. When complete, the agent service will automatically start on the Linux host registering with the Orion server, and becoming a managed node.

Agent Download and Install.pngOnce registered select your newly added agent node and click "Choose Resources" from the 'Manage Agents' view to select items on the node you would like to monitor.

Choose Resources.png

Mass Deployment - Repository

With the introduction of the Linux Agent in SAM 6.3 Beta 3, the Orion server and Additional Web Servers are now also Linux repositories for the Agent. This method can be utilized for mass Agent deployment using automation and orchestration tools such as Puppet and Chef. It also means you can use the same native built-in  package management tools for the Agent, as you would any other package on the Linux operating system. Now you can install the Linux Agent the same way you might install or update BIND or Apache, using 'yum', 'apt-get', or 'zypper' depending upon your distribution. To utilize 'yum', 'apt-get', or 'zypper' for installing the agent you must first register the Orion repository with your operating system. To do so, navigate to [Settings -> All Settings -> Agent Settings -> Download Agent Software -> Linux] and select 'Install via Package Management Tool (e.g. yum, apt)'.

yum.pngBased upon the distribution selected in the drop down (1), a command line string is dynamically generated. Simply click the 'Copy' button (2), then paste this string into an SSH session for the Linux host you want to add the repository to and press 'Enter'. Once the repository is added to the host, you can use the appropriate 'yum', 'apt-get', or  'zypper' command to install the agent from the repository.  Simply click the 'Copy' button (3) and once again, paste this command into the SSH session to install the Agent. The Agent will then be downloaded from the Orion repository and installed on the host.

Select Distribution
Add Repository to Host
Linux Repository.png

SSH Add Repository.png

Install AgentConfigure Agent

CopyPaste Command From Step #3 Above

yum install.png

IP/Hostname, Username & Password

Configure Agent.png

When installation is complete, all that remains is to configure the agent by typing 'service swiagentd init'. This will bring up the Linux Agent configuration settings where you will need to provide the IP, hostname, or FQDN of the Orion server or Additional Polling Engine (option #2). Then enter your Orion 'admin' or equivalent credentials used to login to the Orion web interface (Options 4 & 5). When complete, save your changes and exit (Option 7). This will then register the agent with the Orion server and begin managing it as a node.

Add Node WizardPull Deployment
Deployment via Repository Manual Installation
63 Replies
cbunge
Level 10

Re: Linux Agent Deployment

So odd question.  If we install the Linux Agent on a machine, do you think it will communicate back to the 6.2 SAM as well?

0 Kudos
aLTeReGo
Level 21

Re: Linux Agent Deployment

No sir. The Linux Agent will not work with SAM 6.2 and should make no attempt to communicate with your production Orion instance.

0 Kudos
cbunge
Level 10

Re: Linux Agent Deployment

What versions of Linux does this support? Just the Cent Ubuntu and RHE I see listed in that drop down for the manual install screen?

0 Kudos
aLTeReGo
Level 21

Re: Linux Agent Deployment

The inclusion of minor revisions in the drop down is a bug which will be addressed before we GA. The 'official" supported distributions at this time include.

  • RHEL 6, 7
  • CentOS 5, 6, 7
  • Ubuntu 14

The next Beta should include support SuSE and Amazon Linux AMI. Was there any particular distribution you were looking for?

cbunge
Level 10

Re: Linux Agent Deployment

Unfortunately trying to convince our Linux admins to turn on SNMP and configure has been an uphill battle. They are used to using a shareware software that has had an easy to configure agent installed.  It would be nice to get a large range of OS's as a lot of OVA's seem to come with CentOS or Debian.  To give you an idea of what we have out our vCenter alone (gotta love the Fedora 7 :-|

Linux.PNG

0 Kudos
Selspiero
Level 11

Re: Linux Agent Deployment

+1 for Debian

toby.burton
Level 9

Re: Linux Agent Deployment

Since Ubuntu is derived from debian, I would suggest you select the Ubuntu 11.14 x64 bit option.  This worked in my environment with Debian 8.3 (Jessie) of the amd64 architecture distro.  Please note that i686 is not compatible.

ubuntu-14.4_x64.png

Please note that you may have to manually install the ethtool package (via apt-get install ethtool) for network interfaces to be available via 'List Resources'.

apt-get-ethtool_001.png

Then just install as root using the generated command.  For example, in my environment it looked like the following, but you need to generate your own command since the requestid is uniquely generated.

bash -c "$($(if which wget &>/dev/null; then echo 'wget -O -'; elif which curl &>/dev/null; then echo curl; fi) http://demo:80/Orion/AgentManagement/DownloadLinuxOnlineInstallScript.ashx?requestId=c5979c88-4e60-4...)"

debian-example.png

cbunge
Level 10

Re: Linux Agent Deployment

I'll have to give this a go starting Monday. Thanks for the heads up!  My biggest hurdle is getting root access on machines to test :-|

Selspiero
Level 11

Re: Linux Agent Deployment

Agreed

0 Kudos