(Category) (Category) WebGUI FAQ :
Troubleshooting
Resolutions and hints on error messages.
wg-fomATgwyDOTorg
Subcategories:

Answers in this category:
(Answer) Do this first!
(Answer) FreeBSD, mod_perl2, apache2, GATEWAY_INTERFACE not Perl!, Can't locate ModPerl/Registry.pm (New: Apache::Request on mod_perl2 RC5)
(Answer) http:\\\index.pl\ problem- Sitename disappears
(Answer) ? Question marks, Squares, strange characters on upgrade to 6.2.x+
(Answer) Problem with Request. SQL Column Errors
(Answer) Links going to localhost
(Answer) Can't locate .... in @INC
(Answer) Can I... Why can't I... Why isn't anyone answering my question about 5.x?
(Answer) Theme import problems uid/gid, Byte order is not compatible. Storable.pm (6.2.x)
(Answer) Graphical Editor for Firefox, Netscape?
(Answer) How do I use WebGUI on a nonstandard (not port 80) port?
(Answer) All your troubles are belong to ImageMagick
(Answer) WebGUI shows "Initial Configuration" screen but "save" does not work
(Answer) My Intranet is behind a proxy server. How do I use Syndicated Content behind a proxy server?
(Answer) How do I send to multiple recipients in a dataform?
(Answer) 6.6.3-6.6.4 Upgrade problems. (Blank Admin Bar) -- wrong HTML::Template
(Answer) I hate the GUI Editor! It screws up my code!
(Answer) How to reset my password? I'm locked out!
(Answer) Can I nest Macros? Can I nest href's in macros?
(Answer) How can I get mailman and other progs to work in 6.8+?
(Answer) Not WebGUI: VirtualHost DocumentRoot gets overwritten by VirtualDocumentRoot in httpd.conf
(Answer) Hint: How to get WebGUI to parse only WebGUI sites?

[New Answer in "Troubleshooting"]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Do this first!
go into /data/WebGUI/sbin and type: 
 perl preload.perl
It will definitely tell you what's WebGUI-specific (including perl modules) wrong with your install.

If you get 

 Starting WebGUI (version)
   webgui.conf
   anothersite.conf (optional)
 WebGUI started Successfully!

You're on the right track. Don't forget that httpd-error.log will tell you nice other stuff. Oh, and ... yes, if webgui.log is filling up, you probably should address those issues as well. Those issues are usually "bad things" that are related either to real bugs or something you did bad with the install.

If the error message says, "Maybe you didn't load perlcategory::perlmodule", you might like to try to install the missing thing (again) with CPAN. Don't forget... upgrading Perl (5.6 to 5.8, eg) may necessitate upgrading or re-installing CPAN modules.
wg-fomATgwyDOTorg

This is not valid with 7.x+
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
FreeBSD, mod_perl2, apache2, GATEWAY_INTERFACE not Perl!, Can't locate ModPerl/Registry.pm (New: Apache::Request on mod_perl2 RC5)
From crythias's post: So, I'm on my FreeBSD box and having all sorts of problems with mod_perl2 (1.99r16) The port didn't add the LoadModule.
I had to add Perl 5.8.5 from port but you have to use.perl port to start it (so you can use/install the mod_perl2 port).
The mod_perl2 port is installed, but I kept getting Can't locate ModPerl/Registry.pm in @INC
I check my httpd.conf, and it's verbatim with WebGUI install, but changed for my system. I added
LoadModule perl_module libexec/apache2/mod_perl.so
PerlModule Apache2 I added the Options +ExecCGI to the Files directive (necessary in *my* configs to make the .pl work).

Then I started on sbin/preload.perl ... catching up from something I read... somewhere, I added
use Apache2; before use ModPerl::Registry
which helped preload.perl find ModPerl.

I had to re-install all the perl modules as well. Hint: if you want to install via ports, simply portinstall or portupgrade p5-Port-Name... ferinstance portinstall p5-SOAP-Lite I also found this interesting site: http://lists.otrs.org/pipermail/cvs-log/2004-April/003773.html which explained that GATEWAY_INTERFACE not Perl! at /data/WebGUI/sbin/preload.perl is deprecated, and so changing the line based upon:
# make sure we are in a sane environment.
#$ENV{GATEWAY_INTERFACE} =~ /
# check $ENV{MOD_PERL}, $ENV{GATEWAY_INTERFACE} is deprecated for mod_perl2
$ENV{MOD_PERL} =~ /mod_perl/ or die "MOD_PERL not used!";


And wow! I've now got an apache2/modperl2 on FreeBSD working machine (oh, yeah, and WebGUI's sbin/preload.perl seems to not crash apache now :)

Well, I do hope this helps someone. It took me almost a day of work to get it, but I think I tackled most of the problems. It's late for me, and I want to get to sleep.
wg-fomATgwyDOTorg
New problem exists with mod_perl2 RC5 http://sourceforge.net/tracker/index.php?func=detail&aid=1187256&group_id=51417&atid=463213

2005-04-22 05:12 aaronp_critd writes:

Ok I figured it out. The problem centers around the Apache request object. As of mod_perl v2.0.0RC5, the request object package was renamed from Apache to Apache2::RequestUtil. I changed all references from `grep -Er "Apache->request" /usr/local/www/resources/WebGUI` to Apache2::RequestUtil. I did the same for the server object (Apache2::ServerUtil). Goto:

  http://perl.apache.org/dist/mod_perl-2.0-current/Changes

...for more information. These changes will break WG for all versions of mod_perl less than v2.0.0RC5, but with some quick if statements that could be fixed. It would be nice to include these fixed into the future v6.5.7. Thanks.
wg-fomATgwyDOTorg

[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
http:\\\index.pl\ problem- Sitename disappears
From a post by OhGoOn:
It turns out that a white space at the end of the lines refering to "sitename" causes the url in the links to show:
          http:\\\index.pl\mylink.
I have an install batch that creates a new configuration file www.newconfig.com.conf from scratch, unfortunatelly it left a blank space behind some of the lines. This space is aparently not stripped out correcly in url.pm in the makecompliant sub:
 sub makeCompliant
 {
   my ($value);
   $value = $_[0];
         $value =~ s/\s+$//;        #removes trailing whitespace
         $value =~ s/       #removes leading hitespace
         $value =~ s/         #removes leading slash
         $value =~ s/ /_/g;  #replaces whitespace with underscores
         $value =~ s/\.$//;          #removes trailing period
         $value =~ s/[  #removes all funky characters
         $value =~ s/   #removes a preceeding /
         $value =~ s/\/\//\//g;    #removes double /
         return $value;
 }
Two solutions: 
 1 - don't leave spaces behind lines in the config file
 2 - improve the stripping out of whitespaces. I presume the sub responsible is makeCompliant in url.pm. I am not sure how to change it as it seems that the sub is already doing this.

wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
? Question marks, Squares, strange characters on upgrade to 6.2.x+
You might wish to check out the translations page to download a regional fix for your install.
You might also see if (from 5.x) that you have no 1000's in languageId of your page table. If so, you can quickly fix your USS's by an UPDATE SQL query to the language of your choice.
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Problem with Request. SQL Column Errors
This should be completely resolved by 6.2.9, but just in case...
objectIds were changed from int(11) to char(22), which affected a LOT of stuff. SQL queries running on 'where pageId='.pageId should be set with 
 'where pageId='.quote(pageId)
in order for the full Hashed Id to be queried properly.
If you code or use an installed Macro, be aware of this distinction. If you find an error like that in the main code, do check and submit a bug report exactly what module and error message.
This is just one of the reasons that you shouldn't try to mix and match 5.x and 6.x macros and wobjects.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Links going to localhost
From Len Kranendonk, www.primaat.com: Links going to localhost or some weird place reflect the sitename field in WebGUI.conf.
I'm not savvy with searching for a .conf file and want to know how to change all the links that point to "localhost" to my main site url through the WebGUI interface. If that's not possible, then where do I find this .conf file to modify?
Thanks
First, understand that WebGUI will try to use the same domain that you use, for most of its links, especially if Apache set "UseCanonicalName Off". So, if you are using http://localhost to connect to WebGUI, it's likely that WebGUI will keep using that as a matter of course during your session.

That said, let's say you have a real problem with WebGUI. The .conf file is one that you should have set up, unless you used one of these all-in-one installers. The webgui.conf file is located in your /path/to/WebGUI/etc/webgui.conf ... you should simply edit this file and change the sitename accordingly.

[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Can't locate .... in @INC
Len provided this:
When I load a page I randomly get errors like: 

 "FATAL: Authentication module failed to compile: WebGUI::Auth::WebGUI.Can't locate WebGUI/Auth/WebGUI.pm in @INC"

 "WARNING: Wobject failed to compile: WebGUI::Wobject::USS.Can't locate WebGUI/Wobject/USS.pm in @INC"
I solved it by adding this to the httpd.conf:
 PerlSwitches -I/data/WebGUI/lib
This happened on Apache/2.0.50 (FreeBSD) mod_perl/1.99_16 Perl/v5.8.5
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Can I... Why can't I... Why isn't anyone answering my question about 5.x?
Because, unfortunately, there apparently aren't that many adopters of 5.x who are giving free advice.

Almost every question re 5.x has been answered, fixed or improved in 6.2.x. All new development is centered around that and increasing in 6.3.0+. It is hard to code improvements on new technology and retrofit to old tech. However, that doesn't necessarily mean it's not possible to do what you want. Sometimes just observing the CVS code changes (http://cvs.sourceforge.net/viewcvs.py/pbwebgui/WebGUI/lib/WebGUI/) can give you hints on how to make the changes for you.

Me, personally? I'm not able to provide a lot of support on something that I'm not running.
wg-fomATgwyDOTorg

[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Theme import problems uid/gid, Byte order is not compatible. Storable.pm (6.2.x)
The short short: Themes created in Apache1/mod_perl do not import in Apache2/mod_perl2, and vice versa. This is regardless of version.

The answer is that Storable.pm has a store method and an nstore method. Up to and including 6.2.9, themes are created with the store method, which means they are only valid with the architecture/OS on which they were created. The nstore (network) store method allows cross-platform themes to be created.

These changes need to be made by one who is exporting themes. It has no affect to "fix" broken themes to import properly.

In Attachment.pm:

Change line 28 from:

 use Storable;
to: 
 use Storable qw(nstore retrieve);
Change line 660 from:
 store $hashref, $self->getPath;
to: 
 bless $hashref;
 nstore $hashref, $self->getPath;
Now you can export cross platform themes!
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Graphical Editor for Firefox, Netscape?
So, you've been messing with WebGUI using Firefox and Netscape and basically thought, "ok, but I thought this was GUI... Is there a graphical editor?"

The answer is: yes! Click your name/go to your profile and edit profile. Scroll ALL THE WAY TO THE BOTTOM. See a drop-down box "Editor to use"? Try: HTMLArea 3. Click 'Save'.
wg-fomATgwyDOTorg

In 6.3+, TinyMCE is the default editor, so there shouldn't be a reason to ask this question.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
How do I use WebGUI on a nonstandard (not port 80) port?
Of course httpd.conf needs to be Listening on the port. If I understand it correctly, the webgui.conf for your site should have sitename=site:port as I believe the conf file is used to present the sitename throughout WebGUI.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
All your troubles are belong to ImageMagick
JPG support, preload.perl Auth, and a host of other issues are directly related to ImageMagick not being installed, or not being installled properly.

FreeBSD has it relatively easy (portinstall ImageMagick). Most package management systems should install ImageMagick properly, but *some* binary installs might not have jpg support. IMHO, it is probably best to install ImageMagick compiled from source (--with-jpg), instead of RPM binaries. Your results may vary, but.. hey, I'm just warning you. *SOME* people find that they might also need to install Perl::Magick from CPAN. I'm not yet convinced, but you shouldn't install Perl::Magick until AFTER you have installed ImageMagick. Well, your choice. I'm just saying that Perl::Magick doesn't install ImageMagick, necessary for WebGUI to function.

wg-fomATgwyDOTorg

I mean it. If you can't 
 perl -e "use Image::Magick;"
without error you're not going to have fun and get cryptic error messages like: 
 FATAL - WebGUI.conf - WebGUI::Operation::Auth::getInstance[47] - Couldn't instantiate authentication module: WebGUI. Root cause: Can't locate object method "new" via package "WebGUI::Auth::WebGUI" at /data/WebGUI/lib/WebGUI/Operation/Auth.pm line 46.
 ERROR - WebGUI.ErrorHandler - WebGUI::Operation::execute[63] - Couldn't execute operation : WebGUI::Operation::Auth::www_auth. Root cause: ModPerl::Util::exit: (120000) exit was called at /data/WebGUI/lib/WebGUI/ErrorHandler.pm line 197

wg-fomATgwyDOTorg
This also applies to:
 Couldn't call method view on asset for url:  Root cause: Can't locate object method "get" via package "WebGUI::Storage::Image" at /data/WebGUI/lib/WebGUI/Asset/Wobject/Article.pm line 178.

wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
WebGUI shows "Initial Configuration" screen but "save" does not work
So, you have EVERYTHING up and running, all all "checks" out okay. But you cannot login past the initial screen.
Did you forget something? Probably. Buried deep in the "installation guide" in the section marked "WebGUI Gateway" is this tidbit.....
TIP: If you are installing into a directory other than /data then you'll need to modify preload.perl accordingly.
Not really a TIP, but rather a MUST. Make sure that the PATH fixed in perload.perl or else nothing will work.
mtiltonATchicousdDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
My Intranet is behind a proxy server. How do I use Syndicated Content behind a proxy server?
Version: 6.5+, but perhaps others might benefit:
There is a line (6.5.5's line number is 205) in WebGUI/lib/WebGUI/Asset/Wobject/SyndicatedContent.pm that looks like: 
 my $ua = LWP::UserAgent->new(timeout => 5);
Immediately after that, you can put a line like this: 
 $ua->proxy(['http', 'ftp'], 'http://proxy:port');
or 
 $ua->env_proxy;
You may consider this in HttpProxy.pm. HOWEVER, HttpProxy.pm does kindly include 
 $useragent->env_proxy;
which means that it will observe environment variables that end with _proxy: 
 http_proxy="http://proxy:port"
 ftp_proxy="ftp://proxy:port"
 no_proxy="localhost,my.domain"
More info: http://search.cpan.org/~gaas/libwww-perl-5.803/lib/LWP/UserAgent.pm#Proxy_attributes
Of course, changes to .pm might mean that you should stop and restart apache.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
How do I send to multiple recipients in a dataform?
Perhaps the easiest way is to create an email address that forwards to all the recipients.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
6.6.3-6.6.4 Upgrade problems. (Blank Admin Bar) -- wrong HTML::Template
As usual, read the gotcha.txt. Upgrade HTML::Template. You'll also need to remove/disable WebGUI/lib/HTML/Template.pm.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
I hate the GUI Editor! It screws up my code!
Simple: place code in a snippet and call it with ^AssetProxy("snippetname");
wg-fomATgwyDOTorg
There is another answer: Create your own custom Editor in WebGUI.

http://tinymce.moxiecode.com/tinymce/docs/reference_configuration.html for reference on what you can add.

Specifically, you will want to take a look at http://tinymce.moxiecode.com/tinymce/docs/option_extended_valid_elements.html ... the defaults ignore things like alt tags for links and onmouseover for links. Adding what you're missing to extended_valid_elements will keep the "cleanup" from erasing your code.

in 6.6, you couldn't edit the built-ins, nor copy them, so the best you could hope for is to reconstruct them from what they looked like. Check for the other options you can add.
wg-fomATgwyDOTorg

[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
How to reset my password? I'm locked out!
have database accessibility? version 6.6.x

update authentication set fieldData='RvlMjeFPs2aAhQdo/xt/Kg' where userId='3' and fieldName='identifier'

resets admin to 123qwe

I'd suggest you might manually do this inside phpmyadmin or some such.
wg-fomATgwyDOTorg

"Lost" passwords can also be attributed to someone pressing the "Recover Password" link and not having a valid SMTP server or email address configured.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Can I nest Macros? Can I nest href's in macros?
Yes.

It's ok to use single quote (apostrophe) ' instead of quotation marks " inside HTML and macros.

This won't work: 

 ^GroupText("mygroup","<a href="/some/path">Hello, ^@;. This Link if I'm in mygroup. </a>");
This will work: 
 ^GroupText("mygroup","<a href='/some/path'>Hello, ^@;. This Link if I'm in mygroup. </a>");

wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
How can I get mailman and other progs to work in 6.8+?
Check this thread: http://www.plainblack.com/etcetera/problems-interacting-with-other-perl--cgi-tools
Short answer add passthrus to webgui.conf and add to httpd.conf: 
 <Location /mailman>
    SetHandler None
 </Location>

 <Location /ServAdmin>
    SetHandler None
 </Location>
Hint: You need SetHandler None on all cgi folders.
wg-fomATgwyDOTorg
[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Not WebGUI: VirtualHost DocumentRoot gets overwritten by VirtualDocumentRoot in httpd.conf
I had a problem. VirtualHost DocumentRoot was being ignored... after troubleshooting httpd.conf, I came to the conclusion that it was because of VirtualDocumentRoot. http://httpd.apache.org/docs/2.0/mod/mod_vhost_alias.html is a great read, especially if you don't want to configure WebGUI for bunches of new sites, without having to reconfigure httpd.conf.


wg-fomATgwyDOTorg

[Append to This Answer]
(Answer) (Category) WebGUI FAQ : (Category) Troubleshooting :
Hint: How to get WebGUI to parse only WebGUI sites?
One way is to have subdomains that only run WebGUI sites. You can use the same DocumentRoot, too.

OK, the real way is to adjust "passthruUrls" in your httpd.conf, and if you *have* to do it (for cgi-bin stuff, such as mailman), you may have to use <Location /cgi/bin>SetHandler None</Location>.
But to be "nicer", you have the option of setting a VirtualHost that is WebGUI specific (webgui.domain, www2.domain, etc.) and then your old stuff is still normally accessible, and your WebGUI new stuff doesn't kill your hundreds of pre-WebGUI sites you might have in development.
wg-fomATgwyDOTorg

[Append to This Answer]
Previous: (Category) Installation
Next: (Category) Web Design
This document is: http://www.gwy2.org/cgi-bin/fom?file=14
[Search] [Appearance] [Show Top Category Only]
This is a Faq-O-Matic 2.719.
This FAQ administered by ... Gerald Young