No | Possible Root Cause | Troubleshooting Guide | Solutions |
---|
1 | Client Device | The fastest way to check if the slowness is caused by the client device, is to access the same website / functions with multiple other devices. If Accessibility from other devices are normal, then the probability of slowness caused by the slowness in the device itself is almost certain. Regardless of whether it is mobile or desktop devices, see below for more steps to identify the root cause: - Android Devices
- iOS
- There are many system monitoring Apps in the iOS world as well, examples as below:
- Mac
- Out of the box, we could use the Activity Monitor that comes with Mac OS
- Windows
- There are many different versions of Windows out there, and there are plenty of resources for different versions of Windows, some of the useful resources as below:
Apart from System Performance monitoring, it is never alien to our technical support team that some of the client devices that have been infected by Virus is known to perform badly. Usually, when we detected high CPU usage, and high Network Bandwidth, we would also be recommending the users to install anti-virus software to detect the potential security threat to the devices. Another possibility is the web browser. When it comes to web-browser usage, settings, the following areas could be checked: - DNS settings
- Too many tabs
- Cache
- Proxy Settings
| Depends on the root cause from the troubleshooting of the client device, users could upgrade the RAM, Processor, or perform anti-virus scanning accordingly. At the time of reading, the following guide may be out-dated, but google is your best friends, there are plenty of resources available online to resolve the problems that you are having with optimizing your devices. |
2 | Client Local Area Network | When devices are not connected directly to the internet, it is possible it goes thru routers, switches, proxy servers and other possible network routes to access the Wavelet EMP on the cloud. There are a few ways to check and detect if the problems are caused by the Local Area Network: - Non-technical approach
- Getting help from another users from another location to access the website
- Use a different device that directly connect to the internet, for example you are having problems with your computer accessing the website, but you can test with your phone (without connecting to Wifi, use direct internet connection, 3G etc)
- Using Ping
- Ping your router IP address (not the google and not other external websites / servers)
- Monitoring the network performance on the networking devices
Widget Connector |
---|
url | https://www.youtube.com/watch?v=zTuM6NJyk94 |
---|
|
- this hyperlink provides tutorial for D-Link routers, but other routers should be similar as well, refer to the respective user manual for other routers.
- Other devices within the same local area network
- Sometimes, there's no problem with your device or routers, but there could be another device within the local area network that is infected by Virus, and consuming significant amount of bandwidth. It is also possible that somewhere in the LAN (Local Area Network), there's another users installed some applications like Torrent that download and share large files, or watching youtube, or consuming some live streaming content.
| |
3 | Client Internet Connectivity | On the client side, for easier troubleshoot. Please ask customer to use right tools such as Teamviewer. Top 3 reasons from client side
- The Obvious: The URL has a typo.
- Ask the user to double-check the URL. This may seem obvious but it is very critical that the user puts in the correct URL. It is better to ask the user to send you the URL so that you can examine and try it yourself. There are three things to note in the URL.
- Is the protocol correct? (i.e) http. Your Web Server admin could have very well blocked port 80 altogether
- Is the domain name and the resource being accessed correctly spelled?
- Is the Port number correct ? (if any). The browser will default http to 80 or http to 8080.
The user’s PC does not have Network connectionAsk the user to access other sites to make sure his PC is in the Network. If he cannot access any sites, chances are his PC is having some issues.
The user’s PC is not able to resolve names (DNS)It is possible that the user’s PC is unable to resolve any names due to DNS issues. Have the user execute “nslookup <domain name>” in command prompt and ensure that he is able to resolve the domain name to an IP.
The client router's problemAdvise client to find internal IT expert to fix their router until they able to connect to internet. Kindly inform customer we are not supporting internal problem such as router is reset, LAN cable doesn't work, problem with WIFI. We only support everything that related to EMP server and Port forwarding.If the server is accessible internally, but not accessible externally. You need to ask customer to open router page and login to the router's page and check the Port Forwarding setup. Get the router model and brand and proceed to research the configuration from google. If you can get their internal IT to fix port forwarding, that will be better.
The client's router is congestedRoot cause : A large number of network broadcasts, A large number of broadcasts can be an indication of a misconfigured or faulty NIC, host, switch, software, driver, etc. and can also be an indication of a malware infection somewhere in the networkHigh usage from user's client internally such as downloading and buffering behavior that consumes too much connectivity content.We can advise customer to "restart" their modem and router. Remove the power cord from the modem and/or router, wait at least 10 seconds, and then plug the modem and/or router back in.
The client's connection between EMP application server and database server- Root cause : There is some inconsistent connection between application and database server. You can tested by ssh to application server, and make connection from application to db server. Don't idle your connection. If you lost connection in between 10-15 minutes, there is problem with the network
- We can advise customer to install another segregated switch, with additional cables between the application and database server
Troubleshoot Internet connection problems http://windows.microsoft.com/en-us/windows-vista/troubleshoot-internet-connection-problems Guide to set DNS https://developers.google.com/speed/public-dns/docs/using?hl=en | |
4 | Public Internet | If you are connected from "Public Internet", you might experienced having difficulties of accessing URL which causes by: - Enhanced Protected Mode
- Browser History
- Browser Add-On
- Proxy and DNS Settings
- Browser need to be reset
- Check whether a third-party service, program, or anti-virus is conflicting with browser
- Temporarily disabling the firewall
- Updating older drivers and editing registry key TabProcGrowth
- Checking Windows Updates for drivers
- Restore or refresh your PC
| Refer to this wiki for solutions https://support.microsoft.com/en-us/kb/956196 |
5 | Data Center Network | - Identify the customer.
- Getting server URL from the customer, sometimes it might be IP address. Note that don't confuse the server IP address with the IP address of local network which most of time is similar to 192.168.X.Y.
- Identify the location of the server.
- Customer own host or Datae Center, please contact the person in charge from Data Center
- Internet connectivity of data center or customer host ( Point 1 to 4)
- Customer server condition.
- ssh port is accessible? Port forwarding access
- backup database can be restored and manually restored to wavelet cloud or AWS
If customer server located at AWS, login to aws.amazon.com using (staging-wavelet) account and go to EC2 Instance and check the instance status If customer located at Azure, login to - If customer servers located at Wavelet Cloud office, refer to
| |
6 | Server Network | A server network, or simply a network, is a collection of computers and other hardware components interconnected by communication channels that allow sharing of resources and information.
Basic knowledge of Networking, You don't need to be a CISCO Certified Engineer, but some basic knowledge about IP address, Sub-net mask, Gateway, DNS Server, Port Forwarding, Internal IP Address, External IP address of the modem or Router, how DYNDNShttp://www.cctvcamerapros.com/LinkSys-Port-Forwarding-s/122.htmhttp://pigtail.net/LRP/portforward.htmlhttp://documentation.netgear.com/dg834n/enu/202-10197-02/Advanced.7.3.html
Majority of customers located at AWS, to check the server network:Click the instance -> monitoring. Refer to network in and network out graph and observe
Image Removed If the network out too high, use netstat to observe which IP that causing high network out. kill and chmod the process will help
Power up new instance and migrate the customer database using the new and safer instance security. This to be done after working hours
Troubleshot the server network
- Check IP Config
- ifconfig (for linux customer)
- ipconfig (for windows customer)
- Set Static IP via terminal
- Refer to :
- Solve Session Time Out error in Firefox
- Refer to :
- Linux System Security
- Refer to :
| 7 | Server Operating Systems | - Server Operating Systems : Ubuntu, Centos, Amazon Linux AMI
- The different between Ubuntu and Centos
- Ubuntu : apt-get
- Centos : yum
Try to convince customer to migrate from their own host server to our Amazon AWS cloud if their server operating system has problem. You can use this terminology1) Instead of putting the money in your safe deposit box, under your pillow / bed, people put money in the bank.
2) Instead of building your own power generator, we use Tenaga Nasional electricity. If you just calculate the fuel you consume to generate the electricity, may be it is cheaper to operate your own power plant, but if you consider all costs involved, definitely more expensive.In addition, may be you have more than just Wavelet EMP, may be you have other corporate server, like website, intranet, file server, or any other servers, you can host it all in the same cloud instance (if the operating system is linux)
The advantages of using AWS cloud is customer doesn't need to worry about:- 1) Personnel cost to maintain the internet networking / hardware.
- 2) UPS Power
- 3) Electricity
- 4) No Worries about backup server
- 5) You don't need to worry about scaling
- 6) Everything is virtual, that means, at the click of one button, we can have disaster recovery off-site… to Japan / USA or other places.
| 8 | Server Application Server | To trouble Shoot Server Slow Unresponsive, always refer to basic guide at /wiki/spaces/WU/pages/11568251 The steps to checks: Server LogAs root, vim /usr/java/jboss/server/default/log/server.logScroll to the last line (shift+G) of the server logCheck the exception message, copy the exception message, find the 1st occurrence of the exception (but disregard those regular exceptions for example the one caused by PDF printing “.. unable to forward…”If the message looks something like ‘.. I/O exception…’ or ‘.. unable to connect to the database …’, check the database right away (refer to point 9 Server Database Server)If the message looks something like ‘.. out of memory…’, check the Java Memory Allocation CPU, Memory usageTo check the usage, type : You can display the details for the running processes, by typing cYou can sort the processes by highest memory usage first, by typing mIf the memory usage is mainly by PosgreSQL, refer to point 9If the CPU usage is high (>= 90%), type this command to check 3 to 5 process that consume high CPU: ps aux | sort -nrk 3,3 | head -n 5 |
---|
Kill the process that have high CPU Usually, virus inside /tmp folder, if find virus inside /tmp folder Directly remove the virus by : Put this command on crontab -e at other user instead of root user, because hackers usually attack by using root. For example user emp/empbackup/opswork. Please make sure the user that you choose to put crontab in is sudoers without having to put sudo password. Image Removed Put this command on crontab -e at other user instead of root user, because hackers usually attack by using root (emp, empbackup, opswork)This command will delete file inside /tmp folder every one minute */1 * * * * sudo rm -rf /tmp/* |
---|
Need to make sure doesn't need any password when type command: sudo su -Operating System log it could be caused by hardware failure, which will be recorded into the O/S log. You can access the O/S log at /var/log/message JBoss statusThis is no brainer, just make sure JBoss is actually running,And ONLY 1 instance of JBoss is running (if you are using docker container /wiki/spaces/WU/pages/13042094, /wiki/spaces/WU/pages/38928514)run command : Jboss memory allocation If RAM usage is very high, check the memory allocation for jboss : /usr/java/jboss-4.0.1RC2/server/default/deploy/jbossweb-tomcat50.sar/server.xml See if the xms is too low or xmx too high - compared to the RAM size. In most cases, customer is inpatient with server down, immediately offer to restart their server when idle in transaction happened. After restarting server, check the server log and troubleshot what was happened.Checking idle transaction : select * from pg_stat_activity where (state = 'idle in transaction') |
---|
select count(*), state, datname from pg_stat_activity where state = 'idle in transaction' group by datname, state order by count(*) desc |
---|
If jboss-stop doesn't run anything use : ps aux|grep java kill -9 2304 |
---|
Image Removed
etc/init.d/postgresql-9.2.4 restart jboss-start |
---|
Check previous date server log : cd /usr/java/jboss/server/default/log/ ls -lhrt |
---|
- Check the specific date of the server log
Missing run.sh and shutdown.sh from serverRefer to /wiki/spaces/WU/pages/379454572 | Client Local Area Network | When devices are not connected directly to the internet, it is possible it goes thru routers, switches, proxy servers and other possible network routes to access the Wavelet EMP on the cloud. There are a few ways to check and detect if the problems are caused by the Local Area Network: - Non-technical approach
- Getting help from another users from another location to access the website
- Use a different device that directly connect to the internet, for example you are having problems with your computer accessing the website, but you can test with your phone (without connecting to Wifi, use direct internet connection, 3G etc)
- Using Ping
- Ping your router IP address (not the google and not other external websites / servers)
- Monitoring the network performance on the networking devices
Widget Connector |
---|
url | https://www.youtube.com/watch?v=zTuM6NJyk94 |
---|
|
- this hyperlink provides tutorial for D-Link routers, but other routers should be similar as well, refer to the respective user manual for other routers.
- Other devices within the same local area network
- Sometimes, there's no problem with your device or routers, but there could be another device within the local area network that is infected by Virus, and consuming significant amount of bandwidth. It is also possible that somewhere in the LAN (Local Area Network), there's another users installed some applications like Torrent that download and share large files, or watching youtube, or consuming some live streaming content.
| |
3 | Client Internet Connectivity | On the client side, for easier troubleshoot. Please ask customer to use right tools such as Teamviewer. Top 3 reasons from client side - The Obvious: The URL has a typo.
- Ask the user to double-check the URL. This may seem obvious but it is very critical that the user puts in the correct URL. It is better to ask the user to send you the URL so that you can examine and try it yourself. There are three things to note in the URL.
- Is the protocol correct? (i.e) http. Your Web Server admin could have very well blocked port 80 altogether
- Is the domain name and the resource being accessed correctly spelled?
- Is the Port number correct ? (if any). The browser will default http to 80 or http to 8080.
- The user’s PC does not have Network connection
- Ask the user to access other sites to make sure his PC is in the Network. If he cannot access any sites, chances are his PC is having some issues.
- The user’s PC is not able to resolve names (DNS)
- It is possible that the user’s PC is unable to resolve any names due to DNS issues. Have the user execute “nslookup <domain name>” in command prompt and ensure that he is able to resolve the domain name to an IP.
- The client router's problem
- Advise client to find internal IT expert to fix their router until they able to connect to internet. Kindly inform customer we are not supporting internal problem such as router is reset, LAN cable doesn't work, problem with WIFI. We only support everything that related to EMP server and Port forwarding.
- If the server is accessible internally, but not accessible externally. You need to ask customer to open router page and login to the router's page and check the Port Forwarding setup. Get the router model and brand and proceed to research the configuration from google. If you can get their internal IT to fix port forwarding, that will be better.
- The client's router is congested
- Root cause : A large number of network broadcasts, A large number of broadcasts can be an indication of a misconfigured or faulty NIC, host, switch, software, driver, etc. and can also be an indication of a malware infection somewhere in the network
- High usage from user's client internally such as downloading and buffering behavior that consumes too much connectivity content.
- We can advise customer to "restart" their modem and router. Remove the power cord from the modem and/or router, wait at least 10 seconds, and then plug the modem and/or router back in.
- The client's connection between EMP application server and database server
- Root cause : There is some inconsistent connection between application and database server. You can tested by ssh to application server, and make connection from application to db server. Don't idle your connection. If you lost connection in between 10-15 minutes, there is problem with the network
- We can advise customer to install another segregated switch, with additional cables between the application and database server
| Troubleshoot Internet connection problems http://windows.microsoft.com/en-us/windows-vista/troubleshoot-internet-connection-problems Guide to set DNS https://developers.google.com/speed/public-dns/docs/using?hl=en |
4 | Public Internet | If you are connected from "Public Internet", you might experienced having difficulties of accessing URL which causes by: - Enhanced Protected Mode
- Browser History
- Browser Add-On
- Proxy and DNS Settings
- Browser need to be reset
- Check whether a third-party service, program, or anti-virus is conflicting with browser
- Temporarily disabling the firewall
- Updating older drivers and editing registry key TabProcGrowth
- Checking Windows Updates for drivers
- Restore or refresh your PC
| Refer to this wiki for solutions https://support.microsoft.com/en-us/kb/956196 |
5 | Data Center Network | - Identify the customer.
- Getting server URL from the customer, sometimes it might be IP address. Note that don't confuse the server IP address with the IP address of local network which most of time is similar to 192.168.X.Y.
- Identify the location of the server.
- Customer own host or Datae Center, please contact the person in charge from Data Center
- Internet connectivity of data center or customer host ( Point 1 to 4)
- Customer server condition.
- ssh port is accessible? Port forwarding access
- backup database can be restored and manually restored to wavelet cloud or AWS
If customer server located at AWS, login to aws.amazon.com using (staging-wavelet) account and go to EC2 Instance and check the instance status If customer located at Azure, login to - If customer servers located at Wavelet Cloud office, refer to
| |
6 | Server Network | - A server network, or simply a network, is a collection of computers and other hardware components interconnected by communication channels that allow sharing of resources and information.
- Basic knowledge of Networking, You don't need to be a CISCO Certified Engineer, but some basic knowledge about IP address, Sub-net mask, Gateway, DNS Server, Port Forwarding, Internal IP Address, External IP address of the modem or Router, how DYNDNS
- Majority of customers located at AWS, to check the server network:
- Troubleshot the server network
- Check IP Config
- ifconfig (for linux customer)
- ipconfig (for windows customer)
- Set Static IP via terminal
- Refer to :
- Solve Session Time Out error in Firefox
- Refer to :
- Linux System Security
- Refer to :
| |
7 | Server Operating Systems | - Server Operating Systems : Ubuntu, Centos, Amazon Linux AMI
- The different between Ubuntu and Centos
- Ubuntu : apt-get
- Centos : yum
- Try to convince customer to migrate from their own host server to our Amazon AWS cloud if their server operating system has problem.
- You can use this terminology
- 1) Instead of putting the money in your safe deposit box, under your pillow / bed, people put money in the bank.
- 2) Instead of building your own power generator, we use Tenaga Nasional electricity. If you just calculate the fuel you consume to generate the electricity, may be it is cheaper to operate your own power plant, but if you consider all costs involved, definitely more expensive.
- In addition, may be you have more than just Wavelet EMP, may be you have other corporate server, like website, intranet, file server, or any other servers, you can host it all in the same cloud instance (if the operating system is linux)
- The advantages of using AWS cloud is customer doesn't need to worry about:
- 1) Personnel cost to maintain the internet networking / hardware.
- 2) UPS Power
- 3) Electricity
- 4) No Worries about backup server
- 5) You don't need to worry about scaling
- 6) Everything is virtual, that means, at the click of one button, we can have disaster recovery off-site… to Japan / USA or other places.
| |
8 | Server Application Server | To trouble Shoot Server Slow Unresponsive, always refer to basic guide at /wiki/spaces/WU/pages/11568251 The steps to checks: | |
9 | Server Database Server | | common error is when postgres cannot start as postmasterpid has invalid data To solve: http://intranet.wavelet.asia/projects/tech/wiki/When_postgres_cannot_start_as_postmasterpid_has_invalid_data |
10 | Server Hard Disk | Note: Don't delete anything inside /var/lib/pgsql/data, we stored database inside that folder. It's normal for that folder have big size | |
11 | Wavelet EMP Itself | Server slowness can be found only from specific module from EMP caused by Inefficient code or SQL queries - Get from customer which module causing slowness and test from your personal PC or Laptop whether the module is really slow. Run command showlog, observe whether there is any exception error found. If you are not confident on the code, get any programmer to sit beside you and help to troubleshoot it.
- Variety of exceptions:
- org.postgresql.util.PSQLException. Solutions: copy the query before that error appeared and report to programming team to fix the SQL query.
- nullpointerExecption. Solutions: Repopulate the database to your localhost. Run the debug or your eclipse and found which table or queries causing null pointer exception. In most cases, error will be solved if you find which table has null data and update it to some values depends on the "Type". Example, if the Type is integer, you can update to 0, If it is string, update to '' or empty string
- Common cases is that Modules is missing from EMP. Please refer to below wiki to fix the problem.
| |
12 | Usage of EMP | - Sometimes users doesn't aware with the usage of generating report inside EMP is one of the cause of Server Slowness problem and they tend to generate report with long date range and heavy data at peak operating hours
- Clicking "generate report" button multiple also causing slowness. It is because everytime, user clicked the generate report button. The function will call database and pass all value that is shown in report. If user mistakenly click 5 times, the function will do the same thing 5 times and might result Out of memory problem and idle transaction.
- Solutions:
- Advise customer to generate heavy report out of peak hours example after 8PM and before 9AM
- Be careful when choosing the date range. Report that includes serial number tend to show a lot of data and entries. Advise customer to choose maximum 1 week date range only
- If customer denied that he/she generated heavy report when slowness occured, go to server.log and shows the proof to the person in charge.
- Include username, date, report name, date range generated screenshot. You may use point 9 to check
| |