{"id":20074143,"url":"https://github.com/juniper/contrail-installer","last_synced_at":"2025-05-05T21:31:19.447Z","repository":{"id":11994223,"uuid":"14571011","full_name":"Juniper/contrail-installer","owner":"Juniper","description":"Install scripts for OpenContrail","archived":false,"fork":false,"pushed_at":"2018-07-05T23:39:15.000Z","size":3388,"stargazers_count":29,"open_issues_count":61,"forks_count":64,"subscribers_count":190,"default_branch":"master","last_synced_at":"2025-04-09T04:26:34.148Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Juniper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-20T22:27:24.000Z","updated_at":"2023-10-02T07:41:10.000Z","dependencies_parsed_at":"2022-09-01T14:51:49.042Z","dependency_job_id":null,"html_url":"https://github.com/Juniper/contrail-installer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Juniper%2Fcontrail-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Juniper%2Fcontrail-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Juniper%2Fcontrail-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Juniper%2Fcontrail-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Juniper","download_url":"https://codeload.github.com/Juniper/contrail-installer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252580012,"owners_count":21771251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T14:49:34.383Z","updated_at":"2025-05-05T21:31:17.956Z","avatar_url":"https://github.com/Juniper.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"contrail-installer\n==================\n\ncontrail-installer is a set of scripts and utilities to quickly \nbuild, install, configure and deploy OpenContrail. It can be used\nwith pre-build packages (e.g. Launchpad PPA) or from sources. It\nis typically used in conjunction with devstack.\n\n# Versions\n\nThe contrail-installer master branch generally points to trunk versions \nof OpenContrail components whether sources or snapshots.  For older, \nstable versions, use appropriate release name. \n\nCurrently contrail-installer supports the following:\n\n    contrail-installer: sources master,    devstack: stable/mitaka\n    contrail-installer: sources R3.0,      devstack: stable/mitaka\n    contrail-installer: packages R2.20,    devstack: stable/mitaka\n\n# OpenContrail localrc\n\nOpenContrail uses ``localrc`` to contain all local configuration and customizations. \nBest to start with a sample localrc.\n\n    cd contrail-installer\n    cp samples/localrc-all localrc\n\nCONTRAIL_DEFAULT_INSTALL - Set this to True for installation from OpenContrail binary\npackages. When set to False, trunk OpenContrail bits will be downloaded and compiled. \n\nLAUNCHPAD_BRANCH=PPA - Applicable only when CONTRAIL_DEFAULT_INSTALL is set to True.\nIt specifies to use released binary packages for installation instead of compiling and\nbuilding from sources. Default is to use latest snapshots as this knob is commented out\nby default in sample localrc.\n\nPHYSICAL_INTERFACE - This is external interface Vrouter should bind to. It should have\na valid IP address configured. For example eth0\n\nINSTALL_PROFILE - Set this to ALL to for an all in one node. \n\nUSE_SCREEN - Set this to True to launch contrail modules in a screen session called\n\"contrail\". Connect to screen session for any troubleshooting of contrail modules.\n\nLOGFILE - Specify logfile for contrail.sh runs. By default this is log/contrail.log\nin contrail-installer directory\n\n# OpenContrail script\n\nContrail.sh is the main script that supports following options:\n\n    build     ... to build OpenContrail\n    Install   ... to Install OpenContrail\n    configure ... to Configure \u0026 Provision \n    start     ... to Start OpenContrail Modules\n    stop      ... to Stop OpenContrail Modules\n    restart   ... to Restart OpenContrail Modules without resetting data\n\n# Launching OpenContrail\n\nRun the following NOT AS ROOT:\n\n    cd contrail-installer\n    cp samples/localrc-all localrc (edit localrc as needed)\n    ./contrail.sh build\n    ./contrail.sh install\n    ./contrail.sh configure\n    ./contrail.sh start\n\nUpon successful run of last command, output similar to below should appear:\n\n    #:~/contrail-installer$ 2017-04-26 12:50:29 +++ echo -ne '\\015'\n    ++ clean\n    ++ local r=0\n    ++ echo 'exited with status :0'\n    exited with status :0\n    ++ exit 0\n\nThis will create a screen names \"contrail\" with a tab corresponding to each contrail service:\n\n    #:~/contrail-installer$ screen -ls\n    There are screens on:\n        2427.contrail   (04/26/2017 12:48:59 PM)        (Detached)\n    1 Sockets in /var/run/screen/S-jenkins.\n\n![alt text](contrail-screen.png)\n\n# Devstack\n\nTrunk of contrail-installer currently works with stable/mitaka of devstack.\n\n    git clone git@github.com:openstack-dev/devstack\n    cd devstack\n    git checkout stable/mitaka\n    \nA glue file is needed for devstack to use Contrail neutron plugin\n\n    cp ~/contrail-installer/devstack/lib/neutron_plugins/opencontrail lib/neutron_plugins/\n\nUse provided sample localrc for devstack. Note that this disables some neutron networking services\nbecause these services are provided by Contrail networking plugin. Edit localrc as needed to reflect\nyour physical interface and host:\n\n    cp ~/contrail-installer/devstack/samples/localrc-all localrc\n    HOST_IP=\u003cyour host ip\u003e\n    PHYSICAL_INTERFACE=eth0\n\nRun stack.sh\n    ./stack.sh\n\nif devstack installs successfully, output similar to following will be shown:\n\n    ========================\n    DevStack Components Timed\n    ========================\n\n    run_process - 71 secs\n    test_with_retry - 7 secs\n    apt-get-update - 17 secs\n    pip_install - 269 secs\n    restart_apache_server - 10 secs\n    wait_for_service - 29 secs\n    apt-get - 9 secs\n\n    This is your host IP address: 192.168.0.175\n    This is your host IPv6 address: ::1\n    Horizon is now available at http://192.168.0.175/dashboard\n    Keystone is serving at http://192.168.0.175:5000/\n    The default users are: admin and demo\n    The password: contrail123\n\n![alt text](devstack-screen.png)\n\n# Restarting OpenContrail+Devstack\n\nIf you need to restart OpenContrail or Devstack for some reason, currently they\nneed to be synchronized. So\n\n    cd ~/devstack\n    ./unstack.sh\n\n    cd ~/contrail-installer\n    ./contrail.sh restart\n    cd ~/devstack\n    ./stack.sh\n\nif issues persist, it might be helpful to reboot server or VM and repeat the steps\nbelow\n\n    cd ~/contrail-installer\n    ./contrail.sh start\n    cd ~/devstack\n    ./stack.sh\n\n\n# Verify installation\n    1) screen -x contrail and run through various tabs to see various contrail modules are running\n    2) Run utilities/contrail-status to see if all services are running\n\n\n# Running sanity\nNote that default sample localrc enables simple gateway. A script is available that will\ncreate a virtual network, launch two VMs, ping each VM from host and then SSH into it.\nFollow the steps below:\n\n    cd ~/contrail-installer/utilities\n    export CONTRAIL_DIR=~/contrail-installer\n    export DEVSTACK_DIR=~/devstack\n    ./contrail-sanity\n\n# Opencontrail UI\nOpenContrail UI runs on http port 8080. It will automatically redirect to https port 8143.\nusername is \"admin\", and the password is mentioned in the localrc (default: \"contrail123\")\n\n# Automating contrail.sh and devstack\ncontrail-installer/utilities/task.sh attempts to automate steps required by sequential runs\nof contrail.sh and devstack. It works off a configuration file. Default called auto.conf is\nprovided. Following example launches task.sh in binary PPA mode while using R2.20 packages.\nSee auto.conf for more options to launch in source mode or with use of snapshots\n\n    $ cd ~/contrail-installer/utilities\n    $ diff auto.conf my.conf\n    17c17\n    \u003c ENABLE_BINARY=False\n    ---\n    \u003e ENABLE_BINARY=True\n    22a23\n    \u003e LAUNCHPAD_BRANCH=r2.20\n\n    $ ./task.sh my.conf\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuniper%2Fcontrail-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuniper%2Fcontrail-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuniper%2Fcontrail-installer/lists"}