{"id":3754,"date":"2009-03-16T22:52:04","date_gmt":"2009-03-16T22:52:04","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/webdev\/2009\/03\/16\/web-packaging-installing-web-packages-using-command-line\/"},"modified":"2009-03-16T22:52:04","modified_gmt":"2009-03-16T22:52:04","slug":"web-packaging-installing-web-packages-using-command-line","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/web-packaging-installing-web-packages-using-command-line\/","title":{"rendered":"Web Packaging: Installing Web Packages using Command Line"},"content":{"rendered":"

Today I want to advance our discussions around Web Deployment in Visual Studio 10\u2026  To catch up on the previous discussions in this series check out:<\/p>\n

  • Web Deployment with VS 2010 and IIS<\/a> <\/li>\n
  • Web Packaging: Creating a Web Package using VS 2010<\/a> <\/li>\n
  • Web Packaging: Creating web packages using MSBuild<\/a> <\/li>\n
  • \n

    How does Web Deployment with VS 10 & MSDeploy Work?<\/a> <\/p>\n

    In this post I will focus on installing the MSDeploy based Web Packages to IIS.  You can actually install\/deploy web packages using multiple different avenues listed below:<\/p>\n

      \n
    1. Using IIS Manager UI <\/li>\n
    2. Using command file created by Visual Studio 10 <\/li>\n
    3. Using command line using MSDeploy.exe <\/li>\n
    4. Using Power Shell support provided by MS Deploy <\/li>\n
    5. Using managed APIs provided by MS Deploy <\/li>\n<\/ol>\n

      VS 10 will create Web Packages for you based on your settings in the \u201cPublish\u201d tab of the Web Application Projects (WAPs) property pages.  In the Publish tab you also specify the location where you want the package to be created.  In the same \u201cPublish\u201d tab, you also get an option to specify your destination information (i.e. IIS Application Name, Physical Location on the server)\u2026<\/p>\n

      Check out the section of \u201cPublish\u201d tab below which will give you an idea of the same:<\/p>\n

      <\/p>\n

       <\/p>\n

      After setting all the above information when you right click on your project and click Package \u2013> Create Package then the web package is created at the location specified in \u201cPackage Location\u201d setting. To know more read Web Package Creation post<\/a>.<\/p>\n

      When you create a package VS creates three files of interest in folder specified by \u201cPackage Location\u201d in \u201cPublish\u201d tab; those three files are:<\/p>\n<\/li>\n

    6. \n

      Web Package<\/u> : The package  itself is produced, which can be either a ZIP file or a folder called \u201cAchieve\u201d.  The choice between .zip vs folder is determined based on your settings in \u201cPublish\u201d tab<\/p>\n<\/li>\n

    7. \n

      Destination Manifest<\/u>:  This is the file which will allow you to change the destination information at the time of install eg. connection string, IIS Application name etc<\/p>\n<\/li>\n

    8. \n

      Deploy Command File<\/u>:  VS creates a .cmd file encapsulating MSDeploy command for you so that you don\u2019t even have to type the MSDeploy command while installing the package..<\/p>\n

      So on your dev box below is what happens:<\/p>\n

      \"VS10<\/a> <\/p>\n

      Now when you want to install the package created all you have to do is to take these three files to the destination server and run the command file.  Typically you can hand out these three files to your server administrator and he\/she can run the command on the server (as developers will typically not have access to the servers directly).<\/p>\n

      In the earlier post we talked about how to create a web package for BlogEngine.Web<\/a> solution in staging configuration, let us look at how the solution explorer looks like after the package is created:<\/p>\n

      \"Solution<\/a> <\/p>\n

      Notice the package file, destination manifest and the command file in the above image.<\/p>\n

      If you remember our Package settings<\/a> while creating the web package; in \u201cPublish\u201d tab we provided Destination IIS Application Name as  \u201cDefault Web Site\/VS10-Blog\u201d  and Destination IIS Physical Path as \u201cC:TR8VS10-Blog\u201d.  If we install the package that is where we would expect the install to go (unless I overwrite it using destination manifest and the deploy command file)<\/p>\n

      I am now going to emulate a Server Admin and try to install the web package which was handed to me by the developer by going to Start\u2014>All Programs \u2013> IIS  7.0 Extensions \u2013> MSDeploy Command Console (as Admin)<\/p>\n

      \"MSDeploy<\/a> <\/p>\n

      Note: In IIS 5.1 or IIS 6 you can just start regular command prompt and navigate to MSDeploy install location which is typically %Program Files%IISMicrosoft Web Deploy<\/p>\n

      Also note that server admins can very easily automate these process by writing simple batch files.<\/p>\n

      In MSdeploy command console I will now try to call \u201cBlogEngine.Web.Deploy.cmd\u201d.  I have ensured that the destination manifest, command file and the package are all in the same folder; see the image below:<\/p>\n

      \"image\"<\/a> <\/p>\n

      In MSDeploy Command prompt I can run the VS 10 generated .cmd files in two different modes:<\/p>\n

        \n
      1. \/T \u2013 This is the Trial run switch.  It will allow your server admin to verify whether your package is not going to do something really bad :-)\u2026 But in essence this mode invokes msdeploy in \u2013what if mode which allows you to see what all package will do on the server. <\/li>\n
      2. \/Y \u2013 This switch will actually install the package and get it set up on the server. <\/li>\n<\/ol>\n

        Below is how my command propmpt looks after running the BlogEngine.Web.Deploy.cmd file with \/T switch<\/p>\n

        \"msdeploy<\/a> <\/p>\n

        Notice the \/T switch on the cmd file which in result calls msdeploy in \u2013what if mode\u2026  I truncated the overall out put to show you the final set of information which is \u201cChange Count\u201d\u2026<\/p>\n

        Now when you run the command file with \/Y switch the installation will succeed with the above change count\u2026 Now, let us go and inspect IIS Manager to make sure VS-10 blog application is correctly created with below traits:<\/p>\n