Skip to content

Commit

Permalink
Merge branch 'develop' of https://github.com/zenoss/europa-dev into d…
Browse files Browse the repository at this point in the history
…evelop
  • Loading branch information
smousa committed Oct 1, 2013
2 parents d9ef19d + 47213a8 commit 73ba038
Showing 1 changed file with 43 additions and 4 deletions.
47 changes: 43 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Zenoss Europa Development Environment
=====================================

__Important: Do not clone this repository. Read on for instructions.__
__Important: Do not clone this repository (yet). Read on for instructions.__

Requirements
------------
Expand All @@ -19,9 +19,7 @@ Requirements

Installation
------------
NOTE: If you're on OS X with a case-insensitive filesystem, you should create
a case-sensitive partition or sparse bundle for your source, or Python imports
will get confused.
### Linux

1. If you've previously built Zenoss and are running it on the host box on
which you plan to set up europa-dev, you need to ensure you aren't using
Expand Down Expand Up @@ -138,9 +136,50 @@ will get confused.
the dev box. You can use `git zen` (or just `git`) locally to modify
them, or edit them locally.

### OS X
If you have a case-insensitive filesystem, create a separate source partition
with a case-sensitive filesystem in Disk Utility, and run the Linux
instructions relative to that root. Otherwise, Python imports that differ only
in case (of which a couple exist in the product) will get confused.

### Windows
This is a wild ride. Prepare yourself.

1. Install [Python][] 2.7.x using the Windows installer. Install it for all
users to the default location, C:\Python27. Customize nothing.

2. In Explorer, right-click on "Computer". Select "Properties", then
"Advanced System Settings". Click "Environment Variables". Edit the
system variable "Path" (semicolon-delimited) to include C:\Python27 and
C:\Python27\Scripts at the end.

3. Install [GitHub for Windows][]. This will also install .NET if you don't
have it already. Log in using your normal GitHub account. Clone any repo
to anywhere, which will force SSH keys to be set up properly (you can
delete this repo later). Select Tools > Options... and select "Git Bash"
as your default shell. Click "Update". Close.

4. Double-click on "Git Shell" on your desktop. This will open up a window
running bash.

5. cd to the directory in which you want a europa environment installed and
execute:

curl -fsSL https://github.com/zenoss/europa-dev/raw/windows/install.sh | bash

This script, comparable to the *NIX "go" script, will set up git-flow,
virtualenv, vagrant-berkshelf, create a Europa environment, install the
development tools package, and clone all the repositories.

6. Skip to step 4 of the Linux installation instructions. Bear in mind
Windows will not allow sharing of folders via NFS, so ignore that part.



[zenv]: https://intranet.zenoss.com/docs/DOC-2401
[Virtualbox]: https://www.virtualbox.org/
[GitHub for Windows]: http://windows.github.com
[Python]: http://python.org/download
[Vagrant]: http://www.vagrantup.com/
[Berkshelf]: http://berkshelf.com/
[git-flow]: https://github.com/nvie/gitflow
Expand Down

0 comments on commit 73ba038

Please sign in to comment.