{ "info": { "author": "Mircea Ulinic", "author_email": "mircea.ulinic@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Operating System :: MacOS", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: System :: Networking", "Topic :: Utilities" ], "description": "napalm-salt\n===========\n\nModules for Salt, to retrieve, control, enforce and update configuration\nof network devices\n\nSalt Basics\n===========\n\nNew to Salt? Check out `this document`_ for a brief introduction to get\nup to speed on the basics.\n\nTest Environment\n================\n\nThroughout the rest of this document, we\u2019ll set up a test environment to\nrun some salt commands against routers. This test environment uses a\nvagrant VM running Ubuntu 16.04, which acts as a salt-master as well as\na proxy-master, which establishes and maintains connections to the\nrouters in order to execute commands on them.\n\nInstall Salt\n============\n\nThe simplest way to install Salt is via `salt bootstrap`_. Here\u2019s an\nexample of an installation:\n\n.. code:: bash\n\n wget -O bootstrap-salt.sh https://bootstrap.saltstack.com/develop\n sudo sh bootstrap-salt.sh\n\nThis will install the ``salt-minion`` and ``salt-proxy`` only, but we\nalso want this box to be the ``salt-master``, so we\u2019ll install that:\n\n.. code:: bash\n\n sudo sh bootstrap-salt.sh -M\n\nFor more specific installation instructions, see the `platform-specific\ninstructions`_ from the official Saltstack documentation. Be aware to\ninstall the master distribution **from the PPA repo**, as on the local\nserver will run as Master, controlling the devices as Proxy minions.\n\nCentOS documentation can be found `here`_.\n\nInstall NAPALM\n==============\n\nIf NAPALM has never been installed on your system it will need to be\nbefore napalm-salt can work:\n\n::\n\n sudo apt-get install libffi-dev libssl-dev python-dev python-cffi libxslt1-dev python-pip\n sudo pip install --upgrade cffi\n sudo pip install napalm-junos napalm-iosxr napalm-ios\n\nThe easy way: Salt users can install NAPALM through a single command,\nusing the `napalm-install Saltstack formula`_. A more detailed usage\nexample can be found at:\nhttps://mirceaulinic.net/2017-07-06-napalm-install-formula/.\n\nConfigure Salt Proxy (and Minion)\n=================================\n\nThe main configuration file needed to make Salt run as proxy-master is\nlocated at ``/etc/salt/proxy``. This file should already exist, though\nyou may need to create it.\n\nWe need to tell the proxy process that the local machine is the\n``salt-master``, and to turn off multiprocessing. You can add the\nfollowing to the top of your ``/etc/salt/proxy`` file:\n\n::\n\n master: localhost\n multiprocessing: false\n mine_enabled: true # not required, but nice to have\n pki_dir: /etc/salt/pki/proxy # not required - this separates the proxy keys into a different directory\n\nAdditionally, you may want to edit the ``/etc/salt/minion`` file to\npoint the master location to itself. This is not necessary, but it\nallows you to target the VM as a minion, i\n\n.. _this document: https://docs.saltstack.com/en/latest/topics/tutorials/walkthrough.html\n.. _salt bootstrap: https://docs.saltstack.com/en/latest/topics/tutorials/salt_bootstrap.html\n.. _platform-specific instructions: https://docs.saltstack.com/en/latest/topics/installation/#platform-specific-installation-instructions\n.. _here: centos_installation.md\n.. _napalm-install Saltstack formula: https://github.com/saltstack-formulas/napalm-install-formula", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/napalm-automation/napalm-salt", "keywords": "napalm,salt,saltstack,network,automation", "license": "Apache License 2.0", "maintainer": "", "maintainer_email": "", "name": "napalm-salt", "package_url": "https://pypi.org/project/napalm-salt/", "platform": "", "project_url": "https://pypi.org/project/napalm-salt/", "project_urls": { "Homepage": "https://github.com/napalm-automation/napalm-salt" }, "release_url": "https://pypi.org/project/napalm-salt/0.0.2/", "requires_dist": null, "requires_python": "", "summary": "NAPALM modules for Salt, to facilitate vendor-agnostic event-driven network automation and orchestration", "version": "0.0.2" }, "last_serial": 3069300, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "2bee890442fd843b1c80430ebcb4fb9b", "sha256": "3a14e35ee54bd59d21069c4937c3640f3bdeb8f543ca75361062479c4a47f2da" }, "downloads": -1, "filename": "napalm-salt-0.0.1.tar.gz", "has_sig": false, "md5_digest": "2bee890442fd843b1c80430ebcb4fb9b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3029, "upload_time": "2017-08-03T09:30:53", "url": "https://files.pythonhosted.org/packages/cc/c6/b07fc076b00fd710beb9ce682d147d7f9968e57c34dc4628df0ba948f4f1/napalm-salt-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "d9a6b26d8c6ce9df70781ad151e99d89", "sha256": "99ae976716425171b200b6783b674d376a46096fa1419a3993107214afe60f2e" }, "downloads": -1, "filename": "napalm-salt-0.0.2.tar.gz", "has_sig": false, "md5_digest": "d9a6b26d8c6ce9df70781ad151e99d89", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3024, "upload_time": "2017-08-03T09:36:53", "url": "https://files.pythonhosted.org/packages/0a/f7/875402e1485f26c027aa089cfb1902fd52511c10869bf6c665365ca2aa1c/napalm-salt-0.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d9a6b26d8c6ce9df70781ad151e99d89", "sha256": "99ae976716425171b200b6783b674d376a46096fa1419a3993107214afe60f2e" }, "downloads": -1, "filename": "napalm-salt-0.0.2.tar.gz", "has_sig": false, "md5_digest": "d9a6b26d8c6ce9df70781ad151e99d89", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3024, "upload_time": "2017-08-03T09:36:53", "url": "https://files.pythonhosted.org/packages/0a/f7/875402e1485f26c027aa089cfb1902fd52511c10869bf6c665365ca2aa1c/napalm-salt-0.0.2.tar.gz" } ] }