 | |||||||
|
| Home Cart Free Download Manual | ||||||
Installation: Free Downloads The H2O Family Install Notes Programming: Prerequisites H2O Whitepaper Online Manual Code Examples H2O Free Support |
|
What's H2O? H2O is programming made for the web. What's it like? H2O is English-like. If you know some Perl, VB, ASP, or PhP you'll be immediately productive in H2O. It runs on Linux, Mac, Unix, and Windows. How do I try it? Download H2O for free. Get it from hosting providers. Or buy online. Where does H2O come from? The language was invented by Aestiva. H2O stands for: HTML with HTML/OS Overlays. |
| Installing H2O on Sun Cobalt Step 1: Unzip Your Install Program H2O is delivered in a zip file, usually named "h2o-cobalt[version].zip". Use an unzip program to extract the actual install program, which will be named "asetup[version]_h2o.cgi". You will run this install program later as a cgi application from your browser to unpack and install H2O. See "Upgrading Your H2O Engine" if you need to upgrade your copy of H2O to a newer version. Step 2: Copy Install Program To Cgi Directory Use ftp to log in to your Cobalt server. Go to the "/web" directory. If there is no "cgi-bin" directory there, create one. Upload "asetup[version]_h2o.cgi" to the "/web/cgi-bin" directory. Be sure to use BINARY mode for this transfer! H2O is a compiled binary program, and the install will fail if you don't use BINARY mode. Step 3: Set The Permissions On The Install Program Use the command "chmod 755 asetup[version]_h2o.cgi" in ftp to make the install program executable. This is the "rwxr-xr-x" permission, which gives the file owner read,write,execute permission, and the group and other users read,execute permission. If your version of ftp does not accept "chmod" commands at all, you can use the same command in a telnet or ssh window, or ask your hosting provider to use ssh or telnet to set the permission for you. Step 4: Access The Install Program From A Browser Now you need to run "asetup[version]_h2o.cgi" from a browser. IE, Netscape, Mozilla, or any other standard web browser will work. In the "Location" line of your browser, type in the URL: http://[your domain name]/cgi-bin/asetup[version]_h2o.cgi Replace [your domain name] with the domain name of your website. Replace [version] with the version number in your install program file name. After you've entered the URL, press "Enter" on the keyboard. If you receive the opening page of the H2O Install Wizard, proceed to step 5. If you do not see the Install Wizard, see the "PROBLEMS AND SOLUTIONS " below for help. After you correct the problem, repeat step 4. Step 5: Running The Install Program Click the "Continue" button in the H2O Install Wizard to proceed to the next page. The second page is used to enter information about your web site. Enter the domain name you used to access the install program in the "Domain Name" field. You can see it in the location line of your browser. Add "www." to the front of the domain name if your web site uses it. The "Doc Root" folder on Cobalt servers is the "/web" folder. The install program shows you the full directory name, which looks like "/home/sites/site.../web/". The "Private Doc Root" is the folder where H2O will store text files, databases, and other information. The folder is usually named "private" and placed inside your cgi directory. Debugging and diagnostics are built into "asetup[version]_h2o.cgi" to guide you through the install process. Once you are satisfied that the values on the install wizard screen are correct, click "Complete Install". If you get an "Install Completed" screen, follow the instructions on the screen to access your copy of H2O. You are finished with the install. If you get an error message, read the message to see the cause of the error. PROBLEMS AND SOLUTIONS Problem: When running asetup[version]_h2o.cgi I get a "File Not Found" message. Solution: If you get a "File Not Found" message, check for typos in the URL line, and make sure the domain name you entered is pointing to this server. If no mistakes are found, check the FAQs for your account for details on how to access a cgi program, or ask your system administrator for help. // Posted By Aestiva Hosting Provider Moderator // PROBLEMS AND SOLUTIONS Problem: When running asetup[version]_h2o.cgi the browser asks where I want to save a downloaded file. Solution: If you get a message from your browser asking where you want to save a downloaded file, or the browser displays a page of strange characters, use the admin panel of your Cobalt server to activate cgi programs and try again. If it still fails, get help from your system administrator. // Posted By Aestiva Hosting Provider Moderator // PROBLEMS AND SOLUTIONS Problem: When I run asetup[version]_h2o.cgi I get a "Server Error" Solution: If you get an error message "Server Error" this may mean your copy of "asetup[version]_h2o.cgi" is not the correct version for your computer, or that the install program was copied by ftp without using BINARY mode, or that you have not enabled cgi programs on your server. H2O is a compiled program. The install program for one kind of computer will not run on a different kind of computer. Make sure you have the H2O install program for Cobalt web servers, and always use BINARY mode in ftp to copy the file. If you're sure you have the correct install program, use the admin panel of your Cobalt server to activate cgi programs and try again. If it still fails, get help from your system administrator. // Posted By Aestiva Hosting Provider Moderator // PROBLEMS AND SOLUTIONS Problem: The "Complete Install" fails saying that it cannot read or write to a file. Solution:If your account is nearly out of disk space, your H2O install may fail to complete. About 15 MBytes of free space are required. If you are near the limit, you may need to increase your free disk space. If you got an error message from the install program that names a specific file that could not be written, please use the "ls -l" command to see who owns the file, and make sure that your account has write access. If the file does not exist, check the owner and permissions of the directory where H2O is trying to write the file. If you get write errors that make no sense, make sure you used BINARY mode in ftp when you copied the install program to the server. Sometimes a corrupted install program causes strange filenames and file install errors. // Posted By Aestiva Hosting Provider Moderator // |