Install on windows

You should be completing this section as part of the deploy an new app procedure, which will give you proper context for what this installer does. For windows, installing the Tracelyzer can be done via this installer, or via the command line as follows. Tracelyzer runs a series of diagnostics as part of initialization. You can run it again at any time by running tracelyzer-diagnostics.exe, which is in C:\Program Files\AppNeta\TraceView by default.

To install the Tracelyzer and liboboe via the command line:

  1. Create a file called ‘conf.inf’ with the following contents, and place it in the same directory as your installer.

    [Setup]
    client_id=_access-key_
    
  2. Run following command.

    # square brackets indicate an optional parameters
    # the pipe character separates multiple choices within an option
    # parameters preceded by a slash are defined here
    TraceView_Setup.exe [/SILENT | /VERYSILENT] /LOADINF="conf.inf" [/SUPPRESSMSGBOXES]
    

Uninstall on windows

Use the following command to uninstall the Tracelyzer and its dependencies via the Windows command line.

# square brackets indicate an optional parameters
# the pipe character separates multiple choices within an option
# options preceded by a slash are defined <a href="http://www.jrsoftware.org/ishelp/index.php?topic=setupcmdline">here</a>
C:\Program Files\AppNeta\TraceView\unins000.exe [/SILENT | /VERYSILENT] [/CLOSEAPPLICATIONS | /NOCLOSEAPPLICATIONS]

Uninstall on rhel/centos

To safely uninstall TraceView from your redhat or centos system, you’ll first need to downgrade from the instrumented versions of any packages to the to the ones that would normally be provided by other repositories; this primarily applies to curl and nginx. Uninstalling the base TraceView packages without downgrading instrumented packages can result in your package manager removing critical system packages when it tries to resolve the changed dependencies.

  1. For each package that you upgraded to the TraceView version, use rpm in combination with yum to downgrade the package, as yum does not have the ability to directly swap package versions.

    # erases the TraceView curl package without touching any dependent packages.
    rpm --erase --nodeps -vv curl
    # re-installs the version of curl provided by your package manager's defaults
    # _repo-name_ will be 'tracelytics' or 'appneta' depending on when you installed
    yum --disablerepo=_repo-name_ install curl
    
  2. Remove our repository definition file; it may be one of two files depending on when you installed. yum will notice this file has been removed and clear our packages from its database the next time it is run.

    # deprecated tracelytics repo
    sudo rm /etc/yum.repos.d/tracelytics.repo
    # newer appneta repo
    sudo rm /etc/yum.repos.d/appneta.repo
    
  3. Next you can use yum to remove our base packages.

    sudo yum remove liboboe liboboe-devel tracelyzer
    
  4. You might have also installed other packages like php-oboe and libapache2-mod-oboe; these packages depend on liboboe and will be suggested for removal when you remove our base packages.

Uninstall on ubuntu/debian

  1. Begin by removing our repository from your apt sources. It may be one of two files depending on when you installed.

    # deprecated tracelytics repo
    sudo rm /etc/apt/sources.list.d/tracelytics.list
    # newer appneta repo
    sudo rm /etc/apt/sources.list.d/appneta.list
    
  2. Update your package lists: sudo apt-get update.
  3. Remove the TraceView base packages: sudo apt-get purge liboboe0 liboboe-dev tracelyzer.
  4. If you’ve installed other TraceView packages, like php-oboe or libapache2-mod-oboe, you’ll be prompted to remove those as well, since apt knows they have depend on liboboe.

Keep installed, switch to normal pkgs

Our packages are based on your distribution’s packages and security updates, but contain the tag ‘+tracelytics’ or ‘+appneta’ in the version string. Wherever you see this tag in the output of dpkg --list | grep tracelytics, TraceView versions of those packages are installed. To remove them you must tell apt to downgrade those packages to the original version provided by your distribution.

  1. First remove our repository from your apt sources—see the previous section, and then run apt-get update.
  2. Display the available versions across your enabled repositories by running aptitude versions _package-name_, or apt-cache policy _package-name_ on older debian/ubuntu distros.
  3. For each package that you want to remove, replace our version with your repository’s version by passing the version number to apt-get: sudo apt-get install nginx=_version-number_. This will tell apt that you no longer want to use TraceView packages for this software.

Upgrade on windows

To upgrade Tracelyzer, simply re-install it. You’ll need your access key.

Upgrade on rhel/centos

  1. Check for updates: yum info tracelyzer liboboe.
  2. Pending releases are listed under ‘available packages’. If you don’t see this you’re up to date!
  3. If there are new versions available, run: yum -y update tracelyzer liboboe.

Upgrade on debian/ubuntu

  1. Check for updates apt-get update && apt-cache policy tracelyzer liboboe0.
  2. If ‘latest version’ matches ‘candidate version’ you’re up to date!
  3. If there are new versions available, run: apt-get install tracelyzer liboboe0.