File Manager Spec File
The Spec File submenu contains all functions related to the specification files. From this submenu, you can choose options to load, modify, or create new specification files. The following selections are available:
The specification file is a text file that specifies all the network input files to be loaded for the active session as well as the runcode (extension), data directory datadir, and rate directory ratedir.
Table 1: Spec File Generation Window General Tab Fields
This is the file extension used to distinguish different
networks and different sessions. Output files and reports are appended
with the specified runcode file extension. Runcodes
may consist of any combination of alphanumeric characters. This field
is saved with the keyword
Specifies the name of the specification file. By default this is spec.<runcode> where <runcode> is replaced by the network file extension.
The data directory datadir represents
the path to the default directory in which your data files are searched
for. If a particular file is located in the specified data directory,
its absolute path need not be provided when defining that file. For
example, if the data directory for a design run is specified as
The rate directory is used to specify the path of the
directory where the tariff database files are read. In most cases,
the default path
dparam file specifies design
and simulation parameters, hardware vendor, link bandwidth/overhead,
size and various other network parameters.
Table 2: Spec File Generation Window Design Parameters Tab Fields
Design Parameters File
Specifies the file name of the dparam file.
Allows you to choose the hardware type of the network. This
field is saved with the keyword
Maximum Number of Nodes
The Maximum Number of Nodes helps the program decide how much memory to allocate and can only be modified when the network is closed:
The Maximum Number of Nodes (saved as maxnodenumber in the dparam file) represents the maximum number of nodes that may be entered for a particular network. The number entered should be no smaller than the number of nodes planned and no larger than the node_limit in your license file. The default value is 100.
Maximum Number of Links
The Maximum Number of Links helps the program decide how much memory to allocate and can only be modified when the network is closed:
The Maximum Number of Links (saved as maxlink in the dparam file) represents the maximum number of links for a particular network. Once the limit is reached during a design, the program does not continue to add links. The number entered should be no smaller than the number of links planned. The default value is 1500.
The default link bandwidth, link overhead and per circuit bandwidth overhead calculations vary for different vendors. Because of device-specific characteristics (routing algorithm, rerouting, buffer size, queueing, etc.) the same network data may yield different results when comparing switch models.
The Network Files tab contains references to data files that should be loaded in. Each reference are saved in the specification file with a separate entry.
You can read in files from the Network Files tab. The files in this tab are categorized as described in Table 3.
Table 3: Spec File Generation Window Network File Categories
Type of File
bblink, demand, domainfile, facility, graphcoord, group, muxloc, newdemand, nodeparam, owner, site, srvcprofile, srvctype
admincost, fixlink, linkdist, nodeweight, rsvbwfile
devicedir, egress, ingress, t_trafficload, trafdir, trafficload, tunneltrafdir
Access Design Files
chanbank, offckt, offgraphcoord, offloc, offsitek
Discrete Event simulation
aclist, bgplink, bgpnode, bgpobj, intfmap, junospolicy, policymap, route, tbit, tunnel, vpn
Network backbone files specify how the network is represented.
Backbone files include the
bblink, demand, domainfile,
facilityfile, graphcoord, group, muxloc, newdemand, nodeparam, owner,
site, srvcprofile, and
Table 4: Spec File Generation Window Network Files List
A facility is a set of nodes and links likely to fail
The facility feature does not check the validity of the nodes
and/or links listed in the facility file. Duplicate links and/or nodes
are also duplicated in the facility. Nodes may be specified either
by their node ID or node name. If both are used in the same facility,
then that node is duplicated. Nodes which are not in the
Muxloc specifies the file containing switch information such as name, ID, NPA, NXX, latitude, longitude, vertical, or horizontal. This information is used to determine location placement in the map window as well as for link pricing. See MUXLOC (muxloc=filename).
Cost and control files are used to assign tariffs and implement
link controls. Examples of cost and control files are:
custrate, usercost, admincost, fixlink, linkdist, nodeweight, and
Table 5: Cost and Control Files
Every entry in the
In Table 5, an asterisk (*) specifies files used for a feature that is license dependent.
For more information regarding these files, refer to the Design Menu chapter.
Access Design Files
of access design files include:
offgraphcoord, offloc, and
Examples of traffic files include:
egress, ingress, t_trafficload, trafdir, trafficload, and
Table 6: Traffic Files
The t_trafficload file (IP/MPLS only) is similar to the trafficload file, but for LSP tunnels (layer 2 instead of layer 3)
Examples of the discrete event simulation files include: tfxdata, tfxpattern
Table 7: Discrete Event Simulation
For discrete event simulation only. The
For discrete event simulation only. The
Device specific files contain the definitions for various types
of devices. Examples of device specific files include:
aclist, bgplink, bgpnode, bgpobj, intfmap, policymap, tbit, tunnel, and
Table 8: Device-Specific Files
The vpn file (Router only) contains information about Virtual Private Network details such as vrf, route distinguisher, route target, and protocols.
The routing table descriptor (rtd) file (ATM/PNNI only) is used for PNNI networks to read routing table descriptor information. This file is generated by NorthStar Planner after you saved the network’s RTDs.
The hpnni file (ATM/PNNI only) is used for PNNI networks to describe PNNI information for nodes and logical group nodes in the network. It also contains hierarchical information which allows NorthStar Planner to group the network’s nodes accordingly.
The Report Viewer allows you to view reports that are generated by the system. The report viewer provides quick access and a uniformed and organized way of viewing these reports. To view a report, you must select a file that is in NorthStar Planner report format. To customize the columns displayed, right-click on the column header and select the Select Columns... option.
Due to the length of some reports, the Report Viewer only displays a portion of the report in the viewer window. You may set how many lines to display in the Page Setup. With the jump-to buttons, you can jump to the beginning and end of the report. You can also move forward or back. Clicking the Search button searches the current table for the queried text. Clicking the Advanced Search button opens a new window for more complex searches. The query is entered in the text field at the top of the window. The panels on the bottom are provided for convenience in selecting keys, relations, and boolean operators.
The Report Master allows you to view multiple reports in the Report Master window. The Report Master is similar to the Report Manager which provides quick access and a uniformed and organized way of viewing multiple reports without having to open a network first. To open a report master, you must select a file that is in report master format.
The Report Master files do not contain any actual reports. Instead, the Report Master files reference existing reports and place them into an organized tree structure. The format of a Report Master file is described below.
# NorthStar Planner Report Master
1st_item First.report 2nd_item ../../other_path/2nd.report
The Report Editor allows you to perform basic editing functionality on csv files. Click on a cell to edit the value. Right-click on a cell to for more options to edit rows and columns.
Table 9: Report Editor Window File Manager View
Show Hidden Files
This option displays all hidden files in the directory
This option displays files and directories listed in the File Manager’s right pane as large icons in columns.
This option displays files and directories listed in the File Manager’s as small icons in columns.
This option displays files and directories listed in the File Manager’s in list form.
This option gives a detailed view of the files displayed in File Manager including information such as file permission, file owner, file size, and last modified date. (Note: Each column can be sorted by clicking on the column header.)
This toggles the left pane between the Directories view and Common Actions / Favorite Link view.