-
CentOS only - Enable EPEL & install DNF
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm sudo yum -y install dnf
-
Install packages
sudo dnf -y install git-all # Git and components sudo dnf -y install memcached # Memcached for the session store sudo dnf -y install postgresql-devel postgresql-server # PostgreSQL Database server and to build 'pg' Gem sudo dnf -y install bzip2 libffi-devel readline-devel # For rbenv install 2.2.0 (might not be needed with other Ruby setups) sudo dnf -y install libxml2-devel libxslt-devel patch # For Nokogiri Gem sudo dnf -y install sqlite-devel # For sqlite3 Gem sudo dnf -y install nodejs # For ExecJS Gem and bower sudo dnf -y install gcc-c++ # For unf gem sudo dnf -y install libcurl-devel # For Curb rpm -q --whatprovides npm || sudo dnf -y install npm # For CentOS 7, Fedora 23 and older sudo dnf -y install openssl-devel # For rubygems sudo dnf -y install cmake # For rugged Gem
-
Install the Bower package manager
sudo npm install -g bower -
Enable Memcached
sudo systemctl enable memcached sudo systemctl start memcached -
Configure PostgreSQL
- Required PostgreSQL version is 9.4+.
sudo postgresql-setup initdb sudo grep -q '^local\s' /var/lib/pgsql/data/pg_hba.conf || echo "local all all trust" | sudo tee -a /var/lib/pgsql/data/pg_hba.conf sudo sed -i.bak 's/\(^local\s*\w*\s*\w*\s*\)\(peer$\)/\1trust/' /var/lib/pgsql/data/pg_hba.conf sudo systemctl enable postgresql sudo systemctl start postgresql sudo -u postgres psql -c "CREATE ROLE root SUPERUSER LOGIN PASSWORD 'smartvm'" # This command can return with a "could not change directory to" error, but you can ignore it
-
Install Homebrew
If you do not have Homebrew installed, go to the Homebrew website and install it.
-
Install Packages
brew install git brew install memcached brew install postgresql brew install cmake brew install node
-
Install the Bower package manager
npm install -g bower -
Configure and start PostgreSQL
- Required PostgreSQL version is 9.4+
# Enable PostgreSQL on boot mkdir -p ~/Library/LaunchAgents ln -sfv /usr/local/opt/postgresql/*.plist ~/Library/LaunchAgents launchctl load -w ~/Library/LaunchAgents/homebrew.mxcl.postgresql.plist # Create the ManageIQ superuser psql -d postgres -c "CREATE ROLE root SUPERUSER LOGIN PASSWORD 'smartvm'"
-
Start memcached
# Enable Memcached on boot ln -sfv /usr/local/opt/memcached/homebrew.mxcl.memcached.plist ~/Library/LaunchAgents launchctl load -w ~/Library/LaunchAgents/homebrew.mxcl.memcached.plist
- Use a Ruby version manager
- chruby and ruby-install
- rvm
- rbenv
- Required Ruby version is 2.2.2+
- With Ruby installed,
gem install bundlerto install the latest Bundler. Required Bundler version is 1.8.7+
-
The most reliable authentication mechanism for git uses SSH keys.
- SSH Key Setup Set up a SSH keypair for authentication. Note: If you enter a passphrase, you will be prompted every time you authenticate with it.
-
Github account setup Account Settings.
- Profile: Fill in your personal information, such as your name.
- Profile: Optionally set up an avatar at gravatar.com. When you set up your gravatar, be sure to have an entry for the addresses you plan to use with git / Github.
- Emails: Enter your e-mail address and verify it, click the Verify button and follow the instructions.
- Notification Center / Notification Email / Custom Routing: Change the email address associated with ManageIQ if desired.
- If you are a member of the ManageIQ organization:
- Go to the Members page.
- Verify you are listed.
- Optionally click Publicize Membership.
- Go to the Members page.
-
Fork ManageIQ/manageiq:
- Go to ManageIQ/manageiq
- Click the Fork button and choose "Fork to <yourname>"
-
Git configuration and default settings.
git config --global user.name "Joe Smith" git config --global user.email [email protected] git config --global --bool pull.rebase true git config --global push.default simple
If you need to use git with other email addresses, you can set the local user.email from within the clone using:
git config user.name "Joe Smith" git config user.email [email protected]
git clone [email protected]:JoeSmith/manageiq.git # Use "-o my_fork" if you don't want the remote to be named origin
cd manageiq
git remote add upstream [email protected]:ManageIQ/manageiq.git
git fetch upstreamYou can add other remotes at any time to collaborate with others by running:
git remote add other_user [email protected]:OtherUser/manageiq.git
git fetch other_userIf you want to do a providers development, clone them locally.
git clone [email protected]:JoeSmith/manageiq-providers-amazon.git providers/manageiq-providers-amazonIn your local Gemfile.dev.rb add:
dependencies.reject!{|d| d.name == 'manageiq-providers-amazon'}
gem "manageiq-providers-amazon", :path => File.expand_path("providers/manageiq-providers-amazon", __dir__)bin/setup # Installs dependencies, config, prepares database, etc
bundle exec rake evm:start # Starts the ManageIQ EVM Application in the background- You can now access the application at
http://localhost:3000. The default username isadminwith passwordsmartvm. - There is also a minimal mode available to start the application with fewer services and workers for faster startup or targeted end-user testing. See the minimal mode guide for details.
- To run the test suites, see the guide on that topic.
- You can update ruby and javascript dependencies as well as run migrations using one command
bin/update # Updates dependencies using bundler and bower, runs migrations, prepares test db.- First login fails
Make sure you have memcached running. If not stop the server with bundle exec rake evm:stop,
start memcached and retry.
bin/setup failswhile trying to load the gem 'sprockets/es6'
If this happens check the log for
ExecJS::RuntimeUnavailable: Could not find a JavaScript runtime a few lines down.
When this message is present, then the you need to install node.js and re-try
bin/setupfails while trying to install the 'nokogiri' gem
If this happens, you may be missing developer tools in your OS X. Try to install them with
xcode-select --install and re-try.