ZIP Network Agent Operations

You install the Network Agent as part of an overall workflow for setting up Network Visibility. The supported workflows are:

See Set Up Network Visibility on Linux.

The NetViz Agent needs to be started separately from the Machine Agent when using a bundled approach.

Install the ZIP Network Agent

sudo cd < sudo ./install.sh NetVizMonitoring < start true NetVizMonitoring < < /appd-netviz.sh status sudo root sudo root mount noexec nsuid network-agent cd < unzip < chown -R < < < network_agent_home cd < ./install.sh network_agent_user < <

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

Install Using the Machine Agent ZIP

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

  1. Check System Requirements. See Network Visibility 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 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 <machine-agent-home>/NetVizExtension/agent/
sudo ./install.sh
  5. Enable the NetVizMonitoring extension:
    1. Open this file in a plain-text editor such as vi or Notepad++:
      <machine-agent-home>/NetVizExtension/conf/netVizExtensionConf.yml
    2. Set the start setting to true and save the file.
  6. Start the Machine Agent. The NetVizMonitoring extension should start automatically. To start the Agent on Linux, enter: 
    <machine_agent_home>/bin/machine-agent -d -p <machine_agent_home>/pidfile
  7. Verify that the Network Agent is running:
    <machine-agent-home>/NetVizExtension/agent/bin/appd-netviz.sh status
    The output provides the process ID (PID) of the Network Agent process.See FAQs for Network Visibility.
  8. If you are installing the Network Agent as part of a Set Up Network Visibility on Linux workflow, proceed to the next step in the workflow:

Install Using the Network Agent ZIP

  1. Check System Requirements. See Network Visibility 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, enter the mount command, and check the mounted file system for the directory where you plan to install the agent. The file system 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>
    Note:

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

    /opt/appdynamics/networkVisibility (correct)

    /opt/appdynamics/network visibility (incorrect)

  8. Run these commands as the administrator or root user on the host machine:
    1. This command is requiredonlyif 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. See FAQs for Network Visibility
  11. If you are installing the Network Agent as part of a Set Up Network Visibility on Linuxworkflow, proceed to the next step in the workflow:

Administer the ZIP Network Agent

Warning: 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.
Operation Command Notes
Start Agent <network-agent-home>/bin/start.sh

If the Agent starts successfully, the following displays:

Starting AppDynamics Network Monitoring appd-netviz... OK appd-netviz running.. <
Stop Agent <network-agent-home>/bin/stop.sh

If the Agent stops successfully, the following displays:

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. The following displays:

appd-netviz start/running, process <
Restart Agent <network-agent-home>/bin/appd-netviz.sh restart

If the Agent restarts successfully, the following displays:

Stopping AppDynamics Network Monitoring appd-netviz... OK

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

Uninstall the ZIP Network Agent

  1. Open a terminal andcd to the <network-agent-home > directory.
  2. Stop the Agent by entering:./bin/stop.sh
  3. cd to the <network-agent-home> parent directory: cd ..
  4. Remove the Agent directory by entering:rm -rf <network-agent-home>