add troubleshooting section and upgrade instructions