Help System

WOS and different sticks .................................................................................................... 1

Installing ............................................................................................................................. 1
Creating Autostart............................................................................................................... 3
Configuring ......................................................................................................................... 3
Upgrading ........................................................................................................................... 4
Downloading................................................................................................................... 4
Installing ......................................................................................................................... 4
Troubleshooting .................................................................................................................. 5
WOS................................................................................................................................ 5
Apache ............................................................................................................................ 8
PHP ................................................................................................................................. 9
MySQL ......................................................................................................................... 11

The WOS portable package is available for free download using our online WOS Mixer.

WOS and different sticks

To 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.

Installing
Having 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 package
contains many modules.

When installation is complete, the WOS Portable Status dialog is displayed:

CH-Software 1 2007-09-21
 Help System

Using this dialog, you can start and stop the servers, make an automated backup of your
WOS 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 of
your personal installation. Click this link to access your WOS installation page:

CH-Software 2 2007-09-21
 Help System
You may now choose an application to access.

If you have any problems during installation, take a look at the Troubleshooting topics.

Creating Autostart
To 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 automatically
add .TXT to the end of any filename.

Configuring
You can configure the main settings for your WOS package using the Options option
from the menu in the WOS Portable Status dialog to open the Options window:

CH-Software 3 2007-09-21
 Help System
Upgrading
Downloading
To 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 directories
contain user created files (e.g., Typo, Wordpress etc ) please read Installing below.

Installing
WOS can not currently update packages cleanly, so it will completly delete the existing
package and install the new package. This is OK if you are updating Apache or PHP
since there are no user created files in these directories. However, if you are updating
MySQL or any other application software whose directories contain user created files
(e.g., Typo, Wordpress etc ), this can cause problems

We therefore recommend that you download a new WOS package and copy your existing
files and data from the old package to the new.

Should you decide to upgrade individual applications, then we recommend that you
follow 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 if
you upgrade from MySQL 4 to MySQL 5! If you are not sure about this use
phpMyAdmin 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.

Troubleshooting
This section contains descriptions of problems that have been encountered during
installation or configuration of the WOS packages, together with suggested solutions.

WOS
Problem
old.dir is not writable

Cause
On some Windows systems WOS reports that the old.dir file is not writable. The cause of
this seems to be dependent on the Windows version and we have not yet been able to
reproduce it.

Solutions
Four possible solutions have been suggested:

Solution 1

1. In Windows Explorer go to x:\path\to\wos\wos. 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 3

I noticed this problem on my Windows 2000 machine. I found that it had set the owner of
the file to the group Administrators, and not to the user I was running as. I solved this by
setting up a fresh WOS II directory and changing the owner of old.dir from Administrators
to the user I was running as.

Solution 4

On my Windows XP computer I was trying WOS and received the old.dir unwrittable
error. So I opened up old.dir in notepad and saw that the directory path was C:/.I replaced
this with the exact location of the old.dir. For example, I am running WOS out of a folder
on my desktop called wos so I replaced C:/ with C:\Documents and Settings\Some
User\Desktop\wos\wos.

Problem
WOS crashes on startup with a runtime-error 50003 (applies to version 1.x.x)

Cause
This 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.

Solutions
To 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 from
Microsoft’s Website and install them.

CH-Software 6 2007-09-21
 Help System
Problem
WOS crashs with a blue screen under Windows Vista

Cause
After upgrading my system to a Windows Vista OS, WOS kept crashing when the servers
started up.

Solution
I tested the same files in my XP boot on the same PC and it worked perfectly, so I tested
the 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 the
WOS root.

Problem
I can not access webpages from other computers

Cause
This is not a bug it is a feature! Since we designed WOS as local testing platform we
wanted to make sure that your files did not get accessed from outside.

Solutions
If 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 security
issue. 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.

Apache
Problem
Apache is not starting and the message Apache is not running... is displayed in the WOS
Portable II Status dialog.

Cause
This can be caused by port or socket configuration problems.

Solutions
Solution 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 port
number for the application as described in the application documentation or change the
Apache 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:\path\to\wos\apache2\bin)
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 terminate
this 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:\path\to\wos\apache2\conf, 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 3
To change the Apache port

1. In the Windows Explorer go to x:\path\to\wos\apache2\conf, 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.

PHP
Problem
Import Blogspot post needs curl extension.

CH-Software 9 2007-09-21
 Help System
Cause
Importing Blogger posts in Wordpress on USB requires the curl extension.

Solution
Activate 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 DLLs
into the directory C:\WINDOWS\System32\ ("WINDOWS" or "WINNT", depends on your
installation):
/php5/libeay32.dll
/php5/ssleay32.dll
/php5/ext/php_curl.dll
If you're using PHP Version 4.x, use the files from the PHP4 directory.

Problem
Typo3-Extension Manager behind a firewall

Cause
Typo3 supports the download of innumerable plugins for different jobs (guestbooks,
forum, chat-systems, newsletters,...) with the build-in extension manager. Plugins (or
extensions) are published in the TER (Typo3 (online) Extension Repository), which is
accessable via http.

In WOS v1.1.1, Typo3 tries to establish a direct connection to the TER with the request
http://ter.typo3.com/?id=t3_extrep to retrieve the list of publicly available plugins. If
you're using WOS v1.1.1 on a workstation behind a firewall, Typo3 (PHP) needs to use a
proxy-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 System
MySQL
Problem
When 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!

Cause
Your privilege table structure is from a different version of MySQL.

Solution

1. Stop the whole server.

2. Goto x:\your\wos\dir\mysql\data 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?

Problem
MySQL not running

Cause
The WOS status popup lists both Apache and MySQL as running but the localhost query
via 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.

Problem
MySQL does not shutdown after changing the root password

Cause
You have tried to reset the root password to use for a WOS application.

CH-Software 11 2007-09-21
 Help System
Solution
If you need to use a password for mysql, please create a new user using the phpmyadmin
and use that password.

CH-Software 12 2007-09-21