PSARC 2015/110 OpenStack service updates for Juno PSARC 2014/302 oslo.messaging - OpenStack RPC and notifications PSARC 2014/303 concurrent.futures - high-level Python interface for asynchronous execution PSARC 2014/304 networkx - Python module for complex networks PSARC 2014/305 taskflow - Python module for task execution PSARC 2014/329 pycadf - Python interface for CADF (cloud auditing) PSARC 2014/330 posix_ipc - POSIX IPC primitives for Python PSARC 2014/331 oauthlib - Python implementation of OAuth request-signing logic PSARC 2015/058 oslo - OpenStack common libraries (context, db, i18n, middleware, serialization, utils, vmware) PSARC 2015/059 glance_store - Glance storage library PSARC 2015/060 ipaddr - an IPv4/IPv6 manipulation library in Python PSARC 2015/061 simplegeneric - single-dispatch generic Python functions PSARC 2015/062 wsme - Web Services Made Easy PSARC 2015/063 retrying - General purpose Python retrying library PSARC 2015/065 osprofiler - an OpenStack cross-project profiling library PSARC 2015/066 OpenStack client for Sahara (Hadoop as a Service) PSARC 2015/067 keystonemiddleware - Middleware for OpenStack Identity PSARC 2015/068 pyScss - Compiler for the SCSS flavor of the Sass language PSARC 2015/069 django-pyscss - pyScss support for Django PSARC 2015/073 barbicanclient - OpenStack client for Barbican (Key Management) PSARC 2015/074 pysendfile - Python interface to sendfile PSARC 2015/097 ldappool - a connection pool for python-ldap PSARC 2015/098 rfc3986 - URI reference validation module for Python PSARC 2015/102 iniparse - python .ini file parsing module 20667775 OpenStack service updates for Juno (Umbrella) 18615101 Horizon should prevent network, subnet, and port names with hyphens in them 18772068 instance failed to launch with NoValidHost but no reason 18887457 openstack shouldn't deliver .po files 18905324 hostname.xml should set config/ignore_dhcp_hostname = true 18961031 Duplicate names for role-create and user-create are allowed 19015363 Users should not be allowed to attempt to create volumes when quota exceed 19050335 user appears logged in but unauthorised after horizon reboot 19144215 Instance manipulation buttons greyed out after all instances terminated 19249066 heat stack-preview doesn't appear to do anything 19313272 Need bottom slidebar in horizon for small browser windows 19462265 The Python module oslo.messaging should be added to Userland 19462397 The Python module futures should be added to Userland 19476604 The Python module networkx should be added to Userland 19476953 The Python module taskflow should be added to Userland 19519227 The Python module pycadf should be added to Userland 19582394 The Python module posix_ipc should be added to Userland 19598430 The Python module oauthlib should be added to Userland 19815780 nova package should have dependencies on brand-solaris and brand-solaris-kz 19883623 Image snapshots are missing 'instance_uuid' property 19887874 horizon should set up apache log rotation 19987962 Cinder lists additional volumes attached to instance with linuxy device names 20027791 horizon should be migrated to Apache 2.4 20164815 The Python module django-pyscss should be added to Userland 20173049 The Python module retrying should be added to Userland 20174489 The Python module WSME should be added to Userland 20176001 The Python module keystonemiddleware should be added to Userland 20182039 The Python module pysendfile should be added to Userland 20200162 The Python module pyScss should be added to Userland 20222184 horizon doesn't send start request on shutdown instance 20312312 The Python module python-saharaclient should be added to Userland 20514287 wrong vnic label name used for dhcp vnic in evs 20596802 The Python module oslo.middleware should be added to Userland 20596803 The Python module barbicanclient should be added to Userland 20596804 The Python module oslo.context should be added to Userland 20596805 The Python module iniparse should be added to Userland 20596806 The Python module oslo.vmware should be added to Userland 20596807 The Python module osprofiler should be added to Userland 20596808 The Python module oslo.i18n should be added to Userland 20596809 The Python module oslo.utils should be added to Userland 20596811 The Python module ipaddr should be added to Userland 20596812 The Python module glance_store should be added to Userland 20596813 The Python module oslo.serialization should be added to Userland 20596814 The Python module oslo.db should be added to Userland 20596815 The Python module simplegeneric should be added to Userland 20602690 The Python module ldappool should be added to Userland 20602722 The Python module rfc3986 should be added to Userland 20638369 compilemessages.py requires GNU msgfmt without calling gmsgfmt 20715741 cinder 2014.2.2 20715742 glance 2014.2.2 20715743 heat 2014.2.2 20715744 horizon 2014.2.2 20715745 keystone 2014.2.2 20715746 neutron 2014.2.2 20715747 nova 2014.2.2 20715748 swift 2.2.2 20715749 alembic 0.7.4 20715750 amqp 1.4.6 20715751 boto 2.34.0 20715752 ceilometerclient 1.0.12 20715753 cinderclient 1.1.1 20715754 cliff 1.9.0 20715756 django 1.4.19 20715757 django_compressor 1.4 20715758 django_openstack_auth 1.1.9 20715759 eventlet 0.15.2 20715761 glanceclient 0.15.0 20715762 greenlet 0.4.5 20715763 heatclient 0.2.12 20715764 keystoneclient 1.0.0 20715765 kombu 3.0.7 20715766 mysql 1.2.5 20715767 netaddr 0.7.13 20715769 netifaces 0.10.4 20715770 neutronclient 2.3.10 20715771 novaclient 2.20.0 20715772 oslo.config 1.6.0 20715773 py 1.4.26 20715774 pyflakes 0.8.1 20715775 pytest 2.6.4 20715776 pytz 2014.10 20715777 requests 2.6.0 20715778 simplejson 3.6.5 20715779 six 1.9.0 20715780 sqlalchemy-migrate 0.9.1 20715781 sqlalchemy 0.9.8 20715782 stevedore 1.2.0 20715783 swiftclient 2.3.1 20715784 tox 1.8.1 20715785 troveclient 1.0.8 20715786 virtualenv 12.0.7 20715787 websockify 0.6.0

     1

     2

	    Getting started with the Userland Consolidation

     3

     4

     5

Getting Started

     6

     7

    This README provides a very brief overview of the gate, how to retrieve

     8

    a copy, and how to build it.  Detailed documentation about the Userland

     9

    gate can be found in the 'doc' directory.  Questions or comments about

    10

    the gate can be addressed to [email protected].

    11

    12

Overview

    13

    14

    The Userland consolidation maintains a project page at

    15

    16

         https://solaris-userland.java.net/

    17

    18

    and a Mercurial gate at

    19

    20

         https://hg.java.net/hg/solaris-userland~gate

    21

    22

    This gate contains build recipies, patches, IPS manifests, etc. necessary

    23

    to download, prep, build, test, package and publish open source software.

    24

    The build infrastructure is similiar to that of the SFW consolidation in

    25

    that it makes use of herarchical Makefiles which provide dependency and

    26

    recipe information for building the components.  In order to build the

    27

    contents of the Userland gate, you need to clone it.  Since you are

    28

    reading this, you probably already have.

    29

    30

Getting the Bits

    31

    32

    As mentioned, the gate is stored in a Mercurial repository.  In order to

    33

    build or develop in the gate, you will need to clone it.  You can do so

    34

    with the following command

    35

    36

      $ hg clone https://hg.java.net/hg/solaris-userland~gate /scratch/clone

    37

    38

    This will create a replica of the various pieces that are checked into the

    39

    source code management system, but it does not retrieve the community

    40

    source archives associated with the gate content.  To download the

    41

    community source associated with your cloned workspace, you will need to

    42

    execute the following:

    43

    44

      $ cd /scratch/clone/components

    45

      $ gmake download

    46

    47

    This will use GNU make and the downloading tool in the gate to walk through

    48

    all of the component directories downloading and validating the community

    49

    source archives from the gate machine or their canonical source repository.

    50

    51

    There are two variation to this that you may find interesting.  First, you

    52

    can cause gmake(1) to perform it's work in parallel by adding '-j (jobs)'

    53

    to the command line.  Second, if you are only interested in working on a

    54

    particular component, you can change directories to that component's

    55

    directory and use 'gmake download' from that to only get it's source

    56

    archive.

    57

    58

Building the Bits.

    59

    60

    You can build individual components or the contents of the entire gate.

    61

    62

  Component build

    63

    64

    If you are only working on a single component, you can just build it using

    65

    following:

    66

    67

      setup the workspace for building components

    68

    69

        $ cd (your-workspace)/components ; gmake setup

    70

    71

      build the individual component

    72

    73

        $ cd (component-dir) ; gmake publish

    74

    75

  Complete Top Down build  

    76

    77

    Complete top down builds are also possible by simply running

    78

    79

      $ cd (your-workspace)/components

    80

      $ gmake publish

    81

    82

    The 'publish' target will build each component and publish it to the

    83

    workspace IPS repo.

    84

    Tools to help facilitate build zone creation will be integrated

    85

    shortly.  If the zone you create to build your workspace in does not have

    86

    networking enabled, you can pre-download any community source archives into

    87

    your workspace from the global with:

    88

    89

      $ cd (your-workspace)/components

    90

      $ gmake download

    91

    92

  You can add parallelism to your builds by adding '-j (jobs)' to your gmake

    93

  command line arguments.

    94

    95

  The gate should only incrementally build what it needs to based on what has

    96

  changed since you last built it.