{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Assumptions","type":"text"}]},{"type":"paragraph","content":[{"text":"This guide assumes the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You have a Linux virtual machine where you are currently able to build the appc code","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Your virtual machine should have adequate resources to run the appc Docker images","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Docker images can run in a virtual machine with 4GB of ram, but if you are also running Eclipse, it might be a good idea to configure 6GB or more","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You should give the virtual machine at least 2, possibly 3 or 4 processor cores","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Some of the steps in this guide may only work on newer versions of Linux. In this case, you may see a section in red which has steps to use for an older version.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Where to install Docker","type":"text"}]},{"type":"paragraph","content":[{"text":"You can either run Docker on the same VM that you are using for maven and other development work, or you can install Docker in its own VM. There is less network configuration to be done if Docker is installed in the same VM as your maven builds. In this guide, we will look at installing Docker in the same VM that you are using for builds.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing Docker Services","type":"text"}]},{"type":"paragraph","content":[{"text":"The Docker service is installed on Linux from the package manager. It is available for most Linux distributions.","type":"text"}]},{"type":"paragraph","content":[{"text":"Install on Ubuntu: ","type":"text"},{"text":"sudo apt-get install docker.io","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Install on Centos/Redhat: ","type":"text"},{"text":"sudo yum install docker","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Make sure Docker is set to start","type":"text"}]},{"type":"paragraph","content":[{"text":"sudo systemctl enable docker","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo systemctl start docker","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"For older Linux versions (Ubuntu 1404):","type":"text"}]},{"type":"paragraph","content":[{"text":"sudo service docker start","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Allow Docker to run without root","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: This could be considered a security risk because your account will basically have root access when it’s in the docker group","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sudo groupadd docker","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sudo usermod -aG docker $USER","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sudo shutdown now -r","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"type":"hardBreak"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Test Docker install","type":"text"}]},{"type":"paragraph","content":[{"text":"You can test your install by running ","type":"text"},{"text":"docker version","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Setup proxy server for Docker","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new directory for Docker service: ","type":"text"},{"text":"sudo mkdir /etc/systemd/system/docker.service.d","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new file in the new directory called “http-proxy.conf” with the following contents:","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"[Service]\nEnvironment=”HTTP_PROXY=/”","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reload Docker","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sudo systemctl daemon-reload","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sudo systemctl restart docker","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"For Older Linux (Ubuntu 1404):","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the file “/etc/default/docker”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uncomment the line that begins with “export http_proxy”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace the proxy address on the same line with the address of your proxy server","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart Docker: ","type":"text"},{"text":"sudo service docker restart","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"type":"hardBreak"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing docker-compose","type":"text"}]},{"type":"paragraph","content":[{"text":"We normally use the docker-compose utility to bring up the appc Docker images.","type":"text"}]},{"type":"paragraph","content":[{"text":"It can be installed with: ","type":"text"},{"text":"sudo apt-get install docker-compose","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Depending on your Linux version and repository setup, docker-compose may not be available from the package manager.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Python pip can also be used to install docker compose: ","type":"text"},{"text":"sudo pip install docker-compose","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If pip is not installed, it should be able to be installed with: ","type":"text"},{"text":"sudo apt-get install python-pip","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The full install guide for docker-compose can be found on the Docker website: ","type":"text"},{"text":"https://docs.docker.com/compose/install/","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.docker.com/compose/install/"}}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Preparing for Docker Build in Maven","type":"text"}]},{"type":"paragraph","content":[{"text":"You need to make sure that you have an entry in your maven “settings.xml” file for your local maven repository. This way, when you run the Docker build, it will be able to download the appc installers from your local computer instead of going out to nexus server.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"By default, your maven settings file will be in your Linux home folder, in the .m2 folder (~/.m2/settings.xml)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You’ll want to add a repository entry pointing to your local .m2/repository folder","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The local repository entry looks like the following, it should go in the tag in the settings file. You need to put your Linux user id in the placeholder.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n local-maven\n local-maven\n file:///home//.m2/repository\n \n false\n \n \n true\n \n \n \n \n \n local-maven\n local-maven\n file:///home//.m2/repository\n \n false\n \n \n true\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Cloning the appc deployment project","type":"text"}]},{"type":"paragraph","content":[{"text":"The appc deployment project contains the maven files which will build the Docker image.","type":"text"}]},{"type":"paragraph","content":[{"text":"Clone this repository. (","type":"text"},{"text":"git clone ","type":"text","marks":[{"type":"code"}]},{"text":"https://gerrit.onap.org/r/appc/deployment","type":"text","marks":[{"type":"link","attrs":{"href":"https://gerrit.onap.org/r/appc/deployment"}}]},{"text":")","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Downloading the pre-requisite Docker images","type":"text"}]},{"type":"paragraph","content":[{"text":"Our appc image is based on the ccsdk odlsli Docker image. So we need to download this before building the appc Docker image.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"First, you need to login Docker to the onap repository","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"docker login ","type":"text","marks":[{"type":"code"}]},{"text":"nexus3.onap.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://nexus3.onap.org"}}]},{"text":":10001","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use your Linux Foundation credentials for the login","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note: It appears that if you guess your password too many times, you will be locked out.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now we pull down the image","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At the time of this writing, the latest version of the ccsdk-odlsli-image is “v0.1.0”, but this could change in the future","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pull the image with: ","type":"text"},{"text":"docker pull ","type":"text","marks":[{"type":"code"}]},{"text":"nexus3.onap.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://nexus3.onap.org"}}]},{"text":":10001/onap/ccsdk-odlsli-alpine-image:0.4.1 (For Dublin Release)","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once it is done, we need to tag this image with the correct name that the appc build will be expecting: ","type":"text"},{"text":"docker tag ","type":"text","marks":[{"type":"code"}]},{"text":"nexus3.onap.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://nexus3.onap.org"}}]},{"text":":10001/onap/ccsdk-odlsli-alpine-image:0.4.1 onap/ccsdk-odlsli-alpine-image:0.4.1","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Building with Maven on the command line","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The first step is to build the main appc project.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This must be done on the same system that you will be building the Docker image on","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to your appc folder in a terminal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"mvn clean install","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once this has completed, we will do a Docker build on the deployment project","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to your deployment project folder in a terminal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mvn clean install -P docker","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Checking that the new Docker image was created","type":"text"}]},{"type":"paragraph","content":[{"text":"The command ","type":"text"},{"text":"docker images","type":"text","marks":[{"type":"code"}]},{"text":" will show all the Docker images that you have on your system. You should see an image called “onap/appc-image” that was created recently (when you ran the build).","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Starting the new Docker image","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: Starting up the Docker containers from behind a proxy server usually does not work. We have had several experimental methods to make it work, but none have proven to be reliable.","type":"text","marks":[{"type":"em"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"By default, the docker-compose command will use the “docker-compose.yml” file from the current directory that you run the command from as its configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open a terminal window in the “docker-compose” directory of the appc deployment git repository that you cloned earlier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We want to slightly modify the docker-compose.yml file in this directory","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the file, you will see a “dgbuilder:” line","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove this line and everything below it and save the file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note: If you plan to use the dg-builder, you will want to skip this step. But, if you don’t plan to use it, it will save time and memory to remove it","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the same directory containing the docker-compose.yml file, run the command ","type":"text"},{"text":"docker-compose up -d","type":"text","marks":[{"type":"code"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This will create and start up the appc Docker containers","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can run the ","type":"text"},{"text":"docker-compose logs","type":"text","marks":[{"type":"code"}]},{"text":" command to see the startup log.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once the log displays the Opendaylight logo, you know startup is complete. It will take a few minutes.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Opening the Opendaylight api doc explorer","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From a browser on the same VM where you have Docker running:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"http://localhost:8282/apidoc/explorer/index.html","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8282/apidoc/explorer/index.html"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The username is \"admin\", password is \"Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Commands while running the Docker image","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker-compose logs","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Shows the statup log for the containers. This is a good way to check if startup is complete.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker ps","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Shows all running Docker containers","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker ps -a","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Shows all running and stopped Docker containers","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker stop ","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Stops a running Docker container","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker rm -v ","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Deletes a Docker container and its associated volume (does not delete the Docker image that was used to bring up the container)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker ps | while read a b c d e f g; do docker stop $a; done","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"This will stop all running Docker containers","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker ps -a | while read a b c d e f g; do docker rm -v $a; done","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"This will delete all created Docker containers (will not delete the Docker image files)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker exec -it appc_controller_container bash","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Opens the bash shell in the running appc Docker container. The exit command will allow you to leave the Docker container.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker exec -it appc_controller_container /opt/opendaylight/current/bin/client -u karaf","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Directly opens the opendaylight console that is running in the Docker container","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker images","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"List all of the Docker images that are on your system. Shows their name, version, id, size, and date.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"docker rmi -f ","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Delete the Docker image off your system with the given image id","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Accessing the MySQL database Docker container","type":"text"}]},{"type":"paragraph","content":[{"text":"Once the Docker containers are running, you can directly access the mysql database with this command: ","type":"text"},{"text":"docker exec -it sdnc_db_container mysql -uroot -popenECOMP1.0","type":"text","marks":[{"type":"code"}]}]}],"version":1}

Browser not supported