ZIP Network Agent Operations

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 on Linux workflow, proceed to the next step in the workflow:
   • Multi-Tenant Setup
   • Single-Tenant Setup

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 on Linux workflow, proceed to the next step in the workflow:
    • Multi-Tenant Setup
    • Single-Tenant Setup