The WebSphere Portal Solution Installer (SI) is the recommended technology for installing add-ons to your WebSphere Portal server application. To use this functionality, developers need to provide their deployment resources in the Portal Application Archive (PAA) format that is consumed by the SI. The decisions you make when you build the PAA file will determine how easy it will be to troubleshoot any deployment issues and to maintain your application into the future. This document outlines best practices that you should adhered to when you create your PAA file. Also highlighted are some of the more common mistakes encountered when you build PAA files and the recommendations on how these issues can be resolved.