Warning: Can't synchronize with repository "(default)" (Unsupported version control system "svn": No module named svn). Look in the Trac log for more information.

Changes between Version 4 and Version 5 of ToolBox


Ignore:
Timestamp:
06/29/07 11:41:10 (12 years ago)
Author:
Chris Arndt
Comment:

migration notice

Legend:

Unmodified
Added
Removed
Modified
  • ToolBox

    v4 v5  
    1 ToolBox is a webbased collection of administration tools for your TurboGears applications. 
    2 To run ToolBox, from the command line navigate to your project directory and call: 
    3  
    4 tg_admin toolbox 
    5  
    6 This will start ToolBox and load it in a new webbrowser window for you. By default ToolBox will run on port 7654.  
    7 Currently ToolBox has 4 tools under it's belt: 
    8  
    9 * CatWalk 
    10   Model Browser. Administration tool for listing, creating, updating or deleting your SQLObject instances 
    11  
    12 * WidgetBrowser 
    13   Overview of available system widgets 
    14  
    15 * WebShell 
    16   Interactive webbased Python interpreter 
    17  
    18 * admi18n 
    19   I18N administration tool. Collect your strings, add and manage locales, edit and compile you catalogs 
    20  
    21 Tools are regular TurboGears applications. 
    22  
    23 == Connecting to the toolbox from other machines == 
    24  
    25 Though as the manual says, you can access the server remotely on port 7654 by running {{{ tg-admin toolbox -n -c your.home.ip.here }}}, I found that didn't work at all for accessing Catwalk, which *still* insisted I connect from localhost. The previous syntax was also somewhat irritating to me, since I'm on a DHCP connection that often changes IP address and had to keep looking it up. 
    26  
    27 The workaround I found was to just start up the toolbox as normal, (with  
    28  
    29 {{{ tg-admin toolbox -n & }}} 
    30  
    31 to stop it opening a browser and then let me keep typing). Then, use [http://www.dest-unreach.org/socat/ socat] to set up a simple tunnel: 
    32  
    33 {{{ socat TCP4-LISTEN:9999,fork,reuseaddr TCP4:localhost:7654 }}} 
    34  
    35 I can now connect to http://my.server:9999/ and use the toolbox. I had originally planned to use stunnel, but some of the AJAX components weren't designed to go over https, so plain unencrypted http will have to do. Note, of course, that anyone who connects to your server on port 9999 can now use the toolbox, so you probably don't want to leave socat running after you're done. 
    36  
    37 '''Note''': you can also tell the toolbox to allow other IP addresses to connect by using the '-c' option, for example 
    38  
    39 {{{ tg-admin toolbox -n -c 10.0.0.2 -c 10.0.0.5 }}} 
    40  
    41 This example would allow both 10.0.0.2 and 10.0.0.5 to connect to the toolbox directly (on the default port). Note also that this will not open a web browser (due to using the -n option). You can get a list of all of the options available for the toolbox by typing: 
    42  
    43 {{{ tg-admin toolbox --help }}} 
     1{{{ 
     2#!rst 
     3.. note:: This page has been migrated to http://docs.turbogears.org/1.0/Toolbox. 
     4}}}