{ "info": { "author": "Shunde Zhang", "author_email": "shunde.zhang@ersa.edu.au", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Education", "Intended Audience :: Other Audience", "Intended Audience :: Science/Research", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)", "Natural Language :: English", "Operating System :: OS Independent", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Topic :: Education", "Topic :: Scientific/Engineering", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Clustering", "Topic :: System :: Distributed Computing" ], "description": "===================\nStarCluster v0.9999\n===================\n:StarCluster: Cluster Computing Toolkit for the Cloud\n:Version: 0.9999\n:Author: Justin Riley \n:Team: Software Tools for Academics and Researchers (http://star.mit.edu)\n:Homepage: http://star.mit.edu/cluster\n:License: LGPL\n.. image:: https://secure.travis-ci.org/jtriley/StarCluster.png?branch=develop\n :target: https://secure.travis-ci.org/jtriley/StarCluster\n.. image:: https://pypip.in/d/StarCluster/badge.png\n :target: https://crate.io/packages/StarCluster\n\nDescription:\n============\nStarCluster is a utility for creating and managing computing clusters hosted on\nAmazon's Elastic Compute Cloud (EC2). StarCluster utilizes Amazon's EC2 web\nservice to create and destroy clusters of Linux virtual machines on demand.\n\nAll that's needed to create your own cluster(s) on Amazon EC2 is an AWS account\nand StarCluster. StarCluster features:\n\n* **Simple configuration** - with examples ready to go out-of-the-box\n* **Create/Manage Clusters** - simple **start** command to automatically launch\n and configure one or more clusters on EC2\n* **Automated Cluster Setup** - includes NFS-sharing, Open Grid Scheduler\n queuing system, Condor, password-less ssh between machines, and more\n* **Scientific Computing AMI** - comes with Ubuntu 11.10-based EBS-backed AMI\n that contains Hadoop, OpenMPI, ATLAS, LAPACK, NumPy, SciPy, IPython, and\n other useful libraries\n* **EBS Volume Sharing** - easily NFS-share Amazon Elastic Block Storage (EBS)\n volumes across a cluster for persistent storage\n* **EBS-Backed Clusters** - start and stop EBS-backed clusters on EC2\n* **Cluster Compute Instances** - support for \"cluster compute\" instance types\n* **Expand/Shrink Clusters** - scale a cluster by adding or removing nodes\n* **Elastic Load Balancing** - automatically shrink or expand a cluster based\n on Open Grid Scheduler queue statistics\n* **Plugin Support** - allows users to run additional setup routines on the\n cluster after StarCluster's defaults. Comes with plugins for IPython\n parallel+notebook, Condor, Hadoop, MPICH2, MySQL cluster, installing Ubuntu\n packages, and more.\n\nInterested? See the `getting started`_ section for more details.\n\n.. _getting started:\n\nGetting Started:\n================\nInstall StarCluster using `easy_install`::\n\n $ easy_install StarCluster\n\nor using `pip`::\n\n $ pip install StarCluster\n\nor manually::\n\n $ (Download StarCluster from http://star.mit.edu/cluster/downloads.html)\n $ tar xvzf starcluster-X.X.X.tar.gz (where x.x.x is a version number)\n $ cd starcluster-X.X.X\n $ sudo python setup.py install\n\nAfter the software has been installed, the next step is to setup the\nconfiguration file::\n\n $ starcluster help\n StarCluster - (http://star.mit.edu/cluster)\n Software Tools for Academics and Researchers (STAR)\n Please submit bug reports to starcluster@mit.edu\n\n !!! ERROR - config file /home/user/.starcluster/config does not exist\n\n Options:\n --------\n [1] Show the StarCluster config template\n [2] Write config template to /home/user/.starcluster/config\n [q] Quit\n\n Please enter your selection:\n\nSelect the second option by typing *2* and pressing enter. This will give you a\ntemplate to use to create a configuration file containing your AWS credentials,\ncluster settings, etc. The next step is to customize this file using your\nfavorite text-editor::\n\n $ vi ~/.starcluster/config\n\nThis file is commented with example \"cluster templates\". A cluster template\ndefines a set of configuration settings used to start a new cluster. The\nexample config provides a *smallcluster* template that is ready to go\nout-of-the-box. However, first, you must fill in your AWS credentials and\nkeypair info::\n\n [aws info]\n aws_access_key_id = #your aws access key id here\n aws_secret_access_key = #your secret aws access key here\n aws_user_id = #your 12-digit aws user id here\n\nThe next step is to fill in your keypair information. If you don't already have\na keypair you can create one from StarCluster using::\n\n $ starcluster createkey mykey -o ~/.ssh/mykey.rsa\n\nThis will create a keypair called *mykey* on Amazon EC2 and save the private\nkey to ~/.ssh/mykey.rsa. Once you have a key the next step is to fill-in your\nkeypair info in the StarCluster config file::\n\n [key key-name-here]\n key_location = /path/to/your/keypair.rsa\n\nFor example, the section for the keypair created above using the **createkey**\ncommand would look like::\n\n [key mykey]\n key_location = ~/.ssh/mykey.rsa\n\nAfter defining your keypair in the config, the next step is to update the\ndefault cluster template *smallcluster* with the name of your keypair on EC2::\n\n [cluster smallcluster]\n keyname = key-name-here\n\nFor example, the *smallcluster* template would be updated to look like::\n\n [cluster smallcluster]\n keyname = mykey\n\nNow that the config file has been set up we're ready to start using\nStarCluster. Next we start a cluster named \"mycluster\" using the default\ncluster template *smallcluster* in the example config::\n\n $ starcluster start mycluster\n\nThe *default_template* setting in the **[global]** section of the config\nspecifies the default cluster template and is automatically set to\n*smallcluster* in the example config.\n\nAfter the **start** command completes you should now have a working cluster.\nYou can login to the master node as root by running::\n\n $ starcluster sshmaster mycluster\n\nYou can also copy files to/from the cluster using the **put** and **get**\ncommands. To copy a file or entire directory from your local computer to the\ncluster::\n\n $ starcluster put /path/to/local/file/or/dir /remote/path/\n\nTo copy a file or an entire directory from the cluster to your local computer::\n\n $ starcluster get /path/to/remote/file/or/dir /local/path/\n\nOnce you've finished using the cluster and wish to stop paying for it::\n\n $ starcluster terminate mycluster\n\nHave a look at the rest of StarCluster's available commands::\n\n $ starcluster --help\n\nDependencies:\n=============\n* Amazon AWS Account\n* Python 2.6+\n* Boto 2.9.8\n* Paramiko 1.10.1\n* WorkerPool 0.9.2\n* Jinja2 2.7\n* decorator 3.4.0\n* pyasn1 0.1.7\n* iptools 0.6.1\n* optcomplete 1.2-devel\n\nLearn more...\n=============\nWatch an ~8 minute screencast @ http://star.mit.edu/cluster\n\nTo learn more have a look at the documentation:\nhttp://star.mit.edu/cluster/docs/latest\n\nCommunity\n=========\nStarCluster has a mailing list for users and developers:\n\nhttp://star.mit.edu/cluster/mailinglist.html\n\nJoin our IRC channel #starcluster on freenode. If you do not have an IRC client\nyou can join the #starcluster channel using your web browser:\n\nhttp://webchat.freenode.net/?channels=starcluster\n\nLicensing\n=========\nStarCluster is licensed under the LGPLv3\nSee COPYING.LESSER (LGPL) and COPYING (GPL) for LICENSE details", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/shundezhang/starcluster", "keywords": null, "license": "LGPL3", "maintainer": null, "maintainer_email": null, "name": "StarCluster-openstack", "package_url": "https://pypi.org/project/StarCluster-openstack/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/StarCluster-openstack/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/shundezhang/starcluster" }, "release_url": "https://pypi.org/project/StarCluster-openstack/0.94.2/", "requires_dist": null, "requires_python": null, "summary": "This is an OpenStack port of StarCluster developed by MIT (http://star.mit.edu/cluster)", "version": "0.94.2" }, "last_serial": 931518, "releases": { "0.94.1": [ { "comment_text": "", "digests": { "md5": "eeedb962492d72a62064a73ac1bf4503", "sha256": "eb14be7fc995fec937fe8bb9093783d735bd8c47fd75fe148fe6fc39ffb2f441" }, "downloads": -1, "filename": "StarCluster-openstack-0.94.1.tar.gz", "has_sig": false, "md5_digest": "eeedb962492d72a62064a73ac1bf4503", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2352417, "upload_time": "2013-09-24T00:53:37", "url": "https://files.pythonhosted.org/packages/db/2e/528c101f881237586254a119235d53146d2f83ef932c8c64e6269f097782/StarCluster-openstack-0.94.1.tar.gz" } ], "0.94.2": [ { "comment_text": "", "digests": { "md5": "7af7233baffe132c880d0f38308518de", "sha256": "af135cd635159359f2a5c4be9ba171fa2c4ba2a7f36e0bec9ffebab5a75cfd03" }, "downloads": -1, "filename": "StarCluster-openstack-0.94.2.tar.gz", "has_sig": false, "md5_digest": "7af7233baffe132c880d0f38308518de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2353924, "upload_time": "2013-10-18T04:11:22", "url": "https://files.pythonhosted.org/packages/73/df/7c8a10c8c7e77fa193d4788046147b7fe3f19c4d95610e15fa91b8872977/StarCluster-openstack-0.94.2.tar.gz" } ], "0.94.3-openstack": [ { "comment_text": "", "digests": { "md5": "62d647ac78cab0df79814c6d1ca13ebc", "sha256": "d00fe2940c68e2fbb8b27488868a6aae397a9fb23a2a7e1fcb3ec8a43e3c88f6" }, "downloads": -1, "filename": "StarCluster-openstack-0.94.3-openstack.tar.gz", "has_sig": false, "md5_digest": "62d647ac78cab0df79814c6d1ca13ebc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2355359, "upload_time": "2013-11-29T00:32:21", "url": "https://files.pythonhosted.org/packages/e3/25/4aa2462f855f9a953f7defab74fa9e6d5f561b1498d5ec29c3eabcfd7e42/StarCluster-openstack-0.94.3-openstack.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "7af7233baffe132c880d0f38308518de", "sha256": "af135cd635159359f2a5c4be9ba171fa2c4ba2a7f36e0bec9ffebab5a75cfd03" }, "downloads": -1, "filename": "StarCluster-openstack-0.94.2.tar.gz", "has_sig": false, "md5_digest": "7af7233baffe132c880d0f38308518de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2353924, "upload_time": "2013-10-18T04:11:22", "url": "https://files.pythonhosted.org/packages/73/df/7c8a10c8c7e77fa193d4788046147b7fe3f19c4d95610e15fa91b8872977/StarCluster-openstack-0.94.2.tar.gz" } ] }