Difference between revisions of "WOCE Build Environment"

From WebOS-Ports
Jump to: navigation, search
(Windows Setup)
Line 133: Line 133:
  
 
'''Host:'''
 
'''Host:'''
 +
 +
''nfs:''
 +
 +
1. Install NFS Server
 +
sudo apt-get install nfs-kernel-server
 +
 +
2. Edit:
 +
/etc/exports
 +
''(requires superuser)''
 +
 +
3. Add the following to the end:
 +
/PATH/TO/HOST/SHARE 127.0.0.1(rw,sync,insecure,no_root_squash)
 +
 +
4. Save and close /etc/exports
 +
 +
5. Run the following command:
 +
sudo nfs-kernel-server restart
  
 
'''Client:'''
 
'''Client:'''

Revision as of 17:36, 2 July 2012

Develop in your environment, Build in ours.


WOCE Self-Contained Development Environment

Introduction

The WOCE SDE uses Vagrant and Virtualbox to create a self-contained build environment for use on Windows, OSX and Linux Hosts.

Our goal is to create a consistent build setup for developers so that if there are issues with builds we can know that we all are singing off the same sheet of music.

Minimum Requirements

x86 based computer running Windows(XP minimum), OSX(10.5 minimum) or Linux(32bit or 64bit).

Enough resources to allot:

  • 1 "Virtual CPU"
  • 1GB "Virtual RAM"
  • 20GB "Virtual HD"

Installation Procedure

1. From your development host go to Vagrant Downloads and download the latest version for your host.

2. From your development host go to Virtualbox Downloads and download the latest version for your host.

3. Install Virtualbox

4. Install Vagrant

5. From a Command Prompt in the directory you have set aside for your woce-be VM

$ vagrant box add woce-be http://bit.ly/QS3G1p
$ vagrant init woce-be
$ vagrant up

OSX Setup

Host:

nfs:

1. Edit:

/System/Library/LaunchDaemons/com.apple.nfsd.plist 

(requires superuser)

2. Scroll down to the line that reads:

<string>/sbin/nfsd</string>

3. Add a new line below it that reads:

<string>-N</string>

4. Save the file, close it

5. Edit:

/etc/exports

(requires superuser)

6. Add the following:

/path/to/shared/dir -mapall=501

7. Save and close it

8. Open Terminal.app and run the following:

sudo nfsd enable
sudo nfsd checkexports
showmount -e

If successful, your share's path should be printed to stdout.


Client:

1. Connect to VM

vagrant ssh

2. Edit:

/etc/fstab

3. Modify the bottom line, replacing:

/PATH/TO/HOST/SHARE 

with the location of woce-build clone on your host machine

4. Save and close the fstab

5 run the following command:

sudo mount /srv/share 

(Subject to change if using the host's WOCE folder)

Windows Setup

Host:

1. Download the Hanwin NFS Server

2. Install the Hanwin NFS server

3. Use Install SunRPC PortMap Daemon from the start menu to install and start the daemon

4. With the control panel applet NFS Server you can configure and monitor the service.

  • Administrator rights are required to change settings from the applet.

5. Create an exports file with the directories you want to access from NFS clients.

  • (The format of the exports file is the same as on Linux. Details are specified below.)

6. Use Install NFS Server service from the start menu to install and start the server

Client:

1. Edit:

/etc/fstab

2. Modify the bottom line, replacing:

/PATH/TO/HOST/SHARE 

with the location of woce-build clone on your host machine

3. Save and close the fstab

4. run the following command:

sudo mount /srv/share 

(Subject to change if using the host's WOCE folder)

Linux Setup

Host:

nfs:

1. Install NFS Server

sudo apt-get install nfs-kernel-server

2. Edit:

/etc/exports
(requires superuser)

3. Add the following to the end:

/PATH/TO/HOST/SHARE 127.0.0.1(rw,sync,insecure,no_root_squash)

4. Save and close /etc/exports

5. Run the following command:

sudo nfs-kernel-server restart

Client:

1. Edit:

/etc/fstab

2. Modify the bottom line, replacing:

/PATH/TO/HOST/SHARE 

with the location of woce-build clone on your host machine

3. Save and close the fstab

4. run the following command:

sudo mount /srv/share 

(Subject to change if using the host's WOCE folder)