Infocenter

Using DWunzip

Web pages from the Deployment Wizard can be distributed to servers in a more automated process using the DWunzip tool. This tool is installed on all platforms supported by Host On-Demand, including OS/390, Unix-based systems, and iSeries. DWunzip will unzip the Deployment Wizard .zip file, place the Deployment Wizard files in the appropriate directories, append any necessary file extensions for OS/390, and set file permissions and ownership on the files and directories for non-Windows platforms.

You can use the DWunzip tool to deploy files onto any server running Host On-Demand. You must first transfer the .zip file created by the Deployment Wizard to the Host On-Demand publish directory on the target server. Once you have transferred the file to the target server, run DWunzip, which will automatically complete the remaining steps necessary to deploy the files on that server.

DWunzip is located in the following directories:

DWunzip is a command-line program that requires one parameter: the name of the .zip file to be extracted. The .zip filename does not need a path or .zip extension associated with it; otherwise, an error message and usage statement will result. Other information, known as runtime variables (such as the location of the JRE or of the Host On-Demand publish directory on the server), resides in the command file. Change the default values of the runtime variables if they do not correspond with your environment.

To run DWunzip, do the following:

  1. For all platforms, to run DWunzip, you must be able to write to the Host On-Demand publish directory.
  2. Ensure that the .zip file created by the Deployment Wizard is located in the publish directory on the target server. If it is not, copy it to the publish directory on the target server.
  3. Open the DWunzip command file appropriate to your operating system. For example, AIX users open the file named DWunzip-AIX.
  4. Verify that the target paths specified within the command file are correct. Change any runtime variables if necessary.
    OS/390 users: If you do not want DWunzip to add .ascii extensions to your Deployment Wizard files, you must change the value of the runtime variable ADD_ASCII_EXTENSION to false.
  5. Open a command prompt on the target server and change the current working directory to the directory location of the DWunzip tool.
  6. On non-Windows platforms, make sure the DWunzip command has execute permissions.
  7. Run the appropriate DWunzip command file for your operating system with the .zip file name parameter. For example, AIX users run
    DWunzip-AIX zipfile, where zipfile is the name of the file (without its .zip extension) to be deployed.

When DWunzip is running, it will display status messages to the command line showing the files and folders that were extracted, overwritten, or created. It will also display a message when the command is complete. If you have run this tool once and are running it again on the same .zip file, you will be asked whether you would like to overwrite the files. If you do, the files will be overwritten. If you do not, the tool will close and nothing will be overwritten.