NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Scrollbar
iconsfalse

...

Page info
title
title

Section
Column
width75%
Panel
titleContents of this Page
Table of Contents
minLevel2
Column
Align
alignright
Include Page
Menu LexWiki to Include
Menu LexWiki to Include
Multiexcerpt include
LexWiki 1.0 Installation Guide
LexWiki 1.0 Installation Guide
nopaneltrue
MultiExcerptNameLexWikiInstallationa
PageWithExcerptLexWiki 1.0 Installation Guide
Wiki Markup
{:title}
{section}
{column:width=75%}
{panel:title=Contents of this Page}
{toc:minLevel=2}
{panel}
{column}
{column}
{align:right}{include:Menu LexWiki to Include}{align}
{column}
{section}

{multi-excerpt-include:LexWiki 1.0 Installation GuidepageTitle=LexWiki|name=installationinitialsectionsprerequisites|nopanel=true}

h2. Installation

# Back up any existing MediaWiki installation. This installation process will not upgrade an existing MediaWiki folder.
# Delete any existing MediaWiki install folder after backup.
# Unzip 
Multiexcerpt include
LexWiki 1.0 Installation Guide
LexWiki 1.0 Installation Guide
nopaneltrue
MultiExcerptNameLexWikiInstallationb
PageWithExcerptLexWiki 1.0 Installation Guide

Installation

  1. Back up any existing MediaWiki installation. This installation process will not upgrade an existing MediaWiki folder.
  2. Delete any existing MediaWiki install folder after backup.
  3. Unzip lexwiki-installer.zip

...

  1. to

...

  1. a

...

  1. temporary

...

  1. directory.

...

  1. In

...

  1. the

...

  1. lexwiki-installer

...

  1. directory,

...

  1. edit

...

  1. the

...

  1. lexwiki.properties

...

  1. file

...

  1. to

...

  1. reflect

...

  1. values

...

  1. of

...

  1. your

...

  1. host,

...

  1. port

...

  1. etc.

...

  1. Refer

...

  1. to

...

  1. the

...

  1. comments

...

  1. in

...

  1. that

...

  1. file

...

  1. for

...

  1. detailed

...

  1. directions.

...

  1. If

...

  1. the

...

  1. user

...

  1. has

...

  1. database

...

  1. administrator

...

  1. privileges,

...

  1. set

...

  1. the

...

  1. wikidb.adminuser

...

  1. and

...

  1. wikidb.adminpassword

...

  1. in

...

  1. the

...

  1. lexwiki.properties

...

  1. file.

...

  1. Also

...

  1. be

...

  1. sure

...

  1. to

...

  1. set

...

  1. the

...

  1. has.root

...

  1. property

...

  1. to

...

  1. true

...

  1. .

...

  1. If

...

  1. the

...

  1. user

...

  1. does

...

  1. not

...

  1. have

...

  1. database

...

  1. administrator

...

  1. privileges,

...

  1. create

...

  1. a

...

  1. new

...

  1. database

...

  1. for

...

  1. your

...

  1. wiki

...

  1. and

...

  1. configure

...

  1. the

...

  1. user

...

  1. privileges

...

  1. as

...

  1. described

...

  1. above.

...

  1. Enter

...

  1. all

...

  1. details

...

  1. in

...

  1. the

...

  1. lexwiki.properties

...

  1. file

...

  1. and

...

  1. make

...

  1. sure

...

  1. to

...

  1. set

...

  1. the

...

  1. has.root

...

  1. property

...

  1. to

...

  1. 'false'

...

  1. in

...

  1. lexwiki.properties.

...

  1. On

...

  1. the

...

  1. command

...

  1. prompt,

...

  1. type

...

  1. ant

...

  1. install

...

  1. and

...

  1. hit

...

  1. Enter.

...

  1. Note:

...

  1. You

...

  1. need

...

  1. to

...

  1. run

...

  1. this

...

  1. with

...

  1. an

...

  1. account

...

  1. that

...

  1. has

...

  1. appropriate

...

  1. privileges

...

  1. on

...

  1. the

...

  1. Web

...

  1. server's

...

  1. document

...

  1. root

...

  1. directory.

...

  1. So,

...

  1. if

...

  1. you

...

  1. have

...

  1. only

...

  1. sudo

...

  1. privileges,

...

  1. you'd

...

  1. need

...

  1. to

...

  1. run

...

  1. sudo

...

  1. ant

...

  1. install

...

  1. .

...

  1. The

...

  1. installer

...

  1. will

...

  1. show

...

  1. a

...

  1. BUILD

...

  1. SUCCESSFUL

...

  1. message

...

  1. as

...

  1. displayed

...

  1. below.
{
Code Block
}
install:
[echo]
[echo] Mediawiki was successfully installed\!
[echo] Please access mediawiki at http:/localhost:80/w/mediawiki/index.php/Main_page
[echo] You can log in to mediawiki with username/password:WikiSysop/wikisysop 123.
[echo] The installation log is available at:/Users/joshusa/packages/lexwiki/temp/lexwiki-installer/lexwiki-installer-log.txt
[echo]
BUILD SUCCESSFUL
Total time: 2 minutes 32 seconds
james-2: lexwiki-installer joshua$
{code}

h2. 

Post-Installation

...

The

...

URL

...

where

...

MediaWiki

...

is

...

available

...

will

...

be

...

displayed

...

on

...

the

...

command

...

prompt.

...

Navigate

...

to

...

that

...

URL

...

in

...

your

...

browser

...

and

...

you

...

should

...

see

...

the

...

following

...

page.

screenshot of main page of successful installationImage Added

You can log in to your LexWiki as an administrator using the username and password displayed on the command prompt. Congratulations! The LexWiki installation is complete and ready to be used!

Installing only certain extensions

The installer is capable of installing specified extensions. Open the file module-metadata.txt from the directory in which you unzipped lexwiki-installer.zip.

...

By

...

default

...

all

...

the

...

modules

...

(and

...

their

...

versions)

...

are

...

mentioned

...

here.

...

To

...

add

...

or

...

remove

...

a

...

module,

...

simply

...

edit

...

the

...

relevant

...

line

...

in

...

the

...

file.

...

Make

...

sure

...

to

...

follow

...

the

...

syntax

...

exactly

...

as

...

shown

...

in

...

module-metadata.txt.

...

The

...

syntax

...

in

...

the

...

file

...

is

...

sensitive

...

to

...

the

...

following:

...

  • Every

...

  • module

...

  • descriptor

...

  • starts

...

  • on

...

  • a

...

  • new

...

  • line.

...

  • There

...

  • are

...

  • no

...

  • spaces

...

  • in

...

  • the

...

  • module

...

  • descriptor.

...

  • Every

...

  • module

...

  • descriptor

...

  • ends

...

  • with

...

  • a

...

  • semi-colon.

...

  • Any

...

  • line

...

  • that

...

  • starts

...

  • with

...

  • a

...

  • '#'

...

  • will

...

  • be

...

  • treated

...

  • as

...

  • a

...

  • comment

...

  • and

...

  • ignored.

Troubleshooting

The following is a list of common issues and their solutions.

Media wiki already exists

If you see the following console output:

Code Block


h2. Troubleshooting

The following is a list of common issues and their solutions.

h3. Media wiki already exists

If you see the following console output:

{code}
BUILD FAILED
 /Users/joshua/packages/lexwiki/temp/lexwiki-installer/build.xml:377: Media wiki already exists.
      Please back up your mediawiki install and delete this folder for installation to proceed.
      The existing mediawiki folder was found at: /Library/WebServer/Documents/w/mediawiki
{code}

you

...

need

...

to

...

delete

...

your

...

existing

...

MediaWiki

...

instance

...

before

...

installing.

...

Web

...

server

...

is

...

not

...

running.

...

If

...

you

...

see

...

this

...

output:

{
Code Block
}
check-apache:
     [echo] Checking for web server at http://localhost:8080

 BUILD FAILED
  /Users/joshua/packages/lexwiki/temp/lexwiki-installer/build.xml:329: Web server is not running.
{code}

check

...

that

...

the

...

Web

...

server

...

is

...

up

...

and

...

that

...

you

...

have

...

specified

...

the

...

correct

...

value

...

for

...

the

...

port

...

property

...

in

...

lexwiki.properties.

...

com.mysql.jdbc.CommunicationsException:

...

Communications

...

link

...

failure

...

If

...

you

...

see

...

the

...

following

...

error

...

message

...

on

...

the

...

console:

Code Block


{code}

[echo] ------------- ----------- ----------
[trycatch] Caught exception: com.mysql.jdbc.CommunicationException: Communications link failure
[trycatch]
[trycatch]Last packet sent to the server was 0 ms ago
[echo] Exception Trace:
[echo] com.mysql.jdbc.CommunicationExceptions: Communication link failure
[echo] 
[echo]Last packet sent to the server was 0 ms ago. 
[echo]
{code}

check

...

that

...

your

...

database

...

is

...

running.

...

Can't

...

connect

...

to

...

local

...

MySQL

...

server

...

through

...

socket...

...

If you see a BUILD FAILED message and the console displays the following:

Code Block

fig/index-forAnt.php(518): eval ()'d code on line 49
[exec] Database type: MySQL
[exec] Loading class: DatabaseMYsql
[exec] Using root -->
[exec] Attempting to connect to database server as wikiuser...failed with error[ 2002] Can't connect to local MySQL server through socket '/var/msql/mysql.com'(2)

BUILD FAILED
/Users/joshua/packages/lexwiki/temp/lexwiki-install/build.xml:402: Lexwiki installation failure.

	 you see a BUILD FAILED message and the console displays the following:

!Cant_connect_to_mysql.jpg|alt="screenshot of Did not find file: /Library/WebServer/Documents/w/mediawiki/config/LocalSettings.php message"!

then

...

specify

...

the

...

IP

...

address

...

of

...

your

...

database

...

server

...

for

...

the

...

value

...

of

...

the

...

datasource.host

...

property

...

in

...

lexwiki.properties.

...

Warning

...

messages

...

during

...

installation

...

and

...

on

...

the

...

main

...

page

...

If

...

you

...

are

...

seeing

...

lots

...

of

...

warning

...

messages

...

on

...

the

...

console

...

during

...

installation

...

and

...

then

...

on

...

the

...

main

...

page

...

after

...

successful

...

installation,

...

this

...

is

...

because

...

you

...

have

...

set

...

the

...

PHP

...

logging

...

level

...

too

...

high.

...

Refer

...

to

...

the

...

PHP

...

documentation

...

to

...

reduce

...

the

...

logging

...

level.

...

Scrollbar

...

icons

...

false

...