Revision 4c3bae3b

b/COPYRIGHT
1 
Copyright 2011-2012 GRNET S.A. All rights reserved.
1 
Copyright 2011-2013 GRNET S.A. All rights reserved.
2 2 

  		





  3
  3
  
    
Redistribution and use in source and binary forms, with or


  		





  4
  4
  
    
without modification, are permitted provided that the following


  		












  

    
      b/README.Upgrade
    
  






  
  1
  
    
This document describes changes and steps to upgrade from kamaki 0.7.X to kamaki 0.8


  		





  
  2
  
    

  		





  
  3
  
    
This document refers to users who:


  		





  
  4
  
    
- use the kamaki command line


  		





  
  5
  
    
- load configuration options with the kamaki.cli.config


  		





  
  6
  
    

  		





  
  7
  
    
Notable changes:


  		





  
  8
  
    
- Make progress (>= 1.1) module a requirement (was a suggestion)


  		





  
  9
  
    
- Rename some command groups:


  		





  
  10
  
    
    store --> file


  		





  
  11
  
    
    astakos --> user


  		





  
  12
  
    
- Rename some mandatory configuration options:


  		





  
  13
  
    
    astakos.url --> user.url,


  		





  
  14
  
    
    store.url --> file.url


  		





  
  15
  
    
- Do not require <cmd group>.cli (cli specification) field in configuration file, use it only to override default values.


  		





  
  16
  
    
- Change the naming convention for cli specifications by loosing the _cli suffix:


  		





  
  17
  
    
    <cmd group>_cli --> <cmd group>


  		





  
  18
  
    
- Seperate kamaki image commands based on whether they make requests to Plankton or Cyclades.


  		





  
  19
  
    
    Plankton image commands: kamaki image <action>


  		





  
  20
  
    
    Cyclades image commands: kamaki image compute <action>


  		





  
  21
  
    
- Rename: kamaki image public --> kamaki image list


  		





  
  22
  
    
- Change letter case for recursive download runtime argument:


  		





  
  23
  
    
    kamaki store download -r <container>:<path> [local destination]


  		





  
  24
  
    
    -->


  		





  
  25
  
    
    kamaki file download -R <container>:<path> [local destination]


  		





  
  26
  
    

  		





  
  27
  
    

  		





  
  28
  
    
Suggested upgrade method:


  		





  
  29
  
    
1. Backup the .kamakirc file (usually stored as ~/.kamakirc). E.g.:


  		





  
  30
  
    
    cp ~/.kamakirc ~/tmp/.kamakirc.bu


  		





  
  31
  
    
2. Upgrade kamaki (refer to your installation method). E.g. if installed from pypi:


  		





  
  32
  
    
    pip install --upgrade kamaki


  		





  
  33
  
    
3. Download the script bellow:


  		





  
  34
  
    
    For Linux, OS X, *nix, systems that run bash:


  		





  
  35
  
    
        https://code.grnet.gr/attachments/download/2493/kamaki0.7to0.8.sh


  		





  
  36
  
    
    For windows:


  		





  
  37
  
    
        https://code.grnet.gr/attachments/download/2497/kamaki0.7to0.8.bat


  		





  
  38
  
    
and run it from command line. This script will modify the default .kamakirc file in order to comply with version 0.8


  		












  

    
      b/README.rst
    
  






  3
  3
  
    

  		





  4
  4
  
    
./kamaki is a simple, yet intuitive, command-line tool/interactive shell for managing clouds.


  		





  5
  5
  
    

  		





  6
  
  
    
It is an initial implementation of the OpenStack Compute API, v1.1, with custom


  		





  7
  
  
    
extensions specific to the Synnefo IaaS cloud management software.


  		





  
  6
  
    
It is an initial implementation of the OpenStack Compute API v1.1, with custom


  		





  
  7
  
    
extensions specific to the Synnefo IaaS (www.synnefo.org) cloud management software.


  		












  

    
      b/setup.py
    
  






  50
  50
  
    
setup(


  		





  51
  51
  
    
    name='kamaki',


  		





  52
  52
  
    
    version=kamaki.__version__,


  		





  53
  
  
    
    description='A command-line tool for managing clouds',


  		





  
  53
  
    
    description='A command-line tool for managing www.synnefo.org clouds',


  		





  54
  54
  
    
    long_description=open('README.rst').read(),


  		





  55
  55
  
    
    url='http://code.grnet.gr/projects/kamaki',


  		





  
  56
  
    
    download_url='https://code.grnet.gr/projects/kamaki/files',


  		





  56
  57
  
    
    license='BSD',


  		





  57
  58
  
    
    author='Synnefo development team',


  		





  58
  59
  
    
    author_email='synnefo-devel@googlegroups.com',


  		





  ......




  72
  73
  
    
        'kamaki.clients.compute',


  		





  73
  74
  
    
        'kamaki.clients.cyclades',


  		





  74
  75
  
    
    ],


  		





  
  76
  
    
    classifiers=[


  		





  
  77
  
    
        'Operating System :: OS Independent',


  		





  
  78
  
    
        'Programming Language :: Python :: 2.6',


  		





  
  79
  
    
        'Programming Language :: Python :: 2.7',


  		





  
  80
  
    
        'Intended Audience :: Developers',


  		





  
  81
  
    
        'Intended Audience :: System Administrators',


  		





  
  82
  
    
        'Environment :: Console',


  		





  
  83
  
    
        'License :: OSI Approved :: BSD License',


  		





  
  84
  
    
        'Natural Language :: English',


  		





  
  85
  
    
        'Topic :: System :: Shells',


  		





  
  86
  
    
        'Topic :: Software Development :: Libraries :: Python Modules',


  		





  
  87
  
    
        'Topic :: Utilities'


  		





  
  88
  
    
        ],


  		





  75
  89
  
    
    include_package_data=True,


  		





  76
  90
  
    
    entry_points={


  		





  77
  91
  
    
        'console_scripts': ['kamaki = kamaki.cli:main']


  		












Also available in:
  Unified diff