CSWeb logs errors to a logs/api.log file located in the CSWeb sources folder in your web server's root directory. This log file has more detailed information to help you troubleshoot problems.
If you need assistance setting up CSWeb or troubleshooting problems, please email
cspro@lists.census.gov. Attach to the email any server logs to help the CSPro development team diagnose the problem.
To reconfigure or reset your CSWeb installation:
- Locate the CSWeb sources folder in your web server's root directory.
- Delete the file src/AppBundle/config.php.
- Delete the contents of var/cache folder.
- Open your web browser and launch the CSWeb setup page.
Delete the cache if you notice that your changes are not taking effect when you refresh the browser. From the CSWeb root folder the path to the cache folder is var/cache. Then refresh the browser.
Failed to connect to database. SQLSTATE[HY000] [1045] Access denied for user
The database username and database password are not correct. They should be set to the username and password for a MySQL user that has permissions to access the MySQL database.
Failed to connect to database. SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo failed: No such host is known.
The hostname is incorrect. This should be the hostname for the MySQL database, not the server hostname. In most cases the hostname should be "localhost" unless your database and web server are running on different computers. The hostname should NOT include "http://". If MySQL is running on a different port than the default, you should add the port to the hostname. For example, "localhost:3307".
Something went terribly wrong
This is a general error that could be caused by a number of different problems with the CSWeb configuration. For more information check the CSWeb log files and also check the Apache/IIS/PHP error log.
Failed to connect to localhost
You are using a server URL that uses localhost. Localhost can only be used to access the server from a web browser running on the server itself. To access the server from another computer or device you must use either a domain name or the IP address of the server. If your server does not have a domain name or a static IP address you will need to obtain one. If you are unsure how to do this, you may want to consider using Dropbox synchronization instead of CSWeb.
Unable to resolve host
Either the server URL is incorrect or your device is not connected to the network.
Resource not found on server
The server URL is not correct. The host portion of the URL is probably correct but the part that follows is not. This often happens when "ui" is used instead of "api" at the end of the URL. For example, http://example.org/csweb/ui instead of http://example.org/csweb/api. Always use "api" when syncing with CSWeb from CSPro and use "ui" only when accessing CSWeb from your web browser.
If you run into issues with the CURL library while using IIS a workaround is to disable the curl extension in php.ini and enable allow_url_fopen.