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.

Please be aware of the difference between the two following types of directories:

• The Host On-Demand publish directory
  This is the directory that you specified during the Host On-Demand installation process as the directory for files that are accessible from the Web and that are downloaded by clients to run Host On-Demand. The default publish directory is:
  <Host On-Demand install directory>\HOD
• A special-purpose publish directory
  This is any other directory where you want to place files that are accessible from the Web and that clients can download.

You can choose either type of directory as the destination for the files in the Deployment Wizard .zip file for DWunzip.

Copy the Deployment Wizard .zip file to the directory where you want to unzip it, update the DWunzip command to point to that directory, and launch the command.

DWunzip is located in the following directories:

• On OS/390 platforms:

  /Host On-Demand install directory/lib/samples/DWunzipCommandFiles/

• On all other platforms:

  /Host On-Demand install directory/lib/samples/DWunzip/

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, follow these steps:

1. Verify that the .zip file created by the Deployment Wizard is located in the publish directory in which you want to unzip the files (either in the Host On-Demand publish directory or in a special-purpose publish directory). If not, copy the .zip file to that directory.
2. Open the DWunzip command file appropriate to your operating system. For example, AIX users open the file named DWunzip-AIX.
3. 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.

4. Open a command prompt on the target server and change the current working directory to the directory location of the DWunzip tool.
5. On non-Windows platforms, make sure the DWunzip command has execute permissions.
6. 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.