Gateway Training documents

1. Gateway Installation Steps

• SSH to mb1-56 (or any other cluster)

• sudo su - (login as root)

• yum list | grep caringo (to check what is already installed)

• yum remove caringo-gateway (to remove previously installed gateway)

• rm -rf /etc/caringo/cloudgateway (to clean the system)

• cat /etc/centos-release (to check installed OS)

• yum upgrade (to upgrade the latest OS)

• ls -ltra /tools/drop/solutions/bundleparts/ | grep caringo | tail ---- To check latest gateway rpm's

• yum install /tools/drop/solutions/bundleparts/caringo-gateway-8.2.0-0.8.2.0.rc2.20241204T232957Z.noarch

• run command - /opt/caringo/cloudgateway/bin/initgateway

• Check the status of gateway using command : systemctl status cloudgateway

• Install Web UI :

  yum install /tools/drop/solutions/bundleparts/caringo-gateway-webui-version

  yum install /tools/drop/solutions/bundleparts/caringo-storage-webui-version

• Check all installed caringo build uisng command - “ rpm -q --all | grep caringo”

Open

2. Gateway build installation jenkins Job

Refer this job and pass build name in the “DEPLOY_GATEWAY_RPM_FILENAME” field and fill other fields based on the requirement.

https://jenkins2.englab.local/job/CICD/view/new%2003-ATOMIC%20JOBS/job/atomic-gateway-deploy-v2310/253/rebuild/parameterized

3. Gateway Automation Code

• Gateway hybridcloud repatriation automation test code https://bitbucket.org/caringo/csgateway/src/master/src/test/frameworks/pytest-datacore/v0.0.0.1/datacore/swarm/gateway/   

•   HC Repatiration setup code and validation methods for all testcases, look into this code https://bitbucket.org/caringo/csgateway/src/master/src/test/frameworks/pytest-datacore/v0.0.0.1/datacore/swarm/gateway/hybridcloud/repatriation/resources/v7_9_9_9/common_lib/verify_methods.py

• For Test suite level confgiuration code , look into conftest.py https://bitbucket.org/caringo/csgateway/src/master/src/test/frameworks/pytest-datacore/v0.0.0.1/datacore/swarm/gateway/conftest.py    

• CSgateway all library files https://bitbucket.org/caringo/datacore-swarm-qa/src/master/packages/datacore_swarm_qa/

• Sample jenkins library files https://bitbucket.org/caringo/datacore-swarm-jenkins-shared-libs/src/master/resources/pipelines/atomic/win/atomic-gateway-runseleniumtests-v0503.groovy

• GW Test Automation framework https://datacore-my.sharepoint.com/:w:/p/jeffrey_fisher/EUs6L84m3bxGns92t3R0_GEBazXKc1_JHvNwIoVmnBuVQQ

• Gateway Python automation code documentation http://jenkins.tx.caringo.com:8080/job/CICD/view/90-Jobs%20Under%20Dev/job/atomic-gateway-builddocs-v0503/lastSuccessfulBuild/artifact/TestReferenceDoc/py-modindex.html

• Sample GW Automation testsuite execution report http://jenkins.tx.caringo.com:8080/job/CICD/view/06-TEST%20REPORTS/job/atomic-gateway-gentestreports-v0503/826/artifact/reports/

• Pytest command to run GW HC repatriation test on local testbed python3 -m pytest test_hc_move.py -s -- datacore_swarm_test_gateway_hostname=mb1-54.englab.local --datacore_swarm_TR_timestamp=auto --datacore_swarm_test_version_gateway=7.10.3.0 --datacore_swarm_test_version_gateway_uic=7.7.0.0 --datacore_swarm_test_version_gateway_uis=3.4.0.0 --datacore_swarm_test_data_model_to_use=Snippets

•  Command to run HC Repatriation UI test on local testbed python3 -m pytest -m -m videoclip -s -v --datacore_swarm_test_gateway_hostname=cloudscaler1.tx.caringo.com

  --datacore_swarm_TR_timestamp=auto --datacore_swarm_test_version_gateway=7.10.0.0 --datacore_swarm_test_version_gateway_uic=7.10.0.0

   --datacore_swarm_test_version_gateway_uis=3.5.0.0  ./datacore/swarm/gateway/gw_ui_automation/test_videoclip_ui.py

• Datacore Swarm Automation Test Framework - User guide and Technical reference, Testcase reference docs https://datacoremy.sharepoint.com/:w:/p/jeffrey_fisher/EZVeryA9K49EuGi6eHoI0HgBApWmFraIfpBAdHFCnagizg or login into Jenkins page http://jenkins.tx.caringo.com:8080/job/CICD/ and click on these links

  Open

  

   

• idsys and policy.json files used for Testing purpose

• Jenkins Hybrid cloud Repatriation test suite run - Job link Job with marker “copy “ to run specific testacses marked with “copy“ string https://jenkins2.englab.local/job/CICD/view/new 03-ATOMIC JOBS/job/atomic-gateway-runpytests-v0503/135/ (sample job run) HCR testsuite Jenkins job link run with marker - SGW_HCR marker https://jenkins2.englab.local/job/CICD/view/new 03-ATOMIC JOBS/job/atomic-gateway-runpytests-v0503/136/

• Jenkins UI job - Hybrid cloud repatriation UI testcases job link http://jenkins.tx.caringo.com:8080/job/CICD/view/03-ATOMIC JOBS/job/atomic-gateway-runseleniumtests-v0503/

• Jennins UI job: Videoclip UI tetscases - https://perifery.atlassian.net/browse/CLOUD-4082 .Jenkins job can be run from http://jenkins.tx.caringo.com:8080/job/CICD/view/03-ATOMIC JOBS/job/atomic-gateway-runseleniumtests-v0503/ once issue is FIXED.