Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Troubleshooting installation issues
Clone this wiki locally
Installing the plaso on Ubuntu should be a breeze if you follow the instructions here, however sometimes there can be conflicting packages installed that cause plaso not to run properly. Most often this is caused by either some unsupported versions of packages being installed or if for some reason some of the dependencies was installed from source at some point and those dependencies are out of date.
If you are having trouble getting plaso to run on your computer after following the installation instructions one of the best first steps is to check if all dependencies are met. One way of doing that is to download the check dependency script and run it.
$ wget https://raw.githubusercontent.com/log2timeline/plaso/master/utils/check_dependencies.py $ python check_dependencies.py
The output should be something on these lines:
Checking availability and versions of plaso dependencies. [OK] artifacts version: 20150409 [OK] bencode [OK] binplist version: 0.1.4 [OK] construct version: 2.5.2 ...
[ERROR] status indicates that the version of the dependency is not supported.
First make sure all currently installed packages are up-to-date by running:
$ sudo apt-get update $ sudo apt-get upgrade
Then re-run the check dependencies script. If that still hasn't fixed the issue then you need check each of the dependencies with an error status.
One way of doing so is to use IPython to determine the location of the Python module on your system.
$ ipython Python ... Type "copyright", "credits" or "license" for more information. ... In : import pyewf In : pyewf.get_version() Out: u'20140608' In : pyewf.__file__ Out: '/usr/lib/python2.7/dist-packages/pyewf.so'
Import the Python module of the dependency that was showing an error status. Check its version, if it is part of the libyal collection use the
LIBRARY.get_version() to get the version information, other Python modules can store their version information differently, a commonly used convention is
If the version is an out-of-date version you can use the
LIBRARY.__file__ to determine out where the Python module is located on your system.
The Python module can originate from another Debian package or from a source installation. If this is originating from a source installation one way of removing it is to simply delete that particular file (or .egg directory), however the preferred method is to uninstall source installation properly if possible.
To find out which package a Python module belongs to run:
$ dpkg -S /usr/lib/python2.7/dist-packages/pyewf.so libewf-python: /usr/lib/python2.7/dist-packages/pyewf.so
Another example here is pyparsing:
In : import pyparsing In : pyparsing.__version__ Out: '2.0.3' In : pyparsing.__file__ Out: '/usr/lib/python2.7/dist-packages/pyparsing.pyc'
In this case the Python module is the ".pyc" file, which is not included in the dpkg package:
$ dpkg -S /usr/lib/python2.7/dist-packages/pyparsing.pyc dpkg-query: no path found matching pattern /usr/lib/python2.7/dist-packages/pyparsing.pyc
".pyc" is a "compiled" version of the Python code ".py", these are typically not distributed by packages but generated on your system at installation or first execution time. Therefore in order to find out which package this Python module belongs to remove the final "c" so it becomes ".py" instead of ".pyc", e.g.:
$ dpkg -S /usr/lib/python2.7/dist-packages/pyparsing.py python-pyparsing: /usr/lib/python2.7/dist-packages/pyparsing.py
Once the package has been identified that contains the out-of-date dependency the next step is to see if it is truly at the latest version.
$ apt-cache policy python-construct python-construct: Installed: 2.5.1-1 Candidate: 2.5.1-1 Version table: 2.5.2-1 0 500 REPO *** 2.5.1-1 0 600 REPO 100 /var/lib/dpkg/status
Here you can see an example of python-construct that has version 2.5.1-1 installed instead of version 2.5.2-1, which is required by plaso. To correct this you may have to specifically indicate the version you want to install.
$ sudo apt-get install python-construct=2.5.2-1
Common package conflicts
$ log2timeline.py Traceback (most recent call last): File "/usr/bin/log2timeline.py", line 13, in <module> from plaso.cli import extraction_tool File "/usr/lib/python2.7/dist-packages/plaso/cli/extraction_tool.py", line 7, in <module> from plaso.cli import storage_media_tool ... File "/usr/lib/python2.7/dist-packages/dfvfs/file_io/gzip_file_io.py", line 22, in GzipFile construct.ULInt16(u'signature'), File "/usr/lib/python2.7/dist-packages/construct/macros.py", line 160, in ULInt16 return FormatField(name, "<", "H") File "/usr/lib/python2.7/dist-packages/construct/core.py", line 352, in __init__ StaticField.__init__(self, name, self.packer.size) File "/usr/lib/python2.7/dist-packages/construct/core.py", line 324, in __init__ Construct.__init__(self, name) File "/usr/lib/python2.7/dist-packages/construct/core.py", line 103, in __init__ raise TypeError("name must be a string or None", name) TypeError: ('name must be a string or None', u'signature')
This indicates that an older not supported version of construct is installed on your system. Please make sure you update to the latest version.
$ apt-cache policy python-construct
Check to see if there is a more up-to-date version available, you may need to specifically indicate the version you would like to install, e.g.:
$ sudo apt-get install python-construct=2.5.2-1
The following traceback:
======================= Traceback (most recent call last): File "/usr/bin/log2timeline.py", line 28, in <module> from plaso.frontend import frontend File "/usr/lib/python2.7/dist-packages/plaso/frontend/frontend.py", line 36, in <module> ... pyparsing.lineEnd()) TypeError: __call__() takes exactly 2 arguments (1 given) ========================
This is indicative that you are running an old version of pyparsing. Please make sure you are using the latest version, see what is available using:
$ apt-cache policy python-pyparsing
And install the latest version.
There are some packages that declare libewf2 as one of their dependencies. This is an out dated version of the libewf library provided by your distribution.
See for instance this issue.
The solution here is to remove the libewf2 package from the system and replace it by libewf and libewf2 packages from the GIFT PPA.
$ sudo apt-get remove libewf2
Note that this may remove other packages as well that depend on libewf2, which are likely to be out dated as well.
$ sudo apt-get install libewf libewf2=20140608-1
Installing libewf2 from the GIFT PPA prevents your package manager installing its own version of the libewf2 package when it does not need to, since the necessary files are already provided by the libewf package.