Health
PlatformDomainAcademyDesign SystemFeedback
v1.7
v1.7
  • 👋Introducing Health
    • Release Notes
      • HCM v1.7 Release Notes
        • Release Checklist
        • Eligibility Checklist
        • Service Build Updates
      • HCM v1.6 Release Notes
        • Service Build Updates
        • Release Checklist
        • Migration from v1.5 to v1.6
      • HCM v1.5 Release Notes
        • Migration from v1.4 to v1.5
        • Service Build Updates
        • Release Checklist
      • HCM v1.4 Release Notes
        • Migration from v1.3 to v1.4
        • Service Build Updates
        • Release Checklist
      • v1.3 Release Notes
      • v1.3 Tech Release Summary
        • Master Data Management Service (MDMS) & Configuration Updates
        • Test Cases
        • Service Build Updates
      • v1.2 Release Notes
      • v1.0 Release Notes
  • Product Roadmap
  • 💙HEALTH CAMPAIGN MANAGEMENT
    • Understanding Health Campaign Management (HCM)
    • Value Proposition
  • 🎯HCM PRODUCT SUITE
    • Functional Specifications
      • Campaign Type Setup
      • Campaign Setup
      • Inventory
      • Boundary Hierarchy
      • Beneficiary
      • Boundary Data Specs
      • Draft System User Setup
      • Role Action Mapping
    • Building Blocks & Services
    • Health Products
      • HCM App
        • User Manual
          • Single Round Campaigns
            • Registration & Delivery
              • Registration & Delivery: IRS
          • Multi-Round Campaigns
            • Registration & Delivery
            • Download Beneficiary Data
          • Common Functions
            • User Management
            • 2D Voucher Scanning
            • Proximity-Based Search
            • Voucher-Based Registration and Distribution
            • Tracking Beneficiary Referrals
            • Tracking Side-Effects for Beneficiaries
            • Tracking Adverse Events
            • Health Facility Referral
            • Raising Complaints
            • Resolving Complaints
            • Inventory Management
              • User Manual
                • Stock Management
                • Stock Reconciliation
                • View Reports
                • Bale Scanning
            • Attendance Management
            • Payments
              • Guide to HCM Payments
            • Community Living Facilities
              • Product Requirement Document
          • Support Functions
            • Language Selection
            • Login
            • Forgot Password
            • Project Selection
            • Hamburger Menu
            • Help
            • Sync
            • Checklist
      • Campaign Management Dashboard
        • User Manual
        • Configurations
          • MDMS Configurations and s3 assets
          • IRS Dashboard Chart Configurations
        • Kibana Dashboard Integration With DSS Module
          • Auth Proxy Setup and Configuration for Kibana
        • SMC Dashboard
      • Microplanning
      • HCM Console
      • Health Payments
        • MDMS Configurations
        • Attendance Update and Approval Process
          • Project Selection
          • Register Inbox
          • View Attendance:Edit And Approve
        • Bill Generation Process
          • Project And Bill Aggregation
          • Bill Generation
          • My Bills
  • 🚀REFERENCE IMPLEMENTATIONs
    • Mozambique
      • LLIN Overview
      • Customisation
      • Rollout
  • 🧰TECHNOLOGY
    • Architecture
      • High Level Design
        • Health Campaign System High Level Design
        • Design Decision Log
      • Low Level Design
        • Registries
          • Individual
          • Household
          • Product
          • Facility
          • Attendance
          • Expense
        • Services
          • Project
          • Stock
          • Referral
          • Muster Roll
          • Expense Calculator
      • Field App Architecture
        • UI Packages
          • Closed HouseHold package
          • Registration & Delivery Package
            • Eligibility Checklist
            • Communal Living Facilities
          • Referral Reconciliation Package
          • Inventory Management Package
          • Attendance Management Package
          • DIGIT Scanner Package
          • Digit Showcase Package
          • Digit Data Model Package
          • DIGIT DSS Package
          • Complaints Package
          • Survey Form Package
          • Sync Service Package
    • Standards
    • Security
    • Interoperability
  • 🪝SETUP
    • Planning an HCM Implementation
    • Establish Project & Team
    • Gathering Requirements
    • Installation
      • Install Using GitHub Actions in AWS
      • System Data Setup
      • Project Data Setup
      • Setup Mobile App
      • Setup Kibana Dashboard
        • Create or Edit Existing Dashboards
      • Server Cleanup
    • Configuration
      • Configuring HCM to Campaign and Country Needs
      • Service Configuration
        • Individual Registry
        • Household Registry
        • Product Registry
        • Facility Registry
        • Stock & Inventory
        • Project Services
        • Referral Management
        • Attendance
        • Complaints
          • QA Sign-Off
            • Test Cases
        • User Management
          • QA Sign-Off
        • Muster Roll
        • Expense Service
        • Expense calculator
      • UI Configuration
        • Stock Management
        • Language Selection
        • Login
        • Forgot Password
        • Project Selection
        • Dashboard Configuration
          • Dashboard UI Enhancements
          • HCM Dashboard Master Promotion Guide
        • Attendance Management
          • Attendance Package Extraction and Interaction with HCM Application
    • Quality Assurance Testing
      • Regression Test cases
        • HCM Product
        • HCM Console
        • Microplanning
      • Eligibility and CLF Test cases
      • Console v0.3.1
      • Micro planning v0.2
      • HCM Payments v0.1
  • 🔵COMMUNITY
    • Source Code
    • Committee
      • Digital Product Advisory Committee Charter
      • Idea Management Process
      • Sessions
        • November 2023 Session
        • August 2024 Session
          • Minutes of the Meeting
        • December 2024 Session
    • HCM Declarative Statements & FAQs
Powered by GitBook
On this page
  • Overview
  • Restart Zuul service
  • Steps to Load Project Data
  • Seed Data Postman Script
  • Loading Localisation
  • HCM Console:

Was this helpful?

Export as PDF
  1. 🪝SETUP
  2. Installation

Project Data Setup

PreviousSystem Data SetupNextSetup Mobile App

Last updated 2 months ago

Was this helpful?

https://creativecommons.org/licenses/by/4.0/

Overview

This step involves the execution of the Postman collection for the minimum setup data required to run a campaign from the field worker app.

Restart Zuul service

  • Before you start loading the project data, execute the below command to restart the Zuul gateway.

  • Check if all the services are up and running by using the following command:

kubectl get pods -n egov
  • If all the services are running with Ready 1/1, then restart the Zuul service by using the command given below:

kubectl delete pods {zuul-pod-name} -n egov

Steps to Load Project Data

All file examples in this document refer to the default branches in the health campaign DevOps and configuration repositories for example purposes. If you have replaced these repositories with your fork or clone, refer to the same here.

Create an environment variable file and add the below variables in Postman:

  • Click on New, and Environment, then add the following variables:

  • URL - domain_name provided in infra-as-code/terraform/sample-aws/input.yaml

    • e.g. https://{domain_name}

  • tenantId - mz

  • apiUserName and apiPassword - newly created superuser credentials

  • startDate and endDate in epoch format - epoch converter

  • boundaryCode - use the default value (VFTw0jbRf1y) if Master data is unchanged

  • Import the seed data script

Seed Data Postman Script

  • This collection includes all the scripts to create users, projects, staff, and product variants.

  • Import the HCM setup script in Postman - import guide

  • Choose the new environment created in the environment tab:

  • Once the environment is selected, click on the imported HCM setup collection, click run:

Loading Localisation

Localisation is required to load and show data in different available languages. You can add localisation for English, French, and Portuguese languages by following the instructions given below. If only one specific language is required, download that language-specific collection and run it.

Prepare To Setup

  • Create a port forward to the localisation pod by executing the below command:

kubectl port-forward svc/egov-localization -n egov 8080:8080
  • Replace the URL variable in the Postman Environment to http://localhost:8080

All Languages (English, French, Portuguese)

  • Define locale code for localeEnglish, localeFrench, and localePortuguese in the environment file.

    • localeEnglish - en_MZ

    • localeFrench - fr_MZ

    • localePortuguese - pt_MZ

  • Download the below file for all localisations (English, French, and Portuguese) data to be loaded at once:

  • Import the downloaded file into Postman, select all language localisation collections, and click on run. See the screenshot below for reference:

Instructions for installation of HCM in English

  • To add localisations specific to the English language only, download the file given below:

Import the downloaded file into Postman, select the English collection, and click on run. See the screenshot below for reference:

Instructions for installation of HCM in French

  • To add localisations specific to the French language only, download the file given below:

Import the downloaded file into Postman, select the French collection, and click on run. See the screenshot below for reference:

Instructions for installation of HCM in Portuguese:

  • To add localisations specific to the Portuguese language only, download the file given below:

Import the downloaded file into Postman, select the Portuguese collection, and click on run. See the screenshot below for reference:

HCM Console:

Refer to the HCM Console User manual to set up a Campaign through HCM Console.

Help Section:

  1. Ensure that the Filestore Service is running properly. If it's not, refer to this link for troubleshooting.

  2. Create new products and use them when configuring delivery rules. Avoid using default values in the quick setup flow. Delete the default resources, click on "Add Resources," and then select the items you want to deliver.

124KB
HCM seed.postman_collection.json
18MB
HCM_Localisations_Seed.postman_collection.json
599KB
V0.3 Console en_MZ.postman_collection.json
6MB
Localization_Seed_French.postman_collection.json
1MB
Localization_Seed_Portuguese.postman_collection.json
Portuguese Localisation Collection