Chapter 22 Portal Themes psadmin Subcommands

This chapter list the following subcommands:

• list-themes

• upload-theme

• update-theme

• delete-theme

• download-theme

list-themes

The list-themes subcommand lists all the themes that are installed in the portal.

Long-Named Format

psadmin list-themes --adminuser uid [--passwordfile passwordfile] --portal portalName

Short-Named Format

psadmin list-themes -u uid [-f passwordFile] -p portalName

Options

These are the list of options available for the list-themes subcommand. The following two options are required:

[--adminuser | -u] uid

Specifies the distinguished name (DN) or the user identification name (uid) of the administrator.

[--portal | -p] portalName

Specifies the portal name.

The following option is optional:

[--passwordfile | -f] passwordFile

Specifies the administrator password in the password file. When the --passwordfile option is provided, the password file should contain the password without any other text. If this option is not specified, the password will be prompted.

Example

./psadmin list-themes -u amadmin [-f passwordFile] -p portal1

The above command provides a list of themes in portal1.

Theme: heavy

Id: heavy
Context Path: desktop/themes/heavy
Editable: false
Uses Menu Control: false

Theme: lite

Id: lite
Context Path: desktop/themes/lite
Editable: false
Uses Menu Control: true

upload-theme

The upload-theme subcommand creates a new theme for the given portal.

Long-Named Format

psadmin upload-theme --adminuser uid [--passwordfile passwordfile] --portal portalName --file theme_file [--menucontrol]

Short-Named Format

psadmin upload-theme -u uid [-f passwordfile] -p portalName --file theme_file [--menucontrol]

Options

These are the list of options available for the upload-theme subcommand. The following five options are required:

[--adminuser | -u] uid

Specifies the distinguished name (DN) or the user identification name (uid) of the administrator.

[--portal | -p] portalName

Specifies the portal name.

--file theme-file

Specifies the .skin file that contains theme related sources.

The following two options are optional:

[--passwordfile | -f] passwordFile

Specifies the administrator password in the password file. When the --passwordfile option is provided, the password file should contain the password without any other text. If this option is not specified, the password will be prompted.

--menucontrol

Use this flag if the theme uses menu control for channels or portlets.

Example

./psadmin upload-theme -u amadmin [-f passwordFile] -p portal1 --file x.skin

update-theme

The update-theme subcommand updates an existing theme for the given portal.

Long-Named Format

psadmin update-theme --adminuser uid [--passwordfile passwordfile] --portal portalName --id theme_id [--file theme_file] [--menucontrol]

Short-Named Format

psadmin update-theme -u uid [-f passwordfile] -p portalName --id theme_id [--file theme_file] [--menucontrol]

Options

These are the list of options available for the update-theme subcommand. The following three options are required:

[--adminuser | -u] uid

Specifies the distinguished name (DN) or the user identification name (uid) of the administrator.

[--portal | -p] portalName

Specifies the portal name.

--id theme_id

Specifies the id of theme that needs to be removed.

The following five options are optional:

--file theme-file

Specifies the .skin file that contains theme related sources.

--menucontrol

Use this flag if the theme uses menu control for channels or portlets.

[--passwordfile | -f] passwordFile

Specifies the administrator password in the password file. When the --passwordfile option is provided, the password file should contain the password without any other text. If this option is not specified, the password will be prompted.

Example

./psadmin update-theme -u amadmin [-f passwordFile] -p portal1 --id x --file x.skin

delete-theme

The delete-theme subcommand deletes an existing theme for the given portal.

Long-Named Format

psadmin delete-theme --adminuser uid [--passwordfile passwordfile] --portal portalName --id theme_id

Short-Named Format

psadmin delete-theme -u uid [-f passwordfile] -p portalName --id theme_id

Options

These are the list of options available for the delete-theme subcommand. The following three options are required:

[--adminuser | -u] uid

Specifies the distinguished name (DN) or the user identification name (uid) of the administrator.

[--portal | -p] portalName

Specifies the portal name.

--id theme_id

Specifies the id of theme that needs to be removed.

The following option is optional:

[--passwordfile | -f] passwordFile

Specifies the administrator password in the password file. When the --passwordfile option is provided, the password file should contain the password without any other text. If this option is not specified, the password will be prompted.

Example

./psadmin delete-theme -u amadmin [-f passwordFile] -p portal1 --id x

download-theme

The download-theme subcommand creates a theme package and download it to the local machine.

Long-Named Format

psadmin download-theme --adminuser uid [--passwordfile passwordfile] --portal portalName --name theme_name theme-package-name

Short-Named Format

psadmin download-theme -u uid [-f passwordfile] -p portalName -n theme_name theme-package-name

Options

These are the list of options available for the download-theme subcommand. The following four options are required:

[--adminuser | -u] uid

Specifies the distinguished name (DN) or the user identification name (uid) of the administrator.

[--portal | -p] portalName

Specifies the portal name.

[--name | -n] theme_name

Name of the out of the box theme name, which this theme is based on. The available values are: heavy and lite.

theme-file-name

Specifies the theme archive file in the local machine. If full path is given, the file will be created in that path. Otherwise, the file will be created in the current directory. The archive file must use the extension .skin.

The following option is optional:

[--passwordfile | -f] passwordFile

Specifies the administrator password in the password file. When the --passwordfile option is provided, the password file should contain the password without any other text. If this option is not specified, the password will be prompted.

Example

./psadmin download-theme -u amadmin [-f passwordFile] -p portal1 -n heavy x.skin