Package the server.
The default
archive format is .zip on all platforms apart
from z/OS® where it is .pax.
You can also generate a .jar archive. ![[Updated in November 2013]](../deltaend.gif)
If
you do not specify a server name, defaultServer is
used. If you do not specify the --archive parameter,
the value of server_name is used for package_file_name,
and the compressed file is created in the ${server.output.dir} directory.
Choose
the correct command for your environment.
Use this command to generate a .zip archive.
server package server_name --archive=package_file_name.zip --include=all
where package_file_name.zip is a file name that you choose. This file name can include a full path name. If the full path is omitted, a compressed file called package_file_name.zip is created in the ${server.output.dir} directory.
Use this command to generate a .jar archive.
The advantage of a .jar archive is that the scripts
in the bin directory keep their permissions, so they
are executable when the package is installed.
server package server_name --archive=package_file_name.jar --include=all
where package_file_name.jar is
a file name that you choose. For more information about extraction
options with this archive file, see Archive file extraction options.
server package server_name --archive=package_file_name.pax --include=all
where package_file_name.pax is a file name that you choose. This file name can also include a full path. If the full path is omitted, a compressed file called package_file_name.pax is created in the ${server.output.dir} directory.The pax
archive format saves the extended attributes that are required for
the Liberty profile to work as designed in all supported scenarios.
If a compressed file in ZIP format is required, specify the target
archive name and include the .zip extension.
If the specified name ends with .zip, then a
compressed file in ZIP format is generated, instead of the z/OS default PAX format.
An archive format of .jar is not
valid on z/OS. ![[Updated in November 2013]](../deltaend.gif)
You can also use the --include option with this command. For example, the --include=all option packages the runtime binaries and the relevant files in the ${WLP_USER_DIR} directory; the --include=usr option packages only relevant files in the ${WLP_USER_DIR} directory, effectively excluding the runtime binaries from the compressed file.
The --include=usr option is not valid
with an archive format of .jar. ![[Updated in November 2013]](../deltaend.gif)
If you use the --include=minify option,
the server command packages only those parts of
the runtime environment, and files in the ${WLP_USER_DIR} directory,
that are required to run the server. This option significantly reduces
the size of the resulting archive.
The parts of the runtime
environment that are retained by the minify operation
depend on the features that are configured in the server that you
are packaging. Only those features that are required to run the server
are retained, and the remaining features are removed. Therefore, you
cannot later enable a feature that has been removed. For example,
if only the servlet-3.0 feature is retained, you
cannot later enable the jpa-2.0 feature.
You
can repeat the minify operation to further reduce
the size of the archive if the configuration is changed. There is,
however, no reverse operation for the minify operation,
so if you later require one or more features that have been removed,
you must begin again with a complete Liberty profile server.
While
the minify operation is running, the server is temporarily
started, and you see the associated messages. For this reason, you
cannot use the --include=minify option with a server
that is not able to be started, but you can package it with the --include=all or --include=usr options.
You
can specify the operating systems that you want the packaged server
to support by using the --os option with the --include=minify option.
For
example, to package a server with z/OS support
removed, use the following command:
server package --archive="nozos.zip" --include=minify --os=-z/OS
To
package a server with OS/400® support
retained, but z/OS support
removed, use the following command:
server package --archive="small.zip" --include=minify --os=OS/400,-z/OS
To
package a server that supports only Linux,
use the following command:
server package --archive="linux.zip" --include=minify --os=Linux
Note: To unpax a file on z/OS, go to the location where you want to unpax
the file and then run the following command. The
-ppx option
is used to preserve the extended attributes.
pax -ppx -rf location filename.pax
Where location is
the path where the file exists and filename.pax is
the name of the file.