multiple minor fixes and some refactoring to more toward port unification and reduce complexity
cleaned up deploy notes and created run script