Main Page: Difference between revisions

From bwCloud-OS
Jump to navigation Jump to search
← Older edit
VisualWikitext
Admin (talk | contribs)
Bureaucrats, Interface administrators, intern, Suppressors, Administrators, translationadmin, translator
736 edits
No edit summary
No edit summary
 
(48 intermediate revisions by 2 users not shown)
Line 3: Line 3:
Welcome to the '''bwCloud-OS User Wiki -''' the central guide to using the multi-region '''O'''pen'''S'''tack '''cloud''' shared across '''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.
Welcome to the '''bwCloud-OS User Wiki -''' the central guide to using the multi-region '''O'''pen'''S'''tack '''cloud''' shared across '''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.


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  and affiliated  projects is available on the [https://bwcloud-os.de/ bwCloud-OS website].
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  and related projects is available on the [https://bwcloud-os.de/ '''bwCloud-OS website'''].


If you need technical assistance beyond what is covered here, please open a support '''ticket''' via the [https://bw-support.scc.kit.edu/ bwSupportPortal].
If you need technical assistance beyond what is covered here, please open a support '''ticket''' via the [https://bw-support.scc.kit.edu/ '''bwSupportPortal'''].


== Quickstart ==
== Quickstart ==
<span id="Quickstart"></span>


<br>  
<br>  
Line 16: Line 17:
|content=
|content=
<ol>
<ol>
   <li>Go to the bwCloud-OS [https://bw-cloud.org/q/d Dashboard].</li>
   <li>Go to the bwCloud-OS [https://portal.bw-cloud.org/ Dashboard].</li>
   <li>Select '''bwIDM via OpenID Connect''' and click '''Sign In'''.</li>
   <li>Select '''bwIDM via OpenID Connect''' and click '''Sign In'''.</li>
   <li>Choose your home institution and log in with your university credentials.</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>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>
   <li>After login or registration, you will be redirected to the bwCloud-OS Dashboard.</li>
</ol>
</ol>
<br>For more details about registering, see [[Registration|here]].
<br>
See the [[Registration|Registration page]] for more details.
}}
}}


Line 31: Line 33:
|content=
|content=
<ol>
<ol>
   <li>Log in to the [https://bw-cloud.org/q/d Dashboard].</li>
   <li>Log in to the [https://portal.bw-cloud.org/ Dashboard].</li>
   <li>Go to <strong>Project → Compute → Key Pairs</strong>.</li>
   <li>Go to <strong>Project → Compute → Key Pairs</strong>.</li>
   <li>
   <li>
Line 42: Line 44:
   <li>Make sure the private key is securely stored and accessible on your local machine.</li>
   <li>Make sure the private key is securely stored and accessible on your local machine.</li>
</ol>
</ol>
<br>For help generating an SSH key, see our [[Quickstart: Store SSH key pair|SSH Key Pair Generation guide]].
<br>For help generating an SSH key, see our [[Guide: SSH#Key-Pair-Creation|SSH Guide]].
}}
}}


Line 56: Line 58:
     <ol type="a" style="margin-left: 1.5em;">
     <ol type="a" style="margin-left: 1.5em;">
       <li><strong>Details</strong>: Assign a name</li>
       <li><strong>Details</strong>: Assign a name</li>
       <li><strong>Source</strong>: Choose an image (e.g., Debian 12)</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>Flavor</strong>: Select a resource package (e.g., ''m1.small'')</li>
       <li><strong>Networks</strong>: Choose the network</li>
       <li><strong>Networks</strong>: Choose the appropriate  network</li>
       <li><strong>Key Pair</strong>: Select your SSH key</li> </ol>
       <li><strong>Key Pair</strong>: Select your SSH key</li> </ol>
   </li>
   </li>
   <li>Click <strong>Launch</strong> and wait for the instance to finish building and enter <strong>Running</strong> state.</li>
   <li>Click <strong>Launch</strong> and wait for the instance to finish building and enter <strong>Running</strong> state.</li>
</ol>
</ol>
<br>For full details on managing instances, see  the [[Instances (VMs)|Instances guide]].  
<br>For full details on managing instances, see  the [[Instances (VMs)|Instances page]].  
 
}}
}}


Line 72: Line 73:
|title=IV. Connect to Your VM
|title=IV. Connect to Your VM
|content=
|content=
<ol>
Connect to your VM via SSH from a terminal using the following command:
  <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;">
<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;
ssh -i /path/to/private-key &lt;user&gt;@&lt;address&gt;
</pre>
</pre>
<p>
<ul>
For Debian/Ubuntu images, the '''default username''' is <code>debian</code> or <code>ubuntu</code>. For other images, see our full  [[Images|Image Overview]].
<li>
</ol>
<code><user></code> is the default username, e.g. <code>ubuntu</code> for Ubuntu images. For other images, see the [[Images|Image Overview]].
</li>
<li>
<code><address></code> is the DNS name ([[Networks#FQDN|FQDN]]) or the public IP address of your running instance. Both can be found in the [https://portal.bw-cloud.org/ Dashboard], on the <strong>Instances</strong> page.
</li>
</ul>
</p>
</p>
 
<br>For (advanced) SSH connection methods, see our [[Guide: SSH|SSH Guide]].
}}
}}


== Theme Hub == 


== Topic Hub '''–''' Sections == 
<span id="Theme-Hub"></span>


* '''🔐''' '''[[Registration]]''' - Entitlements, regions
* '''🆔 [[Registration]]''' '''–''' Identity Management, Entitlements, Regions
* '''🖥️ [[Instances (VMs)]] -''' Launch VMs, connect (SSH), flavors
* '''🖥️ [[Instances (VMs)]] –''' Launching Virtual Machines (VMs), Access to VMs (SSH), Flavors, Images
* '''🌐 [[Networks]]''' - IPs, FQDN & DNS, networks
* '''🌐 [[Networks]]''' '''–''' IPs, FQDNs & DNS, Public and Private Networks
* '''🔒 [[Security]]''' - Security groups, SSL-certificates, security incidents
* '''[[Security|🛡️ Security]]''' '''–''' Open and Closed Ports, Security Groups, Security Incidents
* '''💾 [[Storage]]''' - Volumes, snapshots, backup
* '''💾 [[Storage]]''' '''–''' Volumes, Snapshots, Backups
* '''👥''' '''[[Projects & Quota]]''' - Projects, group management, quota change
* '''👥''' '''[[Projects and Quota|Projects & Quota]]''' '''–''' Projects, Group Management, Quota Changes
* '''⚙️ [[Automation & Tools]]''' - API access, automation tools
* '''⚙️ [[Programmatic Access and Automation|Automation]]''' '''–''' API Access, Automation Tools (e.g., Ansible, Terraform)


== Other Notes ==  
== Other Notes ==  


<ul style="list-style: none; padding-left: 0;">
<ul style="list-style: none; padding-left: 0;">
   <li>
   <li>
    '''[[Glossary]]''' - <span style="color: #444;">Key terms and concepts used in bwCloud-OS</span>
  '''📖 [[Glossary]]''' - <span style="color: #444;">Key Terms Used in bwCloud-OS</span>
   </li>
   </li>
</ul>
</ul>

Latest revision as of 18:04, 10 November 2025

bwCloud-OS User Wiki

Welcome to the bwCloud-OS User Wiki - the central guide to using the multi-region OpenStack cloud shared across 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.

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 and related 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.


See the Registration page for more details.


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. Make sure the private key is securely stored and accessible on your local machine.


For help generating an SSH key, see our SSH 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 appropriate network
    5. Key Pair: Select your SSH key
  2. Click Launch and wait for the instance to finish building and enter Running state.


For full details on managing instances, see the Instances page.


IV. Connect to Your VM ▼

Connect to your VM via SSH from a terminal using the following command: 

ssh -i /path/to/private-key <user>@<address>
  • <user> is the default username, e.g. ubuntu for Ubuntu images. For other images, see the Image Overview.
  • <address> is the DNS name (FQDN) or the public IP address of your running instance. Both can be found in the Dashboard, on the Instances page.


For (advanced) SSH connection methods, see our SSH Guide.


Topic Hub – Sections

  • 🆔 Registration – Identity Management, Entitlements, Regions
  • 🖥️ Instances (VMs) – Launching Virtual Machines (VMs), Access to VMs (SSH), Flavors, Images
  • 🌐 Networks – IPs, FQDNs & DNS, Public and Private Networks
  • 🛡️ Security – Open and Closed Ports, Security Groups, Security Incidents
  • 💾 Storage – Volumes, Snapshots, Backups
  • 👥 Projects & Quota – Projects, Group Management, Quota Changes
  • ⚙️ Automation – API Access, Automation Tools (e.g., Ansible, Terraform)

Other Notes

  • 📖 Glossary - Key Terms Used in bwCloud-OS
Retrieved from "https://wiki.bwcloud-os.de/index.php?title=Main_Page&oldid=1508"