2
0
mirror of https://github.com/xcat2/xcat-core.git synced 2025-05-30 09:36:41 +00:00

Refine the doc skeleton

Move the subitems from install->Advanced topics to customized_image
Add the subimtes for Advacned_topics
Add the subitems for discovery
Add subitems for developers
This commit is contained in:
wangxiaopeng 2015-08-20 04:55:16 -04:00
parent d4a3f34e84
commit d273fc8289
70 changed files with 133 additions and 152 deletions

View File

@ -0,0 +1,2 @@
Changing the Hostname or IP for Management Node
===============================================

View File

@ -0,0 +1,2 @@
Chaning the Hostname or IP for Compute Node
===========================================

View File

@ -1,5 +1,5 @@
High Available Management Node
==============================
Highly Available Management Node
================================
.. toctree::
:maxdepth: 2

View File

@ -0,0 +1,2 @@
Setting Up a Linux Hierarchical Cluster
=======================================

2
source/advanced/ib.rst Normal file
View File

@ -0,0 +1,2 @@
Managing the Mellanox Infiniband Network
========================================

View File

@ -4,7 +4,21 @@ Advanced Topics
.. toctree::
:maxdepth: 2
restapi/index.rst
mixed_cluster.rst
hierarchy_cluster.rst
hamn/index.rst
change_mn_ip.rst
change_node_ip.rst
xcat_security.rst
kit.rst
ib.rst
confluent/index.rst
docker/index.rst
hamn/index.rst
mixed_cluster.rst
ipv6_support.rst
xcat_port.rst
sysclone.rst
switch_mgmt.rst
vlan.rst
zone.rst
softlayer.rst

View File

@ -0,0 +1,2 @@
Configuring IPv6 in xCAT Cluster
================================

2
source/advanced/kit.rst Normal file
View File

@ -0,0 +1,2 @@
Using Software KITs
===================

View File

@ -0,0 +1,8 @@
xCAT Web Services REST API
==========================
.. toctree::
:maxdepth: 2
set_up_ws.rst
restapi.rst

View File

@ -1,2 +1,2 @@
Hardware Discovery
REST API Reference
==================

View File

@ -0,0 +1,2 @@
Set Up Web Service for REST API
===============================

View File

@ -0,0 +1,2 @@
Using xCAT in SoftLayer
=======================

View File

@ -0,0 +1,2 @@
Managing Ethernet Switches
==========================

View File

@ -0,0 +1,2 @@
Using System Clone to Deploy Diskful Node
=========================================

2
source/advanced/vlan.rst Normal file
View File

@ -0,0 +1,2 @@
VLAN Configuration
==================

View File

@ -0,0 +1,2 @@
xCAT Port Usage
===============

View File

@ -0,0 +1,2 @@
xCAT 2 Security
===============

2
source/advanced/zone.rst Normal file
View File

@ -0,0 +1,2 @@
Setting Up Management Zones
===========================

View File

@ -0,0 +1,2 @@
Debug xCAT Problems
===================

View File

@ -0,0 +1,2 @@
Developer Guide
===============

View File

@ -7,6 +7,8 @@ This page is for developers interested in working with xCAT.
.. toctree::
:maxdepth: 2
developer_guide.rst
programming_tips.rst
debug_xcat.rst
license/index.rst
git/index.rst
mini-design/index.rst

View File

@ -1,14 +0,0 @@
Mini-design for xCAT Debug Mode
===============================
Overview
--------
+--------+----------+
| Name | Age |
+========+==========+
| Wang | 20 |
+--------+----------+
| Zhao | 18 |
+--------+----------+

View File

@ -1,2 +0,0 @@
Mini-design for Docker Swarm Support
====================================

View File

@ -1,49 +0,0 @@
Mini-design for Docker Support
==============================
Overview
--------
Docker technology is very hot recently, xCAT plans to support it as a way to deploy applictions.
Interface
---------
General Command Line
^^^^^^^^^^^^^^^^^^^^
Will add several new commands to support docker.
* docker create
* Create only
* Start after creating
* docker stop
Stop the docker container
* docker remove
Rest API
^^^^^^^^
Add xCAT Rest API to support docker.
* docker create
URI - /xcatws/<node>/start
::
#curl
#wget
Add a Table
^^^^^^^^^^^
+-----------+------------+-------------+
|Operation |Params |Result |
+===========+============+=============+
|GET |node |on/off |
+-----------+------------+-------------+
|PUT |node |on/off |
+-----------+------------+-------------+

View File

@ -1,24 +0,0 @@
Mini-Design
===========
The **Design Document** for certain feature.
**NOTE**
*The documents displayed in this page are not official guides for user to reference. They are just design documents that describe how to implement certain feature. And sometimes they are not updated with the current implementation.*
2.11
----
.. toctree::
:maxdepth: 2
2.11/docker.rst
2.11/docker-swarm.rst
2.10
----
.. toctree::
:maxdepth: 2
2.10/xcatdebugmode.rst

View File

@ -0,0 +1,2 @@
Programming Tips
================

View File

@ -2,6 +2,3 @@ Select or Create an osimage Definition
======================================
Run copycds to create image
Customize the osimage definitions
=================================

View File

@ -0,0 +1,2 @@
Manually Define Nodes
=====================

View File

@ -0,0 +1,2 @@
Manually Discover Nodes
=======================

View File

@ -0,0 +1,2 @@
MTMS-based Discovery
====================

View File

@ -0,0 +1,2 @@
Sequential-based Discovery
==========================

View File

@ -0,0 +1,2 @@
Switch-based Discovery
======================

View File

@ -1,4 +1,12 @@
.. ========================
.. Using common shared file
.. ========================
.. include:: ../../common/discovery.rst
Hardware Discoveriy & Define Node
=================================
.. toctree::
:maxdepth: 2
manually_define.rst
mtms_discovery.rst
switch_discovery.rst
seq_discovery.rst
manually_discovery.rst

View File

@ -0,0 +1 @@
.. include:: ../../common/discover/manually_define.rst

View File

@ -0,0 +1 @@
.. include:: ../../common/discover/manually_discovery.rst

View File

@ -0,0 +1 @@
.. include:: ../../common/discover/mtms_discovery.rst

View File

@ -0,0 +1 @@
.. include:: ../../common/discover/seq_discovery.rst

View File

@ -0,0 +1 @@
.. include:: ../../common/discover/switch_discovery.rst

View File

@ -1,15 +0,0 @@
Advanced Topics
===============
.. toctree::
:maxdepth: 2
raid_cfg.rst
driver_update_disk.rst
cfg_partition.rst
pre_post_script.rst
syncfile.rst
additional_pkg.rst
cfg_second_adapter.rst

View File

@ -0,0 +1,16 @@
Customize osimage (Optional)
============================
Optional means all the subitems in this page are not necessary to finish an OS deployment. If you are new to xCAT, you can just jump to `Initialize the Compute for Deployment`.
.. toctree::
:maxdepth: 2
raid_cfg.rst
driver_update_disk.rst
cfg_partition.rst
pre_post_script.rst
syncfile.rst
additional_pkg.rst
cfg_second_adapter.rst

View File

@ -4,7 +4,6 @@ Diskful Installation
.. toctree::
:maxdepth: 2
image_mgmt.rst
advanced_topics/index.rst
copy_image.rst
customize_image/index.rst
deploy_os.rst

View File

@ -1,13 +0,0 @@
Advanced Topics
===============
.. toctree::
:maxdepth: 2
driver_update_disk.rst
pre_post_script.rst
syncfile.rst
additional_pkg.rst
cfg_second_adapter.rst
enable_kdump.rst

View File

@ -0,0 +1,2 @@
.. include:: ../../common/deployment/create_img.rst

View File

@ -0,0 +1,15 @@
Customize osimage (Optional)
============================
Optional means all the subitems in this page are not necessary to finish an OS deployment. If you are new to xCAT, you can just jump
to `Initialize the Compute for Deployment`.
.. toctree::
:maxdepth: 2
driver_update_disk.rst
pre_post_script.rst
syncfile.rst
additional_pkg.rst
cfg_second_adapter.rst
enable_kdump.rst

View File

@ -1,3 +1 @@
.. include:: ../../common/deployment/create_img.rst
.. include:: ../../common/deployment/generate_img.rst

View File

@ -4,7 +4,7 @@ Diskless Installation
.. toctree::
:maxdepth: 2
image_mgmt.rst
advanced_topics/index.rst
copy_image.rst
customize_image/index.rst
gen_image.rst
deploy_os.rst

View File

@ -1,4 +1 @@
.. ========================
.. Using common shared file
.. ========================
.. include:: ../../common/kvm/manage_vm.rst

View File

@ -1,4 +0,0 @@
.. ========================
.. Using common shared file
.. ========================
.. include:: ../../common/discovery.rst

View File

@ -1,3 +0,0 @@
.. ========================
.. Using common shared file
.. ========================

View File

@ -1,3 +0,0 @@
.. ========================
.. Using common shared file
.. ========================

View File

@ -23,8 +23,8 @@ Content
overview/index.rst
guides/install-guides/index.rst
guides/admin-guides/index.rst
developers/index.rst
advanced/index.rst
developers/index.rst
help.rst

View File

@ -11,3 +11,4 @@ xCAT is known for exceptional scaling, wide variety of supported hardware, opera
features.rst
support_list.rst
architecture.rst
setup_cluster_process.rst

View File

@ -0,0 +1,2 @@
Brief Steps to Set Up an xCAT Cluster
=====================================