Installing a WebAPP For Dummies (pre-v. 1.0
Published on 06/16/06 at 23:38:51 by StringDancer
Documentation<b><Font size="+1" color="#CD3B13">Please Note! The tutorial below is for older versions of WebAPP (i.e. prior to WebAPP Version 1.0,  released November 25, 2007). We will be working on a new tutorial as soon as there appears to be a need for it. Version 1.0 is provided with a short README.txt and is automatically installed on all Linux server operating systems. Its newly developed InstallShield and error detecting script makes it very easy to install, even for complete beginners. Good luck!</b></font><br><br>

This short tutorial details how to go about installing your WebAPP scripts and getting things working properly. While not intending to be a comprehensive how-to, the following instructions should suffice to help the fledgling webmaster quickly and easily install a WebAPP within a few minutes. It is advised that you read and understand the entire process before beginning the installation.

In your WA distribution (available in our Downloads area), you'll see a folder called cgi-bin. Upload the contents of this folder into your server's cgi-bin. All the remaining folders and files go into your hosting account's html folder (this folder may be called html, htmldocs, webdocs, or some other title -- whatever it's called, it's where all your public accessible files go). You need not upload the readme folder, which are support docs you can read for more help.


FTP has two possible upload modes, ASCII (aka text) mode, and Binary. In your WebAPP installation, everything goes up in ASCII mode with the exception of images (and don't overlook the images folder nested in each of your themes folders). ASCII would include the following file types:

.pl .cgi .dat .cat .js .xml .css .txt .html

If you don't get the upload mode right, things will NOT work!


CGI scripts have to be enabled by setting the permissions. Fortunately, WebApp provides an install.cgi file in the cgi-bin that handles everything for you, but you do need to set the permissions for the install file itself by hand. Different FTP apps handle this differently, but basically you need to set the permissions of install.cgi to 755. This means that:


The server is the "owner" (and you its proxy, in essence), which means the server is given permission to create new content by using the scripts. The "group" is your members. "Everyone" is the world of potential users.

OK. Once you have the permissions set for install.cgi, call it up in the browser. The link should be:, or if nested in a subdirectory of cgi-bin, include that folder in the URL

If the permissions are cool, you'll get an installation configuration page. If not, you'll get a 404 server error page. The script will be ready to execute with a few exceptions:

1. Verify that all path settings reflect the actual paths of your particular install. The system defaults to all folders being root level, so if you created a subdirectory somewhere in the scheme of things, you'll need to modify the paths accordingly.

2. Modify the contact information and time zone if you want. If not now, you can do it later in the site's admin.

When you're ready, pull the trigger on the script. It will go through the entire set of scripts and configure paths and permissions for you, as well as contact info and time zone if you tweaked these. It only takes a second, then you'll get the test link. Click it and see if you succeeded. If a brand spanking new WA appears in a new window, go have a cold beer. If not, you made a mistake in the pathing, and you'll need to redo the install.

Login and start tweaking. The administrative username is admin, and your default password is webapp. You can change the password after login by editing your profile.

Also -- if the install is successful, go back to the install script and click the button to configure your index.html page to forward hits to the cgi-bin. When that's done, don't forget to delete the install.cgi file. You wouldn't want some hacker to drop by later and reconfigure your site, would you....

26 comments, (1035 reads) All Articles by, StringDancer
  Printer Friendly version - Installing a WebAPP For Dummies (pre-v. 1.0  Log in to use this feature 
Sign Up
Comments on this article: Comments on this article:

1. That last bit... Written on 08/07/06 at 12:15:41 by seeknulfind

2. re: That last bit... Written on 08/07/06 at 15:03:56 by StringDancer

3. Got it Written on 08/09/06 at 12:02:28 by seeknulfind

4. re: Got it Written on 01/20/07 at 18:17:17 by StringDancer

5. why don't upload install.cgi on the IE7? Written on 05/19/07 at 17:57:37 by luigicirillo

6. What's Occuring Written on 06/09/07 at 18:52:09 by Dum_Dum

7. You need perl in you server Written on 06/09/07 at 19:34:14 by On

8. re: You need perl in you server Written on 06/10/07 at 11:07:40 by Dum_Dum

9. re: re: You need perl in you server Written on 06/10/07 at 22:38:46 by On

10. re: re: re: You need perl in you server Written on 06/10/07 at 22:40:26 by On

11. re: re: re: re: You need perl in you server Written on 06/11/07 at 00:02:56 by Dum_Dum

12. Up and running (sort of) Written on 06/10/07 at 23:55:18 by Dum_Dum

13. It sounds like a path issue Written on 06/11/07 at 00:00:29 by On

14. re: It sounds like a path issue Written on 06/11/07 at 00:29:30 by Dum_Dum

15. re: re: It sounds like a path issue Written on 06/11/07 at 18:19:30 by On

16. re: re: re: It sounds like a path issue Written on 06/12/07 at 20:08:50 by Dum_Dum

17. re: re: re: re: It sounds like a path issue Written on 06/12/07 at 20:14:48 by On

18. re: re: re: re: re: It sounds like a path issue Written on 06/12/07 at 21:09:37 by Dum_Dum

19. I've fixed it!!! Written on 06/13/07 at 20:15:09 by Dum_Dum

20. re: I've fixed it!!! Written on 06/18/07 at 18:10:30 by Jack Deth

21. replica and rolex watch Written on 08/23/12 at 04:12:16 by carmencha

22. breitling replica Written on 08/30/12 at 22:18:29 by carmencha

23. Scoop Neck Wedding Dress Written on 09/14/12 at 12:28:54 by carmencha

24. Cathedral Train Wedding Dresses Written on 09/17/12 at 11:58:42 by carmencha

25. ultimate replica Written on 12/09/12 at 05:54:50 by carmencha

26. party cocktail dress Written on 04/12/13 at 00:38:07 by carmencha

The comments are owned by the poster. We aren't responsible for its content.
Only registered members may comment on articles.