AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.


    Skip to end of metadata
    Go to start of metadata

    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

    Install 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 this 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 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:  
           <standalone-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 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, 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>

      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 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. See FAQs for Network Visibility
    11. 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:

    Administer 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, the following displays:

    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, 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 <pid #>

    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.. <pid_of_process>

    Uninstall the ZIP Network Agent

    1. Open a terminal and cd 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>
    • No labels