Chapter 13 par

The par command performs functions involving the specified .par file. It can be used for exporting and importing channels or providers to and from the Sun Java System Portal Server.

Syntax

The par command syntax is described in this section. Mixing long-named options with short ones in one command line is not recommended.

Short-Named Format

par export -r uid -p password [-m] [-d] -s staticdir [-v] parfile dn|global {exportfile|from=}...

par import -r uid -p password [-o] [-d] -s staticdir [-v] parfile [dn|global [op...]]

par import -r uid -p password -a [-d] -s staticdir [-v] parfile [dn|global]

Long-Named Format

par export --runasdn uid --password password [--modify] [--debug] --staticdir staticdir [--verbose] parfile dn|global {exportfile|from=}...

par import --runasdn uid --password password [--overwrite] [--debug] --staticdir staticdir [--verbose] parfile [dn|global [op...]]

par import --runasdn uid --password password --auto [--debug] --staticdir staticdir [--verbose] parfile [dn|global]

Subcommands

containers

Description

Lists all available containers and channels in a particular display profile document, indicated by the specified directory server name (or global). This can be used as an aid to formulating other commands.

Syntax

Example

par containers -r "uid=amAdmin,ou=people,o=sesta.com,o=isp" -p joshua -d "o=sesta.com,o=isp"

In this example, the command lists all available containers in the display profile document residing in the LDAP node "o=sesta.com,o=isp".

describe

Description

Describes the contents of the specified .par file, including the entries, and any built-in autoextract operations defined for the entries.

Syntax

Example

In this example, the command output or description of the myfile.par may be something like the following:


Class Root: /

Property Based File Root: /pbfiles

Display Profile Root: /dp

Static Content Root: /static

Entry: mychannel

AutoExtract:dpnode=o%3Dsesta.com%2Co%3Disp,channel,entry=mychannel

DP Document: this my JSP based channel.

Channel: SampleJSP.a

Includes: Property Based File, root templateBaseDir, path default/mychannel/samplecontent.jsp (channel)

Includes: Property Based File, root templateBaseDir, path default/mychannel/sampledoedit.jsp (channel)

Includes: Property Based File, root templateBaseDir, path default/mychannel/sampleedit.jsp (channel)

Includes: Property Based File, root templateBaseDir, path default_en_US/mychannel/samplecontent.jsp

(channel)

Includes: Property Based File, root templateBaseDir, path default_en_US/mychannel/sampledoedit.jsp

(channel)

Includes: Property Based File, root templateBaseDir, path default_en_US/mychannel/sampleedit.jsp

(channel)

export

Description

Populates the specified .par file by exporting the provider or channel information from the portal server. The command takes a .par file, a directory server name argument (or keyword global) corresponding to the desired display profile document to update, and any number of (requires at least one) exportfile or from specifications. The from specifications contain exactly the same information as an export file; the only difference is that the “lines” are separated by semicolons.

The par export command without the -m option creates a .par file. The par export command with the -m option is used to update and / or add to an already existing .par file that defines a provider, channel or container.

Syntax

par export -r|--runasdn uid -p|--password password [-d|--debug] -s|--staticdir staticdir [-v|--verbose] parfile dn|global {exportfile|from=}...

par export -r|--runasdn uid -p|--password password [-d|--debug] -s|--staticdir staticdir [-v|--verbose] -m|--modify parfile dn|global {exportfile|from=}...

Example

par export -r "uid=amAdmin,ou=people,dc=sesta,dc=com" -p joshua mychannel.par "o=sesta.com,o=isp" myexport.txt

In this example, the command exports the channel definition and template files for mychannel into mychannel.par from the "dc=sesta,dc=isp" dn. Also, if it were a JSPProvider channel, the directory line transfers all of the .jsp files, including locale-specific versions.

import

Description

Imports objects from the specified .par file into the portal server. The command takes a .par file, and optional arguments for the display profile document to import the objects into the indicated display node in the directory server (or the root display profile indicated by the keyword global), and operations to be performed. If these things are not specified, they are taken from the .par file. The auto option can be used to indicate that you wish to simply perform the autoextract operations already contained in the .par file.

If you want to add a new channel, you can use the par import command with or without the -o option. If a channel already exists, you must use the -o option with the par import command to completely replace (overwrite) the old channel. You can use this subcommand to import providers as well as channels.

Syntax

Examples

In this example, the command extracts the channel from myfile.par file, if that is the automatic operation defined in the myfile.par PAR file.

par import -r "uid=amAdmin,ou=people,o=sesta.com,o=isp" -p joshua --auto myfile.par "o=sesta.com,o=isp"

In this example, the command extracts the channel explicitly, installing it with a different name in the target dn, and making it available in container topcontainer.

par import -r "uid=amAdmin,ou=people,o=sesta.com,o=isp" -p joshua myfile.par "o=sesta.com,o=isp" "entry=mychannel,channel=anothername,avail=topcontainer"

Options

The following table contains two columns: the first column lists the possible options for the par command; the second column gives a brief description of the corresponding option. This command supports the following options (listed in alphabetical order):


-a or --auto	Use with the import subcommand to apply the autoextract operations from the .par file. There should be no operations specified on the command line in this case. The dn argument may still be specified; if specified, it replaces the dn in the autoextract operations. If operations are specified on the command line, they are ignored.
-d or --debug	Specify this to produce extra debugging information on error messages.
-m or --modify	Use with the export subcommand to update an existing .par file rather than replace it. Any new files added for an entry supplement or replace the old ones. Also, use this command to add new files to an existing provider or channel by using a .par file.
-o or --overwrite	Use with the import subcommand to replace existing channels.
-p or --password	Specifies the password for authentication. Required for all of the subcommands except describe. If not specified, the par utility prompts for it.
-r or --runasdn	Specifies the distinguished name of the user for authentication. Required for all of the subcommands except describe. If not provided, the par utility prompts for it. Use the format uid=userName,ou=people,dc=organizationName,dc=organizationalUnit
-s or --staticdir	Defines the host-specific directory of the static content directory to be used for import or export.
-v or --verbose	Describes operations as they are executed. Use with the import and export subcommands.
-V or --version	Specify this option to the par command to print descriptive information about the utility, such as its version, legal notices, and other similar information to standard output. Any subcommand and all other options are ignored when this option is present.
-?	Obtain help for any subcommand.

Arguments

The following table contains two columns: the first column lists the possible arguments for the par command; the second column gives a brief description of the corresponding argument. This command takes the following arguments:


dn	Specifies the distinguished node in the directory server to access. Use the format "o=organizationName,o=organizationalUnit" - SHOULD’NT THIS BE “dc=organizationName,dc=organizationalUnit”?
global	Specifies the global level node in LDAP to access the display profile document.
exportfile	These files each correspond to an entry (provider, channel, or provider/channel combination) in the .par file, and simply specify the data to be inserted into the specified .par file. It can be a small file if the information is too large to list on the command line. See Export Files for more information.
from	Specified on the command line, this is taken as equivalent to an export file containing the from line, followed by an equal to ("=") sign, and any other lines separated by a semicolon (";"). See Export Files for more information on line properties.
op	Specifies the operation to perform. See Operations for more detail.
parfile	Specifies the PAR file to operate upon; that is, indicates the PAR file to import, export, or describe.

Export Files

These files simply specify data to be inserted into a .par file. The file consists of lines containing a keyword, followed by a colon and white space delimited fields. The from: line is required and it must be the first line of the file. Lines beginning with “#” are treated as comments.

The following table contains two columns: the first column lists the possible line keywords or properties; the second column gives a brief description of the corresponding property.


from: types name	The from line indicates what entity is being exported. The types can be “channel”, “provider”, or “channel,provider”, and “channel+provider”. The name indicates the channel name, or a provider name if a provider is being exported. The name must be URL encoded if the name contains white space (+), commas (%2C), colons (%3A), semicolons (%3B), plus signs (%2B), or percent signs (%25).
auto: none	The auto line specifies the autoextract operation for the entry. It takes the op argument followed by the operation. The none argument can also be entered, suppressing the autoextract. If no auto: line is specified, a default autoextract is produced. The default operation is to extract the channel and/or provider with its original names.
auto: op
file: root\|. path [types]	The file line indicates that a file, based on a property setting, is to be included. The property can come from either the desktop properties file, located by default in /etc/opt/SUNWps/desktop/desktopconfig.properties file or from the display profile visible to a getProperty() call for the item being exported or imported. The root specifies the root of the file location and path specifies the path to the rest of the file. The root is a property name that corresponds to a directory (like). If root is given as ".", the file is assumed to be static content located at the web server’s doc root. You can also specify the types of operation the file is to be associated with, defaulting to “channel”. The types can be “channel”, “provider”, or “channel,provider”, and “channel+provider”.
class: class [types]	The class line indicates that a class file is to be packaged with the entry, and you may optionally specify the types of operations that the class file are associated with. If not specified, “provider” is assumed. types can be “channel”, “provider”, or “channel,provider”, and “channel+provider”; also, when specifying both, you can use a space.
directory: root\|. dir +\|.\|filter [types]	The directory line implies an entire directory search with all non-directory files to be included as if entered as file lines. It includes the capability of specifying a filter, that is a directory component which must be present in recursive directory searches. The root specifies the root of the directory, or “.” to indicate static content. dir is the directory underneath the root to search from, which can be given as “.” to start at the root itself. The filter specifies the filter component which must be in the directory, which implies a recursive descent. It can be given as + for a recursive descent with no filter, or "." for no recursive descent (just the contents of the actual directory). You can also specify the types of operation, which default to “channel”. types can be “channel”, “provider”, or “channel,provider”, and “channel+provider”.
entry: name	The entry specifies the entry name used in the .par file. If not specified, it defaults to the name from the from: line.
desc: text	Any number of desc lines may appear, and are concatenated together as a user-visible description packaged with the entry.

Operations

Each operation (op), in the export file or on the command line, must be specified as a comma separated list of keywords that can have values, most of which are optional. The operations are in a blank or space separated list. Each operation is in the following format.

dpnode=dn,entry=name,provider[=name],channel[=name],container=name[,avail=na me,selected]

dpnode

This specifies the distinguished name in the directory server (or the keyword global) for the display profile document that this operation is targeted at. This may not apply if the context it is being specified in has already provided this. For example, if the import subcommand defines the distinguished name, the distinguished name in the file is ignored.

entry

The par utility defaults to the first entry in the file if an entry is not specified.

provider

This indicates that a provider extraction is to take place. If the name is missing, it simply uses the name packaged with the provider in the .par file.

channel

This indicates that a channel extraction is to take place. If the name is missing, it simply uses the name provided with the channel in the .par file.

container

This applies only to channel extractions and indicates which container the channel is to be inserted into. If omitted, the channel is inserted into the channels element at the display profile document root.

avail

This applies only to channel extractions and indicates a container whose avail (or available) list is to receive a reference to the new channel. If omitted, no new channel reference is created.

selected

This applies only if avail was used. It indicates that the container whose avail list received a reference, also has a reference placed in its selected list.

If the op information is in both the par import command and in the .par file, the command information takes precedence.

PAR Files

This section contains supplemental information on the PAR file format. You do not require this information to run the par command.

Overview

The PAR file is a JAR file with manifest entries for transporting channels, providers, and their associated files. It is intended allow flexibly when installing providers, channels, or both. The .par file contains 4 major types of files:

Par File Contents

The .par file must contain the headers listed in the following table. This table contains two columns: the first column lists the required global headers; the second column gives a brief description of the corresponding header.


PS-Version	Specifies a portal server specific version number of the .par file. Also verifies that this is a .par file.
PS-DefaultEntry	Names the entry used for operations involving an unnamed entry.
PS-DPRoot	Indicates the root directories in the archive for parEntry documents, classes, property based files, and static content, respectively. If unspecified, the corresponding files are rooted at the top of the archive.
PS-ClassRoot
PS-PBFileRoot
PS-StaticRoot

In the .par file, there must be a named entry for each parEntry XML file. The section for each named entry may contain the headers in the following table. This table contains two columns: the first column lists the possible headers; the second column gives a brief description of the corresponding header.


PS-EntryName	Specifies the command visible name of the entry.
PS-AutoExtract	Specifies the autoextract operation for the entry, if one exists.
PS-Include	Contains a comma separated list of archived files specified by their actual archive path. The path implies what type of file they are according to the “root” specifications. The files are appended with a parenthesized number which corresponds to the types of operations the file applies to (a mask with 1 for provider, 2 for channel). This can be ignored if there are no files other than the XML document associated with the entry.

If the .par file contains only one entry, entries need not be named in manipulating the file since the default entry is the entry used if none is named.

Previous Contents Index Next
Sun Java System Portal Server 6 2005Q4 Technical Reference Guide