User Guide

Appendix D: Importing Plans using the Command Line
Data Center Planner is a Java application with a command line interface, which provides a method for
integration with a user’s current automation capabilities. It requires Java version 1.6, a plan file in a Microsoft
Excel .xls format, a valid user account and a Data Center Planner server accessible on port 8443. As a command
line tool, it can be used alone or in conjunction with scripts.
To import a floor plan with the java application:
1. Open a command line on your operating system. For Windows, this can be reached by searching Start- Run -
cmd, and click OK.
2. At the prompt, go the directory where the dvr-planimport.jar file exists. To get list of commands for help
importing a floor plan, enter -help.
Example (Windows) - C:\DataCenterPlanner\planImport>java -jar dvr-planImport.jar –help
3. The following information displays:
Usage: java -jar dvr-planImport.jar [-avh] [-p password] -u name -s server -f file
A utility for importing a plan into Data Center Planner
Required arguments:
-s (or --server) a_servername
Name of the Data Center Planner server to import the plan to. Must be a valid DNS name or
IP address.
-f (or --file) a_filename
Path of the excel file that represents the plan to import, including filename. Must be on
a locally mapped drive, meaning URLs won't work
-u (or --username) a_name
The name of the user who has rights to import the plan. This is the same as the Data
Center Planner login.
-p (or --password) a_password
Password corresponding to the supplied user. If not supplied as an argument, the program
will prompt for a password and the password will NOT be echoed to the console.
-a (or --allowSelfSignedCerts)
If present, this argument allows the utility to allow SSL connections with servers that
sign their own certificates. While technically optional, this argument is necessary
unless a non-self signed certificate has been installed on the Data Center Planner
server.
Optional Arguments:
-i (or --importToUpdate)
If present, the plan importer will update the plan with the same name. After initial
import of a plan, this option is required. Attempts to import the same plan without this
option will result in an error with no change to the Data Center Planner plan. Please
note that the import utility will not allow deletion of data in the Data Center Planner
plan. To delete an asset or move it to unplaced assets, you must perform the operation
using Data Center Planner client application
-v (or --verbose)
Prints information while the utility runs, otherwise the utility is quiet if there are no
errors.
-h (or --help)
140 Data Center Planner Installer/User Guide