Synnefo » ./kamaki

.TH "KAMAKI" "1" "December 16, 2013" "0.12" "Kamaki"

.SH NAME

kamaki \- Command-line tool for managing clouds

.

.nr rst2man-indent-level 0

.

.de1 rstReportMargin

\\$1 \\n[an-margin]

level \\n[rst2man-indent-level]

level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]

-

\\n[rst2man-indent0]

\\n[rst2man-indent1]

\\n[rst2man-indent2]

..

.de1 INDENT

.\" .rstReportMargin pre:

. RS \\$1

. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]

. nr rst2man-indent-level +1

.\" .rstReportMargin post:

..

.de UNINDENT

. RE

.\" indent \\n[an-margin]

.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]

.nr rst2man-indent-level -1

.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]

.in \\n[rst2man-indent\\n[rst2man-indent-level]]u

..

.\" Man page generated from reStructeredText.

.

.SH SYNOPSIS

.sp

\fBkamaki\fP [\fIgroup\fP] [\fIcommand\fP] [...] [\fIoptions\fP] [\fIarguments\fP]

\fBkamaki\-shell\fP [\fIgroup\fP] [\fIcommand\fP] [...] [\fIarguments\fP]

.SH DESCRIPTION

.sp

\fBkamaki\fP is a simple, yet intuitive, command\-line tool for managing

clouds. It can be used in three forms: as an interactive shell

(\fIkamaki\-shell\fP), as a command line tool (\fIkamaki\fP) or as a clients API for

other applications (\fIkamaki.clients\fP).

.sp

To run \fIkamaki\fP as an interactive shell, type

.INDENT 0.0

.INDENT 3.5

kamaki\-shell

.UNINDENT

.UNINDENT

.sp

To run \fIkamaki\fP as tool type

.INDENT 0.0

.INDENT 3.5

kamaki <group> <command> [...] [options]

.UNINDENT

.UNINDENT

.sp

The kamaki clients API can be imported in python applications as

\fIkamaki.clients\fP

.sp

List of available command groups:

.INDENT 0.0

.TP

.B user

Astakos/Identity API commands

.TP

.B project

Astakos project API commands

.TP

.B quota

Astakos/Account API commands for quotas

.TP

.B resource

Astakos/Account API commands for resources

.TP

.B file

Pithos+/Storage object level API commands

.TP

.B container

Pithos+/Storage container level API commands

.TP

.B group

Pithos+/Storage user groups

.TP

.B sharer

Pithos+/Storage sharer accounts

.TP

.B server

Cyclades/Compute API server commands

.TP

.B flavor

Cyclades/Compute API flavor commands

.TP

.B image

Cyclades/Plankton API image commands

.TP

.B imagecompute

Cyclades/Compute API image commands

.TP

.B network

Networking API network commands

.TP

.B subnet

Networking API network commands

.TP

.B ip

Networking API floatingip commands

.TP

.B port

Networking API network Commands

.TP

.B config

Kamaki option and cloud configuration

.TP

.B history

Kamaki command history

.UNINDENT

.SH HIDDEN COMMAND GROUPS

.INDENT 0.0

.TP

.B livetest

Live tests that check kamaki against running services. To enable:

kamaki config set livetest.cli livetest

.TP

.B service

Astakos API service commands

.TP

.B endpoint

Astakos API endpoints commands

.TP

.B commission

Astakos API commission commands

.UNINDENT

.SH OPTIONS

.sp

.nf

.ft C

\-\-help, \-h              Show help message and exit.

\-v                      Use verbose output.

\-d                      Use debug output.

\-o KEY=VAL              Override a config value (can be repeated)

\-\-cloud CLOUD           Choose a cloud to connect to

.ft P

.fi

.SH COMMANDS

.SS user

.INDENT 0.0

.IP \(bu 2

authenticate  Authenticate a user, show user information

.IP \(bu 2

info          Get info for (current) session user

.IP \(bu 2

uuid2name     Get user name(s) from uuid(s)

.IP \(bu 2

authenticate  Authenticate a user and get all authentication information

.IP \(bu 2

list          List (cached) session users

.IP \(bu 2

add           Authenticate a user by token and add to kamaki session (cache)

.IP \(bu 2

name2uuid     Get user uuid(s) from name(s)

.IP \(bu 2

select        Select a user from the (cached) list as the current session user

.IP \(bu 2

delete        Delete a user (token) from the (cached) list of session users

.UNINDENT

.SS project

.INDENT 0.0

.IP \(bu 2

info          Get details for a project

.IP \(bu 2

unsuspend     Resume a suspended project (special privileges needed)

.IP \(bu 2

suspend       Suspend a project (special privileges needed)

.IP \(bu 2

list          List all projects

.IP \(bu 2

create        Apply for a new project

.IP \(bu 2

modify        Modify a project

.IP \(bu 2

terminate     Terminate a project (special privileges needed)

.IP \(bu 2

application   Application management commands

.IP \(bu 2

membership    Project membership management commands

.IP \(bu 2

reinstate     Reinstate a terminated project (special privileges needed)

.UNINDENT

.SS quota

.INDENT 0.0

.IP \(bu 2

list          Get user quotas

.IP \(bu 2

info          Get quota for a service (cyclades, pithos, astakos)

.UNINDENT

.SS resource

.INDENT 0.0

.IP \(bu 2

list          List user resources

.UNINDENT

.SS file

.INDENT 0.0

.IP \(bu 2

info      Get information/details about a file

.IP \(bu 2

truncate  Truncate remote file up to size

.IP \(bu 2

mkdir     Create a directory ( create \-\-content\-type=\(aqapplcation/directory\(aq )

.IP \(bu 2

create    Create an empty file

.IP \(bu 2

move      Move objects, even between different accounts or containers

.IP \(bu 2

list      List all objects in a container or a directory object

.IP \(bu 2

upload    Upload a file

.IP \(bu 2

cat       Fetch remote file contents

.IP \(bu 2

modify    Modify the attributes of a file or directory object

.IP \(bu 2

append    Append local file to (existing) remote object

.IP \(bu 2

download  Download a remove file or directory object to local file system

.IP \(bu 2

copy      Copy objects, even between different accounts or containers

.IP \(bu 2

overwrite Overwrite part of a remote file

.IP \(bu 2

delete    Delete a file or directory object

.UNINDENT

.SS container

.INDENT 0.0

.IP \(bu 2

info      Get information about a container

.IP \(bu 2

modify    Modify the properties of a container

.IP \(bu 2

create    Create a new container

.IP \(bu 2

list      List all containers, or their contents

.IP \(bu 2

empty     Empty a container

.IP \(bu 2

delete    Delete a container

.UNINDENT

.SS group

.INDENT 0.0

.IP \(bu 2

create    Create a group of users

.IP \(bu 2

list      List all groups and group members

.IP \(bu 2

delete    Delete a user group

.UNINDENT

.SS sharer

.INDENT 0.0

.IP \(bu 2

info      Details on a Pithos+ sharer account (default: current account)

.IP \(bu 2

list      List accounts who share file objects with current user

.UNINDENT

.SS server

.INDENT 0.0

.IP \(bu 2

info      Detailed information on a Virtual Machine

.IP \(bu 2

modify    Modify attributes of a virtual server

.IP \(bu 2

create    Create a server (aka Virtual Machine)

.IP \(bu 2

list      List virtual servers accessible by user

.IP \(bu 2

reboot    Reboot a virtual server

.IP \(bu 2

start     Start an existing virtual server

.IP \(bu 2

shutdown  Shutdown an active virtual server

.IP \(bu 2

delete    Delete a virtual server

.IP \(bu 2

wait      Wait for server to finish [BUILD, STOPPED, REBOOT, ACTIVE]

.UNINDENT

.SS flavor

.INDENT 0.0

.IP \(bu 2

list       list flavors

.IP \(bu 2

info       get flavor details

.UNINDENT

.SS image

.INDENT 0.0

.IP \(bu 2

info          Get image metadata

.IP \(bu 2

list          List images accessible by user

.IP \(bu 2

register      (Re)Register an image file to an Image service

.IP \(bu 2

modify        Add / update metadata and properties for an image

.IP \(bu 2

unregister    Unregister an image (does not delete the image file)

.UNINDENT

.SS imagecompute

.INDENT 0.0

.IP \(bu 2

info      Get detailed information on an image

.IP \(bu 2

list      List images

.IP \(bu 2

modify    Modify image properties (metadata)

.IP \(bu 2

delete    Delete an image (WARNING: image file is also removed)

.UNINDENT

.SS network

.INDENT 0.0

.IP \(bu 2

info: Get details about a network

.IP \(bu 2

disconnect: Disconnect a network from a device

.IP \(bu 2

modify: Modify network attributes

.IP \(bu 2

create: Create a new network

.IP \(bu 2

list: List networks

.IP \(bu 2

connect: Connect a network with a device (server or router)

.IP \(bu 2

delete: Delete a network

.UNINDENT

.SS subnet

.INDENT 0.0

.IP \(bu 2

info      Get details about a subnet

.IP \(bu 2

list      List subnets

.IP \(bu 2

create    Create a new subnet

.IP \(bu 2

modify    Modify the attributes of a subnet

.UNINDENT

.SS ip

.INDENT 0.0

.IP \(bu 2

info      Details for an IP

.IP \(bu 2

list      List reserved floating IPs

.IP \(bu 2

attach    Attach a floating IP to a server

.IP \(bu 2

pools     List pools of floating IPs

.IP \(bu 2

release   Release a floating IP

.IP \(bu 2

detach    Detach a floating IP from a server

.IP \(bu 2

reserve   Reserve a floating IP

.UNINDENT

.SS port

.INDENT 0.0

.IP \(bu 2

info      Get details about a port

.IP \(bu 2

list      List all ports

.IP \(bu 2

create    Create a new port (== connect server to network)

.IP \(bu 2

modify    Modify the attributes of a port

.IP \(bu 2

delete    Delete a port (== disconnect server from network)

.IP \(bu 2

wait      Wait for port to finish [ACTIVE, DOWN, BUILD, ERROR]

.UNINDENT

.SS config

.INDENT 0.0

.IP \(bu 2

list       list configuration options

.IP \(bu 2

get        get a configuration option

.IP \(bu 2

set        set a configuration option

.IP \(bu 2

del        delete a configuration option

.UNINDENT

.SS history

.sp

Command user history, as stored in ~/.kamaki.history

.INDENT 0.0

.IP \(bu 2

show      show intersession history

.IP \(bu 2

clean     clean up history

.IP \(bu 2

run       run/show previously executed command(s)

.UNINDENT

.SS livetest (hidden)

.INDENT 0.0

.IP \(bu 2

all         test all clients

.IP \(bu 2

args        test how arguments are treated by kamaki

.IP \(bu 2

astakos     test Astakos client

.IP \(bu 2

cyclades    test Cyclades client

.IP \(bu 2

error       Create an error message with optional message

.IP \(bu 2

image       test Image client

.IP \(bu 2

pithos      test Pithos client

.IP \(bu 2

prints      user\-test print methods for lists and dicts

.UNINDENT

.SS service (hidden)

.INDENT 0.0

.IP \(bu 2

list          List available services

.IP \(bu 2

uuid2username Get service username(s) from uuid(s)

.IP \(bu 2

quotas        Get service quotas

.IP \(bu 2

username2uuid Get service uuid(s) from username(s)

.UNINDENT

.SS endpoint (hidden)

.INDENT 0.0

.IP \(bu 2

list      Get endpoints service endpoints

.UNINDENT

.SS commission (hidden)

.INDENT 0.0

.IP \(bu 2

info      Get commission info (special privileges required)

.IP \(bu 2

resolve   Resolve multiple commissions (special privileges required)

.IP \(bu 2

accept    Accept a pending commission  (special privileges required)

.IP \(bu 2

reject    Reject a pending commission (special privileges required)

.IP \(bu 2

issue     Issue commissions as a json string (special privileges required)

.IP \(bu 2

pending   List pending commissions (special privileges required)

.UNINDENT

.SH AUTHOR

.sp

Synnefo development team <\fI\%synnefo-devel@googlegroups.com\fP>.

.SH COPYRIGHT

2013, GRNET

.\" Generated by docutils manpage writer.

.\" 

.