• Share
  • Email
  • Embed
  • Like
  • Save
  • Private Content
Wos portable help
 

Wos portable help

on

  • 3,305 views

Installation and User Guide for Website on a Stick application

Installation and User Guide for Website on a Stick application

Statistics

Views

Total Views
3,305
Views on SlideShare
3,305
Embed Views
0

Actions

Likes
0
Downloads
8
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

    Wos portable help Wos portable help Document Transcript

    • Help SystemWOS and different sticks .................................................................................................... 1Installing ............................................................................................................................. 1Creating Autostart............................................................................................................... 3Configuring ......................................................................................................................... 3Upgrading ........................................................................................................................... 4 Downloading................................................................................................................... 4 Installing ......................................................................................................................... 4Troubleshooting .................................................................................................................. 5 WOS................................................................................................................................ 5 Apache ............................................................................................................................ 8 PHP ................................................................................................................................. 9 MySQL ......................................................................................................................... 11The WOS portable package is available for free download using our online WOS Mixer.WOS and different sticksTo date, there are known issues with WOS not working properly on the following sticks: • Sony sticks • IPods • Some U3 sticks Note: If WOS does not work on your U3 stick, try reformatting it.InstallingHaving downloaded your personalized WOS installation zip: 1. Double-click the zip file to open it. 2. Select all the files in the zip and extract them to your USB drive. 3. Double-click the wos.exe now visible on your USB drive. 4. Click OK to accept the next stage of the install each time the installer prompts you.Note: The installation process can take quite some time, especially if your packagecontains many modules.When installation is complete, the WOS Portable Status dialog is displayed:CH-Software 1 2007-09-21
    • Help SystemUsing this dialog, you can start and stop the servers, make an automated backup of yourWOS system and even configure some of the WOS server settings.The default WOS page then opens in your browser, with a back link to the Home page ofyour personal installation. Click this link to access your WOS installation page:CH-Software 2 2007-09-21
    • Help SystemYou may now choose an application to access.If you have any problems during installation, take a look at the Troubleshooting topics.Creating AutostartTo create an Autostart file for your USB stick: 1. Open Notepad, or other text editor. 2. Type in the following content: [autorun] open=wos.exe icon=wos.exe label=Wiki On A Stick 3. Save the file as AUTORUN.INF.Note: Ensure the file extension is really .INF as Windows Notepad will automaticallyadd .TXT to the end of any filename.ConfiguringYou can configure the main settings for your WOS package using the Options optionfrom the menu in the WOS Portable Status dialog to open the Options window:CH-Software 3 2007-09-21
    • Help SystemUpgradingDownloadingTo download the application(s) you require: • Go to the WOS Mixer page • Select I have already a WOS Portable II Package and want to update it and click Go. • Download the package(s) you want and save the file(s) in the folder where WOS resides. • If the package you are upgrading contains no user created files in these directories, simply start WOS and WOS will recognize the new package and install it.Caution: If you are updating MySQL or any other application software whose directoriescontain user created files (e.g., Typo, Wordpress etc ) please read Installing below.InstallingWOS can not currently update packages cleanly, so it will completly delete the existingpackage and install the new package. This is OK if you are updating Apache or PHPsince there are no user created files in these directories. However, if you are updatingMySQL or any other application software whose directories contain user created files(e.g., Typo, Wordpress etc ), this can cause problemsWe therefore recommend that you download a new WOS package and copy your existingfiles and data from the old package to the new.Should you decide to upgrade individual applications, then we recommend that youfollow the steps described in this MySQL example to avoid losing lose all your data.Caution This only works if you stay with the same MySQL version! It will not work ifyou upgrade from MySQL 4 to MySQL 5! If you are not sure about this usephpMyAdmin or the mysqldump tool to dump all the data and import it later. 1. Stop WOS. 2. Create a backup of the whole WOS system using the Backup option from the menu in the WOS Portable Status dialog or just make copy of your WOS folder. 3. Open the mysql folder in your WOS directory in windows explorer. 4. Copy the data folder to a safe place. 5. Download the new MySQL package and copy it to the WOS folder where the wos.exe resides. 6. Exit and re-start WOS 7. WOS now installs the new package. Click OK to confirm the installation.CH-Software 4 2007-09-21
    • Help System 8. When the package installation is complete and WOS fully started, ensure the server is stopped. 9. Open the mysql folder again. 10. Delete the data folder. 11. Copy the data folder you backed up earlier into the mysql folder.If you have any problems check the Troubleshooting topics.TroubleshootingThis section contains descriptions of problems that have been encountered duringinstallation or configuration of the WOS packages, together with suggested solutions.WOSProblemold.dir is not writableCauseOn some Windows systems WOS reports that the old.dir file is not writable. The cause ofthis seems to be dependent on the Windows version and we have not yet been able toreproduce it.SolutionsFour possible solutions have been suggested:Solution 1 1. In Windows Explorer go to x:pathtowoswos. Select the old.dir with a right click and and choose properties. 2. Check the Archive box and select OK 3. Start WOS.Note: To fix this permanently you must edit the path in the old.dir (eg c: instead of c:)Solution 2 1. Log in as an administrator. 2. Open old.dir with a text editor and copy complete contents. 3. Open a new file in your text editor and paste copied contents into it. 4. Close the original old.dir and delete it.CH-Software 5 2007-09-21
    • Help System 5. Save your open file as old.dir.Solution 3I noticed this problem on my Windows 2000 machine. I found that it had set the owner ofthe file to the group Administrators, and not to the user I was running as. I solved this bysetting up a fresh WOS II directory and changing the owner of old.dir from Administratorsto the user I was running as.Solution 4On my Windows XP computer I was trying WOS and received the old.dir unwrittableerror. So I opened up old.dir in notepad and saw that the directory path was C:/.I replacedthis with the exact location of the old.dir. For example, I am running WOS out of a folderon my desktop called wos so I replaced C:/ with C:Documents and SettingsSomeUserDesktopwoswos.ProblemWOS crashes on startup with a runtime-error 50003 (applies to version 1.x.x)CauseThis error can have two reasons and is caused by a Microsoft bug: • Your PC is running with a color depth of less than 32 bits. • The latest version of VB6 run-time is not installed.SolutionsTo solve the color depth problem: 1. Right click on a free place on the desktop and select Properties in the context menu. 2. In the resulting dialog click the Settings tab and select a color depth 32 bit from the Color quality drop-down box. 3. Click confirm.To solve the VB6 run-time problem simply download the latest VB 6 Runtime fromMicrosoft’s Website and install them.CH-Software 6 2007-09-21
    • Help SystemProblemWOS crashs with a blue screen under Windows VistaCauseAfter upgrading my system to a Windows Vista OS, WOS kept crashing when the serversstarted up.SolutionI tested the same files in my XP boot on the same PC and it worked perfectly, so I testedthe obvious solution: 1. Start Windows Vista and go to the WOS directory. 2. Right click on wos.exe and click on Properties. 3. Select the Compatibility tab. 4. Activate the Run this program in compatibility mode for checkbox and select Windows XP (Service Pack 2). 5. Click OK.If it still crashes, do the same with the file httpd.exe in the apache2/bin directory of theWOS root.ProblemI can not access webpages from other computersCauseThis is not a bug it is a feature! Since we designed WOS as local testing platform wewanted to make sure that your files did not get accessed from outside.SolutionsIf you want to access your files from another computer: 1. Choose Options from the menu of the WOS Portable II Status dailog. 2. Disable Only allow access from localhost. 3. Add the ip addresses you want to allow or deny access to in the appropriate list. 4. Select the Permision order (deny or allow first). 5. Click OK.To open WOS completly to the world:Caution This opens your pages to everyone in the World! This can be a real securityissue. Be sure this is what you really want.CH-Software 7 2007-09-21
    • Help System 1. Choose Options from the menu of the WOS Portable II Status dailog. 2. Disable Only allow access from localhost. 3. Enable Do not change the file htaccess. 4. Click OK. 5. Delete the .htaccess file from your www folder.Note: If you are using a router, you must configure it to allows port 80 traffic through.ApacheProblemApache is not starting and the message Apache is not running... is displayed in the WOSPortable II Status dialog.CauseThis can be caused by port or socket configuration problems.SolutionsSolution 1 1. Check if you are running another application that uses port 80 (Webserver default port), e.g. Skype. 2. If yes, close the application and start WOS again.Note: If you want to use the offending appplication while using Apache, change the portnumber for the application as described in the application documentation or change theApache port.If this does not help try the following:Solution 2 1. Click on Start. 2. Select Run. 3. Input cmd. 4. Click OK. 5. Input the path to the Apache bin folder (e.g., cd x:pathtowosapache2bin) followed by the Enter key. 6. Input apache -t followed by the Enter key (from WOS II the apache executable is called httpd so try httpd -t). 7. If the output is Syntax OK, go to the next step. Otherwise get in contact with us.CH-Software 8 2007-09-21
    • Help System 8. Input apache or, if you use Apache 2, httpd.If the output is: make_sock: could not bind to address 0.0.0.0.:80 No listening sockets available, shutting down Unable to open logs.Then you are still running another application that is using port 80. Find and terminatethis application or follow the instructions to change the Apache port.If the output is: [error] (OS 10038)An operation was attempted on something that is not a socket. : Child 4408: Encountered too many errors accepting client connections. Possible causes: dynamic address renewal, or incompatible VPN or firewall software. Try using the Win32DisableAcceptEx directive. 1. In the Windows Explorer go to x:pathtowosapache2conf, select httpd.conf and open it in a text editor (eg. Notepad). 2. Add the following line (does not matter where): Win32DisableAcceptEx 3. Start WOS.Solution 3To change the Apache port 1. In the Windows Explorer go to x:pathtowosapache2conf, select httpd.conf and open it in a text editor (eg. Notepad).) 2. Look for the line Listen 80 and replace it with Listen <port> (eg Listen 8080). 3. Look for the line ServerName localhost:80 and replace it with ServerName localhost:<port> (eg. ServerName localhost:8080). You must use the same port number in both lines. 4. Start WOS. 5. Open localhost:<port> or 127.0.0.1:<port> (eg., 127.0.0.1:8080) in your browser.PHPProblemImport Blogspot post needs curl extension.CH-Software 9 2007-09-21
    • Help SystemCauseImporting Blogger posts in Wordpress on USB requires the curl extension.SolutionActivate curl by: 1. Open the php.ini file from PHP4 or PHP5 installation and look for the extensions. 2. Uncomment the lines ;extension=php_curl.dll to extension=php_curl.dll (remove the ";") and save the file. 3. Restart WOS.If you get an error message about loading php_curl.dll, try copying the following DLLsinto the directory C:WINDOWSSystem32 ("WINDOWS" or "WINNT", depends on yourinstallation): /php5/libeay32.dll /php5/ssleay32.dll /php5/ext/php_curl.dllIf youre using PHP Version 4.x, use the files from the PHP4 directory.ProblemTypo3-Extension Manager behind a firewallCauseTypo3 supports the download of innumerable plugins for different jobs (guestbooks,forum, chat-systems, newsletters,...) with the build-in extension manager. Plugins (orextensions) are published in the TER (Typo3 (online) Extension Repository), which isaccessable via http.In WOS v1.1.1, Typo3 tries to establish a direct connection to the TER with the requesthttp://ter.typo3.com/?id=t3_extrep to retrieve the list of publicly available plugins. Ifyoure using WOS v1.1.1 on a workstation behind a firewall, Typo3 (PHP) needs to use aproxy-server.To do this: 1. Activate curl and set up the name/port of the proxy server in the Typo3 Install Tool ("[SYS][curlUse]" and "[SYS][curlProxyServer]", see Typo3 documentation). 2. Edit the php.ini file (see above solution).CH-Software 10 2007-09-21
    • Help SystemMySQLProblemWhen creating a new user in PHPMyAdmin the following message appears:Warning: Your privilege table structure seems to be older than this MySQL version! Please run the script mysql_fix_privilege_tables that should be included in your MySQL server distribution to solve this problem!CauseYour privilege table structure is from a different version of MySQL.Solution 1. Stop the whole server. 2. Goto x:yourwosdirmysqldata and delete the complete mysql folderin this directory. 3. Download the new mysql data table http://www.wos.chsoftware.net/mysql_fix.zip and unzip it in this folder. 4. Start WOS.Note: Why not update your whole WOS package to a current version?ProblemMySQL not runningCauseThe WOS status popup lists both Apache and MySQL as running but the localhost queryvia the browser states that MySQL is not running.Solution 1. Check the file mysql/data/xxx.err. 2. Try to start mysql through the command line.If the problem persists contact us via the contact form.ProblemMySQL does not shutdown after changing the root passwordCauseYou have tried to reset the root password to use for a WOS application.CH-Software 11 2007-09-21
    • Help SystemSolutionIf you need to use a password for mysql, please create a new user using the phpmyadminand use that password.CH-Software 12 2007-09-21