LPI Wiki - User contributions [en]

Developer guide

2015-10-28T23:31:59Z

BenDupuis: /* Install Perforce */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Installation Steps==
===Install Docker===

Install docker:
https://docs.docker.com/linux/started/

You may have to do this step.

Add user to docker group:
usermod -a -G docker $USER

===Install Perforce===

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in your home directory for the source code. 
mkdir -p ~/p4/xamnet

Create new file in this folder called ~/p4/xamnet/.p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit ~/.bashrc file to include:
xamdev=$HOME/p4/xamnet/xamnet/dev/dev/pde/mojo
xamman=$HOME/p4/xamnet/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

This one time, source ~/.bashrc (it's automatic on subsequent logins):
. ~/.bashrc

===Create Your Perforce Workspace===
tbd

and:
p4 sync

==Running the Tests==
===Load Docker Image===

Load linux image from $xamdev/docker 
cd $xamdev/docker
docker load -i xamnet:dev-docker-img.tar

Create your own personalized Dockerfile
mkdir -p ~/docker/$USER
cp -r $xamdev/docker/rick/rick/xamdev ~/docker/$USER
cd ~/docker/$USER

# Now edit Dockerfile.dev and change all occurrences of "rick" to your username '''except on the FROM line'''

Build your personalized image 
docker build --rm -t $USER/$USER-xamdev:dev -f Dockerfile.dev .

'''If that complained''' because the value of $USER was less than 4 characters then substitute a longer word for the first $USER, e.g. 
docker build --rm -t mydockerimages/$USER-xamdev:dev -f Dockerfile.dev .

Edit the container start script, ''rundocker.dev'', and set IMAGE to what you used before, e.g.
IMAGE=$USER/$USER-xamdev:dev

Start the container and run from its shell 
./rundocker.dev

===Create xamdev database===
You will need two databases, one for regression tests and one for development.

Create regression test database 
./build-tools/bin/makedatabase.sh

Create development database 
./build-tools/bin/makedatabase.sh xamdev_development

You will be prompted for your mysql root password for each.

===Run xamdev web app===
Through docker terminal

cd $xamdev
morbo script/xamdev_web

Use ip address to connect to server through browser.

If the message "Can't create listen socket: Address already in use at /usr/share/perl5/Mojo/ loLoop.pm line 120" is displayed use command:

morbo -l http://*:3001 script/xamdev_web

===Run Regression Tests===

cd $xamdev
prove -v t

Developer guide

2015-10-28T18:58:01Z

BenDupuis: /* Run xamdev web app */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Installation Steps==
===Install Docker===

Install docker:
https://docs.docker.com/linux/started/

You may have to do this step.

Add user to docker group:
usermod -a -G docker $USER

===Install Perforce===

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in your home directory for the source code. 
mkdir -p ~/p4/xamnet

Create new file in this folder called ~/p4/xamnet/.p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit ~/.bashrc file to include:
xamdev=$HOME/p4/xamnet/dev/dev/pde/mojo
xamman=$HOME/p4/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

This one time, source ~/.bashrc (it's automatic on subsequent logins):
. ~/.bashrc

===Create Your Perforce Workspace===
tbd

and:
p4 sync

==Running the Tests==
===Load Docker Image===

Load linux image from $xamdev/docker 
cd $xamdev/docker
docker load -i xamnet:dev-docker-img.tar

Create your own personalized Dockerfile
mkdir -p ~/docker/$USER
cp -r $xamdev/docker/rick/rick/xamdev ~/docker/$USER
cd ~/docker/$USER

# Now edit Dockerfile.dev and change all occurrences of "rick" to your username '''except on the FROM line'''

Build your personalized image 
docker build --rm -t $USER/$USER-xamdev:dev -f Dockerfile.dev .

'''If that complained''' because the value of $USER was less than 4 characters then substitute a longer word for the first $USER, e.g. 
docker build --rm -t mydockerimages/$USER-xamdev:dev -f Dockerfile.dev .

Edit the container start script, ''rundocker.dev'', and set IMAGE to what you used before, e.g.
IMAGE=$USER/$USER-xamdev:dev

Start the container and run from its shell 
./rundocker.dev

===Create xamdev database===
You will need two databases, one for regression tests and one for development.

Create regression test database 
./build-tools/bin/makedatabase.sh

Create development database 
./build-tools/bin/makedatabase.sh xamdev_development

You will be prompted for your mysql root password for each.

===Run xamdev web app===
Through docker terminal

cd $xamdev
morbo script/xamdev_web

Use ip address to connect to server through browser.

If the message "Can't create listen socket: Address already in use at /usr/share/perl5/Mojo/ loLoop.pm line 120" is displayed use command:

morbo -l http://*:3001 script/xamdev_web

===Run Regression Tests===

cd $xamdev
prove -v t

Developer guide

2015-10-28T18:57:11Z

BenDupuis: /* Run xamdev web app */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Installation Steps==
===Install Docker===

Install docker:
https://docs.docker.com/linux/started/

You may have to do this step.

Add user to docker group:
usermod -a -G docker $USER

===Install Perforce===

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in your home directory for the source code. 
mkdir -p ~/p4/xamnet

Create new file in this folder called ~/p4/xamnet/.p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit ~/.bashrc file to include:
xamdev=$HOME/p4/xamnet/dev/dev/pde/mojo
xamman=$HOME/p4/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

This one time, source ~/.bashrc (it's automatic on subsequent logins):
. ~/.bashrc

===Create Your Perforce Workspace===
tbd

and:
p4 sync

==Running the Tests==
===Load Docker Image===

Load linux image from $xamdev/docker 
cd $xamdev/docker
docker load -i xamnet:dev-docker-img.tar

Create your own personalized Dockerfile
mkdir -p ~/docker/$USER
cp -r $xamdev/docker/rick/rick/xamdev ~/docker/$USER
cd ~/docker/$USER

# Now edit Dockerfile.dev and change all occurrences of "rick" to your username '''except on the FROM line'''

Build your personalized image 
docker build --rm -t $USER/$USER-xamdev:dev -f Dockerfile.dev .

'''If that complained''' because the value of $USER was less than 4 characters then substitute a longer word for the first $USER, e.g. 
docker build --rm -t mydockerimages/$USER-xamdev:dev -f Dockerfile.dev .

Edit the container start script, ''rundocker.dev'', and set IMAGE to what you used before, e.g.
IMAGE=$USER/$USER-xamdev:dev

Start the container and run from its shell 
./rundocker.dev

===Create xamdev database===
You will need two databases, one for regression tests and one for development.

Create regression test database 
./build-tools/bin/makedatabase.sh

Create development database 
./build-tools/bin/makedatabase.sh xamdev_development

You will be prompted for your mysql root password for each.

===Run xamdev web app===
Through docker terminal

cd $xamdev
morbo script/xamdev_web

Use ip address to connect to server through browser.

If the message "Can't create listen socket: Address already in use at /usr/share/perl5/Mojo/ loLoop.pm line 120" is displayed, use command:

morbo -l http://*:3001 script/xamdev_web

===Run Regression Tests===

cd $xamdev
prove -v t

Developer guide

2015-10-22T14:32:31Z

BenDupuis: /* Setup Docker Image */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==
===Install Docker===

Install docker:
https://docs.docker.com/linux/started/

You may have to do this step.

Add user to docker group:
usermod -a -G docker $USER

===Install Perforce===

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit .bashrc file to include:
xamdev=$HOME/p4/xamnet/dev/dev/pde/mojo
xamman=$HOME/p4/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

This one time source .bashrc:
. .bashrc

===Create Your Perforce Workspace===
tbd

and:
p4 sync

===Load Docker Image===
tbd

* Load linux image from $xamdev/docker/rick/rick/xamdev
* Run scripts to install needed packages.

===Run xamdev web app===
through docker terminal

use ip address to connect to server through browser

===Run Regression Tests===

cd $xamdev
prove -v t

Developer guide

2015-10-22T14:11:07Z

BenDupuis: /* Create Your Perforce Workspace */

Developer guide

2015-10-22T14:09:16Z

BenDupuis: /* Create Your Perforce Workspace */

Developer guide

2015-10-22T14:00:39Z

BenDupuis: /* Create Your Perforce Workspace */

Developer guide

2015-10-22T14:00:09Z

BenDupuis: /* Install Perforce */

Developer guide

2015-10-22T13:57:58Z

BenDupuis: /* Install Docker */

Developer guide

2015-10-22T13:18:02Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==
===Install Docker===

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker $USER

===Install Perforce===

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit .bashrc file to include:
xamdev=$HOME/p4/xamnet/dev/dev/pde/mojo
xamman=$HOME/p4/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

This one time source .bashrc:
. .bashrc

Developer guide

2015-10-22T13:16:25Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==
Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit .bashrc file to include:
xamdev=$HOME/p4/xamnet/dev/dev/pde/mojo
xamman=$HOME/p4/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

This one time source .bashrc:
. .bashrc

Developer guide

2015-10-22T13:15:05Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit .bashrc file to include:
xamdev=$HOME/p4/xamnet/dev/dev/pde/mojo
xamman=$HOME/p4/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

This one time source .bashrc:
. .bashrc

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T13:08:04Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=<username>
P4PASSWD=<password>
P4CLIENT=<username>-dev

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T13:05:28Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4USER=youruser
P4PASSWD=yourpassword
P4CLIENT=yourclient

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T13:04:12Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T13:03:32Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new perforce folder in Home directory. 
mkdir -p p4/xamnet

Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T13:02:01Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4 /usr/local/bin
sudo chmod +x /usr/local/bin/p4

Create new perforce folder in Home directory. 
Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T12:59:45Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
sudo cp ~/Downloads/p4/usr/local/bin
sudo chomod +x usr/local/bin/p4
Create new perforce folder in Home directory. 
Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T12:53:54Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce client from: http://www.perforce.com/downloads/helix 
Create new perforce folder in Home directory. 
Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T12:49:41Z

BenDupuis:

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce 
Create new perforce folder in Home directory. 
Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

Add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T12:48:44Z

BenDupuis:

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

Install perforce 
Create new perforce folder in Home directory. 
Create new file in this folder called .p4settings 
Include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

Edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

Install docker:
sudo apt-get install docker

add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T12:47:43Z

BenDupuis: /* Steps */

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

install perforce 
create new perforce folder in Home directory 
create new file in this folder called .p4settings 
include in this file: 
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

install docker:
sudo apt-get install docker

add user to docker group:
usermod -a -G docker username

Developer guide

2015-10-22T12:45:21Z

BenDupuis: Created page with "__FORCETOC__ ==Introduction== This is a quick start guide. ==Steps== install perforce create new perforce folder in Home directory create new file in this fol..."

__FORCETOC__
==Introduction==

This is a quick start guide.

==Steps==

install perforce
create new perforce folder in Home directory
create new file in this folder called .p4settings
include in this file:
P4PORT=p4.lpi.org:1666
P4CLIENT=yourclient
P4USER=youruser
P4PASSWD=yourpassword

edit .bashrc file to include:
xamdev=/home/username/perforce/xamnet/dev/dev/pde/mojo
xamman=/home/username/perforce/xamnet/man/dev/pde/mojo
export P4CONFIG=.p4settings

install docker:
sudo apt-get install docker

add user to docker group:
usermod -a -G docker username

Xamnet

2015-10-22T12:41:33Z

BenDupuis: /* Guides */

__FORCETOC__
==Introduction==

Xamnet is a project to develop the tools and infrastructure needed to develop, deliver and manage a certification and credential programme.

The three main component of this project are:

* [[Xamdev]] - Exam and certification development tools
* [[Xamdel]] - Exam delivery system and tools
* [[Xamman]] - Exam results and candidate credential management tools

 

==Guides==

The following guides are in the works:

* [[Developer guide]]
* Installation guide
* Administrator guide
* User guide