# FAQs

<details>

<summary>Q1. Which versions of tools are recommended for use with DIGIT?</summary>

A. Git - 2.38.1 (latest version)

Java - JDK 8

Intellij - 2022.2.3(latest version)

Kafka - 3.2.0(latest version)

Postman - v9.4(latest version)

Kubectl - 1.25.3(latest version)

Postgres - v10

</details>

<details>

<summary>Q2. Which IDE is recommended for DIGIT development?</summary>

**A.** Intellij, Eclipse, VS Code or any other preferred IDE can be used. Make sure that it supports Java development and install the Lombok plugin for the IDE.

</details>

<details>

<summary>Q3. What are the tools which make development effortless?</summary>

**A**.\
[Jsonformatter.org](http://jsonformatter.org) is a lightweight tool which is quite handy when it comes to working with sending postman requests and putting objects to Kafka topics. Another such site is [editor.swagger.io](http://editor.swagger.io) which makes reading/designing APIs a lot easier and understandable. Use Postman to test APIs. Use k9s to work with your Kubernetes clusters.

</details>

<details>

<summary>Q4. Is it necessary to get a new auth token every few hours?</summary>

**A.** Auth tokens come with an expire period after which you will have to refresh it by hitting the oauth2 APIs.

If you don’t want to refresh auth now and again you can port-forward services and get the same result. There are a couple of things to keep in mind though.

1. As there are many services to port forward, you must not mix up port numbers while port forwarding.
2. Port forwarding by-passes the zuul api gateway, hence in this case, when accessing a service directly, for a request to be valid, a user has to send the userInfo JSON inside the RequestInfo object.

Sample

```json
"userInfo": {
"id": 24226, 
"uuid": "11b0e02b-0145-4de2-bc42-c97b96264807", 
"userName": "sample_user", 
"roles": [
             {
                 "name": "Citizen", 
                 "code": "CITIZEN"
             }
         ]
}
```

</details>

<details>

<summary>Q5. What are our options when we get a bad request response in postman?</summary>

**Answer**

You can disconnect the forwarded port and start port forwarding again with recheck on port numbers. If this doesn’t solve the error, in some cases like adding mdms configuration, you can restart the pod to get the desired output.

</details>

<details>

<summary>Q6. I deployed the service in a DIGIT environment. But I am getting a 400 or 500 from Zuul.</summary>

Check whether the service is up. Insert appropriate namespace in the commands below.

```sh
kubectl describe service -n <namespace>
```

Check whether the pod is up.

<mark style="color:blue;">`kubectl describe pod -n egov`</mark>

Check the ingress and make sure the context path is right.

<mark style="color:blue;">`kubectl describe ingress <service name> -n egov`</mark>

</details>

<details>

<summary>Q7. My service, pod, ingress are all looking good. But I am still getting a ZuulRuntimeException. What do I do?</summary>

This could be a forwarding issue from Zuul to services. Restart Zuul and restart your service.

</details>

<details>

<summary>Q8. I made a change to the role action mapping in MDMS. But I am unable to access the APIs. Getting a 403 unauthorized error.</summary>

Restart MDMS so it picks up the role action mapping. Also restart the access control service. Access control caches the role action mappings for 15 minutes. Hence a hard restart will force the cache to reset.

</details>

<details>

<summary>Q9. My pod is in CrashLoopBackOff. What do I do?</summary>

</details>

\\


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digit.org/platform/guides/developer-guide/backend-developer-guide/faqs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.