PDFs

On this page:

Related pages:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
44 rates

Use this workflow if both of these conditions are true:

  1. The Network Agent will run on a host with one Java App Server Agent (single-tenant install).  
  2. The host does not have an App Agent installed, OR
    The App Agent is running in an IBM JVM, OR
    The host has an App Agent installed and you can stop and restart the application that the agent is monitoring.

The Network Agent will have greater visibility into persistent connections if you use this workflow instead of Single-Tenant Install with No App Restart

Check System Requirements 

See Network Visibility Requirements and Important Notes.

Stop the Monitored Application

If the host has an App Agent running, stop the application that this agent is monitoring. You will restart the application after you install and run the Network Agent.

Install the Network  Agent

Install the agent based on the package: 

ZIP Network Agent
 Click here to expand...

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

Install using the Standalone Machine Agent ZIP

(New in 4.4.2) 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 Important Notes.
  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 Important Notes.
  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:

 

RPM Network Agent
 Click here to expand...

  1. Check System Requirements: See Network Visibility Requirements and Important Notes.
  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 machine 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. Verify that you have sudo or root access permissions on the machine where you want to install the agent.
  7. Download the agent package to the machine.
  8. Open a terminal window and enter the following command: sudo rpm -ivh <installer.rpm>
    The network agent software is installed under /opt/appdynamics/netviz.  
  9. To start the agent, enter the following command: sudo service appd-netviz start
  10. Verify that the Network Agent is running: sudo service appd-netviz status 
  11. If you experience any problems or issues, see FAQs and Troubleshooting for Network Visibility.
  12. If you are installing the Network Agent as part of a Set Up Network Visibility workflow, proceed to the next step in the workflow:

DEB Network Agent
 Click here to expand...

 

  1. Check System Requirements: See Network Visibility Requirements and Important Notes.
  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 machine where you want to install the 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 agent package to the machine.
  6. Enter the following command:
    sudo dpkg -i <installer.deb>
    The network agent software is installed under /opt/appdynamics/netviz
    The agent should start automatically with the following message: appd-netviz start/running. process <pid #>
    To verify the Network Agent status, run the following: sudo service appd-netviz status 
  7. If the agent does not start, run the following:  sudo service appd-netviz start 
  8. If you experience any problems or issues, see FAQs and Troubleshooting for Network Visibility.
  9. If you are installing the Network Agent as part of a Set Up Network Visibility workflow, proceed to the next step in the workflow:

 

Set Up the App Agent

Install or Update the App Agent (if needed)

Network Visibility requires a Java App Agent (version 4.4 or higher) installed on the same host as the Network Agent. See Install the Java Agent.

Configure the App Agent
  1. Navigate to the following folder: <app-agent-install-dir>/<version-number>/external-services
  2. Extract the netviz.zip archive so that the ZIP contents are under the following folder: 
        <app-agent-install-dir>/<version-number>/external-services
  3. Configure the App Agent startup command to include the following command-line argument. This argument is required for the agent to map network metrics to application flows.
    -javaagent:<app_server_agent_home>/javaagent.jar \
    -Dappdynamics.socket.collection.bci.enable=true

 

Restart the Monitored Application

After you set up the App Server Agent, restart the application that the App Server Agent is monitoring.

 

  • No labels