Using the NPSDUMP for NPS 1.5 Reporting Feature

  • 3910063
  • 07-Mar-2007
  • 16-May-2013

Environment

Novell Portal Services 1.5
NPSDUMP Utility
nps15dpa.EXEis available athttps://support.novell.com/servlet/filedownload/pub/nps15dpa.exe/

**Note** NPS 1.5 is no longer supported, patched or modified. Please consider upgrading the services to a supported platform.

NPSDump is a backup/restore utility for Novell Portal Services (NPS) directory information. NPSDump can be used to backup the current configuration of a portal and all related settings. Additionally, NPSDump can be used to restore previously saved settings. It can also be used to copy a portal configuration from a staging environment to a production environment. Note: NPSDump does not copy or move NPS files, these include: style sheets, skins, classes, and jars.

Do NOT run NPSDump v1.0 on an NPS v1.5 portal.

Situation

Using the NPSDUMP for NPS 1.5 Reporting Feature

Resolution

NPSDump is designed to be run from the nps/WEB-INF/Tools/bin folder. The reason for this location is the dependency on certain NPS related jar files that are relative to the bin folder location. You will need to modify NPSDUMP.BAT or NPSDUMP.SH to fit your environment. Installation and Configuration Steps: 1) Extract nps15dpa.EXE to a temporary directory. 2) Extract the NPSDump2002.3.15a.zip file to the nps/WEB-INF/Tools/bin folder. 3) Change to the nps/WEB-INF/Tools/bin folder. 4) Edit NPSDump.bat or NPSDump.sh. Ensure the path to every jar file is correct. Assuming you are using Tomcat and the default paths were used for Tomcat and NPS installations: a) For NetWare 6: Change the path for servlet.jar from \lib\servlet.jar to \tomcat\33\lib\common\servlet.jar b) For Windows: Change the path for servlet.jar from \lib\servlet.jar to \lib\common\servlet.jar c) If you are not running Tomcat on Windows or NetWare, you will need to make the appropriate modifications to match your environment. d) Save the file. 5) Create NPSDump.properties. You can create it by hand or you can have NPSDump create it. To have NPSDump create it, type NPSDump -r "cn=admin,o=corp". NPSDump will detect NPSDump.properties is missing and will create a default one. Now, edit the file and fill in the values as needed. NPSDump.properties may look like this: Server=192.168.1.1 User=cn=admin,o=corp Password=secret Save the file. 6) At the command prompt, type: npsdump -r "cn=portal,ou=nps,o=novell" **Note** Replace the path to the Portal Object with the correct path. Make sure to use the quotes. The above command will generate the NPSDump.properties file. 7) Edit the NPSDump.properties file. The password is the password for the ID that will be used. The server should be the IP address or DNS name of the portal server. The user should be the LDAP name (e.g. cn=admin,o=novell) of the ID that will be used to read the Portal Object and the other objects created by NPS (e.g. Pages, Themes, etc.) Save the file. **Note** The password is in clear text so if you are using the admin ID or an ID with significant rights, then remove the password once you are done with the NPSDump utility. 8) At the command prompt, type: npsdump -r"cn=portal,ou=nps,o=novell" **Note** Replace the path to the Portal Object with the correct path. Make sure to use the quotes. This will generate the npsdump.zip file. 9) At the command prompt, type: npsdump -v This will read the npsdump.zip file and generate the npsdump.xml file. 10) Double-click on PortalReport.html located in the webapps\nps\web-inf\tools\NPSDump and it will generate the portal report from npsdump.xml. **NOTE** Refer to NPSDump.doc (extracted from NPSDump2002.3.15a.zip) for additional information.

Additional Information


Formerly known as TID# 10069872