Installation

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

Installation

To install the SpaceObServer Web Access, please execute the setup file 'SpaceObServerWebAccess-Demo.msi' or 'SpaceObServerWebAccess-Full.msi' on your machine and follow the instructions. The setup will copy the necessary files to your hard disk. The SpaceObServer Web Access may be uninstalled using the Software applet in the Control Panel of Windows.

The SpaceObServer Web Access is an Add-on for the SpaceObServer, but does not need to be installed on the same machine (stand-alone). Only the connection to the database is required (either via the network or local), where the SpaceObServer stores the scans:

InstallSpaceObServerWebAccessOnSeparateMachine_EN

Installation Steps

The software requires the .NET Framework 4.5. Please install the framework before you start the setup.

1.Start the setup file on the target machine.

2.Agree to the license agreement via checking the box and click on 'Install'.

3.Type in the installation key (the dialog does not appear in the demo version). You can get the installation key on our homepage http://www.jam-software.com in the customer area.

4.In the next step, the setup reviews if the required features are activated. If this is not the case, then the missing features will be displayed with a short description:
 
SetupActivateWindowsFeatures
 
Press the button 'Enable Now' to enable the missing features. The process may take a few minutes to complete.

5.In the next dialog, you can configure the website:
 
SetupWebSiteParameters
 
1. The display name of the website.
2. The port of the website (e.g. http://hostname:80).
3. The hostname is the URL where you can access the SpaceObServer Web Access via the browser. Please make sure, that the address is registered in the DNS server.
4. You can restrict the IP-address where the SpaceObServer Web Access is accessible (e.g. http://192.168.178.1). Choose the default vaule 'All' to allow all addresses.
5. Alternatively you can add the SpaceObServer Web Access as an web app to an existant website.
 
You can change all these configurations in the IIS-Manager, after the installation.
If all options are set up, please press the button 'Apply'.
 

6.The SpaceObServer Web Access has an administrator backend which is accessible via the URL http://hostname/admin. Use the dialog to select a security group that is allowed to access the administrator backend:
 
SetupAdminRole

A.Please enter the name of a security group or an user account and start the search via the button 'Search'. It is also possible to search in combination with an domain by the following pattern: 'DOMAIN\GROUPNAME'.

B.When the search found an user or security group in the Active Directory, then the result will be listed in the select box. Select and apply the entry via the button 'Apply Selection'.

C.The selected security group or user will be displayed in this section. You can change the SID in this field manually. Via the button 'Apply', you grant the SID access to the Admin Backend.

 

7.In the next dialog, you can choose the database where the SpaceObServer has stored the scans. The SpaceObServer Web Access creates the reports from this source and provides them via the network. You can decide between 'SQL Server Authentication' (recommended) and the 'Windows Authentication':

A.SQL Server Authentication
 
SetupDatabaseConnection

1.Choose the type of the database.

2.Enter a server name here. Alternatively you can enter an IP-address.

3.Enter the name of the database.

4.Choose the 'SQL-Server Authentication' and enter the username and the password.

5.Test the connection to the database via the button.

6. If the database connection is successful, then press the button 'OK'.
 

B.Windows Authentication
If you want to use the Windows Authentication for the database connection, please skip this dialog via the button 'x' at the top right. After the setup, please follow the additional steps at the and of this manual.

8.The next dialog shows the URL where the SpaceObServer Web Access is accessible via the browser. You can copy the URL and paste it in your browser. The dialog also shows the URL to the administrator backend:
 
SetupLaunchWebAccess

9. The final dialog box completes the installation. You can find information how to get started with the SpaceObServer Web Access in the chapter 'Quickstart'.

Security advice: We recommend to enable HTTPS (Secure Socket Layer) for the SpaceObServer Web Access.

 

Windows Authentication for the database connection

1.Open the Windows Command Line as Administrator.

2.Navigate to the installation folder of SpaceObServer Web Access, open the folder '/bin' and execute the command 'SpaceObServer.exe /connectionstring':
"C:\Program Files (x86)\JAM Software\SpaceObServer Web Access\bin\SpaceObServer.exe /connectionstring"

3.Fill out the required fields in the dialog, select the 'Windows authentication' and press the button 'OK'.

4.In Windows open the IIS-Manager.

5.Select 'Application Pools' > 'spaceobserver_apppool' > 'Advanced Settings':
 
WindowsAuthIISConfigureAppPool

6.At the entry 'Identity' press the 'select' button:
 
WindowsAuthSelectIdentity

7.Choose 'Custom account' and press the button 'Set'. After that, enter the Windows account you want to use for the connection to the database and press the button 'OK':
 
WindowsAuthIISAddWindowsAccount

8.Recycle the spaceobserver_apppool.

9.If the SpaceObServer Web Access does not work with the Windows Authentication, please use the SQL Server Authentication (recommended) and in the 'Advanced Settings' of the Apppool 'spaceobserver_apppool' set the Identity back to 'LocalSystem'.