Main Page: Difference between revisions

From bwCloud-OS
Jump to navigation Jump to search
← Older editNewer edit →
VisualWikitext
Admin (talk | contribs)
Bureaucrats, Interface administrators, intern, Suppressors, Administrators, translationadmin, translator
736 edits
No edit summary
Admin (talk | contribs)
Bureaucrats, Interface administrators, intern, Suppressors, Administrators, translationadmin, translator
736 edits
No edit summary
Line 1: Line 1:
= bwCloud-OS wiki =
_NOTOC_
__NOTOC__


= bwCloud-OS User Wiki =
Welcome to the '''bwCloud-OS User Wiki''' — the central knowledge base for using the multi-region '''O'''pen'''S'''tack '''cloud''' shared across the state of '''B'''aden-'''W'''ürttemberg, Germany. This cloud is jointly operated by the universities of Freiburg, Karlsruhe, Mannheim, and Ulm, and is available  to users from all participating educational institutions in the state.


This wiki is primarily designed to answer '''frequently asked questions (FAQs)''' and provide '''practical guidance''' for common tasks when using the bwCloud-OS service. General information about the bwCloud-OS service and affiliated  projects is available on the [https://bwcloud-os.de/ bwCloud-OS website].


Welcome to the '''bwCloud-OS User Wiki''' — the central knowledge base for using the multi-region '''O'''pen'''S'''tack cloud shared across the state of '''B'''aden-'''W'''ürttemberg, Germany.
If you need technical assistance beyond what is covered here, please open a support '''ticket''' via the [https://bw-support.scc.kit.edu/ bwSupportPortal].


The cloud is jointly operated by the universities of '''Freiburg''', '''Karlsruhe''', '''Mannheim''', and '''Ulm''', and is available for use by '''all participating educational institutions''' throughout the state.
== Quickstart ==
<hr style="border: 1px solid #1e3a8a;">


General information about the bwCloud-OS service and the bwCloud3 project is available on our [https://bwcloud-os.de/ website]. Technical support is available on the [https://bw-support.scc.kit.edu support portal].
<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; padding: 0.5em 1em; margin: 1em 0;">
<strong>I. Register and/or Log in</strong>
<div class="mw-collapsible-content" style="margin-top: 0.5em;"><ol>
  <li>Go to the bwCloud-OS [https://bw-cloud.org/q/d Dashboard].</li>
  <li>Select <strong>bwIDM via OpenID Connect</strong> and click '''Sign In'''.</li>
  <li>Choose your home institution and log in with your university credentials.</li>
  <li>If logging in for the first time: register for <strong>bwCloud SCOPE</strong> by accepting the terms of use.</li>
  <li>After login or registration, you will be redirected to the bwCloud-OS Dashboard.</li>
</ol>
</div>
</div>


= Quickstart =
<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; padding: 0.5em 1em; margin: 1em 0;">
'''Create VM'''
<strong>II. Upload or Create an SSH Key</strong>
# Log in to the [https://dashboard.bw-cloud.org bwCloud-OS Dashboard] and select the desired '''Region''' in the top left corner.  
<div class="mw-collapsible-content" style="margin-top: 0.5em;">
# Under ''Compute → Key Pairs'', make sure you have a key uploaded '''or''' create a new key pair.
<ol>
# Go to ''Compute → Instances → Launch Instance'' and fill out the tabs one by one:
  <li>Log in to the [https://bw-cloud.org/q/d Dashboard].</li>
## '''Details:''' Assign a name.
  <li>Go to <strong>Project → Compute → Key Pairs</strong>.</li>
## '''Source:''' Choose an [[Images|Image]] (e.g. Debian 12).
  <li>
## '''Flavor:''' Select a [[bwCloud-OS Provided-Flavors|Hardware Flavor]] (e.g. <code>m1.small</code>).
    Choose one of the following options:
## '''Networks:''' Select the appropriate [[Network Overview|network]].
    <ul>
## '''Key Pairs:''' Choose your [[Quickstart: Store SSH key pair|SSH key pair]].
      <li><strong>To import an existing key</strong>: Click <strong>Import Public Key</strong>, enter a name, , select <strong>SSH Key</strong> type, and upload your '''''public''''' SSH key. Then click <strong>Import</strong>.</li>
## Click ''Launch''.
      <li><strong>To create a new key pair</strong>: Click <strong>Create Key Pair</strong>, enter a name, select <strong>SSH Key</strong> type, and click <strong>Create</strong>. The private key will be downloaded automatically.</li>
# Connect: <code>ssh -i /path/to/private-key &#x3C;user&#x3E;@&#x3C;IP-address&#x3E;</code> (for Debian/Ubuntu: user <code>debian</code> or <code>ubuntu</code>). Username overview [[Images|here]].  
    </ul>
= Theme-Hub =
  </li>
; [[Registration|Registration]]
  <li>Ensure you have access to the private key on your local machine.</li>
: entitlements, region
</ol>
;  [[Instances (VMs)|Instances (VMs)]]
For help generating an SSH key, see our '''[[Quickstart: Store SSH key pair|SSH Key Pair Generation guide]].'''
: start VMs, connect (SSH), images/flavors, snapshots
; [[Network & Security|Network & Security]]
: floating-IP, security groups, networks/router, DNS/FQDN
; [[Storage|Storage]]
: volumes, performance, backups
; [[(Group-)Projects & Quota|(Group-)Projects & Quota]]
: apply, roles, entitlements, group projects
; [[Automation & Tools|Automation & Tools]]
: Ansible, API-access


</div>
</div>


== Other Notes ==
<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; padding: 0.5em 1em; margin: 1em 0;">
; Network/Ports
<strong>III. Launch a Virtual Machine</strong>
: see [[Reference: Network – blocked/allowed ports.]].
<div class="mw-collapsible-content" style="margin-top: 0.5em;">
; Support
<ol>
: [https://bw-support.scc.kit.edu Support: open ticket]
  <li>
; Terms
    Go to <strong>Compute → Instances → Launch Instance</strong> and fill out the tabs:
: [[Glossary|Glossary]]<nowiki/>  
    <ol type="a" style="margin-left: 1.5em;">
:
      <li><strong>Details</strong>: Assign a name</li>
      <li><strong>Source</strong>: Choose an image (e.g., Debian 12)</li>
      <li><strong>Flavor</strong>: Select a resource package (e.g., m1.small)</li>
      <li><strong>Networks</strong>: Choose the network</li>
      <li><strong>Key Pair</strong>: Select your SSH key</li> </ol>
  </li>
  <li>Click <strong>Launch</strong> and wait for the instance to finish building and enter <strong>Running</strong> state.</li>
</ol>
</div>
</div>
 
<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; padding: 0.5em 1em; margin: 1em 0;">
<strong>IV. Connect to Your VM</strong>
<div class="mw-collapsible-content" style="margin-top: 0.5em;">
<ol>
  <li>Find the '''''public''''' IP address of your running instance in the <strong>Instances</strong> overview.</li>
  <li>Connect via SSH from your terminal using the following command:</li>
 
<pre style="background-color: #f9f9f9; border: 1px solid #ccc; padding: 0.5em;">
ssh -i /path/to/private-key &lt;user&gt;@&lt;IP-address&gt;
</pre>
<p>
For Debian/Ubuntu images, the '''default username''' is <code>debian</code> or <code>ubuntu</code>. See our full  '''[[Images|Username Overview]]''' for other images.
</ol>
</p>
</div>
</div>
 
== Theme Hub == 
<hr style="border: 1px solid #1e3a8a;">
 
* '''🔐''' '''[[Registration]]''' - Entitlements, region selection
* '''🖥️ [[Instances (VMs)]] -''' Start VMs, connect (SSH), flavors, images, snapshots
* '''🌐 [[Network & Security]]''' - IPs, DNS & FQDN, networks, routers, security groups
* '''💾 [[Storage]]''' - Volumes, backups, performance
* '''👥''' '''[[(Group-)Projects & Quota]]''' - Projects, group management, quota change
* '''⚙️ [[Automation & Tools]]''' - Ansible, API access
 
== Other Notes ==
<hr style="border: 1px solid #1e3a8a;">
 
<ul style="list-style: none; padding-left: 0;">
  <li>
    '''[[Glossary]]''' - <span style="color: #444;">Key terms and concepts used in bwCloud-OS</span>
  </li>
</ul>

Revision as of 08:18, 15 October 2025

_NOTOC_

bwCloud-OS User Wiki

Welcome to the bwCloud-OS User Wiki — the central knowledge base for using the multi-region OpenStack cloud shared across the state of Baden-Württemberg, Germany. This cloud is jointly operated by the universities of Freiburg, Karlsruhe, Mannheim, and Ulm, and is available to users from all participating educational institutions in the state.

This wiki is primarily designed to answer frequently asked questions (FAQs) and provide practical guidance for common tasks when using the bwCloud-OS service. General information about the bwCloud-OS service and affiliated projects is available on the bwCloud-OS website.

If you need technical assistance beyond what is covered here, please open a support ticket via the bwSupportPortal.

Quickstart

I. Register and/or Log in

  1. Go to the bwCloud-OS Dashboard.
  2. Select bwIDM via OpenID Connect and click Sign In.
  3. Choose your home institution and log in with your university credentials.
  4. If logging in for the first time: register for bwCloud SCOPE by accepting the terms of use.
  5. After login or registration, you will be redirected to the bwCloud-OS Dashboard.

II. Upload or Create an SSH Key

  1. Log in to the Dashboard.
  2. Go to Project → Compute → Key Pairs.
  3. Choose one of the following options:
    • To import an existing key: Click Import Public Key, enter a name, , select SSH Key type, and upload your public SSH key. Then click Import.
    • To create a new key pair: Click Create Key Pair, enter a name, select SSH Key type, and click Create. The private key will be downloaded automatically.
  4. Ensure you have access to the private key on your local machine.

For help generating an SSH key, see our SSH Key Pair Generation guide.

III. Launch a Virtual Machine

  1. Go to Compute → Instances → Launch Instance and fill out the tabs:
    1. Details: Assign a name
    2. Source: Choose an image (e.g., Debian 12)
    3. Flavor: Select a resource package (e.g., m1.small)
    4. Networks: Choose the network
    5. Key Pair: Select your SSH key
  2. Click Launch and wait for the instance to finish building and enter Running state.

IV. Connect to Your VM

  1. Find the public IP address of your running instance in the Instances overview.
  2. Connect via SSH from your terminal using the following command:
    3. ssh -i /path/to/private-key <user>@<IP-address>

    For Debian/Ubuntu images, the default username is debian or ubuntu. See our full Username Overview for other images.

Theme Hub

Other Notes

  • Glossary - Key terms and concepts used in bwCloud-OS
Retrieved from "https://wiki.bwcloud-os.de/index.php?title=Main_Page&oldid=572"