Hello community,
here is the log from the commit of package sapnwbootstrap-formula for
openSUSE:Factory checked in at 2020-08-20 22:31:20
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/sapnwbootstrap-formula (Old)
and /work/SRC/openSUSE:Factory/.sapnwbootstrap-formula.new.3399 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "sapnwbootstrap-formula"
Thu Aug 20 22:31:20 2020 rev:12 rq:828069 version:0.5.1+git.1597913457.86e3b88
Changes:
--------
---
/work/SRC/openSUSE:Factory/sapnwbootstrap-formula/sapnwbootstrap-formula.changes
2020-07-07 13:01:29.122339710 +0200
+++
/work/SRC/openSUSE:Factory/.sapnwbootstrap-formula.new.3399/sapnwbootstrap-formula.changes
2020-08-20 22:31:25.464054161 +0200
@@ -1,0 +2,6 @@
+Thu Aug 20 02:19:18 UTC 2020 - Simranpal Singh <[email protected]>
+
+- Version 0.5.1
+ * Add pillar.example to package
+
+-------------------------------------------------------------------
Old:
----
sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049.tar.gz
New:
----
sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88.tar.gz
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ sapnwbootstrap-formula.spec ++++++
--- /var/tmp/diff_new_pack.iHn16n/_old 2020-08-20 22:31:26.012054417 +0200
+++ /var/tmp/diff_new_pack.iHn16n/_new 2020-08-20 22:31:26.016054419 +0200
@@ -19,7 +19,7 @@
# See also http://en.opensuse.org/openSUSE:Specfile_guidelines
Name: sapnwbootstrap-formula
-Version: 0.4.4+git.1594058536.82f1049
+Version: 0.5.1+git.1597913457.86e3b88
Release: 0
Summary: SAP Netweaver platform deployment formula
License: Apache-2.0
@@ -52,6 +52,7 @@
mkdir -p %{buildroot}%{fdir}/metadata/%{fname}
cp -R %{fname} %{buildroot}%{fdir}/states
cp -R %{ftemplates} %{buildroot}%{fdir}/states/%{fname}
+cp pillar.example %{buildroot}%{fdir}/states/%{fname}
cp -R form.yml %{buildroot}%{fdir}/metadata/%{fname}
if [ -f metadata.yml ]
then
++++++ _service ++++++
--- /var/tmp/diff_new_pack.iHn16n/_old 2020-08-20 22:31:26.040054431 +0200
+++ /var/tmp/diff_new_pack.iHn16n/_new 2020-08-20 22:31:26.040054431 +0200
@@ -4,8 +4,8 @@
<param name="scm">git</param>
<param name="exclude">.git</param>
<param name="filename">sapnwbootstrap-formula</param>
- <param name="versionformat">0.4.4+git.%ct.%h</param>
- <param name="revision">82f104952d812f4413920b8e38e63a95fc8984c5</param>
+ <param name="versionformat">0.5.1+git.%ct.%h</param>
+ <param name="revision">86e3b883940101531c106fc223c481c949eb73a1</param>
</service>
<service name="recompress" mode="disabled">
++++++ sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049.tar.gz ->
sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88.tar.gz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/README.md
new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/README.md
--- old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/README.md
2020-07-06 20:02:16.000000000 +0200
+++ new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/README.md
2020-08-20 10:50:57.000000000 +0200
@@ -1,31 +1,61 @@
-# SAP Netweaver salt formula
+# SAP Netweaver Salt formula
-Salt formula for bootstrapping and managing SAP Netweaver platform. Currently
the next SAP Netweaver components are available:
+Salt formula to bootstrap and manage SAP Netweaver platforms.
+## Features
+
+Currently the next SAP Netweaver components are available:
- ASCS instance
- ERS instance
- PAS instance
- AAS instance
- Database instance (this adds the required users, tables, views, etc to the
current Hana database)
+Besides that, the formula setups all of the pre requirements as:
+- Hostnames
+- Virtual addresses
+- NFS mounts
+- Shared disks
+- SWAP partition space
+
The formula follows the best practices defined in the official [SUSE
documentation](https://www.suse.com/media/white-paper/sap_netweaver_availability_cluster_740_setup_guide.pdf?_ga=2.211949268.1511104453.1571203291-1421744106.1546416539).
**Disclaimer: the formula only works with SAP Hana as database.**
## Installation
-The package can be installed copying the content directly to the configure
salt `file_roots` or via zypper in SUSE distributions.
+The project can be installed in many ways, including but not limited to:
+
+1. [RPM](#rpm)
+2. [Manual clone](#manual-clone)
+
+### RPM
+
+On openSUSE or SUSE Linux Enterprise you can just use the `zypper` system
package manager:
+```shell
+zypper install sapnwbootstrap-formula
+```
+
+**Important!** This will install the formula in
`/usr/share/salt-formulas/states/netweaver`. Make sure that
`/usr/share/salt-formulas/states` entry is correctly configured in your Salt
minion configuration `file_roots` entry if the formula is used in a masterless
mode.
+
+Find the latest development repositories at SUSE's Open Build Service
[network:ha-clustering:sap-deployments:devel/sapnwbootstrap-formula](https://build.opensuse.org/package/show/network:ha-clustering:sap-deployments:devel/sapnwbootstrap-formula).
- # To use a development version
- # zypper ar
https://build.opensuse.org/project/show/network:ha-clustering:Factory ha-cluster
+### Manual clone
- zypper in sapnwbootstrap-formula
+```
+git clone https://github.com/SUSE/sapnwbootstrap-formula
+cp -R cluster /srv/salt
+```
+
+**Important!** The formulas depends on
[salt-shaptools](https://github.com/SUSE/salt-shaptools) package. Make sure it
is installed properly if you follow the manual installation (the package can be
installed as a RPM package too).
## Usage
+### Pre-requirements
+
The formula has some hard dependencies and all of them must be in place for a
successful netweaver deployment.
-- In order to deploy a correct Netweaver environment a NFS share is needed
(SAP stores some shared files there). The NFS share must have the folders
`sapmnt` and `usrsapsys` in the exposed folder. It's a good practice the store
this folder with the Netweaver SID name (for example `/sapdata/HA1/sapmnt` and
`/sapdata/HA1/usrsapsys`). **This subfolders content is removed by default
during the deployment**.
+- In order to deploy a correct Netweaver environment a NFS share is needed
(SAP stores some shared files there). The NFS share must have the folders
`sapmnt` and `usrsapsys` in the exposed folder. It's a good practice the create
this folder with the Netweaver SID name (for example `/sapdata/HA1/sapmnt` and
`/sapdata/HA1/usrsapsys`). **This subfolders content is removed by default
during the deployment**.
- Netweaver installation software (`swpm`) must be available in the system. To
install the whole Netweaver environment with all the 4 components, the `swpm`
folder, `sapexe` folder, `Netweaver Export` folder and `HANA HDB Client`
folders must already exist, or be previously mounted when provided by external
service, like NFS share. The `netweaver.sls` pillar file must be updated with
all this information. `Netweaver Export` and `HANA HDB Client` folders must go
in `additional_dvds` list. Check the [pillar.example](./pillar.example) for
more details.
@@ -35,7 +65,47 @@
Find an example about all of the possible configurable options in the
[pillar.example](pillar.example) file.
-## Salt pillar encryption
+### Configuration
+
+Follow the next steps to configure the formula execution. After this, the
formula can be executed using `master/minion` or `masterless` options:
+
+1. Modify the `top.sls` file (by default stored in `/srv/salt`) including the
`netweaver` entry.
+
+ Here an example to execute the Netweaver formula in all of the nodes:
+
+ ```
+ # This file is /srv/salt/top.sls
+ base:
+ '*':
+ - netweaver
+ ```
+
+2. Customize the execution pillar file. Here an example of a pillar file for
this formula with all of the options:
[pillar.example](https://github.com/SUSE/sapnwbootstrap-formula/blob/master/pillar.example)
+
+3. Set the execution pillar file. For that, modify the `top.sls` of the
pillars (by default stored in `/srv/pillar`) including the `netweaver` entry
and copy your specific `netweaver.sls` pillar file in the same folder.
+
+ Here an example to apply the recently created `netweaver.sls` pillar file
to all of the nodes:
+
+ ```
+ # This file is /srv/pillar/top.sls
+ base:
+ '*':
+ - netweaver
+ ```
+
+4. Execute the formula.
+
+ 1. Master/Minion execution.
+
+ `salt '*' state.highstate`
+
+ 2. Masterless execution.
+
+ `salt-call --local state.highstate`
+
+**Important!** The hostnames and minion names of the netweaver nodes must
match the output of the `hostname` command.
+
+### Salt pillar encryption
Pillars are expected to contain private data such as user passwords required
for the automated installation or other operations. Therefore, such pillar data
need to be stored in an encrypted state, which can be decrypted during pillar
compilation.
@@ -50,6 +120,15 @@
- If a masterless approach is used (as in the current automated deployment)
the gpg private key must be imported in all the nodes. This might require the
copy/paste of the keys.
+## OBS Packaging
+
+The CI automatically publishes new releases to SUSE's Open Build Service every
time a pull request is merged into `master` branch. For that, update the new
package version in
[_service](https://github.com/SUSE/sapnwbootstrap-formula/blob/master/_service)
and
+add the new changes in
[sapnwbootstrap-formula.changes](https://github.com/SUSE/sapnwbootstrap-formula/blob/master/sapnwbootstrap-formula.changes).
+
+The new version is published at:
+-
https://build.opensuse.org/package/show/network:ha-clustering:sap-deployments:devel/sapnwbootstrap-formula
+-
https://build.opensuse.org/package/show/openSUSE:Factory/sapnwbootstrap-formula
(only if the spec file version is increased)
+
## License
See the [LICENSE](LICENSE) file for license rights and limitations.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/_service
new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/_service
--- old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/_service
2020-07-06 20:02:16.000000000 +0200
+++ new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/_service
2020-08-20 10:50:57.000000000 +0200
@@ -4,7 +4,7 @@
<param name="scm">git</param>
<param name="exclude">.git</param>
<param name="filename">sapnwbootstrap-formula</param>
- <param name="versionformat">0.4.4+git.%ct.%h</param>
+ <param name="versionformat">0.5.1+git.%ct.%h</param>
<param name="revision">%%VERSION%%</param>
</service>
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/sapnwbootstrap-formula.changes
new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/sapnwbootstrap-formula.changes
---
old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/sapnwbootstrap-formula.changes
2020-07-06 20:02:16.000000000 +0200
+++
new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/sapnwbootstrap-formula.changes
2020-08-20 10:50:57.000000000 +0200
@@ -1,4 +1,10 @@
-------------------------------------------------------------------
+Thu Aug 20 02:19:18 UTC 2020 - Simranpal Singh <[email protected]>
+
+- Version 0.5.1
+ * Add pillar.example to package
+
+-------------------------------------------------------------------
Thu May 28 22:00:38 UTC 2020 - Simranpal Singh <[email protected]>
- Version 0.5.0
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/sapnwbootstrap-formula.spec
new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/sapnwbootstrap-formula.spec
---
old/sapnwbootstrap-formula-0.4.4+git.1594058536.82f1049/sapnwbootstrap-formula.spec
2020-07-06 20:02:16.000000000 +0200
+++
new/sapnwbootstrap-formula-0.5.1+git.1597913457.86e3b88/sapnwbootstrap-formula.spec
2020-08-20 10:50:57.000000000 +0200
@@ -52,6 +52,7 @@
mkdir -p %{buildroot}%{fdir}/metadata/%{fname}
cp -R %{fname} %{buildroot}%{fdir}/states
cp -R %{ftemplates} %{buildroot}%{fdir}/states/%{fname}
+cp pillar.example %{buildroot}%{fdir}/states/%{fname}
cp -R form.yml %{buildroot}%{fdir}/metadata/%{fname}
if [ -f metadata.yml ]
then
