Troubleshooting in the shell

 





How to resolve commonly faced issues

The purpose of this guide is to provide some guidance to troubleshooting some recurring issues on the development server.

Possible trouble areas

  • Frontend 

  • Git workflows

  • Voice Telephony

  • Development servers


Everything is logged on a development server so as a general rule of thumb always check logs if there are any to assist in finding a solution. For example, if it is a PHP log, it is likely to be found here:

/usr/local/apache/logs/error_log

Frontend

Let’s say that you’re unable to access the web page due to a “Whoops Error”. There could be a number of reasons. If the stack trace includes [STALE WEBPACK-MIX ASSETS], running 


yarn install --check-files && yarn prod 


on the development server will safely bring the web app back. 


What actually happens

Yarn will fetch and rebuild the web assets and you should be able to use the web application afterwards.

What if you’re still unable to access the web app? Sometimes performing a hard reload by holding 

CTRL + SHIFT + R will remove cached data.


Git workflows

---Does the branch exist on my local? If yes, have I fetched changes onto local repo?

However, there are instances where you could face issues checking out a branch or updating a branch.

If you encounter an error like error: pathspec 'feature/branch-XYZ' did not match any file(s) known to git,

but you are certain the branch exists, you’ll need to track the branch yourself.


git branch -track [branch-name] origin/[branch-name]


There are cases where you are not able to checkout a branch because there may be local changes on the development server. Git recommends you stash those changes, or if you are willing to reset your changes, you can do a forced checkout. 


NB. 1. If you're working on a development server, you are not supposed to be live editing servers but it is still acceptable only when absolutely necessary. In this case you can safely discard the changes on the server and checkout to your branch.

   

Development Servers

Sometimes server issues may come from caching. Removing the cached files will usually resolve the issues.  

Sometimes the logs will give you a hint about the errors that are occurring on the development server, they may not be related to what you're doing at all.

You may encounter this error(check image below) while performing a rollback on a migration. This may due to the app running cached files.


Run the following commands
- php artisan clear-compiled

- composer dump-autoload

- php artisan optimize

Then Rollback again. The error should be gone.

This is all I can think of. For now.



Comments

Post a Comment

Popular posts from this blog

Coffee Culture in Ghana

Image
 I'm writing about coffee with a simple intention: knowledge sharing. I've always wanted to write about my interests. Currently, I've developed an interest in the nitty-gritty of coffee production, especially the Ghanaian coffee variety. You can go ahead and say it,  I have a coffee obsession. I don't intend to only write about coffee. I've spent a lot of time considering ways I can compile my observations in a more structured way because I tend to forget a lot of interesting things. Here goes... Most people in African countries drink tea, and Ghana is no exception. Typically, when we talk about morning beverages in Ghana, we have tea in mind. "Tea" as in Milo chocolate drink. I'm not criticising the way we think about our morning beverages, at least some of us take in a light breakfast.  Milo is the most popular morning breakfast here. Until Nescafe. Nescafe is an instant coffee that broke into the Ghanaian scene. Preparation of Nescafe is so convenie...
Read more

The Nostalgic Resurgence of Shounen Anime

Image
  A lot of millennials grew up watching anime. As a result, anime became part of our identities. A lot of us may have possessed  Dragon Ball or Pokemon paraphernalia. This is how influential otaku culture is to this generation. The problem is that the shounen formula became tiring as we grew up. Shounen anime is targeted at young boys, and the shounen formula always includes some form of struggle and solving challenges through camaraderie. Popularly known as the power of friendship. But it gets really annoying. Talk-no-jutsu is another anime trope that becomes terrifyingly dull. The protagonist literally "talks" the villain into defeat by signalling some virtue the mangaka wants to extol. In any case, lots of young people lost interest in following shounen anime that keeps running. Yes, we're looking at you Dragon Ball .  I loved One piece. It has stellar world-building, lovable characters and a marvellous story-line. The only problem is that One Piece has reached abou...
Read more

Writing Automated Tests with Kotlin

Image
Kotlin is a programming language that has been abstracted to the point that it can read like plain English. Kotlin helps a lot of devs tp easily refactor their whole codebase and maintain the code much more easily. Learning Kotlin is like learning any other programming language. You need to understand the syntax and also know some exceptions. Once you are comfortable using Kotlin, you'll appreciate programming a lot more and write code with greater efficiency. You can get started by taking these exercises . We're going to go through writing android tests using Kotlin. Prerequisites 1. Install the Android Studio IDE or Intellij IDE. One of the things to do to start, 2. Enable offline builds by clicking on the Toggle offline mode button.  3. Switch to feature/Clipboarde2e branch  4. Run  npx react-native bundle --platform android --dev true --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/ 5. Open ...
Read more