DUE TO SPAM, SIGN-UP IS DISABLED. Goto Selfserve wiki signup and request an account.
Page History
What's this?
Details on the documentation needs for ACS 4.2.
Purpose
- Update documentation for new features.
- Update documentation for UI changes.
- Respond to change request and bug tickets.
Assumptions and Risks
The time available before the release is short. The list of features to be included in the release is in flux, making it difficult to plan which features to write about first.
Documentation Deliverables and Outlines
The Documentation plan is derived from the Apache CloudStack 4.2 QA Plan. The following table lists the new features and how they affect documentation. We are committed to provide documentation for features marked P1 and P2.
Update Docs for New Features
|
| Feature | Engineering Contacts | Links: Engineering Functional Spec FS+ Doc Bug Number Numbers | Writer | Doc Impact on Documentation | Hours | Writer | Status | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | IP Address reservation within a network | Saksham | 2 | AWS-style Health Checks | Rajesh Battala | https://cwikiissues.apache.org/confluencejira/displaybrowse/CLOUDSTACK/Load+Balancer+Health+checks | Radhika |
| JT Done | ||||||||||||||||
2 | 3 | Netscaler LB on Shared VLANs | Rajesh Battala | https://cwiki.apache.org/confluence/display/CLOUDSTACK/LB+on+Shared+VLANs | Radhika |
|
| Radhika | Moved to 4.2 | ||||||||||||||||
5 3 | Optional Public IP assignment for EIP with Basic Zone | Murali | https://cwiki.apache.org/confluence/display/CLOUDSTACK/L4-L7+network+services+in+shared+network- |
| Radhika |
| 7 Done | Advanced Search UI | Brian |
|
|
|
|
| |||||||||||
4 | 8 | L4-L7 network services in shared network - | Murali - | https://cwiki.apache.org/confluence/display/CLOUDSTACK/L4-L7+network+services+in+shared+network |
| Radhika | On Track | ]]></ac:plain-text-body></ac:structured-macro> |
| Done | |||||||||||||||
5 10 | User provided hostname to be specified in vCenter -vCenter | Vijay B | https://issues.apache.org/jira/browse/CLOUDSTACK778 (https://cwiki.apache.org/confluence/display/CLOUDSTACK/- | Radhika |
| Radhika Done | On Track | 13 | Storage subsystem 2.0 | Edison | |||||||||||||||
6 | High Availability: EIP enhancements | Murali | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Storage+subsystem+2.0browse/CLOUDSTACK-652 | Radhika |
|
| |||||||||||||||||||
7 | Support non-contiguous VLAN ranges | Bharat | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Storage+subsystem+2.0browse/CLOUDSTACK-701 | Radhika |
| in progress | |||||||||||||||||||
8 | Specify egress rules on Physical device | Jayapal | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Storage+subsystem+2.0browse/CLOUDSTACK-779 | Radhika |
| Done | |||||||||||||||||||
9 | High Availability: implement GSLB (Global Server Load Balancing) capability for ELB service | Murali | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Storage+subsystem+2.0- |
|
|
| Radhika |
|
| ||||||||||||||||
10 | IPv6 Support | Sheng |
| Radhika |
| APIs are done | |||||||||||||||||||
11 | nTier Apps 2.0 Requirements | Kishan/Sheng |
| Radhika |
|
| |||||||||||||||||||
12 | VMware vNetwork Distributed Virtual Switch support in CloudStack | Sateesh |
| Radhika |
| under review | |||||||||||||||||||
13 | Framework for CloudStack to orchestrate virtual network appliances to provide network services | Murali |
| Radhika |
|
| |||||||||||||||||||
14 | Multiple IP Address per NIC | Jaypal | Moved to 4.2 | 14 | High Availability: EIP enhancements | Murali | https://issues.apache.org/jira/browse/CLOUDSTACKCLOUDSTACK24-652 | Radhika |
| Done | |||||||||||||||
15 | Multiple IP Ranges | Bharat | https://issues.apache.org/jira/browse/CLOUDSTACK652CLOUDSTACK-702 | Radhika |
| In Progress | |||||||||||||||||||
16 | Integrate Cisco ASA 1000v into CloudStack | Kaushik | Radhika |
| Radhika |
| |||||||||||||||||||
17 | Integrate Cisco VSG in CloudStack | Kaushik | 16 | VM's base image update facility (includes Reset a VM on reboot)- | Harikrishna Patnala | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Base+Image+Updation+facility |
|
|
|
| Radhika |
|
| ||||||||||||
18 | Site-to-Site VPN | Sheng | CLOUDSTACK-703 | Radhika |
|
| |||||||||||||||||||
19 | Support multiple subnets per vlan for KVM HV | Anthony |
| Radhika |
|
| |||||||||||||||||||
20 | Delete events and alerts | Sanjay | Doc: CLOUDSTACK-1567 | Radhika |
| Done | |||||||||||||||||||
21 | Dedicated Resources:Limit Resources to domain/accounts | Sanjay | 19 | New Image based provisioning method for Baremetal- | Frank zhang- | https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+Baremetal- | Radhika |
| Under Review |
| |||||||||||||||
22 | Dedicated Resources - Public IP Addresses and VLANs per Tenant | Likitha | 21 | XenServer updates notifications | Sanjay T | Radhika | JT |
| |||||||||||||||||
23 | Advanced Search UI | Brian |
| nTier Apps 2.0 Requirements | Sheng |
|
|
|
| ||||||||||||||||
24 | Storage subsystem 2.0 | Edison |
|
|
| https://cwiki.apache.org/confluence/display/CLOUDSTACK/nTierStorage+Appssubsystem+2.0+Requirements | Radhika |
| 24 | Support non-contiguous VLAN ranges | Bharat |
|
|
| |||||||||||
25 | VM's base image update facility (includes Reset a VM on reboot) | Hari P | https://issuescwiki.apache.org/jiraconfluence/browsedisplay/CLOUDSTACK-701/Base+Image+Updation+facility |
| Radhika |
| |||||||||||||||||||
26 | New Image based provisioning method for Baremetal | Frank | 27 | Dedicated Resources: | Deepti | Dedicate Pod, Cluster or Host to a domain |
|
|
| https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+Baremetal |
|
|
| ||||||||||||
27 29 | XenServer updates notifications | Likitha Sanjay | JT |
|
| ||||||||||||||||||||
28 | 30 | Dedicated Dedicated Resources:Limit Resources to domain/accounts Dedicate Pod, Cluster or Host to a domain | Devdeep Sanjay |
|
|
|
| 32 | Specify egress rules on Physical device- | ||||||||||||||||
29 | Configurable setting to use linked clones or not on VMware | Vijay Jaypal Reddy- |
|
| Radhika |
| 33 | Health monitoring for load balanced instances | Rajesh | 670 | JT |
|
| ||||||||||||
? 30 | 34 | 3rd Party Plugin | Sonny | JT |
|
|
| ||||||||||||||||||
35 | IPv6 Support | Sheng |
|
|
| Radhika |
| ||||||||||||||||||
31 | 36 | XenMotion Migration | Devdeep | Doc: CLOUDSTACK-900 | JT |
|
| ||||||||||||||||||
37 32 | VMWare Enhancements: Support for DRS, VM HA | Sateesh |
|
|
|
|
| 38 | VMware vNetwork Distributed Virtual Switch support in CloudStack | Sateesh | -https://cwiki.apache.org/confluence/display/CLOUDSTACK/Integration+of+CloudStack+with+VMware+DVS | Radhika |
| 42 |
| ||||||||||
33 | ELB: auto-scale request handling capacity by provisioning LB appliances | Murali Redddy |
|
|
|
| 43 | Framework for CloudStack to orchestrate virtual network appliances to provide network services | Murali Reddy | CLOUDSTACK897-
|
|
| Moved to Future | 44 | Support VM Snapshot | Mice Mica Xia |
|
|
|
| |||||
45 | Persistent Network Identity | Hari P |
|
| JT |
| |||||||||||||||||||
46 | Multiple IP Address per NIC | Jaypal | https://issues.apache.org/jira/browse/CLOUDSTACK24- |
|
|
|
| ||||||||||||||||||
34 | 47 | CPU/Memory OverCommit | Bharat (XS) | JT |
| JT |
| ||||||||||||||||||
48 35 | SNMP Alerts Monitoring | Anshul | https://issues.apache.org/jira/browse/CLOUDSTACK-680 | JT |
| JT |
| ||||||||||||||||||
49 36 | syslog enhancements | Anshul | JT |
|
| ||||||||||||||||||||
37 | 52 | Object Store-Integration with CS as secondary Storage | Nitin | https://cwiki.apache.org/confluence/display/CLOUDSTACK/S3-based+secondary+Storage | JT | Radhika |
| ||||||||||||||||||
38 | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="5357294a-c0f5-4293-a4e8-62142b65efa9"><ac:plain-text-body><![CDATA[ | 53 | Zone-wide (primary) Block Storage | Edison | [https://issues.apache.org/jira/browse/CLOUDSTACK-724 |
|
| JT |
|
|
|
|
|
|
|
|
| ||||||||
39 | 53 | Dynamic Resource Scaling (Scaling up CPU and RAM for running VMs)- | Nitin Mehta | -https://issues.apache.org/jira/browse/CLOUDSTACK-658 |
| JT |
| 55 | Multiple IP Ranges | Bharat | https://issues.apache.org/jira/browse/CLOUDSTACK-702
|
| |||||||||||||
40 |
|
|
| 56 | Integrate Cisco VSG in CloudStack | Koushik Das | https://issues.apache.org/jira/browse/CLOUDSTACK-743
|
|
|
| 57 | Integrate Cisco ASA 1000v into CloudStack{-} | Koushik Das | https://issues.apache.org/jira/browse/CLOUDSTACK-742
|
|
|
| 58 | {-}Zone-wide primary storage target | Anthony | JT |
| JT |
| |
59 41 | {-}IP Address reservation within a network | Saksham | AWS-style Health Checks | Rajesh | Eng: CLOUDSTACK-443 |
|
| Radhika{-} | - | JT |
|
| |||||||||||||
42 60 | Volume snapshot enhancements for VMware + Better VM Sync{-} | Kelven Yang | https://cwiki.apache.org/confluence/display/CLOUDSTACK/VMWare+Enhancements+-+Support+for+DRS+and+VM+HA- |
|
| JT |
| JT |
|
| |||||||||||||||
43 | Persistent Network Identity | Hari P | 61 | Configurable setting to use linked clones or not on VMware | Vijay B | -https://issues.apache.org/jira/browse/CLOUDSTACK-670- |
|
| JT |
|
| ||||||||||||||
44 | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="03794f52-3f97-4863-87e1-56fbf969b1cd"><ac:plain-text-body><![CDATA[ | 63 | Affinity / Anti-affinity Rules - | Prachy | [https://cwiki.apache.org/confluence/display/CLOUDSTACK/Affinity++Anti-affinity+rules | JT |
|
|
| ||||||||||||||||
64 45 | Granular Global Parameters | Hari P |
|
|
| ||||||||||||||||||||
46 | 65 | Support support multiple subnets per vlan for KVM HV | Anthony Xu Bharat | https://issues.apache.org/jira/browse/CLOUDSTACK-788 https://issues.apache.org/jira/browse/CLOUDSTACK-788 |
|
|
|
| |||||||||||||||||
47 | Mixed zones | Sonny | Doc: CLOUDSTACK-1570 | JT |
|
|
| ||||||||||||||||||
48 | Update Dev Guide | Radhika |
| Radhika |
| On Track | |||||||||||||||||||
49 | Release Notes 4.2 |
| 66 | Site-to-Site VPN: Monitoring of VPN Tunnels | Sheng | CLOUDSTACK-703 |
|
| Radhika | Done | |||||||||||||||
67 50 | Update Developer Guide Installation Guides |
|
|
|
|
| Radhika | On Track | |||||||||||||||||
51 | Update API documentation |
|
|
|
|
| 68 | Release Notes 4.2 | |||||||||||||||||
|
|
|
| jzb |
| 69 | |||||||||||||||||||
Update Installation Guides |
|
|
|
| jzb |
|
Installation Guides: Update
Each new release requires an update of the existing Installation Guide. A rewrite is required for "build from source" installation procedure.Looking for community contribution.
Hours: Up to 32 hours
Release Notes
Each new release requires an update of existing Release Notes. New features, Known issues, and Fixed issues sections require major rewrite.
Hours: Up to 32 hours including the review cycle.
API Reference: Update
Each new release requires an update of the existing API Reference man pages. These are auto-generated and require only posting to the website.
Hours: Up to 8 hours maximum if no rewrite is planned.
Documentation Bugs
It is assumed that bugs will be filed against documentation and some will be prioritized for this release. Currently known doc bugs per release can be obtained by querying the bugbase. Triage of existing bugs is needed to determine which are required in this release. The goal is to address as many as possible of the bugs that reflect inaccuracies in the documentation. Enhancement requests can be targeted to a later release.
Hours: Dedicating up to 60 hours for defect closure.This might vary based on the feature requirements.
Translation
Publican can output .po files which we can use to translate documentation into any desired language.
We are using Transifex to obtain community contributed translations of the documentation. For more information, see http://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docs.
Additional Doc Activities
In addition to the deliverables noted,additional activities are required during this time frame.
- Community outreach activities: presentations at professional gatherings, presence on mailing lists and social media, organizing CloudStack meetups etc.
Timeline
March 25-29
dvSwitch: incorporating comments (Radhika)
Delete events and alerts: research (Radhika)
SNMP Alerts: write overview (Jessica)
S3 secondary storage: investigation (Jessica)
VM snapshots (VMware only for now): write overview (Jessica)
April 1 - 5
Multiple IP addresses per NIC: done (Radhika)
Limit resources to domains/accounts: done (Radhika)
Regions, AWS-Style: review and approval (Jessica)
Health monitoring for NetScaler load balanced instances: write overview (Jessica)
S3 secondary storage: write (Jessica)
April 8 - 12
S3 secondary storage: write (Jessica)
Limit resources to domains/accounts: review (Radhika)
dvSwitch - first review comments are incorporated. Queries are awaiting answers (Radhika)
April 15 - 19
Radhika: vacation
Cisco UCS baremetal: write overview (Jessica)
April 22 - 26
Document Support non-contiguous VLAN ranges (Radhika)
Delete events and alerts: done (Radhika)
April 28 - May 3
Dedicated Resources - Public IP Addresses and VLANs per Tenant (Radhika) (research)
Multiple IP Ranges (research)
May 6 - May 11
Overview
Content Tools