...
Warning | ||
---|---|---|
| ||
This page is due some major revision, below section is a placeholder / WIP for new/updated layout |
ONAP Developer Set-Up (revised)
Create a Linux Foundation Account
OS Specific Instructions
MAC/OSX
Redhat/CentOS
Ubuntu
Windows
GitBash
Java
...
a Linux Foundation Account
Follow the instructions on the identity portal to create a Linux Foundation account and get access to the ONAP Gerrit instance.
Verify that you can log in at https://gerrit.onap.org/ and that you can see the ONAP list of repositories.
OS Specific Instructions
MAC/OSX ( to be reviewed by a MAC user )
get your MBP 2016 ready for development
generate keys - either ssh-add the key or rename it as id_rsa and put it into your ~/.ssh dir
Install the JDK (as dmg) - http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
Install homebrew package manager -
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
python should already be installed. - do a --version check
install pip - sudo easy_install pip
install openstack tools
install docker (dmg) - https://docs.docker.com/docker-for-mac/install/#download-docker-for-mac
install maven - apache-maven-3.6.3-bin.tar, create ~/.m2 and place settings.xml there
git comes with Xcode or Homebrew - do a --version check
install git-review via homebrew: brew install git-review
Redhat/CentOS ( to be reviewed by a Redhat/CentOS user )
20190130 - re-validating for RHEL 7.6 subscription
set JAVA_HOME in ~/.bashrc | yum install java-1.8.0-openjdk-devel get it via alternatives --config javac currently export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64 | |||||
install git and development tools | yum install git yum groupinstall 'Development Tools' this will give you make and python | |||||
install npm (will also be installed automatically by the ecomp build) - TODO: UPDATE as ecomp is locked | ||||||
download and install latest Maven create an ~/.m2 folder and copy our settings.xml there add maven to your path - check it with mvn --version | http://maven.apache.org/download.cgi tar -xvf apache-maven-3.6.3-bin.tar.gz | |||||
Add the following option to your MAVEN_OPTS in order not to periodically hang on downloading artifacts in linux | -Djava.net.preferIPv4Stack=true | |||||
enable IP4 forwarding to enable the RHEL VM to act as an edge router - without this docker containers cannot communicate | add to /etc/sysctl.conf | |||||
Install docker (required for some repos like dcae-inventory off dcae |
|
Ubuntu ( to be reviewed by a Ubuntu user )
enable ubuntu desktop | apt-get update apt-get install ubuntu-desktop | |||||||
enable static IP | vi /etc/network/interfaces add iface enp0s25 inet static address 192.168.15.101 netmask 255.255.255.0 network 192.168.15.0 broadcast 192.168.15.255 gateway 192.168.15.1 dns-nameservers 8.8.4.4 | |||||||
disable strict host checking (client and server) |
| |||||||
Enable non CD repositories so an apt-get update will work | comment out the CD first line in /etc/apt/sources.list | |||||||
enable ssh if skipped during installation so we can remote ssh | sudo apt-get install openssh-server | |||||||
enable root login and gui (no sudo su -) | sudo passwd root sudo usermod -U root sudo reboot now sudo vi /etc/lightdm/lightdm.conf [SeatDefaults] greeter-session=unity-greeter user-session=ubuntu greeter-show-manual-login=true : enable root login vi /etc/ssh/sshd_config FROM:
PermitRootLogin prohibit-password
TO:
PermitRootLogin yes systemctl restart sshd | |||||||
set JAVA_HOME in ~/.bashrc or /etc/environment ubuntu@ubuntu:~$ echo $JAVA_HOME | if not sudo apt install openjdk-8-jdk | |||||||
install git and development tools | sudo apt-get install git | |||||||
install npm (will also be installed automatically by the ecomp build) | sudo apt install npm | |||||||
download and install latest Maven create an ~/.m2 folder and copy our settings.xml there add maven to your path - check it with mvn --version | http://maven.apache.org/download.cgi tar -xvf apache-maven-<version>-bin.tar.gz or sudo apt install maven | |||||||
Add the following option to your MAVEN_OPTS in order not to periodically hang on downloading artifacts in linux | in /etc/environment -Djava.net.preferIPv4Stack=true | |||||||
Install docker (required when building docker images) | use the current as of 20180621 17.03 version in the script
|
Windows
Note: The DCAE and SDC repo will not fully clone in a windows environment (even git-bash) until some file paths are reduced below 255 chars -
Jira | ||||||
---|---|---|---|---|---|---|
|
Jira | ||||||
---|---|---|---|---|---|---|
|
Enabling long paths in windows
Code Block |
---|
git config --system core.longpaths true |
GitBash
Install git-bash in accordance with https://www.atlassian.com/git/tutorials/install-git#windows
Java
ONAP is moving to Java 11 but many projects still use Java 8.
Download and install the appropriate openjdk version in accordance with the component you are using and set JAVA_HOME.
Maven
Download the latest Maven using installer from https://maven.apache.org/download.cgi
Connecting to ONAP Gerrit
...