Project

spacewalk

0.0
No commit activity in last 3 years
No release in over 3 years
Can be used for testing or to attach 'foreign' systems
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
 Project Readme

About Spacewalk

DESCRIPTION

Spacewalk is a pure-Ruby implementation of the Spacewalk client protocol stack.

COMMANDS

The bin subdir contains a couple of commands to simulate a client talking to the Spacewalk server.

Command options

All commands have the following options in common

  • --server <spacewalk-url> to specify the full url of the spacewalk server
    • Example: --server http://spacewalk.opensuse.org

Registration

The register_remote fakes a registration of a client system and stores the system_id as a file with the system name.

Synopsis

register_remote <options> <client-system-name>

Possible <options>:

  • --server <spacewalk-url> - required, specifies the spacewalk server
  • --key <activation-key> - requires, specifies the activation key
  • --packages - optional, upload locally installed packages
  • --description <text> - optional, a text line to identify the system
  • --arch <arch> - optional, to simulate different architectures

Registration example

ruby register_remote.rb --server https://spacewalk.opensuse.org --key 1-default --packages --description "Fake registration" --arch x86_64 my.system.com

Actions

The actions command pulls pending actions from the server and outputs matching CFEngine promises. Actions are then marked as 'successful'.

If --future <hours> is given, actions are not marked and will stay pending in the server.

Synopsis

actions <options> <client-system-name>

Possible <options>:

  • --server <spacewalk-url> - required, specifies the spacewalk server
  • --future <hours> - optional, returns future actions

Actions example

ruby actions.rb --server https://spacewalk.opensuse.org --future 1 my.system.com

Action results

submit is a helper tool to submit action results back to the server. This can be used for actions marked as 'in progress', waiting for the client to submit a final result.

Synopsis

submit <options> <client-system-name>

Possible <options>:

  • --server <spacewalk-url> - required, specifies the spacewalk server
  • --action <action_id> - required, the id of the action
  • --message <text> - optional, text information about the result
  • --result <exit-code> - optional, exit code of a command

Action results examples

ruby submit.rb --server https://spacewalk.opensuse.org --action 6434 --message "Leider kaputt" --result "0" my.system.com

REQUIREMENTS

  • Ruby

INSTALL

  • sudo gem install spacewalk

LICENSE:

(The Ruby License)

Copyright (c) 2011-2014 SUSE Linux Products GmbH

See http://www.ruby-lang.org/en/LICENSE.txt for the full text