netTerrain 10.0 Installation Guide

Document Code. GN_D_nT10
Last revision: 10/30/2025

© 2025 Graphical Networks LLC. All rights reserved.

Graphical Networks and netTerrain are registered trademarks of Graphical Networks LLC. Other product names mentioned in this manual may be trademarks or registered trademarks of their respective companies and are hereby acknowledged and stuff. If rash, irritation, redness, or swelling develops, discontinue reading. Safety goggles may be required during use. Do not eat this guide.
Bada bing bada boom.
This document was created with 100% recycled electrons.

Image: Eniac.

(Electronic Numerical Integrator and Computer) was the first general-purpose electronic digital computer and a pioneering machine in computing. It was designed by John Presper Eckert and John William Mauchly at the University of Pennsylvania, and its design dates back to the 1940s.

Graphical Networks LLC
Telephone: +1-240-912-6223
Fax: 1-240… never mind

1 Introduction

This guide provides the steps to successfully install the netTerrain product from scratch. If you already have netTerrain installed and want to upgrade to a newer version, please go to section 4. We appreciate your business.

1.1 Hardware requirements

netTerrain is a modern n-tiered web-based enterprise-grade software for network, fiber and data center documentation that can be deployed in a variety of configurations. The data tier (database server) and the application tier (application server) can be deployed on the same or on separate (physical or virtual) machines. These specifications may not yield a fast-performing system if there is a high volume of activity associated with other applications or database systems running in parallel, abnormal spikes in user activity or other external factors that can slow down disk, CPU or memory usage. Translation: we can keep adding more fancy words to give you this warm fuzzy feeling that you’ll have the exact server you need, but we know better. Server sizing and estimation is more an art than a science. Take the table below with a huge grain of salt.

Server Hardware	Minimum1	Standard2	Optimal3
Processor	Intel Core-I7	Intel Xeon processor (E5 or E7 or better processor family) or similar. Or multiple virtual sockets and CPUs (4 x 1) core allocation for VM instances.	Intel Xeon processor (E5 or E7 or better processor family) or similar. Or multiple virtual sockets and CPUs (4 x 2) core allocation for VM instances.
**RAM**	8GB	32GB	64GB
**Hard Disk Space4**	10 GB Free space	High Speed w/ 40 GB Free space	High Speed SSD w/ 100 GB Free space

1.2 Server – Software

The software requirements are the following:

• Windows 2016, 2019, 2022 Server (other Windows desktop operating systems are also supported)
• MS SQL Server 2016, 2019 or 2022 Standard or Enterprise Edition with SQL Server Management Studio (SSMS). SQL Server Express is also supported for smaller deployments (usually less than 10 concurrent users and less than 10,000 devices – please consult with support@graphicalnetworks.com before deploying netTerrain with SQL Express).
• MS IIS 8.0 or better for the application server
• .NET Framework 4.7.2 or greater for the application server
• Certain configuration requirements for IIS and SQL Server apply

1.3 Notes on Server Sizing

Below are some user and device thresholds to determine which server configuration is best for your environment:

1. Minimum requirements are based on a medium sized deployment with up to 10 concurrent Users and 500 devices.
2. Standard requirements are based on a large sized deployment with 25 concurrent Users and 2500 devices.
3. Optimal requirements are based on a very large deployment supporting up to 100 concurrent Users and 25,000 devices.

Concurrent users are counted as users entering or updating the system through the browser at the same time.

The total number of named users supported is usually the number of concurrent viewers multiplied by a factor that depends on the probability of two users accessing the server concurrently during peak usage.

A conservative estimate is a factor of 10, which would yield the following counts for named users:

1. Number of named users for minimum configuration: up to 100
2. Number of named users for standard configuration: up to 250
3. Number of named users for optimal configuration: up to 1000

Take these numbers with a huge grain of salt. Sizing and performance are closer to an art than a science since many factors come into play. The above-mentioned limitations are based on conservative estimates. For additional named users and devices in any of these configurations, additional servers in a netTerrain site license mode can be set up.

2 Installation process

The netTerrain installer has many steps that can be automated. Using the automated features, the application and the database can be created automatically, and it checks for IIS requirement compatibility. However, in some cases, these automated steps may not work, such as the database not being currently accessible, or permissions being limited on the app server.

We recommend trying the automated steps when the app server and database are on the same machine (or the database is easily accessible from the installation machine) and resorting to the manual process when you know in advance that access to the database is restricted or the setup of IIS needs to be fine-tuned by hand. A hybrid approach is also possible where the installer automates certain parts and you take care of the rest manually.

2.1 Installing netTerrain

The installation process consists of 5 easy steps. You should be up and running in no time but first make sure you have the netTerrain installer executable file. It is typically called ‘netTerrain-10.0.XXX.XXX-Universal-Install’ (XXX being the database version the build number). For example, a valid name would be netTerrain-10.0.1004.6087-Universal-Install. After the installation is complete you will need a valid license key to activate netTerrain.

2.1.1 Step 1: running the installer file

Start install banner

2.1.2 Step 2: starting the basic installation process

Run the EXE and wait for the first screen. Then click ‘Next’, the general installation options dialog lets you change the default installation directory. We suggest sticking with the default, as it may make your future upgrades more seamless. If you change this directory, you may need to proceed with certain manual steps during a future upgrade to move files from one folder to another.

General installation

Take the plunge and start the installer by clicking on ‘Install’. The installer will now start moving files from the executable package to your server.

Installation operation in progress

2.1.3 Step 3: setting up the application

In this step you can set up the name of the application that IIS will configure for the netTerrain web server.

The installer will check any missing IIS components and proceed to activate them, whenever possible.

After this is done, proceed with the setup of the IIS application, as displayed below:

App name setting

In the dialog above you can choose the default settings, which means that netTerrain will install the application on the web server using the default Host site and default Application pool.

The application creation process usually takes only a few seconds. In case of errors (such as picking a name for an application that was already used) the installer will inform you of the error and you can retry or skip this step altogether (in which case you need to install the IIS app manually).

Click on the ‘Next’ button, and the IIS application is created.

2.1.4 Step 4: setting up the database

The process of creating the database is very simple. From the database set up dialog that popped up, choose a database server you want to use to house the netTerrain database and provide the credentials to connect to it. the installer supports both SQL and Windows authentication. You may need to request access from you Database Administrator (DBA).

Enter the server name (SQL Server Name) and credentials. Or you can try using “Windows Authentication”. This is typically used for a database that is located on the application server.

Database creation process

In the next step, you can choose the name of the database and the paths where the related files (e.g., logs) will be saved.

If the configuration is correct click Next.

Database creation

2.1.5 Step 5: setting up the administrator account

Once the database configuration is complete, continue with the administrator user configuration.

User administrator creation

Enter appropiate credentials and click Next.

2.1.6 Step 6: probe installation

The so-called “Probe” is a background service that allows the discovery process to take place from the netTerrain service. This should not be confused with the Probe application, which is an extension of the probe service usually installed as a thick client on remote networks.

Click Next and the process is complete.

Process completed

2.1.7 Step 7: applying the netTerrain license key

If in the previous step you had the ‘Open netTerrain...’ option checked, a new browser window should open, showing the netTerrain login page. The credentials that must be entered are those chosen in the previous step.

netTerrain login. Use the username and password you chose in the previous step.

After providing those netTerrain credentials, you are presented with a license info page. Click on the ‘Activate new license key’ link and enter the valid netTerrain license in the ‘Key’ field, as displayed below.

Activating new license key

2.1.8 Step 8: setting up the images

The netTerrain catalog is quite large, so much so, that we don’t ship the images associated with the devices in the regular installer. Instead, there is a separate file included in your installer package (CD or link), usually called images.rar.

The images.rar file, as the name suggests, is a compressed rar file, which needs to be unpacked. To do this follow this process:

• Take the image.rar file from your installation package and copy it to the images folder (usually located under ProgramData\Graphical Networks\netTerrain\vis\Images).
• Inside the images folder unpack the contents by using the ‘Extract here’ feature.
• • As a result you should have two sub folders inside the images folder, including the ‘Backgrounds’ and ‘Nodes’ sub folders.
• After netTerrain has been installed, double check that this process worked as expected by logging in to netTerrain and navigating to the catalog and making sure that the devices in the device section include a vendor icon.

2.2 Manual netTerrain installation

To perform manual configuration, follow these steps: In the installer, during the IIS configuration step, you can check Skip IIS Configuration.

The IIS site and Application Pool are now disabled, and these options will not be configured. To continue with the database configuration, click Next.

It is also possible to configure the database manually by checking “Skip database setup.”

2.2.1 Setting up the IIS application manually

Once the application server components have been installed, if you skipped step 3 from section 2.1, an application needs to be created on the web server.

1) Open IIS on the application server machine and add a new application pool called 'netTerrain' and ensure the .NET Framework is set to version 4 and pipeline mode integrated. (.NET Framework could be v4.5).

2) Create a new application called 'vis' (other names are also permitted).

3) Retain the default parameters associated with this application and point the physical folder to the 'vis' folder that was created by the installer under C:\inetpub\wwwroot\netTerrain.

4) The application pool in IIS should be set to netTerrain which has a minimum configuration of .NET Framework 4.7.

a. If there is no option for setting `netTerrain', then you must create one manually. Return to the beginning of point 1.

5) Next, open the Application pools feature in IIS and right click on the netTerrain. Select Advanced Settings to modify application pool parameters.

In the advanced settings dialog, proceed to enable 32-Bit Applications, by selecting True from the drop down box.

After the above steps are completed go to the App_Data folder that is in C:\inetpub\wwwroot\netTerrain and right click the folder. Select the properties option and then go to the Security tab. Add "Modify" permissions for the IIS_IUSRS account to this folder. These permissions should also be applied to the EmbeddedDocs folder located in the same directory.

2.2.2 Setting up the database manually

Once the application server components have been installed on the server, if you skipped step 4 from section 2.1, you must manually install the netTerrain database.

Proceed to restore the netTerrain database file as follows:

1) If no netTerrain database has been created, proceed to create one in SSMS. Any name may be used for the database, so during restoration ensure the data and log files are pointing to the correct database.

2) Locate the netterrain-build_full_XXXXXX database restore file located in C:\inetpub\wwwroot\netTerrain\db.

3) Open SQL Server Management Studio and restore the database called GNCORE.

4) Once the database has been restored, create a new SQL user, which will be mapped to the netTerrain database.

5) Apply this user to the netTerrain database using the security dialog.

6) Verify that the database collation has been set to “SQL_Latin1_General_CP1_CI_AS”. Change this setting if it is not the correct collation.

7) If you are using an Active Directory user account for SQL authentication, you should create a specific netTerrain active directory account for this purpose. Do not use an individual user’s Active Directory account.

2.2.2.1 Additional database parameters

TCP/IP and named pipes may need to be enabled for the database or database engine. For SQL Server, these parameters can usually be enabled from the SQL Server Configuration Manager under the properties menu.

The firewall on the database server needs to allow traffic for SQL port 1433. If the firewall is blocking SQL traffic, an exception for port 1433 needs to be added to the firewall configuration settings (check with the server system administrator on how to open that port for the specific Operating System that runs on the server).

2.2.3 Configuring the application server

Once the database is restored on the SQL Server Engine, the application server can be configured properly so that the visualization engine will communicate with the database and display data appropriately.

The web.config needs to be updated with the appropriate connection string settings. The web.config file is in the C:\inetpub\wwwroot\netTerrain.

Edit the web.config file and look for the “connectionstrings” tag. The ‘Data Source’ will be the database server and instance information, the catalog is the netTerrain database chosen in the previous section, and the ‘uid’ and ‘pwd’ are the username and password for the netTerrain user created in the previous sub section.

Example:

<add name="NetTerrain" providerName="System.Data.SqlClient" connectionString="Data Source=SQL Server ipaddress or name;Initial Catalog=gncore5;uid=vis;pwd=vis909303;" />

2.2.4 Installing the mandatory 3rd party components manually

This step is also done automatically by the installer, but if it was skipped (or failed) then you must proceed to install these mandatory components manually.

The netTerrain application requires a redistributable component from Microsoft that needs to be installed on the application server. This component can be installed using a file called ‘vcredist_x86.exe’ located in C:\Program Files (x86)\Graphical Networks\netTerrain\Utilities. Simply run the executable and follow the installation prompts.

Microsoft Visual C++ redistributables

2.2.5 Installing the catalog

Just as with the more automated process, you must make sure that you have the catalog imagery set up, by going through step 5, specified in the previous section.

2.2.6 Verifying the installation

Open a supported web browser (such as Chrome) and in the address type in http://<servername>/<app> where <servername> and <app> represent your server and IIS app names chosen during the installation.

Attention!

If you receive the error: ‘500.21 “ExtensionlessUrlHandler-Integrated-4.0” has a bad module “ManagedPipelineHandler” in its module list’, ASP.NET is not registered. Please try running the following command in cmd.exe:

%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i

You can now finish up the installation by supplying a valid netTerrain license key, as explained in section 2.1.7.

3 Post Installation Settings

The netTerrain installation process includes other non-mandatory settings that you should consider to get the most out of your system.

3.1 SQL Server Active Directory user authentication

In some instances, your SQL server database may be using an Active Directory user for authentication to the netTerrain database. If this is how your SQL server database has been configured, then you will need to change the following parameters in the web.config file and in the IIS application (please note that an active directory user account should have been set up with permissions to the database):

1) In the web.config file replace the SQL server uid and pwd with Trusted_Connection=yes

<add name="NetTerrain" providerName="System.Data.SqlClient" connectionString="Data Source=server name or IP Address;Initial Catalog=gncore;Trusted_Connection=yes;" />

2) add <identity impersonate="true" /> after the <system.web> section of the web.config file.

<system.web>
<identity impersonate="true" />
<compilation debug="false" targetFramework="4.0" />
<httpRuntime maxRequestLength="10485760" />
<authentication mode="Forms">
  <forms cookieless="UseCookies" loginUrl="~/Account/LogOn" timeout="20" />
</authentication>

3) Open your IIS configuration manager and select basic settings for the netTerrain web application you set up to use with netTerrain. Typically, this is called vis. Then press the "Connect as…" button.

4) Select the "specific user" option and enter the active directory user information. This should match the Active Directory user that was applied to the netTerrain database.

5) Test the login to the netTerrain application. If you can get logged in, then it is successful. If you still cannot log in, please refer to the netTerrain log for further details. This log can be found on the application server typically here: C:\ProgramData\Graphical Networks\netTerrain\vis\Logs. Look for the one with the most recent date. Review the log for error information.

3.2 Active Directory settings

netTerrain allows you to use existing active directory users for web authentication. To configure active directory, you must set up a group or groups within active directory, assign a user or users to the group or groups and then set up the configuration in the admin console under the Active Directory section.

Go to your AD server and set up one or more groups and assign a user or multiple users to the group or groups.

To enable and set up AD, navigate to the admin console and check the box for 'Support Active Directory Accounts'. Then fill out the corresponding fields. To ensure the correct values were entered, select check availability. 'Success' should be returned. Otherwise, you may need to correct your input or debug AD settings and connectivity.

Enabling Active Directory

Service Login: Enter an AD user account that will be used to walk the AD server directory (Typically any AD account that is part of the "Domain Users" group, no additional permissions should be needed). An authorized user account is needed to allow the information within AD to become accessible.

Show domain name on login: If you would like the domain name to appear when someone browses to the netTerrain website. You should leave this off if this is a public facing website.

Allow pinging domain controller: This can help speed up the login time. However, it may not work in all environments if ping is not allowed between the application server and the AD server.

The next step is to configure the group mappings, which is located at the bottom under the ‘Active Directory’ tab.

Configuring group mappings

Use one line per mapping with the format displayed below:

ADgroup1: Admin

ADgroup2: PowerUser

ADgroup3: ReadOnly

GROUP Permission Level names: Admin, PowerUser, Edit, ReadOnly, DiagramReadOnly, Updater 

Next, go to the users page and select ‘Synchronize AD users’ to retrieve the allowed user accounts.

Once configured you should be able to use an AD user account to log into the netTerrain system.

3.3 Logout timeout settings

If you would like to increase or decrease the default logout time for the netTerrain application, open the web.config file and modify the following setting:

<forms cookieless="UseCookies" loginUrl="~/Account/LogOn" timeout="20" />

The unit for the timeout here is in minutes.

3.4 Authentication settings

Unless you use some directory services like AD, you may want to consider hardening your netTerrain security settings by specifying your password policies and more. In the web.config file you can set some parameter to match your IT security mandates around things like password length, complexity and more.

Look for the MembershipProviders section in your web.config file and in there you’ll see an array of parameters which can be modified:

MembershipProviders for authentication settings

At Graphical Networks we believe that you should set your security settings any way you like so that you can comply with an array of possible mandates, even if they make little sense. Having said that, we certainly hope you don’t fall into the common trap of setting up passwords that are hard to remember and easy for a computer to guess, hence our default values for these parameters may not necessarily reflect the common myths surrounding password strength.

xkcd webcomic on password strength

The parameters you can modify here, which are quite self-explanatory, include:

• enablePasswordRetrieval Default: false
• enablePasswordReset Default: true
• requiresQuestionAndAnswer Default: false
• requiresUniqueEmail Default: false
• maxInvalidPasswordAttempts Default: 2
• minRequiredPasswordLength Default: 6 (and yes, you should immediately change this one to a lot more unless you plan to use directory services)
• requireLowerCaseLetter Default: false
• requireUpperCaseLetter Default: false
• requireDecimalDigit Default: false
• minRequiredNonAlphanumericCharacters Default: 0
• passwordAttemptWindow Default: 10
• applicationName Default: ‘/’

4 Upgrade Installation

In this section of the guide, we will find a detailed description of the process required for a system administrator to upgrade an existing installation of the netTerrain application server and database.

Please note that the SQL database should be version 2016 or newer. Older versions may fail to update.

4.1 Backup

4.1.1 application server backup

Before proceeding with the upgrade, the application server should be backed up. The best practice would be to stop the IIS server service and backup the netTerrain folder to an alternate location. Then restart the IIS service, after the backup has been completed.

The typical location of the netTerrain application folder for Windows is C:\ProgramData\Graphical Networks\netTerrain\vis for older versions and C:\inetpub\wwwroot\netTerrain\ for newer versions (above 10.x versions)

4.1.2 database backup

The SQL server production database that is used by netTerrain should be fully backed up before upgrading the database, unless you feel like living on the edge. In all fairness, in the entire history of Graphical Networks we do not recall an instance of database corruption due to an upgrade attempt, but still, back it up!

The netTerrain database is called GNCORE by default (you can find the database name in the web.config file). In addition, it is recommended that a database restore test be performed to ensure the database backup will be restored properly. You should consult with your SQL server database administrator (DBA) on how the backup and restore test should be performed. If you are the lucky SQL server admin and dont know how to do this, google it.

4.2 Upgrading the application server

4.2.1 run the installation

To begin the upgrade process, run the provided netTerrain installer. You will see a beautiful splash screen like the one below:

netTerrain upgrade splash screen.

click Next.

4.2.2 Step 2: path detection

In this dialog, the installer automatically displays the path to the file associated with the previously detected netTerrain installation. This path may not be the current working directory. This can be verified by reviewing the application path in the IIS manager. This allows the administrator to verify the location before proceeding with the upgrade or reinstallation process, Click Install.

Upgrade progress.

4.2.3 Step 3: upgrading

The subsequent steps are mostly the same as the ones used with a new installation.

Server name.

Database name.

If the installer is able to connect to the database directly, it retrieves all database connection parameters and the database name directly from the web.config file.

Click Next.

4.2.4 Step 4: database patch

In many cases access cannot be granted for the installer to connect to the database server directly, in which case the database patch must be provided to the database admin to run it locally on the server. Otherwise the installer automatically manages the netTerrain database update process.

Database patch.

Once the database update is successfully completed, click Next to complete the process.

4.2.5 Step 5: checking the netTerrain version.

Login to the netTerrain server via a web browser. Your login screen should show you that you are on version 10.0 already.

netTerrain v10 login splash screen.

After logging in, click on Help->About and review the netTerrain.

Make sure the first three numbers of the database and application version match.

5 Settings

One of our mantras as a software company is to try to deliver a product that you can “manage by exception”. This means that ideally it should already be configured in such a way that it accommodates your most likely needs. Only in case of an exception, where some setting needs to be changed, would you need to tap into them and change it. Hence, manage by exception.

Even though we get better and better at guessing what you need out-of-the-box, there are still plenty of situations where you want to configure something that departs from the default values set in the software when you initially install it. Also, as we keep delivering product, more and more settings pop up, so we thought it would be useful for the more advanced users to get a detailed view of these (in)famous settings.

5.1 The admin console vs settings.xml

Some of the settings are nicely displayed in the netTerrain administration console, which is very easy to use. In there you can currently adjust so-called global settings, which are parameters that affect the whole project, including things such as:

• Search and table view results per page.
• Email notification settings and GUI notifications.
• Default diagram/page setup.
• Displays and effects.
• Import/export buttons that you want shown in the tool.
• IP toolset, collector download and more.

These and more settings are nicely explained in the Admin guide.

Global settings section in the admin console

Anything that doesn't make it into the GUI (because it may be a bit too obscure of a setting or perhaps we don't want somebody to just easily change it from the console) goes into a file called Settings.xml. This file can be found on the netTerrain app server inside the netTerrain root folder and can be edited with a simple text editor like notepad.

Settings.xml file inside the netTerrain root folder

Now that we know what this settings.xml file does, we can dive deep into its bowels and look at what these settings do.

5.2 Authentication and security settings

These settings deal with how you login, and how netTerrain behaves in certain scenarios when it comes to security. As you know, in the web.config file you control the basic configuration parameters, including the application connection string and more. In there you will find a few more settings related to authentication, such as your password strength and so on in case you are using native authentication. Let’s review the parameters:

• PreserveLoginUrl: this setting controls whether the URL should be preserved on your browser.
• AutoLoginAsReadOnly: turns login-less access to the system on or off. If turned on, you will be granted access to netTerrain automatically in read-only mode (you won’t be associated with a user, of course), and you can log in later from within the tool if you want.
• MaximumFailedLoginAttempts: self-explanatory.
• ActiveDirectorySyncGroupFilter, ActiveDirectorySyncUserFilter, ActiveDirectoryUserFilter: Active Directory settings to tune your AD to properly synch up with netTerrain groups and users.
• ActiveDirectoryShowInAdminConsole: show AD settings in the admin console.
• ActiveDirectorySyncGroupFilter: active Directory custom filters.
• ActiveDirectoryUseGroupDistinguishedNameInSyncUserFilter: sets which distinguished name to use in SyncUserFilter.
• ActiveDirectoryUseDomainControllerAccountLockoutPolicy: When ‘true’ doesn’t lock a user after N failed login attempts counting on the DC.
• OpenIdAzureRolesManagement: uses Azure application roles to set user permissions.
• AuthenticationCookieTimeoutMinutes: self-explanatory.
• OAuthAuthenticationAllowInsecureHttp: should only be set to false when working in an environment closed off to the Internet.
• <!-- Microsoft Open ID authentication parameters. -->: self-explanatory.
• <!-- 2FA. -->: These parameters deal with the setup of multi-factor authentication.

Important!

If install netTerrain on a server that is not using https, you must uncomment the following highlighted section in your web.config file:

 <httpProtocol>

 <customHeaders>

 <clear />

 <remove name="X-Powered-By" />

 <add name="X-XSS-Protection" value="1; mode=block" />

 <!--<add name="Content-Security-Policy" value="upgrade-insecure-requests; frame-src 'self'; frame-ancestors 'none';" />-->

 <add name="X-Content-Type-Options" value="nosniff" />

 <add name="X-Download-Options" value="noopen" />

 <add name="X-Permitted-Cross-Domain-Policies" value="none" />

 <add name="Strict-Transport-Security" value="max-age=31536000; includeSubdomains; preload" />

 <add name="Cache-Control" value="private, no-store" />

 <add name="X-Frame-Options" value="deny" />

 </customHeaders>

 </httpProtocol>.

The resulting web.config section, if you are not using https, should look like this:

 <httpProtocol>

 <customHeaders>

 <clear />

 <remove name="X-Powered-By" />

 <add name="X-XSS-Protection" value="1; mode=block" />

 <add name="Content-Security-Policy" value="upgrade-insecure-requests; frame-src 'self'; frame-ancestors 'none';" />

 <add name="X-Content-Type-Options" value="nosniff" />

 <add name="X-Download-Options" value="noopen" />

 <add name="X-Permitted-Cross-Domain-Policies" value="none" />

 <add name="Strict-Transport-Security" value="max-age=31536000; includeSubdomains; preload" />

 <add name="Cache-Control" value="private, no-store" />

 <add name="X-Frame-Options" value="deny" />

 </customHeaders>

 </httpProtocol>

5.3 Directories

There seems to be an endless array of settings related to folder, paths and the like. Unless you must do something esoteric like integrating the output of these folders and paths with some external system and you must read it from a path or folder other than the default, then there shouldn’t be a need to ever touch these. I am not going to explain the meaning of each, since they are quite self-explanatory, so here they are in their full glory:

• QuotesFile
• LocalizationFile
• WebApiModulesPath and WebApiNetPipeAddress
• DevExpressFilesPath
• NetVizImportQueuePath
• VisioImportQueuePath
• SupportLink
• SevenZipAppPath
• ThemesPath
• DevExpressDefaultConnectionStringName
• SQLTablesPath
• SQLExpressionsPath
• DynamicReportsPath
• ImagesPath
• ImagesUserUploadedPath
• RTFPath
• LogPath
• VendorsOidsPath
• MibFilesPath

5.4 Default Global settings

This is a loose categorization of parameters that have to do with default settings that affect all users globally and are not related to more specific categories listed here or in the other two blogs. Below we’ll briefly describe what each setting does.

5.4.1 DefaultDiagramId

Like the name suggests, with this parameter we define which diagramId should be the default diagram that users access in the absence of a cached diagramId. Normally this id corresponds to the top-level diagram and it shouldn’t be changed.

However, in some scenarios you may want new users that access the system (or existing users flushing the cache) to access a diagram other than the top level.

5.4.2 DefaultThemeName

This is the default theme or skin you want your users to see when they log into netTerrain. Each user can later override this with their own skin.

5.4.3 AllowSymbolsInExpressions

This parameter is a bit obscure. When set to true you can use symbols in your expressions (see database and scripting guide). We recommend leaving it false unless you work in an environment closed off to the internet.

5.4.4 DevExpressDefaultDashboard

This parameter lets you define the default dashboard view that will appear when users click on the report button.

5.4.5 UseMetricSystem

Sets the metric system as the default for measurement units.

5.5 Notifications

Notification parameters include the ones you see for errors as well as those quirky quotes of the day and other alerts.

5.5.1 ShowErrors and ErrorLog

When set to use you will see error notifications on the bottom right corner of netTerrain and errors will be logged.

5.5.2 IntervalHideQuote and IntervalHideHelpMessage

These two settings let you set the display time of quotes and help messages (in milliseconds).

Quote of the day notification

5.5.3 HelpMessageShowCount

This setting lets you determine how many times you want to display each help message category for new users that join netTerrain.

Help notifications

5.5.4 ShowAlertIf90PercentsCapacityReached

When set to yes, this parameter will alert users when your netTerrain object license count has reached 90% of its capacity.

5.6 Usability and visualization

This section is one of the more useful ones as it lets you control certain aspects of usability and visualization.

5.6.1 SearchStringLength

This parameter determines the minimum size of a search string that does not result in a search error. Users that enter a string with a smaller number of characters will get a search error notification. It should probably always be set to 3 characters.

Search error notification

5.6.2 ShowNodeTitle

Show the title (name) of a node when hovering over it.

5.6.3 ShowLinkTitle

Show the title (name) of a link when hovering over it.

5.6.4 ShowFreeTextTitle

Show the title of a free text object when hovering over it.

5.6.5 EnableShortcutsToAddNodeRackDeviceAutomatically

When set to true, you can use simple shortcuts to add nodes, racks, and devices to netTerrain. These will be of the default generic type.

5.6.6 IsInStockColumnEnabled

When this setting is enabled, the “In Stock” option is displayed in the catalog for devices and rack types. Mostly used for warehousing purposes.

5.6.7 IsUniqueAllTypesColumnEnabled

When this setting is enabled, the “is unique across types’ checkbox is enabled for the catalog. We recommend leaving this setting off.

5.6.8 EmbeddedDocumentsFileSizeLimit

This parameter is very useful and determines the maximum file size in bytes that you allow for document uploads when you use the attachment feature. If users try to upload a document larger than this limit, they will get an error notification.

5.6.9 EmbeddedDocumentsExtensions

This parameter is also related to the parameter above and specifies which document extensions are approved for document embedding.

5.6.10 LinkCreationByMouseHoverOver

When set to true, as soon as you hover the mouse over a node, it’ll display all the snapping points for you to create a link.

5.6.11 DefaultSnapping

DefaultSnapping and DefaultSnappingDynamic are two parameters related to static (non-OSP) and dynamic (OSP-based) diagrams that when set to true, objects on a diagram will snap nicely as soon as you approach some right angle or alignment with an adjacent object.

5.6.12 MinObjectsToShowSize

This one is geeky, and at the same time a bit confusing. This parameter basically lets you control the zoom level that netTerrain needs to set itself with an object node at the center, when the so-called auto-zoom controlled by the AutoZoomToNodeFactor (see below) kicks in.

Auto-zoom happens when you navigate to a diagram and a specific node is the context, such as when you go up from a node, or you reach a diagram by searching for a specific node and the node you come from is small. What exactly small means is what this parameter defines.

The MinObjectsToShowSize parameter is the minimum size in diagram units/himetrics that defines the node as small. To find out if a node is small, netTerrain takes the smallest of the numbers associated with the width and height of the node as per the node settings and compares it to the setting. If the node size as defined above is smaller than the parameter number then auto-zoom kicks in. The zoom level that will be used is defined by the parameter below.

This feature comes in very handy when you have dense diagrams, and it would be hard to see a node without netTerrain automatically zooming you in.

5.6.13 AutoZoomToNodeFactor

This is the zoom-level factor for the auto-zoom feature, as described above. This factor is determined as a percentage of the node size relative to the absolute diagram size.

5.6.14 ChangeLinksThicknessToZoomLevel

This setting determines the link thickness behavior when zooming in or out, for both static and dynamic diagrams:

• 0: the absolute link thickness is unchanged regardless of the zoom level. This means that as you zoom in the link thickness increases proportional to the zoom level and vice versa.

• 1: the absolute link thickness changes for OSP maps only. This means that the relative thickness remains unchanged so that it always looks the same regardless of zoom level.

• 2: same as above, but for any diagram type.

5.6.15 MinRelativeNodeSizePerc

This parameter determines the minimum possible size of a node dropped on a diagram, relative to the size of the diagram at the given zoom level. This is useful when you need to drop nodes on a diagram while zoomed in or out and the node happens to have a very small default size. This setting makes sure that you can at least see the node. A parameter of 20, for example, means that regardless of the zoom level, a node you are dropping in (let’s pretend it is rectangular), cannot be bigger than 20% of the length of the visible diagram.

5.6.16 MaxRelativeNodeSizePerc

This parameter determines the maximum possible size of a node dropped on a diagram, relative to the size of the diagram at the given zoom level. This is useful, when you need to drop nodes on a diagram while zoomed in to prevent them from being bigger than the visible part of the diagram itself.

A parameter of 20, for example, means that regardless of the zoom level, a node you are dropping in (let’s pretend it is rectangular), cannot be bigger than 20% of the length of the visible diagram.

5.6.17 DynamicReportsInvalidProperty

A bit obscure, this parameter lets you specify what value you want to display when a property value is invalid within a dynamic query.

5.6.18 Map and general OSP settings

You can set up your Open Street Map server, which will involve a little bit of fiddling here and a whole lot of steps in your environment (see the Outside Plant section on your User Guide).

5.6.18.1 Map layers

netTerrain OSP supports different layers for GIS mapping, including three predefined layers for OpenStreetMaps (OSM) and two layers for Google Maps. These layers are set in 5 MapSource settings, which by default are configured as follows:

• MapSource1: OSM Standard layer.
• MapSource2: OSM transport layer.
• MapSource3: OSM light layer.
• MapSource4: Google Maps layer.
• MapSource5: Google Satellite layer.

Map layers

5.6.18.2 ZoomedOutObjectMapping

This one is quite important for proper tuning of the outside plant diagrams and deals with the representation of objects that look very small as you zoom out. As opposed to other regular diagrams, in outside plant projects it is very common to have large geographical areas be represented on one diagram by one OSM map. In those diagrams you may have nodes that you only see once zoom in a lot. In zoomed out mode those nodes would then basically disappear. But if that’s the case then you wouldn’t know where to find them when you first access that map.

In the settings.xml file we let you control how you would want those nodes represented in zoomed out mode. We can show clusters of nodes at zoomed out levels, so that at least you know where on the map you have nodes. We can also use halos, which are representations of the nodes that always look the same and have the same size on a diagram regardless of zoom level. The possible values are:

• 1 - Show clusters and halos
• 2 - Show halos only
• 3 - Show nothing

5.6.18.3 Circuit settings

Circuits are special Outside Plant elements that consist of end-to-end connections or services with their own special set of rules. For circuits we provide three settings:

• CircuitNameLabel: the representation of the name field in circuit tables views in case you don’t want it to literally say ‘Name’.

• CircuitTableDeleteButtonLocation: a bit obscure, this setting lets you control where on a table view you want the delete button to be located. 0 means left, 1 means right.

• CircuitNamesNotEditable`: when set to true, circuit names cannot be edited on the table views after they have been created.

5.6.18.4 Strand settings

Strands are another special Outside Plant element with their own special set of rules. Strands pop up on a cable when a catalog manager creates that cable type in netTerrain with a non-zero strand count property value. For strands we also have some special foo that lets you fine-tune your fiber campus and outside plant diagrams.

• StrandStatus0: default status value for the strand when it is first created as part of the cable.
• StrandColor: default strand color in case no color is assigned to a strand in the catalog definition.
• StrandStatusUndefined: the value you want represented for strands when a status is not defined.
• StrandModeUndefined: same as above, but for strand modes.
• StrandStatusValues: the list of status values that are permitted for strands.
• StrandModeValues: same as above but for strand modes. The typical values are “Single,Multi”.
• AddLinkTypeStrandsQtyValues: list of all the possible strand counts that can be defined for a cable containing strands. The usual values are "0,2,4,6,8,12,24,48,72,144,288,512,1024".
• StrandNamesNotEditableOnDiagram: when set to true, strands names cannot be changed on a diagram. They are predefined in the catalog.
• StrandModeNotEditableOnDiagram: same as above but for the mode.
• HasStrandMarkerPosition: here you can define the position for the marker on a port, if said port has strands connected. The possible values include 0 (bottom right of port); 1 (center) and 2 (bottom left).

5.6.19 BOM settings

Along with all the elements above, in Outside plant projects you can also define a Bill of Materials report that is generated from a circuit layout record. Two settings help you customize these reports:

• BOMReportCustomTextFilePath: the location of a file that can contain custom text that appears in every BOM report. The default is the netTerrain root folder.
• BOMReportBorderColor: self-explanatory.

5.6.20 CLR settings

In the settings.xml file you can also control some settings for the CLR representations in netTerrain, such as labels, font sizes and colors. The names of the settings are self-explanatory:

• BlockCLRByDefault:
• BlockCLRDisplayedField
• BlockCLRLabelsFontSize
• BlockCLRBuildingsLabelsFontSize
• BlockCLRManholesLabelsFontSize
• BlockCLRBoundsColor
• BlockCLREndEqDeviceLabel
• BlockCLREndEqCardLabel
• BlockCLREndEqPortLabel
• BlockCLRDeviceLabel
• BlockCLRCardLabel
• BlockCLRPortLabel
• CLRShowLinkName

5.7 Other Settings

Below is a list of additional settings you can control from the settings.xml. Descriptions for these are usually included in the settings file.

• ExtendedQueryFeatures
• ErrorApiLog
• FixFieldAccordingZoom
• EncryptUpgradeRequest
• MinDiagramToObjectsSquareRatio
• MinDiagramToObjectsSizeRatio
• DiagramObjectCatalogRemoveSearch
• DefaultDiagramGridSpacingX
• DefaultDiagramGridSpacingY
• EnableCatalogJsonExport
• EnableRackAudit
• AuditDate
• AuditStatus
• AuditedBy
• SNMPTrapsSeverity
• MobileAppIOS
• MobileAppAndroid
• BarcodeProperty
• EnableIpam
• IpamDashboardUrl