README.md in forj-1.0.5 vs README.md in forj-1.0.6

- old
+ new

@@ -43,28 +43,62 @@ $ gem install bundler --no-rdoc --no-ri $ gem install rake --no-rdoc --no-ri $ bundle install --gemfile Gemfile $ rake install +**For all OS including Linux/windows/mac +2 vagrant images has been written. +Read [vagrant/README.md] for details. + +This solution helps to develop and test on forj and lorj + +For more information about lorj, a process/controller library, see https://github.com/forj-oss/lorj + Quick steps: How to create a forj? ---------------------------------- forj setup # follow the instructions 1. Setup your first forj account. - `$ forj setup [AccountName]` + `$ forj setup [AccountName [provider]]` Ex: `forj setup MyAccount`. In this example, your account will be named 'MyAccount'. The first time you setup your account, it will become the default one. - **WARNING!!!** [Provider] is currently not supported. By default, it is using hpcloud as default provider. + Supported provider: **hpcloud**, **openstack**. hpcloud is the default. + + If you uses hphelion as a provider, check the API authentication system to select hpcloud or openstack. + + - *hpcloud* : Use this provider for http://www.hpcloud.com/, or hphelion. + Uses Access key and secret key authentication mechanism. + + - [hp public cloud|http://www.hpcloud.com/] from HP. Tested successfully. + + - *openstack*: Use this provider to access any openstack installation (public or private) or Hphelion (public or private) + Uses login and password authentication system + + If you want to test against a new local openstack cloud, you can consider : + + - [packstack|https://wiki.openstack.org/wiki/Packstack] from RedHat. Can be used for a notebook local installation. tested successfully. + - [hphelion|http://www8.hp.com/fr/fr/cloud/helion-overview.html] from HP. Tested successfully + - [Ubuntu OpenStack|http://www.ubuntu.com/cloud] from Canonical. Not tested. + + For any other cloud, you need a provider in lorj library. Contribute to create a new provider! + See + 2. Create your forge on your default account `$ forj boot <blueprint> <InstanceName>` Ex: `forj boot redstone myforge` - This command will start a Redstone forge named 'myforge' with the default FORJ account. Previous, we set it to be MyAccount. +NOTE: If you are creating a Forge in a corporate network, a proxy may be required for Maestro to access internet. +You can ask `forj` cli to send the proxy to use with -e + +Ex: Thanks to a CorporateAccount setup with forj setup, the following will use it and set the webproxy metadata. + + `forj boot redstone myforge -a CorporateAccount -e webproxy=$http_proxy` ###Forj options: To get forj cli help, just type: