Difference between revisions of "Getting Started"
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
= Getting Started with [[OpenStack]], Nova, and Swift = | = Getting Started with [[OpenStack]], Nova, and Swift = | ||
| − | |||
If you are new to [[OpenStack]], you will undoubtedly have questions about installation, deployment, and usage. It can seem really overwhelming! But don't fear, there are actually places to get information to guide you and to help resolve any issues you may run into during the on-ramp process. | If you are new to [[OpenStack]], you will undoubtedly have questions about installation, deployment, and usage. It can seem really overwhelming! But don't fear, there are actually places to get information to guide you and to help resolve any issues you may run into during the on-ramp process. | ||
| − | Be careful though. A LOT of content is being brought online because this is a new project with a very active community. So please be aware of of the creation time or last update for all information. If you are reading a document that is a few months old, and you feel that it isn't entirely accurate, then please let us know through the [https://launchpad.net/~openstack | + | Be careful though. A LOT of content is being brought online because this is a new project with a very active community. So please be aware of of the creation time or last update for all information. If you are reading a document that is a few months old, and you feel that it isn't entirely accurate, then please let us know through the [https://launchpad.net/~openstack mailing list] so it can be updated or removed. |
# Installation guides | # Installation guides | ||
| − | There are several sets of installation directions and scripts available. They have worked for many people, but your mileage may vary. It is best to consider them to be rough outlines or general guides for helping you deploy your own development or test environment. | + | |
| + | There are several sets of installation directions and scripts available. They have worked for many people, but your mileage may vary. It is best to consider them to be rough outlines or general guides for helping you deploy your own development or test environment. | ||
To help mitigate any issues you run into, please, please use the other resources listed on this document to help you get through the process. And hey, if you figure something out, please let us know, or contribute it back so we can help others. | To help mitigate any issues you run into, please, please use the other resources listed on this document to help you get through the process. And hey, if you figure something out, please let us know, or contribute it back so we can help others. | ||
| Line 13: | Line 13: | ||
Installation help can generally be found here: http://wiki.openstack.org/InstallInstructions | Installation help can generally be found here: http://wiki.openstack.org/InstallInstructions | ||
| − | + | # The Openstack Wiki search | |
Considering that you are already in the wiki, this may seem obvious. However, there are many layers of wiki content for Openstack below the surface that an enterprising individual can locate. | Considering that you are already in the wiki, this may seem obvious. However, there are many layers of wiki content for Openstack below the surface that an enterprising individual can locate. | ||
| Line 21: | Line 21: | ||
You can find the search box in the upper right hand corner of any Openstack wiki page. | You can find the search box in the upper right hand corner of any Openstack wiki page. | ||
| − | + | # The Launchpad Answers area | |
| − | During setup or testing, you may have questions about how to do something, or end up in a situation where you can't seem to get a feature to work correctly. One place to look for help is the Answers section on Launchpad. Launchpad is the "home" for the project code and its developers and thus is a natural place to ask about the project. | + | |
| + | During setup or testing, you may have questions about how to do something, or end up in a situation where you can't seem to get a feature to work correctly. One place to look for help is the Answers section on Launchpad. Launchpad is the "home" for the project code and its developers and thus is a natural place to ask about the project. | ||
When visiting the Answers section, it is usually good to at least scan over recently asked questions to see if your question has already been answered. If that is not the case, then proceed to adding a new question. Some tips: | When visiting the Answers section, it is usually good to at least scan over recently asked questions to see if your question has already been answered. If that is not the case, then proceed to adding a new question. Some tips: | ||
| − | + | * Give a clear, consise summary | |
| − | + | * Provide as much detail as possible in the description. Paste in your command output or stack traces, link to screenshots, etc. | |
| − | The Launchpad Answers areas are available here - | + | The Launchpad Answers areas are available here - Nova: https://answers.launchpad.net/nova Swift: https://answers.launchpad.net/swift |
| − | Nova: https://answers.launchpad.net/nova | + | |
| − | Swift: https://answers.launchpad.net/swift | + | # The Launchpad Bugs area |
| − | |||
So you think you've found a bug. That's great! Seriously, it is. The Openstack community values your setup and testing efforts and wants your feedback. To log a bug you must have a Launchpad account, so sign up at https://launchpad.net/+login if you do not already have a Launchpad ID. | So you think you've found a bug. That's great! Seriously, it is. The Openstack community values your setup and testing efforts and wants your feedback. To log a bug you must have a Launchpad account, so sign up at https://launchpad.net/+login if you do not already have a Launchpad ID. | ||
| Line 43: | Line 43: | ||
* Provide as much detail as possible in the description. Paste in your command output or stack traces, link to screenshots, etc. | * Provide as much detail as possible in the description. Paste in your command output or stack traces, link to screenshots, etc. | ||
* Be sure to include what version of the software you are using. This is especially critical if you are using a development branch eg. "Austin release" vs lp:nova rev.396. | * Be sure to include what version of the software you are using. This is especially critical if you are using a development branch eg. "Austin release" vs lp:nova rev.396. | ||
| − | * Any deployment specific info is helpful as well. eg. Ubuntu 10.04, multi-node install. | + | * Any deployment specific info is helpful as well. eg. Ubuntu 10.04, multi-node install. |
| − | The Launchpad Bugs areas are available here - | + | The Launchpad Bugs areas are available here - Nova: https://bugs.launchpad.net/nova Swift: https://bugs.launchpad.net/swift |
| − | Nova: https://bugs.launchpad.net/nova | ||
| − | Swift: https://bugs.launchpad.net/swift | ||
| − | + | # The Openstack IRC channel | |
| − | |||
| − | + | The Openstack community lives and breathes in the #openstack IRC channel on the Freenode network. You can come by to hang out, ask questions, or get immediate feedback for urgent and pressing issues. To get into the IRC channel you need to install an IRC client or use a browser-based client by going to http://webchat.freenode.net/. | |
| − | - | ||
| − | |||
| − | * * When you are in the IRC channel and want to share code or command output, the generally accepted method is to use a Paste Bin, the Openstack project has one at http://paste.openstack.org. Just paste your longer amounts of text or logs in the web form and you get a URL you can then paste into the channel. | + | - Colloquy (Mac OS X) http://colloquy.info/ - mIRC (Windows) http://www.mirc.com/ - XChat (Linux) |
| + | |||
| + | * * When you are in the IRC channel and want to share code or command output, the generally accepted method is to use a Paste Bin, the Openstack project has one at http://paste.openstack.org. Just paste your longer amounts of text or logs in the web form and you get a URL you can then paste into the channel. | ||
The Openstack IRC channel is: #openstack on irc.freenode.net | The Openstack IRC channel is: #openstack on irc.freenode.net | ||
| − | + | # [[OpenStack]] Mailing Lists | |
| − | |||
A great way to keep track of what is going on with [[OpenStack]] or to ask questions and communicate with other users is to join the available mailing lists. | A great way to keep track of what is going on with [[OpenStack]] or to ask questions and communicate with other users is to join the available mailing lists. | ||
You can sign up for the various [[OpenStack]] mailing lists here: http://wiki.openstack.org/MailingLists | You can sign up for the various [[OpenStack]] mailing lists here: http://wiki.openstack.org/MailingLists | ||
Revision as of 18:03, 12 November 2010
Getting Started with OpenStack, Nova, and Swift
If you are new to OpenStack, you will undoubtedly have questions about installation, deployment, and usage. It can seem really overwhelming! But don't fear, there are actually places to get information to guide you and to help resolve any issues you may run into during the on-ramp process.
Be careful though. A LOT of content is being brought online because this is a new project with a very active community. So please be aware of of the creation time or last update for all information. If you are reading a document that is a few months old, and you feel that it isn't entirely accurate, then please let us know through the mailing list so it can be updated or removed.
- Installation guides
There are several sets of installation directions and scripts available. They have worked for many people, but your mileage may vary. It is best to consider them to be rough outlines or general guides for helping you deploy your own development or test environment.
To help mitigate any issues you run into, please, please use the other resources listed on this document to help you get through the process. And hey, if you figure something out, please let us know, or contribute it back so we can help others.
Installation help can generally be found here: http://wiki.openstack.org/InstallInstructions
- The Openstack Wiki search
Considering that you are already in the wiki, this may seem obvious. However, there are many layers of wiki content for Openstack below the surface that an enterprising individual can locate.
The wiki search feature is very powerful in that it can do both searches by title and by content. If you are searching for specific information, say about "networking" or "api" for nova, you can find lots of content using the search feature. More is being added all the time, so be sure to check back often.
You can find the search box in the upper right hand corner of any Openstack wiki page.
- The Launchpad Answers area
During setup or testing, you may have questions about how to do something, or end up in a situation where you can't seem to get a feature to work correctly. One place to look for help is the Answers section on Launchpad. Launchpad is the "home" for the project code and its developers and thus is a natural place to ask about the project.
When visiting the Answers section, it is usually good to at least scan over recently asked questions to see if your question has already been answered. If that is not the case, then proceed to adding a new question. Some tips:
- Give a clear, consise summary
- Provide as much detail as possible in the description. Paste in your command output or stack traces, link to screenshots, etc.
The Launchpad Answers areas are available here - Nova: https://answers.launchpad.net/nova Swift: https://answers.launchpad.net/swift
- The Launchpad Bugs area
So you think you've found a bug. That's great! Seriously, it is. The Openstack community values your setup and testing efforts and wants your feedback. To log a bug you must have a Launchpad account, so sign up at https://launchpad.net/+login if you do not already have a Launchpad ID.
You can view existing bugs and report your bug in the Launchpad Bugs area. It is suggested that you first use the search facility to see if the bug you found has already been reported (or even better, already fixed). If it still seems like your bug is new or unreported then it is time to fill out a bug report.
Some tips:
- GIve a clear, consise summary!
- Provide as much detail as possible in the description. Paste in your command output or stack traces, link to screenshots, etc.
- Be sure to include what version of the software you are using. This is especially critical if you are using a development branch eg. "Austin release" vs lp:nova rev.396.
- Any deployment specific info is helpful as well. eg. Ubuntu 10.04, multi-node install.
The Launchpad Bugs areas are available here - Nova: https://bugs.launchpad.net/nova Swift: https://bugs.launchpad.net/swift
- The Openstack IRC channel
The Openstack community lives and breathes in the #openstack IRC channel on the Freenode network. You can come by to hang out, ask questions, or get immediate feedback for urgent and pressing issues. To get into the IRC channel you need to install an IRC client or use a browser-based client by going to http://webchat.freenode.net/.
- Colloquy (Mac OS X) http://colloquy.info/ - mIRC (Windows) http://www.mirc.com/ - XChat (Linux)
- * When you are in the IRC channel and want to share code or command output, the generally accepted method is to use a Paste Bin, the Openstack project has one at http://paste.openstack.org. Just paste your longer amounts of text or logs in the web form and you get a URL you can then paste into the channel.
The Openstack IRC channel is: #openstack on irc.freenode.net
- OpenStack Mailing Lists
A great way to keep track of what is going on with OpenStack or to ask questions and communicate with other users is to join the available mailing lists.
You can sign up for the various OpenStack mailing lists here: http://wiki.openstack.org/MailingLists
