Importing Pluggable Views or Libraries

A library export file to import containing pluggable views or libraries from another MashZone NextGen Server. See Exporting Pluggable Views or Libraries for instructions.

A directory containing resources for one pluggable view or pluggable library to import or update, plus an optional configuration file to provide additional metadata. See Creating Pluggable Views or Libraries for details.

You may use this command to deploy pluggable views and pluggable libraries that you have exported from one MashZone NextGen Server to another MashZone NextGen Server. See Example for an example of this usage.

You may also use this command to add to or update pluggable views or pluggable libraries MashZone NextGen based on source files on your computer. See Creating Pluggable Views or Libraries for more information and examples.

1. If it is not started, start the MashZone NextGen Server for the MashZone NextGen Repository where you wish to import data. See Start and Stop the MashZone NextGen Server for instructions.

2. Open a command or terminal window and move to the MashZoneNG-install/prestocli/bin folder.

padmin importLib [-d input-directory] [-f input-file]
[-q filter] [-o] [-c] [-l prestoURL] -u username
-w password [-v]

-d input-directory: the root directory containing configuration and resources for one pluggable view or pluggable library to add to or update in MashZone NextGen.

Note:

You must include either the -d or the -f option

See Views and Libraries in MashZone NextGen for more information on valid resources in this directory.

-f input-file: the path and name of the export ZIP file to use to import views and libraries from another MashZone NextGen Server.

Note:

You must include either the -d or the -f option.

-q filter: defines which pluggable views and libraries to import from the ZIP input file specified in the -f option. This option is not valid with the -d option.

"all" to import all pluggable views and pluggable libraries from this input file. You can also use "ALL" or "*".

"author=list-of-owner-ids", the user ID for a specific user or a list of comma-separated user IDs. This imports the pluggable views and pluggable libraries listed in the input file that are owned by those users.

"mine", to import all pluggable views or libraries from the input file that are owned by the user identified by the credentials used to execute this command (in the -u option).

"ids=list-of-app-ids", the ID for a specific pluggable view or pluggable library or a list of comma-separated view or library IDs. This imports those specific views or libraries from the input file.

"name=list-of-library-names", a specific pluggable view or library name.

"type=view", to import only pluggable views from the input file.

"subtype=view-category-name", to import only pluggable views that belong to the specified view category from the input file.

-c: an optional flag to allow the import process to continue after import errors. By default, any import errors stop all further processing.

-o: an optional flag to allow import information for a view or library to overwrite an existing view or library with the same ID.

-l prestoUrl: an optional URL to the MashZone NextGen Server where these views and libraries should be imported to. If you omit this option, this defaults to http://localhost:8080/mashzone/edge/api.

Use this option if the MashZone NextGen Server is remote, if it is not running in Tomcat or if it is not using the default Tomcat port.

-u username: the MashZone NextGen username to use as credentials to execute this command. With the -d option, this also becomes the owner of the pluggable view or library that is imported or updated unless the properties file for this import specifies an owner.

-w password: the MashZone NextGen password to use as credentials to execute this command.

-v: an optional flag to turn on verbose logging.

Messages and errors from the import process are sent to the console window (stdout).

The following example from a Windows environment, imports all pluggable views and libraries from the import file localCustomViews.zip to the local MashZone NextGen Server.

c:\MashZone NextGenversion\prestocli> padmin importLib
-q "all" -f localCustomLibs.zip -u Administrator -w manage

The following example from a Windows environment, imports only the pluggable views in the view category network from the import file remoteCustomViews.zip to the local MashZone NextGen Server.

c:\MashZone NextGenversion\prestocli> padmin importLib
-q "subtype=network" -f remoteCustomLibs.zip -u Administrator -w manage

For examples of adding pluggable views or libraries with the importLib command, see Import Pluggable Library/View Examples and Managing Updates and Library Versions.