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+ Bug Numbers | Writer | Doc Impact on Documentation | Hours | Writer | Status | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | IP Address reservation within a network | Saksham | 2 | AWS-style Health Checks | Rajesh Battala | Eng: CLOUDSTACK-443 | 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 | Advanced Search UI | Brian |
|
|
|
|
| |||||||||||||||
Done | ||||||||||||||||||||||
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 |
| 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 | ||||||||||||
6 | High Availability: EIP enhancements | Murali Edison | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Storage+subsystem+2.0 | Radhika |
|
| ||||||||||||||||
7 | Support non-contiguous VLAN ranges | Bharat | https://issueshttps://cwiki.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/displaybrowse/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 |
| Moved to 4.2 | 14 | High Availability: EIP enhancements | Murali | https://issues.apache.org/jira/browse/CLOUDSTACK-652 |
| Radhika |
| 16 | under review | |||||||||
13 | Framework for CloudStack to orchestrate virtual network appliances to provide network services | Murali |
| Radhika |
|
| ||||||||||||||||
14 | Multiple IP Address per NIC | Jaypal | VM's base image update facility (includes Reset a VM on reboot)- | Harikrishna Patnala | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Base+Image+Updation+facilitybrowse/CLOUDSTACK24- | Radhika |
| Done | ||||||||||||||
15 | Multiple IP Ranges | Bharat | https://cwikiissues.apache.org/confluencejira/display/CLOUDSTACK/Base+Image+Updation+facilitybrowse/CLOUDSTACK-702 | Radhika |
| In Progress | ||||||||||||||||
16 | Integrate Cisco ASA 1000v into CloudStack | Kaushik | https://cwikiissues.apache.org/confluencejira/displaybrowse/CLOUDSTACK/Base+Image+Updation+facility-742 | Radhika |
|
|
| |||||||||||||||
17 | Integrate Cisco VSG in CloudStack | Kaushik | 19 | New Image based provisioning method for Baremetal- | Frank zhang- | https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+Baremetal- | Radhika |
|
|
| 21 | XenServer updates notifications | Sanjay T | https://issues.apache.org/jira/browse/CLOUDSTACK-192
|
| JT |
|
| nTier Apps 2.0 Requirements | Sheng |
| |
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 | 24 | Support non-contiguous VLAN ranges | Bharat | Radhika |
| Radhika |
| Under Review | ||||||||||||
22 27 | Dedicated Resources : | Deepti | Dedicate Pod, Cluster or Host to a domain |
|
| - Public IP Addresses and VLANs per Tenant | Likitha | Radhika |
|
| ||||||||||||
29 23 | Likitha | Advanced Search UI |
|
|
|
| 30 | Dedicated Resources:Limit Resources to domain/accounts | ||||||||||||||
24 | Storage subsystem 2.0 | Edison | https://cwiki.apache.org/confluence/display/CLOUDSTACK/Storage+subsystem+2.0 Sanjay |
|
| Radhika |
| 32 | Specify egress rules on Physical device- | Jaypal Reddy |
| |||||||||||
25 | VM's base image update facility (includes Reset a VM on reboot) | Hari P | https://issuescwiki.apache.org/jiraconfluence/browsedisplay/CLOUDSTACK-779 /Base+Image+Updation+facility |
| Radhika |
| 33 | High Availability: implement GSLB (Global Server Load Balancing) capability for ELB service | Murali | Eng: CLOUDSTACK-653
|
| Radhika | ? | |||||||||
26 | New Image based provisioning method for Baremetal | Frank | 34 | 3rd Party Plugin | Sonny | https://issues.apache.org/jiraconfluence/browse/CLOUDSTACK-625- display/CLOUDSTACK/CloudStack+Baremetal |
|
|
| |||||||||||||
27 | 35 | IPv6 Support | Sheng | XenServer updates notifications | Sanjay | JT |
|
| Radhika |
| ||||||||||||
28 | Dedicated Resources: Dedicate Pod, Cluster or Host to a domain | Devdeep |
| 36 | XenMotion Migration | Devdeep | Doc: CLOUDSTACK-900 |
|
|
|
| |||||||||||
37 | VMWare Enhancements: Support for DRS, VM HA | Sateesh |
|
|
|
|
| |||||||||||||||
29 | Configurable setting to use linked clones or not on VMware | Vijay | 38 | VMware vNetwork Distributed Virtual Switch support in CloudStack | Sateesh | -https://cwiki.apache.org/confluence/display/CLOUDSTACK/IntegrationConfigurable+ofsetting+CloudStackto+withuse+VMware+DVS linked+clones+or+not+on+VMware | JT |
|
| Radhika |
| |||||||||||
30 | 3rd Party Plugin | Sonny | JT | 42 | ELB: auto-scale request handling capacity by provisioning LB appliances | Murali Redddy |
|
| ||||||||||||||
31 | XenMotion Migration |
| 43 | Framework for CloudStack to orchestrate virtual network appliances to provide network services | Murali Reddy | Doc: CLOUDSTACK-900 | JT CLOUDSTACK897- |
|
| Moved to Future | ||||||||||||
32 | VMWare Enhancements: Support for DRS, VM HA | Sateesh | 44 | Support VM Snapshot | Mice Xia | https://issuescwiki.apache.org/jiraconfluence/browsedisplay/CLOUDSTACK-684 /Integration+of+CloudStack+with+VMware+DVS |
|
|
| |||||||||||||
33 | 45 | Persistent Network Identity | Hari P | Support VM Snapshot | Mica Xia | httpshttp://mindtouchissues.citriteapache.netorg/Releasesjira/Merlin/Features/CloudStack_and_AWS_Support/CloudStack_Feature_Requestsbrowse/CLOUDSTACK-684- |
|
|
| |||||||||||||
34 | CPU/Memory OverCommit | Bharat | JT |
|
| |||||||||||||||||
35 | SNMP Alerts | Anshul | 46 | Multiple IP Address per NIC | Jaypal | https://issues.apache.org/jira/browse/CLOUDSTACK24CLOUDSTACK-680 |
|
|
|
| 47 | CPU/Memory OverCommit | Bharat (XS) | CS+alerts+via+SNMP+to+external+management+system [https://issues.apache.org/jira/browse/CLOUDSTACK-711 680 |
| JT |
| 48 |
| |||
36 | syslog enhancements SNMP Alerts | Anshul | JT |
|
| |||||||||||||||||
37 | Object Store-Integration with CS as secondary Storage | Nitin | https://cwiki.apache.org/confluence/display/CLOUDSTACK/FSS3-based+for+Integrating+CS+alerts+via+SNMP+to+external+management+system secondary+Storage | JT |
|
| JT |
| ||||||||||||||
38 | Zone-wide (primary) Block Storage | Edison | 49 | syslog enhancements | Anshul | JT |
|
|
| |||||||||||||
39 | Dynamic Resource Scaling (Scaling up CPU and RAM for running VMs) | 52 | Object Store-Integration with CS as secondary Storage | Nitin | https://cwikiissues.apache.org/confluencejira/displaybrowse/CLOUDSTACK/S3-based+secondary+Storage |
|
| Jessica T |
| <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="d2b7c6a4-6fcd-4710-84f2-50edc2e54ecf"><ac:plain-text-body><![CDATA[ | 53 | Zone-wide (primary) Block Storage | Edison | [https://issues.apache.org/jira/browse/CLOUDSTACK-724
|
| JT |
| |||||
|
|
|
|
|
|
|
| 53 | Dynamic Resource Scaling (Scaling up CPU and RAM for running VMs)- | Nitin Mehta | -https://issues.apache.org/jira/browse/CLOUDSTACK-658 ||||||||||||
-658 | JT |
|
| |||||||||||||||||||
40 | Zone-wide primary storage target | Anthony | JT |
|
| |||||||||||||||||
41 | AWS-style Health Checks | Rajesh | Eng: CLOUDSTACK-443 |
|
| JT |
| 55 | Multiple IP Ranges | Bharat | https://issues.apache.org/jira/browse/CLOUDSTACK-702
|
|
|
| 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 | https://issues.apache.org/jira/browse/CLOUDSTACK-724-
|
| JT |
| 59 | {-}IP Address reservation within a network | Saksham | https://issues.apache.org/jira/browse/CLOUDSTACK-705
|
| Radhika{-} | - |
60 | Volume snapshot enhancements for VMware + Better VM Sync{-} | Kelven Yang |
|
| JT |
| JT |
| ||||||||||||||
61 | Configurable setting to use linked clones or not on VMware | Vijay B | -https://issues.apache.org/jira/browse/CLOUDSTACK-670-
|
| JT |
| <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="4c0613a9-c3b2-4791-81e0-fb1dba1fba22"><ac:plain-text-body><![CDATA[ | 63 | Affinity / Anti-affinity Rules- | Prachy | [https://cwiki.apache.org/confluence/display/CLOUDSTACK/AffinityLoad+Balancer+Health+checks | JT |
|
| ||||||||
42 | Volume snapshot enhancements for VMware + Better VM Sync | Kelven Yang | Anti-affinity+rules | JT |
|
| ||||||||||||||||
43 | Persistent Network Identity | Hari P |
|
|
|
| ||||||||||||||||
44 | Affinity / Anti-affinity Rules | Prachy | 64 | Granular Global Parameters | Hari P | JT |
|
| ||||||||||||||
45 | 65 | Support multiple subnets per vlan for KVM HV | Anthony Xu | Granular Global Parameters |
|
|
|
| ||||||||||||||
46 | support multiple subnets per vlan | Bharat | 66 | Site-to-Site VPN: Monitoring of VPN Tunnels | Sheng | CLOUDSTACK-703 |
|
| Radhika | |||||||||||||
Done 47 | 67 | Delete events and alerts | Mixed zones | Sonny Sanjay | Doc: CLOUDSTACK-15671570 | JT |
|
| ||||||||||||||
48 | Update Dev Guide | 68 Radhika | Mixed zones | Sonny Radhika |
| On Track | ||||||||||||||||
49 | Release Notes 4.2 |
|
|
|
|
| ||||||||||||||||
50 | Update Installation Guides |
|
| Doc: CLOUDSTACK-1570 | If the UI is affected, there could be doc changes. |
| Jessica T |
| 69 | Update Developer Guide |
|
|
| |||||||||
51 | Update API documentation |
| Radhika | On Track | 70 |
| Release Notes 4.2 | |||||||||||||||
|
|
|
| jzb |
| 71 | ||||||||||||||||
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