Difference between revisions of "Known issues"

From VistrailsWiki
Jump to navigation Jump to search
(New page: Check this page for known issues with VisTrails Releases and how to work around them. ==Rev 559== There are two issues with the binary version of this release. '''1. When the current di...)
 
 
(16 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Check this page for known issues with VisTrails Releases and how to work around them.
Check this page for known issues with VisTrails Releases and how to work around them.


== Version 2.1.3 ==
The mac binary contains the wrong usersguide. Please use [http://www.vistrails.org/usersguide/v2.1/html/VisTrails.pdf this one].
== Version 2.1 ==
The server doesn't start because of an import problem. This can be fixed by replacing vistrails/gui/application_server.py with [http://pastebin.com/raw.php?i=Ye5jEBkP this file].
Parameter Explorations does not work. Parameters are cleared before being executed. This can be fixed by replacing vistrails/gui/paramexplore/pe_view.py with [[media:pe_view.zip]].
== Version 2.0 ==
=== Ubuntu 10.04 ===
The version of PyQt shipped with Ubuntu 10.04 is not supported by VisTrails. A new version can be downloaded here:
http://www.riverbankcomputing.co.uk/software/pyqt/download/
== Version 1.4.2 rev1728 ==
=== Web Services package fails to load ===
This is because of the new way packages are structured (see [http://www.vistrails.org/index.php/UsersGuideVisTrailsPackages#How_to_make_you_package_reloadable UsersGuideVisTrailsPackages]). As the web services package serializes information to disk for caching purposes, the stored information became inconsistent. So, if you see the error
('Error loading configuration file: ', '~/.vistrails/webServices/modules.conf')
Just remove your ~/.vistrails/webServices and enable the package again.
We are preparing a fix for this that will be available in the next release.
===VisTrails fails to start on Ubuntu/Fedora===
The changes in the apt-get interface have not been reflected in this VisTrails version. Please use the [http://www.vistrails.org/index.php/Downloads#Nightly_build nightly build] as the fix was already ported to VisTrails trunk.
== Version 1.2.1 rev1337 ==
=== VisTrails does not finish properly when executed in batch mode ===
In your VisTrails installation, edit the file located at VisTrails/vistrails/vistrails.py as follows:
Change lines 46-48
    if (app.temp_configuration.interactiveMode or
        not app.temp_configuration.check('spreadsheetDumpCells')):
        v = app.exec_()
by:
    if (app.temp_configuration.interactiveMode):
        v = app.exec_()
    else:
        app.finishSession()
==Command-Line Switches==
The VisTrails development team is refactoring the implementation of many of the command-line switches supported by VisTrails. Please refer to the table below for a summary of which switches work and which ones don't, and their status.
<table border=1>
<tr>
<th>Short form</th><th>Long form</th><th>Description</th>
</tr>
<tr>
<td>-h</td><td>--help</td><td>Print a help message and exit.</td>
</tr>
<tr>
<td>-S ''/path''</td><td>--startup=''/path''</td><td>Set user configuration directory (default is ~/.vistrails).<br><font color="RED">'''NOT WORKING'''. See ticket #213.</font></td>
</tr>
<tr>
<td>-?</td><td>&nbsp;</td><td>Print a help message and exit.</td>
</tr>
<tr>
<td>-v</td><td>--version</td><td>Print version information and exit.</td>
</tr>
<tr>
<td>-V ''num''</td><td>--verbose=''num''</td><td>Set verboseness level (0–2, default=0,
higher means more verbose).<br> <font color="RED">'''MORE TESTING NEEDED.''' I haven't yet found a use case where this makes a difference.</font></td>
</tr>
<tr>
<td>-b</td><td>--noninteractive</td><td>Run in non-interactive (batch) mode.</td>
</tr>
<tr>
<td>-n</td><td>--nosplash</td><td>Do not display splash screen on startup.</td>
</tr>
<tr>
<td>-c ''num''</td><td>--cache=''num''</td><td>Enable/disable caching (0 to disable,
nonzero to enable. Default is enabled).</td>
</tr>
<tr>
<td>-m ''num''</td><td>--movies=''num''</td><td>Set automatic movie creation on spreadsheet
(0 or 1, default=1). Set this to zero to work around VTK bug with offscreen renderer and OpenGL texture3D mappers. <br><font color="RED">This switch is more for the Spreadsheet than for VisTrails proper, but we'll keep it for now.</font></td>
</tr>
<tr>
<td>-s</td><td>--multiheads</td><td>Display the Builder and Spreadsheet on
different screens (if available).</td>
</tr>
<tr>
<td>-x</td><td>--maximized</td><td>Maximize Builder and Spreadsheet windows at startup.</td>
</tr>
<tr>
<td>-l</td><td>--nologger</td><td>Disable logging. <br><font color="RED">'''NOT WORKING.''' Known issues.</font></td>
</tr>
<tr>
<td>-d</td><td>--debugsignals</td><td>Debug Qt signals. <br><font color="RED">'''NOT USED.''' To be removed.</font></td>
</tr>
<tr>
<td>-a ''params''</td><td>--parameters=''params''</td><td>Set workflow parameters (non-interactive mode only). <br><font color="RED">'''WORKING, BUT''' this option will eventually be superseded by the Medley functionality.</font></td>
</tr>
<tr>
<td>-t ''host''</td><td>--host=''host''</td><td>Set hostname or IP address of database
server.</td>
</tr>
<tr>
<td>-r ''port''</td><td>--port=''port''</td><td>Set database port.</td>
</tr>
<tr>
<td>-f ''dbName''</td><td>--db=''dbName''</td><td>Set database name.</td>
</tr>
<tr>
<td>-u ''userName''</td><td>--user=''userName''</td><td>Set database username. <br><font color="RED">'''NOT SURE''' if this works as advertised. Sometimes the username is not automatically populated in the Open Database Connection dialog, while the other fields are.</font></td>
</tr>
</table>
==Rev 674==
On Linux machines using PyQt4.2, there is a bug that causes vtk pipelines not to show on the spreadsheet.
Solution: edit the file <code>path_to_vistrails_src/vistrails/packages/vtk/vtkcell.py</code>
in the import section (around line 27),  add
  import sip
replace line 244:
  vp = '_%s_void_p' % (hex(int(QtGui.QX11Info.display()))[2:])
by
<code>
try:
    vp = '_%s_void_p' % (hex(int(QtGui.QX11Info.display()))[2:])
except TypeError:
    #This was changed for PyQT4.2
    if isinstance(QtGui.QX11Info.display(),QtGui.Display):
        display = sip.unwrapinstance(QtGui.QX11Info.display())
        vp = '_%s_void_p' % (hex(display)[2:])
</code>
==Rev 559==
==Rev 559==
There are two issues with the binary version of this release.
There are two issues with the binary version of this release.
Line 10: Line 134:
'''2. When installing on a non-english system or on a custom directory, VisTrails won't start. This is due to absolute paths inside the bookmarks file.'''
'''2. When installing on a non-english system or on a custom directory, VisTrails won't start. This is due to absolute paths inside the bookmarks file.'''


'''Solution''': Remove file <code>bookmarks.xml</code> inside <code>~/.vistrails</code> folder. On Windows it's located on <code>C:\Documents and Settings\your_username\.vistrails</code>
'''Solution''': Remove file <code>bookmarks.xml</code> inside <code>~/.vistrails</code> folder. On Windows XP it's located on <code>C:\Documents and Settings\your_username\.vistrails</code>. On Windows Vista, it's located at <code>C:\Users\your_username\.vistrails</code>.

Latest revision as of 17:20, 6 August 2014

Check this page for known issues with VisTrails Releases and how to work around them.

Version 2.1.3

The mac binary contains the wrong usersguide. Please use this one.

Version 2.1

The server doesn't start because of an import problem. This can be fixed by replacing vistrails/gui/application_server.py with this file.

Parameter Explorations does not work. Parameters are cleared before being executed. This can be fixed by replacing vistrails/gui/paramexplore/pe_view.py with media:pe_view.zip.

Version 2.0

Ubuntu 10.04

The version of PyQt shipped with Ubuntu 10.04 is not supported by VisTrails. A new version can be downloaded here: http://www.riverbankcomputing.co.uk/software/pyqt/download/

Version 1.4.2 rev1728

Web Services package fails to load

This is because of the new way packages are structured (see UsersGuideVisTrailsPackages). As the web services package serializes information to disk for caching purposes, the stored information became inconsistent. So, if you see the error

('Error loading configuration file: ', '~/.vistrails/webServices/modules.conf')

Just remove your ~/.vistrails/webServices and enable the package again. We are preparing a fix for this that will be available in the next release.

VisTrails fails to start on Ubuntu/Fedora

The changes in the apt-get interface have not been reflected in this VisTrails version. Please use the nightly build as the fix was already ported to VisTrails trunk.

Version 1.2.1 rev1337

VisTrails does not finish properly when executed in batch mode

In your VisTrails installation, edit the file located at VisTrails/vistrails/vistrails.py as follows:

Change lines 46-48

   if (app.temp_configuration.interactiveMode or
       not app.temp_configuration.check('spreadsheetDumpCells')):
       v = app.exec_()

by:

   if (app.temp_configuration.interactiveMode): 
       v = app.exec_()
   else:
       app.finishSession()

Command-Line Switches

The VisTrails development team is refactoring the implementation of many of the command-line switches supported by VisTrails. Please refer to the table below for a summary of which switches work and which ones don't, and their status.

Short formLong formDescription
-h--helpPrint a help message and exit.
-S /path--startup=/pathSet user configuration directory (default is ~/.vistrails).
NOT WORKING. See ticket #213.
-? Print a help message and exit.
-v--versionPrint version information and exit.
-V num--verbose=numSet verboseness level (0–2, default=0, higher means more verbose).
MORE TESTING NEEDED. I haven't yet found a use case where this makes a difference.
-b--noninteractiveRun in non-interactive (batch) mode.
-n--nosplashDo not display splash screen on startup.
-c num--cache=numEnable/disable caching (0 to disable, nonzero to enable. Default is enabled).
-m num--movies=numSet automatic movie creation on spreadsheet (0 or 1, default=1). Set this to zero to work around VTK bug with offscreen renderer and OpenGL texture3D mappers.
This switch is more for the Spreadsheet than for VisTrails proper, but we'll keep it for now.
-s--multiheadsDisplay the Builder and Spreadsheet on different screens (if available).
-x--maximizedMaximize Builder and Spreadsheet windows at startup.
-l--nologgerDisable logging.
NOT WORKING. Known issues.
-d--debugsignalsDebug Qt signals.
NOT USED. To be removed.
-a params--parameters=paramsSet workflow parameters (non-interactive mode only).
WORKING, BUT this option will eventually be superseded by the Medley functionality.
-t host--host=hostSet hostname or IP address of database server.
-r port--port=portSet database port.
-f dbName--db=dbNameSet database name.
-u userName--user=userNameSet database username.
NOT SURE if this works as advertised. Sometimes the username is not automatically populated in the Open Database Connection dialog, while the other fields are.

Rev 674

On Linux machines using PyQt4.2, there is a bug that causes vtk pipelines not to show on the spreadsheet. Solution: edit the file path_to_vistrails_src/vistrails/packages/vtk/vtkcell.py

in the import section (around line 27), add

 import sip

replace line 244:

 vp = '_%s_void_p' % (hex(int(QtGui.QX11Info.display()))[2:])

by

try:
    vp = '_%s_void_p' % (hex(int(QtGui.QX11Info.display()))[2:])
except TypeError:
    #This was changed for PyQT4.2
    if isinstance(QtGui.QX11Info.display(),QtGui.Display):
        display = sip.unwrapinstance(QtGui.QX11Info.display())
        vp = '_%s_void_p' % (hex(display)[2:])

Rev 559

There are two issues with the binary version of this release.

1. When the current directory is not on the PATH. This causes VisTrails to raise a Requirements not fulfilled exception.

Solution: Adding '.' or path_to_vistrails_install/vistrails to the PATH solves this problem.

2. When installing on a non-english system or on a custom directory, VisTrails won't start. This is due to absolute paths inside the bookmarks file.

Solution: Remove file bookmarks.xml inside ~/.vistrails folder. On Windows XP it's located on C:\Documents and Settings\your_username\.vistrails. On Windows Vista, it's located at C:\Users\your_username\.vistrails.