## WebLaminarTools How-To

WebLaminarTools can be run from a USB device or from a server.  It's the first decision you need to make depending on how much you need to guarantee access to the data within.   Another option is to place it on a server and back it up to a USB device.  We have tested WebLaminarTools on many different USB devices without problems.  On this page are a listing of known problems and their solutions as well as procedures to help you get the most our of WLT.

Support

This email address is being protected from spambots. You need JavaScript enabled to view it.

Getting Started

2. Extract onto the USB device at the root or to the base of a Drive on your system.
4. Start WebLaminarTools. After accepting the license you can begin using WebLaminarTools. Directions for usage are on the wiki that is part of WebLaminarTools.
5. Enjoy!

We have worked hard to make this tool as easy to use as possible. Once you have successfully logged in take some time to review the wiki notes if you are not familiar with wiki markup. There are many links to help you learn.

If your WebLaminarTools will not start often its the interaction of the operating system and it's drive letter assignments. This can happen in a corporate setting where drive letters are mapped to network drives. If you are not on the corporate network and you use your WebLaminarTools the operating system may assign a drive letter to the USB drive that is taken by a network drive when you log into work.

1. start c:\windows\system32\compmgmt.msc
2. Re-assign the drive letter for WebLaminarTools to some letter that is not mapped when logged into work.
3. reboot and login as usual.
4. WebLaminarTools will appear in Explorer.

Windows vista - If start here link will not resolve in browser.

The localhost entry in c:\windows\system32\etc\hosts needs the loopback address. Vista has a quirk that requires you run notepad as administrator even if you are logged in on an administrative account. Follow the instructions

1. Click Start button
2. click All Programs, click Accessories, right-click Notepad, and then click Run as administrator. If you are prompted for an administrator password or for a confirmation, type the password, or click Allow or Yes.
3. Edit hosts file
     127.0.0.1  localhost


The start here link will work now because it can resolve localhost to your computer.

WebLaminarTools launches applications and you can add more on your own. For example utilities from Microsoft can not be included in the distribution but can be downloaded and integrated into the wiki. Here is the process for getting this done:

2. create a launch script in \www\launch\your_launch_script.php
4. This is an example of a launch script.

{codecitation style="brush: xml;"} <?php
$cmd = "\\apps\\SysInternals\\procexp.exe"; exec($cmd);
?> {/codecitation}

Creating a stock watch page

If you like to watch your investments here is an easy way to imbed a call to Yahoo finance.

2. Example: http://finance.yahoo.com/q?d=t&s=F,RHT
3. So it would look like **http://finance.yahoo.com/q?d=t&s=F,RHT|Stock Portfolio in the navigation editor
2. Go to http://netweather.accuweather.com/adcbin/netweather_v2/signup-page2.asp?partner=netweather  to generate html code
3. Choose variables for your locale.
4. Copy code from generator into the new page you just created.  The code should be surrounded by <html>  insert code here </html> tags so it will render properly.

Migrate Mediawiki

1. Install http://www.mediawiki.org/wiki/Extension:MultiUpload for multiple images
2. To export pages \php5\php \www\mediawiki\maintenance\dumpBackup.php --current >SW.xml
3. Use Special:Import Page and use SW.xml
1. maxuploadsize= in php.ini to set max size if SW.xml is bigger thatn 1.4MB
4. Gather all image files from the mediawiki/images directory into one directory
5. Use Special:Import Multiple Files to bring images into the Wiki.

Recover from search index corruption

If you get the following error after editing a page:

"SearchMySQL::update". MySQL returned error "145: Table '.\mediawiki\searchindex' is marked as crashed and should be repaired "

WLT Procedure : replace drive letter with whatever your installation is on

1. stop DB    <-- verify stopped w/MOWES
2. cd I:\mysql\data\mediawiki  <-- mysql data directory
3. I:\mysql\bin\myisamchk -r searchindex <---- run this command to fix the table
4. StartDB    <-- verify started w/MOWES
5. cd www/mediawiki/maintenace
6. \php5\php rebuildall.php              <--run this command to  rebuild the search indexes

Change WebLaminarTools wiki skin

WebLaminarTools Mediawiki uses the vector skin to enable the dropdown side menu among other things.   Versions 2.0 and greater of WebLaminarTools  have the vector skin. If you would like to customize the look and feel of the skin you need to make changes to the CSS.

1. Edit the css file at Drive:\www\mediawiki\skins\vector\main-ltr.css
2. Place images to be used in Drive:\www\mediawiki\skins\vector\images
3. For our example here will use the two images
2. border.jpg
4. Search for the this stanza to replace the border image

body {
background-color: #f3f3f3;
background-image: url('/images/page-base.png');

1. Replace the image file name with yours

body {
background-color: #f3f3f3;
background-image: url('/images/border.jpg');

1. Search for the stanza to replace the header image

#mw-page-base {
height: 5em;
background-color: white;

1. Replace the image file name with yours

#mw-page-base {
height: 5em;
background-color: white;

1. You may need to restart MOWES to restart the wiki for your changes to be picked up.   Flush the cache in your browser with Cntrl-F5 and check your work.  Here is an example of what can be done.

Numbered lists

If your like me you may have tried to document a process and have the need for verbage in between numbers of a list. This can be frustrating because it breaks the numbering but there is syntax that will allow for this. The key is the use of #: in a numbered list creating neat and understandable steps for a process.. This tells the mediawiki interpreter to allow for some text and not have the numbering discontinued in the list.

Example:

 # Patch server environment
#: The patching of the servers is required due to a security update released by the vendor last week. It is our policy to maintain our servers at the highest level of security patching to reduce our vulnerability and protect our business. ##Test patch in QA ##: All patches should be tested in QA and the normal regression suite applied to it for analysis by Operations. After successful completion of the test suite a release date will be chosen ##Create change control ##:Change controls must be placed into the queue for approval by Wednesday for approval to be considered by weeks end. The requestor must be available to answer all questions before the request is approved. ##Apply patch ##Notify Operations team of success or rollback.

This will appear as:

1. Patch server environment
The patching of the servers is required due to a security update released by the vendor last week. It is our policy to maintain our servers at the highest level of security patching to reduce our vulnerability and protect our business.
1. Test patch in QA
All patches should be tested in QA and the normal regression suite applied to it for analysis by Operations. After successful completion of the test suite a release date will be chosen
2. Create change control
Change controls must be placed into the queue for approval by Wednesday for approval to be considered by weeks end. The requestor must be available to answer all questions before the request is approved.
3. Apply patch
4. Notify Operations team of success or rollback.

Wiki Contributions configuration

Wiki contributions is an extension added new for version 2.2 of WebLaminarTools.  It allows you to view the amount of contributions made by the wiki collaborators.  This helps administrators understand if the site is stagnate or is being used on a regular basis.   For team collaboration or a study group it leverages peer pressure to get great performance and commensurate contribution from your team.

The statistics are available on Special Pages inside your wiki but you can also place them on a wiki page to keep everyone on the team informed.  WeblaminarTools adds the statistics on a page with the following wiki text.  We used a table to format things more compact but you could place them in any wiki element.  The Special:ContributionScores call is followed by numbers that coincide with the amount of users / days elapsed

Example:

# 10 top contributors from the last 5 days
{{Special:ContributionScores/10/5}}


Wiki text:

== Wiki contribution statistics  ==

|+ Wiki Contributions
|-
! bgcolor="#ff9966" scope="col" | '''Top 10'''
! bgcolor="#ff9966" scope="col" | '''Top 15'''
|-
|{{Special:ContributionScores/10/5}}
|{{Special:ContributionScores/15/3/}}
|-
| {{Special:ContributionScores/10/all}}
| {{Special:ContributionScores/15/all}}
|}

If you feel so inclined to add a Internet gadget from Google a complete list can be found here.  They work by using javascript to call some code on a remote server.   With WebLaminarTools we have raw html enabled so wrap the code Google gives you with <html> </html> tags.   Please be aware that if access to the internet is down the gadget will not appear on the page.

Example:

<html>

</html>

Wiki Mgmt

When you introduce your new wiki to your friends or your organization it's time to think about managing the content and who can edit your pages.  WIth an entry in the LocalSettings.php file for Mediawiki you can control how things are viewed or edited.

How do I stop anonymous users from editing any page?

* Set $wgGroupPermissions['*']['edit'] = false; at bottom of LocalSettings.php. See Manual:Preventing access#Restrict anonymous editing for more information.  How do I stop anonymous users from reading any page? * Set$wgGroupPermissions['*']['read'] = false; at bottom of LocalSettings.php.

See also Manual:$wgWhitelistRead. See Manual:Preventing access#Restrict viewing of all pages for more information.  How do I restrict account creation? * Set$wgGroupPermissions['*']['createaccount'] = false; at bottom of LocalSettings.php.

If you encounter problems with your wiki as you work with it here are some things you can do to narrow down the problem.

* Sometimes memory limits needs to be raised to fix blank pages. Look for this line in LocalSettings.php.

ini_set( 'memory_limit', '40M' );

* If a page errors out and you cannot see what is wrong add this to the beginning of the LocalSettings.php file just below the <?php tag.

<?php
error_reporting( E_ALL );
ini_set( 'display_errors', 1 );

If additional debugging information is needed add these lines to the bottom of the LocalSettings.php file.  It will generate a log file called MWdebug_log.txt in verbose form including sql calls.

$wgShowExceptionDetails = true; <-- EOF$wgShowSQLErrors = true;
$wgDebugDumpSql = true;$wgDebugLogFile = 'E:/MWdebug_log.txt';

Server side installation

With some edits you can take your WebLaminarTools installation and place it on a server.  The basic steps are:

1. Edit httpd.conf
1. edit httpd.conf   -  in apache2/conf/httpd.conf search for ServerRoot and add the path to your apache2 directory.  Ex. C:\apache2
2. edit httpd.conf - search for Listen and add the IP:port of your web installation.   Ex. 10.2.2.4:8080
3. edit httpd.conf - search for ServerName and add the same entry for IP:port of your server
2. edit .htaccess in the root of the website and replace all with "ALLOW FOR ALL".  Ex. C:\www\.htaccess.
1. This circumvents the MoWes secuirty edits.  Please consult the Apache docs for less than wide open access.
3. Install mysqld-nt as a windows service - C:\yourpath\mysql\bin\mysqld-nt --install
4. install apache as a windows service - C:\yourpath\apache2\bin\httpd.exe -k install -n "httpd-MoWeS" -f "C:\yourpath\apache2\conf\httpd.conf"
1. No need for starting MoWes as you have started the windows services, mysqld first.
5. test URL - http://IP:port/mediawiki/index.php/Main_Page

MathJax pointers

Equation editing can be handled in one of two formats with Mathjax.   Inline or centered on page.  By default WLT is configured to handle the basic excape sequences:

• inline    -    $$mathematical expression$$
• centered  -  $mathematical expression$

Here are some resources to help with the editing of the mathematical expression.   With MathJax you can use TEX or mathML.