SAP Applications and SUSE Linux Enterprise High Availability salt modules and States

This project has been created to provide salt modules and states for SAP HANA and other SAP applications and the SLE-HA clustering tools. For that, it wraps the shaptools project code. The main idea is to use this module in salt formulas to deploy these applications easily.

Installation and usage

INFO: Currently this project has been created as an independent project, but the idea is to merge to the salt project to extend it with these new functionalities.

Run locally

To run the module functionalities locally run:

cd salt-shaptools
sudo salt-call --local -m modules hana.is_installed

To run the state modules (there is a demo example in the demo folder) run:

cd salt-shaptools
sudo salt-call --retcode-passthrough -l debug -m . state.template demo/primary.sls

Run in minions

To run the module funcionalities in the minions:

1. Copy the content of modules in your "salt://_modules/" (by default /srv/salt/_modules)
2. Copy the content of states in your "salt://_states/" (by default /srv/salt/_states)
3. Synchronize modules with the minions. For that run:

sudo salt-call  saltutil.sync_all

4. Execute the module functionalities. For that run:

sudo salt-call hana.is_installed

Writing unit test

You can have look at: https://docs.saltstack.com/en/latest/topics/development/tests/unit.html

How to run the tests

Salt has a quite particular way to execute the tests. As a summary, tests are split in integration and unit tests. The first group tests the module using actual salt master/minions, so the setup is more complicated. The unit tests in the other hand only check the code functions.

In order to execute the tests, the test files must be stored in the salt project tests folder sub-folder (integration or unit, for example). By now, as the project is in a separated repository, the easiest way is to copy our project code to a actual salt repository and run the tests. For that follow the next instructions:

1. Download 2 needed extra projects: (saltstack and shaptools)

git clone --depth=50 https://github.com/openSUSE/salt
git clone https://github.com/SUSE/shaptools.git

Your directory layout should looks like ( all the 3 dirs are in same three dir level)

- salt-shaptools
- salt
- shaptools

2. Create a virtual environment, inside the salt-shaptools dir and install dependencies:

virtualenv saltvirtenv
source saltvirtenv/bin/activate

# python 3.6 - official requirements from salt (works with python >3.6)
pip install -r ../salt/requirements/pytest.txt
pip install -r tests/requirements.3.6.yaml # pinned pytest-cov
# or
# python 2.7 - latest available versions for old python release
pip install -r tests/requirements.2.7.yaml

pip install -e ../salt
pip install -e ../shaptools
rm ../salt/tests/conftest.py # remove this file from the saltstack repo

3. Run the tests. For that:

cd salt-shaptools
sudo chmod 755 tests/run.sh
./tests/run.sh

4. Running your modules/states:

For testing/running modules:

salt-call --local saptune.apply_solution "SAP-ASE"

For testing/running states:

salt-call --local state.single saptune.solution_applied "HANA"

Dependencies

A list of dependencies is named above in the pip install ... commands.

License

See the LICENSE file for license rights and limitations.

Author

Xabier Arbulu Insausti (xarbulu@suse.com)

Reviewers

Pull request preferred reviewers for this project:

• Xabier Arbulu Insausti (xarbulu@suse.com)