Importing Pluggable Views or Libraries
you must have either:
A directory containing resources for one pluggable view or pluggable library to import or update, plus an optional configuration file to provide additional metadata.
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.
2. Open a command or terminal window and move to the MashZoneNG-install/prestocli/bin folder.
3. Enter this command:
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
-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.
The filter can be:
"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).
Example
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.