Jump to: navigation, search

Difference between revisions of "Documentation/InstallGuideChanges"

Line 113: Line 113:
 
7 Add the dashboard
 
7 Add the dashboard
 
:# When complete, jump to launch an instance or continue configuring additional services. We could launch an instance before the dashboard, but I think people feel GUIs provide a more polished experience. If we feel the dashboard is important, we should include screen shots for creating and launching an instance.
 
:# When complete, jump to launch an instance or continue configuring additional services. We could launch an instance before the dashboard, but I think people feel GUIs provide a more polished experience. If we feel the dashboard is important, we should include screen shots for creating and launching an instance.
 +
:# Note that Cinder is required for the Dashboard to work
  
 
8 Add the Block Storage Service
 
8 Add the Block Storage Service

Revision as of 23:44, 7 February 2014

The new OpenStack Networking Guide will be taking content from the Install and Cloud Admin Guides, which means the content of those two guides is going to be "beefed up" to provide more context for users so that they get a good understanding of what's going on, rather than just a series of steps. We are also considering moving nova-network to be with Neutron, rather than Nova. This is the target outline, of the relevant chapters.

NOTE: this is the current version, put here as a reference for us to work from.

Preface

Document change history

1 Architecture

  1. Conceptual architecture
  2. Logical architecture
  3. Example architectures

2 Basic operating system configuration

  1. Before you begin
  2. Networking
  3. Network Time Protocol (NTP)
  4. Passwords
  5. MySQL database
  6. OpenStack packages
  7. Messaging server

3 Configure the Identity Service

4 Configure the Image Service

5 Configure Compute services

  1. Compute service
  2. Install Compute controller services
  3. Configure a Compute node
  4. Enable Networking
  5. Launch an instance

6 Add the dashboard

7 Add the Block Storage Service

8 Add Object Storage

9 Install the Networking service

  1. Networking considerations
  2. Neutron concepts
  3. Install Networking services
  4. Neutron deployment use cases

10 Add the Orchestration service

11 Add the Telemetry service

Proposed changes

Preface

Document change history

1 Architecture

  1. Conceptual architecture
  1. Provide general explanation of "core" nodes... controller, network, and compute.
  2. Provide general explaination of "additional" nodes... storage.
  3. Explain general hardware requirements of nodes... cpu, disk, and memory.
  1. Example core architectures
  1. Two-node with Nova networking (two interfaces per node)
  1. Provide diagrams containing services on each node and physical/logical connectivity (e.g., network interfaces with usable IP addresses)
  1. Three-node with Neutron networking (two interfaces per node except network which has three)
  1. Provide diagrams containing services on each node and physical/logical connectivity (e.g., network interfaces with usable IP addresses)
  1. Indicate requirements for "surrounding" network components (e.g., do not use DHCP, external network should offer more than 1 IP address to support floating IPs etc.)
  2. Provide links to additional networking information (book?)
  1. Example architecture with additional nodes
  1. Add storage nodes to either of the core architectures
  1. Explain option to "condense" architectures with fewer nodes or network interfaces with the caveat that it makes troubleshooting more difficult and probably doesn't reflect a production environment (maybe?)

2 Basic operating system configuration

  1. Before you begin
  1. Prefer use of "base" installations rather than "everything" installations
  2. Provide recommended partition sizes and filesystem types? (maybe?)
  1. Networking
  1. Explain firewall situation (depends on distribution)
  2. Configuration for two-node arch (broken up by node)
  1. Provide recommended entries for /etc/hosts or DNS
  2. Note importance of key-based SSH authentication when considering multiple compute nodes with migration
  3. Provide connectivity tests
  1. Configuration for three-node arch (broken up by node)
  1. Provide recommended entries for /etc/hosts or DNS
  2. Note importance of key-based SSH authentication when considering multiple compute nodes with migration
  3. Provide connectivity tests
  1. Configuration for additional nodes (although I'm wondering if we should move these details to their associated chapters... e.g., swift)
  1. Install additional base services and useful troubleshooting tools
  1. ntp, wget, tcpdump...
  1. Passwords
  2. MySQL database
  1. Recommend further restricting grants before moving into production
  1. Messaging server (moved before OpenStack packages since the OpenStack repos don't provide these packages)
  2. OpenStack packages

3 Configure the Identity Service

  1. Add a "demo" tenant and user so that Neutron doesn't break
  2. Explain openrc files and how to use them (mostly covered in "Install the OpenStack command-line clients" chapter)

4 Configure the Image Service

5 Configure Compute services

  1. Compute service
  1. Change to "concepts" like the other services
  1. Install Compute controller services
  2. Configure a Compute node

6 Configure networking

  1. Configure Nova networking
  1. Which use case(s)?
  1. Configure Neutron networking
  1. ML2 with... GRE or VXLAN?

7 Add the dashboard

  1. When complete, jump to launch an instance or continue configuring additional services. We could launch an instance before the dashboard, but I think people feel GUIs provide a more polished experience. If we feel the dashboard is important, we should include screen shots for creating and launching an instance.
  2. Note that Cinder is required for the Dashboard to work

8 Add the Block Storage Service

  1. When compete, jump to launch an instance or continue configuring additional services

9 Add Object Storage

  1. When compete, jump to launch an instance or continue configuring additional services

10 Add the Orchestration service

  1. When compete, jump to launch an instance or continue configuring additional services

11 Add the Telemetry service

  1. When compete, jump to launch an instance or continue configuring additional services

12 Launch an Instance