https://github.com/larsks/novaconsole

https://github.com/larsks/novaconsole

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/larsks/novaconsole
• Owner: larsks
• License: apache-2.0
• Created: 2014-12-22T05:06:46.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2022-06-21T00:17:03.000Z (over 2 years ago)
• Last Synced: 2024-07-31T21:52:57.042Z (6 months ago)
• Language: Python
• Size: 20.5 KB
• Stars: 20
• Watchers: 6
• Forks: 10
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-ConoHa-cloud - github: This is a simple client for connecting to the remote serial console of an OpenStack Nova server

README

        
This is a simple client for connecting to the remote serial console of

an OpenStack Nova server, using the API implemented in the Juno release of

OpenStack.  You can read more about that support here:

- http://blog.oddbit.com/2014/12/22/accessing-the-serial-console-of-your-nova-servers/

## Usage

With valid OpenStack credentials (`OS_USERNAME`, `OS_PASSWORD`,

`OS_AUTH_URL`, etc) available in your environment, you can run

`novaconsole` with the name or UUID of a Nova server:

    $ novaconsole my-server

    WARNING:novaconsole.client:connected to: ws://127.0.0.1:6083/?token=bdcea854-2566-4f3b-86ef-4791aba42eea

    WARNING:novaconsole.client:type "~." to disconnect

You can also provide a websocket URL directly on the command line:

    $ novaconsole --url ws://127.0.0.1:6083/?token=bdcea854-2566-4f3b-86ef-4791aba42eea

    WARNING:novaconsole.client:connected to: ws://127.0.0.1:6083/?token=bdcea854-2566-4f3b-86ef-4791aba42eea

    WARNING:novaconsole.client:type "~." to disconnect

In either case, you will have an interactive connection to the serial

console of your Nova server.  You can type `~.` to disconnect.  If you

find that the `~` conflicts with something (for example, `~` is also

used as the default escape character by `ssh`), you can specify a new

escape character with `-e`:

    $ novaconsole -e@ my-server

    WARNING:novaconsole.client:connected to: ws://127.0.0.1:6083/?token=3fd11349-cd64-4dac-bbe0-68c49e9e1dc9

    WARNING:novaconsole.client:type "@." to disconnect

## Server configuration

For this to work, your server must be configured to support serial

console access.  This is a typical default for most "cloud" specific

images, which will include something like `console=tty0

console=ttyS0,11500n81` on the kernel command line.  This provides

console output on both the graphical (vnc) console and the serial

console, and takes input from the serial console.

## Installation

You can install the package with `pip`:

    pip install git+http://github.com/larsks/novaconsole.git

Or you can clone the repository by hand and run `setup.py`:

    git clone http://github.com/larsks/novaconsole.git

    cd novaconsole

    python setup.py install