/
Gateway Training documents

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”

image-20241218-061834.png

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

    image-20250106-062528.png

     

  • idsys and policy.json files used for Testing purpose

    image-20250106-070244.png

  • 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.