On this page:

Related pages:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
17 rates

Installing the Network Agent is generally performed as part of an overall workflow for setting up Network Visibility. The supported workflows are:

To determine the best workflow for your environment, see Set Up Network Visibility.

 

Installing the ZIP Network Agent

You can install the agent using the Standalone Machine Agent or the Network Agent ZIP.

Install using the Standalone Machine Agent ZIP

You can install the Network Agent as an extension using the Standalone Machine Agent installer. This option is available on Linux 32-bit and 64-bit ZIP installers, version 4.4.2 or higher, only.

  1. Check System Requirements: See Network Visibility Requirements and Supported Environments.
  2. If you are installing the Network Agent as part of the Multi-Tenant Install workflow, stop each application of interest if it is monitored by an installed App Agent. You will restart each application after you install and set up the Network Agent.
  3. Install the Standalone Machine Agent using the Linux ZIP installer as described in the Linux Install Using ZIP with Bundled JRE page.
  4. Run the install script using sudo
         cd <standalone-machine-agent-home>/NetVizExtension/agent/
         sudo ./install.sh 
  5. Enable the NetVizMonitoring extension:
    1. Open the following file in a plain-text editor such as vi or Notepad++: 
           <standalone-machine-agent-home>/NetVizExtension/conf/netVizExtensionConf.yml
    2. Set the start setting to true and save the file.
  6. Start the Standalone Machine Agent. The NetVizMonitoring extension should then start automatically. To start the agent on Linux: 
         <machine_agent_home>/bin/machine-agent -d -p <machine_agent_home>/pidfile 
  7. Verify that the Network Agent is running:  
         <standalone-machine-agent-home>/NetVizExtension/agent/bin/appd-netviz.sh status 
    The output provides the process ID (PID) of the Network Agent process.
    If you experience any problems or issues, see FAQs for Network Visibility.
  8. If you are installing the Network Agent as part of a Set Up Network Visibility workflow, proceed to the next step in the workflow:
Install using the Network Agent ZIP
  1. Check System Requirements: See Network Visibility Requirements and Supported Environments.
  2. If you are installing the Network Agent as part of the Multi-Tenant Install workflow, stop each application of interest if it is monitored by an installed App Agent. You will restart each application after you install and set up the Network Agent.
  3. Verify that you have sudo or root access permissions on the host where you want to install the network agent. (You do not need sudo or root access to run the agent.)
  4. Open a command prompt on the host, run the mount command, and check the mounted filesystem for the directory where you plan to install the agent. The filesystem should not have the noexec and nsuid flags set.
  5. Download the network-agent package to the machine. 
  6. In a terminal window, cd to the folder where you downloaded the Network Agent ZIP package.
  7. Enter the following command, where <network_agent_home> is the folder where you want to install the agent software:
    unzip <installer.zip> -d <network_agent_home>

    The parent path should not include any directory names with spaces:

    /opt/appdynamics/networkVisibility (OK)

    /opt/appdynamics/network visibility (invalid)

  8. Run the following commands as the administrator or root user on the host machine:
    1. The following command is required only if you are logged in as a different user from the one that will configure and run the agent: 
       chown -R <network-agent-user-group>:<network-agent-user> <network-agent-home>
    2. Go to <network_agent_home> and run the install script:
      cd<network-agent-home>
         ./install.sh
  9. Start the agent by running the following command as the <network_agent_user>:
    <network-agent-home>/bin/start.sh
  10. Verify that the Network Agent is running:
    1. Identify the agent process: <network-agent-home>/bin/appd-netviz.sh status 
      The output provides the process ID (PID) of the Network Agent process.
    2. If you experience any problems or issues, see FAQs for Network Visibility.
  11. If you are installing the Network Agent as part of a Set Up Network Visibility workflow, proceed to the next step in the workflow:

 

Administering the ZIP Network Agent 

Run commands as <network_agent_user>

You should run the following commands as a  <network_agent_user>  with permissions to configure and run the agent on the host machine.

OperationCommandNotes
Start agent<network-agent-home>/bin/start.sh

If the agent starts successfully, you should see the following:

Starting AppDynamics Network Monitoring appd-netviz...
OK
appd-netviz running.. <pid_of_process>

Stop agent<network-agent-home>/bin/stop.sh

If the agent stops successfully, you should see the following:

Stopping AppDynamics Network Monitoring appd-netviz...
OK

Check agent status<network-agent-home>/bin/appd-netviz.sh status

This command shows whether the agent is running or not. You should see the following: 

appd-netviz start/running, process <pid #>

Restart agent<network-agent-home>/bin/appd-netviz.sh restart

If the agent restarts successfully, you should see the following:

Stopping AppDynamics Network Monitoring appd-netviz...
OK

Starting AppDynamics Network Monitoring appd-netviz...
OK
appd-netviz running.. <pid_of_process>

Uninstalling the ZIP Network Agent

  1. Open a terminal and cd to the <network-agent-home> directory.
  2. Stop the agent by running the command: ./bin/stop.sh
  3. cd to the <network-agent-home> parent directory: cd ..
  4.  Remove the agent directory by running the following command: rm -rf <network-agent-home>
  • No labels