Installing GeoStream

Note
Before installing the GeoStream server, ensure that the server hardware and software complies with recommended minimum system requirements.

To install the GeoStream server:

• Copy the GeoBase installer MSI application to a convenient location, such as your desktop.

Note
Note that the installer file includes the server version in its name. For example, GeoBase4.3.2.1.msi indicates that the GeoStream (and GeoBase) versions are '4.3.2.1'.

• Double-click the installer. The installer application will begin by displaying an introductory/welcome window. Click Next to view the 'End-User License Agreement' window.

Note
If you have previously installed this GeoStream server version, a license agreement window will not be displayed. Instead, you will be presented with two installer options: Repair and Remove. Select Repair to overwrite any corrupted or missing files and registry entries with new, default versions and entries. Select Remove to uninstall the GeoStream server from the computer.

• Accept the terms of the license by selecting the license acceptance check box. If you do not accept the license terms, the Next button will remain inactive, preventing you from continuing with the installation. When you have accepted the license terms, click Next to view the Microsoft Windows Server 2008 R2 certification panel.

Note
Read this panel carefully before continuing. It contains important information about the steps needed to install GeoStream files that are certified for use with Microsoft Windows Server 2008 R2.

• Click Next to view the installation version panel.

• Click Install beside the second, GeoStream-only, installation option. The 'GeoStream Settings' panel will open.

Note
Only the second, GeoStream-only, installation option will install GeoStream files that are certified for Microsoft Windows Server 2008 R2.

• The 'GeoStream Settings' panel displays the GeoStream server's current installation location, the GeoStream server name and the tile image cache directory. To change either the server name or the default installation and cache locations, click Change and edit the default settings. When you have finished editing the folder locations or server name, click Next.

The default values for these options are:

1. GeoStream Installation Directory: 'C:\inetpub\wwwroot\GeoStream\'. This is the directory into which the GeoStream server files will be installed.

2. Server Name: 'GeoStream'. This is the name that will be used by the IIS web server.

3. Server Cache Directory: 'C:\ProgramData\GeoStreamCache'. This is the directory that will contain the GeoStream server's tile cache. A map layer presented using the GeoStream server consists of a collection of individual image 'tiles' (with a default size of 300 x 300 pixels). When clustered together, these tiles create a complete map. They are typically cached on the server rather than being re-created every time they are needed, reducing the time needed to display a complete map.

• Click Install. The installation process will begin. This process may take several minutes.

Note
If you have not previously installed a GeoStream server you may be asked to provide a license file (.lic format). Click Select existing license, then click Browse... Navigate to the license file on your computer, then click Open and OK. If you do not have a trial license, contact gbsupport@verizonconnect.com.

Note
If a GeoStream server has been installed previously using the same server name you chose in the steps above, a warning message will be displayed. To overwrite this existing server instance, click Overwrite. To retain the existing server and its settings, click Abort. This will cancel the new installation.

• When the installation process has completed, the installer will display a final information window indicating that the process has been completed. Click Finish to close the installer.

Data files (.gbfs format) contain the map and street data GeoStream requires to operate. If you have not done so already, you should now download a suitable test gbfs file from the Verizon Connect Spatial website (navigate to 'Downloads', then to your continent). You can also obtain a test file by contacting gbsupport@verizonconnect.com.

In a default installation of GeoStream, .gbfs data files should be copied into the C:\inetpub\wwwroot\GeoStream\Bin\Data folder. If no data is present, the GeoStream server will be unable to display a map in the client.

If you have not done so, copy a map data file to this location now.

Note

GeoStream will automatically detect .gbfs format files within the data repository folder. The default repository location expected by GeoStream varies according to the installation type chosen. The location detailed above is expected by a GeoStream-only installation. If GeoStream is installed together with the GeoBase SDK, the default data repository location will typically be the C:\Program Files\Telogis\GeoBase\GeoStream\server\Bin folder.

To select an alternative data repository location, edit the Path value in the 'repository.Config' file located in the GeoStream installation directory (typically C:\inetpub\wwwroot\GeoStream).

Open a web browser and navigate to http://localhost/GeoStream/tile.aspx?t=6,-2,300,2,5. This will test that the server is functioning correctly, and should display a map centered on the US Pacific Northwest.

Alternatively, navigate to http://localhost/GeoStream/, then open the 'scripts' folder and select any of the .aspx format files beginning with 'tutorial'.

If for any reason your installation fails, see the Troubleshooting a GeoStream Server section.

Note
Only the GeoStream Server, when installed using the GeoStream-only installation option, has been certified for Microsoft Windows Server 2008 R2.

To test advanced GeoStream functionality, navigate to the following location: http://localhost/GeoStream/scripts/tutorial.demo.aspx.

Test the following functionality:

Address Lookup. Type a street address (such as '20 Enterprise, Aliso Viejo, California') into the left text field, then click GeoCode. The map will zoom and center on the location. Note that the location you choose must be included in the GeoStream map data file.

Reverse Geocoding. Click On beside 'Reverse Geocoding:' in the upper left corner panel. Move the mouse cursor over a populated area of the map. The 'Address' field of the information box will populate with the street address immediately below the current mouse position.

Satellite Imagery. Click On beside 'Satellite Imagery' in the upper left corner panel to enable satellite imagery. Click Off to return to the standard map view.

Map Zoom. Click Zoom beside 'Mode:' in the upper left corner panel. Use your mouse to select a map area (left-click a point on the map then, while holding down the mouse key, drag the mouse arrow in any direction to create an opaque zoom box). Note that you can also zoom in or out at any time using the mouse scroll wheel, or the zoom slide bar in the lower right corner of the window.

Map Pan. Click Pan beside 'Mode:' in the upper left corner panel. The mouse cursor will change to a hand. Use your mouse to 'drag' the map (left-click a point on the map then, while holding down the mouse key, move the mouse hand cursor).

Routing and Driving Directions. Right-click a map location and select the 'Set Route Start' option. Right-click a second location and select the 'Set Route End' option. Right-click the map and select 'Get Directions'. A route highlight will be displayed showing a driving route between the two locations. Click Directions on the upper right panel to view written navigation directions from the start point to the route destination.

Advanced Server Configuration

The GeoStream server includes a number of advanced configuration options that specify:

• Password and authentication settings for individual user accounts

• The locations of repositories and datasets

• File compression settings

• Timeout and refresh periods

• Layer configurations

• Satellite imagery configuration

• Server configuration (trusted networks and load balancing)

The (.Config format) files used to configure these settings are located in the GeoStream installation folder, (typically C:\inetpub\wwwroot\GeoStream) and are detailed in the Configuring the server and GeoStream Satellite Imagery sections.

Note
Note that the location of these files will differ depending on the GeoStream installer version used. If GeoStream is installed together with the GeoBase SDK, these files will be located in the C:\Program Files\Telogis\GeoBase\GeoStream\server folder by default.

Enabling Satellite Imagery

<add key="SatelliteUser" value="name"/>
<add key="SatellitePass" value="password"/>

<add key="SatelliteHost" value="http://imagery1.telogis.com/ImageryCache/" />

Uninstalling a GeoStream Server

To uninstall the GeoStream server:

• Copy the GeoBase installer MSI application to a convenient location, such as your desktop.

• Double-click the installer. The installer application will begin by displaying an introductory/welcome window.

• Click Next. You will now be presented with two installer options: Repair and Remove.

• Click Remove. A confirmation window will open.

Note

During uninstallation, the IIS application pool will be checked to ensure the GeoStream directory is not in use. This directory is removed during the uninstallation process. If the directory is found to be in use by IIS, a dialog message will be displayed requesting that the IIS application pool be manually stopped before proceeding. If this message is displayed, click Next to continue when the application pool has been stopped.

• Click Remove to uninstall the GeoStream server from the computer. This may take a moment.

• Click Finish. The GeoStream server is now removed.