Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions source/adminguide/extensions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,8 @@ CloudStack provides sample built-in orchestrator extensions for demonstration an

.. include:: extensions/builtin_extensions.rst

.. include:: extensions/limitations.rst

.. include:: extensions/troubleshooting.rst

.. include:: extensions/developer.rst
Expand Down
1 change: 1 addition & 0 deletions source/adminguide/extensions/builtin_extensions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -179,6 +179,7 @@ Adding Hyper-V to CloudStack
#. **Add Host.** Add a host to the newly created cluster with the following details:

|hyperv-add-host.png|
**Note**: Add the detail **verify_tls_certificate** set to **false** to skip TLS certificate verification for self-signed certificates.

#. **Create Template.** A Template in CloudStack can map to either a `Template` or an `ISO` in Hyper-V.
Provide a dummy `url` and template name. Select `External` as the hypervisor and `HyperV` as the extension. Under `External Details`, specify:
Expand Down
55 changes: 55 additions & 0 deletions source/adminguide/extensions/limitations.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information#
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.


Limitations
===========

Although the external Instances behave a lot like CloudStack managed
Instances in many ways, there are some limitations. Some of these
limitations are due to the framework itself, while others can be addressed
by adding custom actions in the scripts written for the built-in extensions.

**Some general features/actions not supported at the framework level:**

- Console access to the external Instances.

- Data volumes.

- User Data and Metadata services.

- SSH key injection.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

userdata and sshkey injections will work right! as these are VR related operations and we do support all networking via VR. cc @shwstppr @rohityadavcloud

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ideally they should, but I think there are some issues with userdata and metadata services via VR. I don't know the exact root cause though.


- Affinity Groups.

- Migrate Instance.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@abh1sar could we also add host capacity & utilisation? Also do we support multiple nics (post-deployment or on initial deployment?)

It may be exhaustive to list what we don't support, perhaps we can say at the end specifically what is supported and that all the list of things (above) are some of the general things that we don't support?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I'll add host capacity and utilisation.
multiple nics are supported during initial deployment only.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rohityadavcloud I have changed the wording so that it doesn't appear to be an exhaustive list. I haven't added a list of what is supported, as I think the documentation already has that info.


- Host Capacity and Utilization Stats.

- Add Nics to Instance post deployment.

**Actions which can be implemented using Custom Actions in built-in extensions:**

- Reinstall Instance.

- Backup and Restore.

- Recurring Snapshots.

- Change Service Offering.

- Resize Volume.

- Attach ISO.