mirror of
https://github.com/xcat2/xcat-core.git
synced 2025-06-15 19:01:44 +00:00
Doc update for Service Node upgrading
This commit is contained in:
Mark Gurevich
@ -20,12 +20,12 @@ Configure ``otherpkgdir`` and ``otherpkglist`` for service node osimage
|
||||
otherpkgdir=/install/post/otherpkgs/rhels7/x86_64
|
||||
[root@fs4 xcat]# mkdir -p /install/post/otherpkgs/rhels7/x86_64/xcat
|
||||
|
||||
* Download or copy `xcat-core` and `xcat-dep` .bz2 files into that `xcat` directory ::
|
||||
* Download or copy ``xcat-core`` and ``xcat-dep`` .bz2 files into that ``xcat`` directory ::
|
||||
|
||||
wget https://xcat.org/files/xcat/xcat-core/<version>_Linux/xcat-core/xcat-core-<version>-linux.tar.bz2
|
||||
wget https://xcat.org/files/xcat/xcat-dep/<version>_Linux/xcat-dep-<version>-linux.tar.bz2
|
||||
|
||||
* untar the `xcat-core` and `xcat-dep` .bz2 files ::
|
||||
* untar the ``xcat-core`` and ``xcat-dep`` .bz2 files ::
|
||||
|
||||
cd /install/post/otherpkgs/<os>/<arch>/xcat
|
||||
tar jxvf core-rpms-snap.tar.bz2
|
||||
@ -50,7 +50,7 @@ Configure ``otherpkgdir`` and ``otherpkglist`` for service node osimage
|
||||
xcat/xcat-dep/rh7/x86_64/perl-Net-Telnet
|
||||
xcat/xcat-dep/rh7/x86_64/perl-Expect
|
||||
|
||||
.. note:: You will be installing the xCAT Service Node RPM ``xCATsn`` on the Service Node, not the xCAT Management Node RPM. Do not install both.
|
||||
.. note:: You will be installing the xCAT Service Node RPM ``xCATsn-<version>`` on the Service Node, not the xCAT Management Node RPM ``xCAT-<version>``. Do not install xCAT Management Node RPM ``xCAT-<version>`` on the Service Node.
|
||||
|
||||
Update the rhels6 RPM repository (rhels6 only)
|
||||
----------------------------------------------
|
||||
@ -103,7 +103,7 @@ For example ::
|
||||
Monitor the Installation
|
||||
------------------------
|
||||
|
||||
Watch the installation progress using either wcons or rcons: ::
|
||||
Watch the installation progress using either ``wcons`` or ``rcons`` and monitor log messages: ::
|
||||
|
||||
wcons service # make sure DISPLAY is set to your X server/VNC or
|
||||
rcons <node_name>
|
||||
@ -116,20 +116,20 @@ Update Service Node Diskful Image
|
||||
|
||||
To update the xCAT software on the Service Node:
|
||||
|
||||
#. Remove previous xcat-core, xcat-dep, and tar files in the NFS mounted ``/install/post/otherpkgs/`` directory: ::
|
||||
#. Remove previous ``xcat-core``, ``xcat-dep``, and tar files in the NFS mounted ``/install/post/otherpkgs/`` directory: ::
|
||||
|
||||
rm /install/post/otherpkgs/<os>/<arch>/xcat/xcat-core
|
||||
rm /install/post/otherpkgs/<os>/<arch>/xcat/xcat-dep
|
||||
rm -rf /install/post/otherpkgs/<os>/<arch>/xcat/xcat-core
|
||||
rm -rf /install/post/otherpkgs/<os>/<arch>/xcat/xcat-dep
|
||||
rm /install/post/otherpkgs/<os>/<arch>/xcat/<xcat-core.tar>
|
||||
rm /install/post/otherpkgs/<os>/<arch>/xcat/<xcat-dep.tar>
|
||||
|
||||
#. Download the desired tar files from xcat.org on to the Management Node, and untar them in the same NFS mounted ``/install/post/otherpkgs/`` directory: ::
|
||||
#. Download the desired tar files from http://xcat.org/download.html to the Management Node, and untar them in the same NFS mounted ``/install/post/otherpkgs/`` directory: ::
|
||||
|
||||
cd /install/post/otherpkgs/<os>/<arch>/xcat/
|
||||
tar jxvf <new-xcat-core.tar>
|
||||
tar jxvf <new-xcat-dep.tar>
|
||||
|
||||
#. On the Service Node, run the package manager commands relative to the OS to update xCAT. For example, on RHEL, use the following yum commands: ::
|
||||
#. On the Service Node, run the package manager commands relative to the OS to update xCAT. For example, on RHEL, use the following ``yum`` commands: ::
|
||||
|
||||
yum clean metadata # or yum clean all
|
||||
yum update '*xCAT*'
|
||||
|
||||
@ -56,7 +56,7 @@ When you run ``copycds``, xCAT will only create a Service Node stateful osimage
|
||||
postinstall
|
||||
rootimgdir
|
||||
|
||||
#. Create the exlist, pkglist and otherpkglist file.
|
||||
#. Create the ``exlist``, ``pkglist`` and ``otherpkglist`` files.
|
||||
|
||||
xCAT ships a basic requirements lists that will create a fully functional Service Node. However, you may want to customize your service node by adding additional operating system packages or modifying the files excluded by the exclude list. Check the below files to see if it meets your needs. ::
|
||||
|
||||
@ -67,7 +67,7 @@ When you run ``copycds``, xCAT will only create a Service Node stateful osimage
|
||||
|
||||
If you would like to change any of these files, copy them to a custom
|
||||
directory. This can be any directory you choose, but we recommend that you
|
||||
keep it /install somewhere. A good location is something like ``/install/custom/netboot/<osimage>``.
|
||||
keep it ``/install`` somewhere. A good location is something like ``/install/custom/netboot/<osimage>``.
|
||||
|
||||
::
|
||||
|
||||
@ -95,11 +95,11 @@ When you run ``copycds``, xCAT will only create a Service Node stateful osimage
|
||||
xcat/xcat-dep/rh7/ppc64le/perl-Net-Telnet
|
||||
xcat/xcat-dep/rh7/ppc64le/perl-Expect
|
||||
|
||||
.. note:: You will be installing the xCAT Service Node RPM ``xCATsn`` on the Service Node, not the xCAT Management Node RPM. Do not install both.
|
||||
.. note:: You will be installing the xCAT Service Node RPM ``xCATsn-<version>`` on the Service Node, not the xCAT Management Node RPM ``xCAT-<version>``. Do not install xCAT Management Node RPM ``xCAT-<version>`` on the Service Node.
|
||||
|
||||
#. Create the postinstall script.
|
||||
|
||||
xCAT ships a default postinstall script for stateless Service Node. You may also choose to create an appropriate /etc/fstab file in your
|
||||
xCAT ships a default postinstall script for stateless Service Node. You may also choose to create an appropriate ``/etc/fstab`` file in your
|
||||
Service Node image. :
|
||||
|
||||
::
|
||||
@ -151,7 +151,7 @@ When you run ``copycds``, xCAT will only create a Service Node stateful osimage
|
||||
images, creating custom files and new custom osimage definitions as you need
|
||||
to.
|
||||
|
||||
* Make your xCAT software available for otherpkgs processing
|
||||
* Make your xCAT software available for ``otherpkgs`` processing
|
||||
|
||||
Option 1:
|
||||
|
||||
@ -197,7 +197,7 @@ When you run ``copycds``, xCAT will only create a Service Node stateful osimage
|
||||
|
||||
genimage rhels7.3-ppc64le-netboot-service
|
||||
|
||||
* Prevent DHCP from starting up until xcatd has had a chance to configure it:
|
||||
* Prevent DHCP from starting up until ``xcatd`` has had a chance to configure it:
|
||||
|
||||
::
|
||||
|
||||
@ -205,7 +205,7 @@ When you run ``copycds``, xCAT will only create a Service Node stateful osimage
|
||||
chroot $OSIMAGE_ROOT/rootimg chkconfig dhcpd off
|
||||
chroot $OSIMAGE_ROOT/rootimg chkconfig dhcrelay off
|
||||
|
||||
* IF using NFS hybrid mode, export /install read-only in Service Node image:
|
||||
* IF using NFS hybrid mode, export ``/install`` read-only in Service Node image:
|
||||
|
||||
::
|
||||
|
||||
@ -226,7 +226,7 @@ Install Service Nodes
|
||||
|
||||
rinstall service osimage=rhels7.3-ppc64le-netboot-service
|
||||
|
||||
Watch the installation progress using either wcons or rcons:
|
||||
Watch the installation progress using either ``wcons`` or ``rcons`` and monitor log messages:
|
||||
|
||||
::
|
||||
|
||||
@ -300,10 +300,10 @@ Update Service Node Stateless Image
|
||||
|
||||
To update the xCAT software in the image at a later time:
|
||||
|
||||
* Download the updated xcat-core and xcat-dep tarballs and place them in
|
||||
your osimage's otherpkgdir xcat directory as you did above.
|
||||
* Generate and repack the image and reboot your Service Node.
|
||||
* Run image generation for your osimage definition.
|
||||
* Download the updated ``xcat-core`` and ``xcat-dep`` tarballs from http://xcat.org/download.html and place them in
|
||||
your osimage's ``otherpkgdir`` xcat directory as you did above.
|
||||
* Generate and repack the image.
|
||||
* Reinstall your Service Node.
|
||||
|
||||
::
|
||||
|
||||
@ -314,6 +314,6 @@ To update the xCAT software in the image at a later time:
|
||||
.. note:: The Service Nodes are set up as NFS-root servers for the compute nodes.
|
||||
Any time changes are made to any compute image on the mgmt node it will be
|
||||
necessary to sync all changes to all Service Nodes. In our case the
|
||||
``/install`` directory is mounted on the servicenodes, so the update to the
|
||||
``/install`` directory is mounted on the Service Nodes, so the update to the
|
||||
compute node image is automatically available.
|
||||
|
||||
|
||||
@ -27,23 +27,23 @@ The ``mlnxofed_ib_install`` is a sample script intended to assist with the insta
|
||||
+---------+------------------+----------------------------------------------------------+
|
||||
| Option | Required | Description |
|
||||
+=========+==================+==========================================================+
|
||||
|``-p`` | Yes || The full path to the MLNX_OFED ISO image |
|
||||
|``-p`` | Yes | The full path to the MLNX_OFED ISO image |
|
||||
+---------+------------------+----------------------------------------------------------+
|
||||
|``-m`` | No || Use this option to pass arguments to the Mellanox OFED |
|
||||
| | || installation script ``mlnxofedinstall``. |
|
||||
| | || |
|
||||
| | || The special keyword ``-end-`` must be added to the end |
|
||||
| | || of the string to mark the completion of the option list |
|
||||
| | || option list. |
|
||||
| | || |
|
||||
| | || If nothing is specified, xCAT passes the following |
|
||||
| | || ``--without-32bit --without-fw-update --force`` |
|
||||
|``-m`` | No | Use this option to pass arguments to the Mellanox OFED |
|
||||
| | | installation script ``mlnxofedinstall``. |
|
||||
| | | |
|
||||
| | | The special keyword ``-end-`` must be added to the end |
|
||||
| | | of the string to mark the completion of the option list |
|
||||
| | | option list. |
|
||||
| | | |
|
||||
| | | If nothing is specified, xCAT passes the following |
|
||||
| | | ``--without-32bit --without-fw-update --force`` |
|
||||
+---------+------------------+----------------------------------------------------------+
|
||||
|``-i`` | For diskless || The image root path of the diskless image |
|
||||
| | || |
|
||||
|``-i`` | For diskless | The image root path of the diskless image |
|
||||
| | | |
|
||||
+---------+------------------+----------------------------------------------------------+
|
||||
|``-n`` | For diskless || nodeset status, value is ``genimage`` |
|
||||
| | || |
|
||||
|``-n`` | For diskless | nodeset status, value is ``genimage`` |
|
||||
| | | |
|
||||
+---------+------------------+----------------------------------------------------------+
|
||||
|
||||
|
||||
|
||||
@ -1433,7 +1433,7 @@ Change the attributes mgtifname=eth0 and net=10.1.0.0. ::
|
||||
|
||||
curl -X PUT -k 'https://127.0.0.1/xcatws/networks/network1?userName=root&userPW=cluster&pretty=1' -H Content-Type:application/json --data '{"mgtifname":"eth0","net":"10.1.0.0"}'
|
||||
POST - Create the network {netname}. DataBody: {attr1:v1,attr2:v2...}.
|
||||
`````````````````````````````````````````````````````````````````````
|
||||
``````````````````````````````````````````````````````````````````````
|
||||
|
||||
Refer to the man page: :doc:`mkdef </guides/admin-guides/references/man1/mkdef.1>`
|
||||
|
||||
@ -1576,7 +1576,7 @@ Set the name attribute for policy 3. ::
|
||||
|
||||
curl -X PUT -k 'https://127.0.0.1/xcatws/policy/3?userName=root&userPW=cluster&pretty=1' -H Content-Type:application/json --data '{"name":"root"}'
|
||||
POST - Create the policy {policyname}. DataBody: {attr1:v1,attr2:v2...}.
|
||||
```````````````````````````````````````````````````````````````````````
|
||||
````````````````````````````````````````````````````````````````````````
|
||||
|
||||
It will create a new policy resource.
|
||||
|
||||
|
||||
@ -9,9 +9,9 @@ If using an ISO, copy it to (or NFS mount it on) the management node, and then r
|
||||
|
||||
copycds <path>/<specific-distro>.iso
|
||||
|
||||
.. note:: While sle15 contains installer medium and packages medium, need ``copycds`` copy all contents of DVD1 of the installer medium and DVD1 of the packages medium, for example: ::
|
||||
|
||||
copycds SLE-15-Installer-DVD-ppc64le-GM-DVD1.iso SLE-15-Packages-ppc64le-GM-DVD1.iso
|
||||
.. note:: While sle15 contains installer medium and packages medium, need ``copycds`` copy all contents of DVD1 of the installer medium and DVD1 of the packages medium, for example:
|
||||
|
||||
``copycds SLE-15-Installer-DVD-ppc64le-GM-DVD1.iso SLE-15-Packages-ppc64le-GM-DVD1.iso``
|
||||
|
||||
If using a DVD, put it in the DVD drive of the management node and run: ::
|
||||
|
||||
|
||||
@ -1,10 +1,12 @@
|
||||
Updating xCAT
|
||||
=============
|
||||
|
||||
If at a later date you want to update xCAT, first, update the software repositories and then run: ::
|
||||
If at a later date you want to update xCAT on the Management Node, first, update the software repositories and then run: ::
|
||||
|
||||
yum clean metadata # or, yum clean all
|
||||
yum update '*xCAT*'
|
||||
|
||||
# To check and update the packages provided by xcat-dep:
|
||||
yum update '*xcat*'
|
||||
|
||||
If running in a hierarchical environment, Service Nodes must be the same xCAT version as the Management Node. To update Service Nodes: `Diskless <https://xcat-docs.readthedocs.io/en/stable/advanced/hierarchy/provision/diskless_sn.html#update-service-node-stateless-image>`_ or `Diskful <https://xcat-docs.readthedocs.io/en/stable/advanced/hierarchy/provision/diskful_sn.html#update-service-node-diskful-image>`_
|
||||
|
||||
@ -20,5 +20,5 @@ To use the generated RPM from the step above for node discovery:
|
||||
1. Uninstall the old ``xCAT-genesis-base`` RPM and install the newly built ``xCAT-genesis-base`` RPM on the xCAT Management node
|
||||
2. Execute: ``mknb ppc64``
|
||||
|
||||
3. Follow :doc:`discover nodes </guides/admin-guides/manage_clusters/ppc64le/discovery/mtms/discovery.html>`
|
||||
3. Follow :doc:`discover nodes </guides/admin-guides/manage_clusters/ppc64le/discovery/mtms/discovery>`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user