ASEBA-Network™ Installation and Configuration Instructions

Table of Contents

Instructions for Installing and Configuring ASEBA-Network™ on a Single Server

Complete the steps below to install and configure ASEBA-Network™ on a single server:

Click on the "setup.exe" file to start the installation. Follow the prompts to go through the installation. When the installer is finished, the license manager will open. Enter ALL serial keys.

You need to enter in your NETWORK serial key AND an AGE GROUP MODULE serial key. Enter all serial numbers and fill out the required information.

Click the desktop icon "Configure ASEBA-Network". This will open PowerShell as an administrator. Follow the prompts to configure ASEBA-Network™ on your server.

If the PowerShell script fails or you prefer to install and configure IIS manually, perform the following steps:

  1. Open "Server Manager".
  2. Click "Add Roles and Features".
  3. Click "Next" and then Choose "Role Based or Feature Based Installation".
  4. Select your server.
  5. In server roles, select "Web Server IIS".
  6. Under "Web Server", click "Application Development" and choose "ASP.NET 4.5".
  7. Under "Common HTTP Features", make sure "Static Content" is installed.
  8. Click "Add Features".
  9. Click "Next", then "Install".

If the PowerShell script fails or you prefer to configure the ASEBA-Network™ website manually, perform the following steps:

  1. Open IIS.
  2. Find your server in the list of nodes and click on it to expand.
  3. Select "Sites".
  4. Click "Default Website". Alternatively, you can select or create a different website.
  5. Click "Basic Settings". It is located on the right hand side of the application screen.
  6. Click the "..." button next to the physical path.
  7. Select the folder location where ASEBA-Network™ is installed. Commonly, this is in the "Program Files(x86)" folder.
  8. Click the "ASEBA" folder.
  9. Click the "wwwroot" folder.
  10. Click OK. The file path should look similar to this: C:\ProgramFiles(x86)\ASEBA\ASEBA-Network\2015\wwwroot
  11. Click on "Application Pools" and choose "Default App Pool".
  12. Click "Advanced Settings". It is located on the right hand side of the application screen.
  13. In the "Process Model" section, make sure that "Load User Profile" is set to TRUE.

If you are using SQL CE, you can skip to setting up users below. Otherwise, the next section will give instructions for SQL server installation and configuration with ASEBA-Network™.

If you have not already, install SQL Server and SQL Server Management Studio on the server. Open SQL Server Management Studio as an Administrator. Find and open the "Configuration.sql" file, which is often located in C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\Scripts\Configuration. **Important** Change the username and the password to match what you made in the PowerShell script.

After making the username and password changes, execute the configuration script by clicking on "Execute" or pressing the "F5" key."

If the configuration script fails or you prefer to configure SQL Server manually, perform the following steps to attach the database files:

  1. Make sure that users have full control of the ASEBA installation folder before starting (read, write, modify, delete). The service account user also needs "modify" access to the database folders if it does not already have that access. See below to check what user account is the service account user if it is not known.
  2. Open SQL Server Management Studio, run as administrator. If your user account is not an administrator, you can elevate your privileges by right-clicking the icon and selecting "Run as Administrator".
  3. If the name of the service account user is needed, this query run in Query Analyzer will return the name: SELECT servicename, service_account FROM sys.dm_server_services.
  4. Under the server list on the left, right-click on "Databases" and select "Attach". Under "Databases to Add", click the "Add" button. Select this file: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_data\Databases\SQL_Server\ASEBA.Database.mdf.
  5. Under the server list on the left, right-click on "Databases" and select "Attach". Under "Databases to Add", click the "Add" button. Select this file: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_data\Databases\SQL_Server\ASEBA.Logs.mdf.
  6. Under the server list on the left, right-click on "Databases" and select "Attach". Under "Databases to Add", click the "Add" button. Select this file: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_data\Databases\SQL_Server\ASEBA.Membership.mdf.

If the configuration script fails or you prefer to configure SQL Server manually, perform the following steps to create a SQL Server user account for ASEBA-Network™:

  1. Open SQL Management Studio and the instance of your server where the three ASEBA-Network™ databases have been attached.
  2. Open the "Security" folder and right-click on "Logins". Choose "New Login".
  3. Enter in a login name. Select the radio button for "SQL Server Authentication". Uncheck "Enforce Password Policy".
  4. Select "User Mapping" from the list on the left. Click the "Map" checkbox for each of the three ASEBA-Network™ databases. As you are clicking on each database, also ensure that the user had "db_owner" checked in the list of role memberships in the below window.
  5. Click "OK" to create the new user.

Now that the database is set up, make sure the file permissions on the database folders are correct. Specifically, the service account user needs access to the directory where the database resides. If you need the nName of the service account user, run the following command from a query window in SQL Server Management Studio: SELECT servicename, service_account FROM sys.dm_server_services.

If you know the service account user, open file explorer and go to the directory where the databases reside. Normally the directory is this: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_Data\Databases. Right-click on that folder, then select "Properties". Select the "Security" tab, find the service account user in the list, then click "Edit". You will need administrator privileges to do so. Add the full control of privileges to the user account, and click "OK".

To point the ASEBA-Network™ front end to use the databases, open the “ConnectionStrings.config” file in a text editor (C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot). If you are using SQL Server, you can delete the SQL CE connection strings to look like this:

In the connection string where it says “{myserver}” add your server name and instance of it. Where you see “{my user name}” enter the server user name. Remove the brackets. Where you see “{my password}” enter the server password. Remove the brackets. Save this file.

The final step is to set up Your ASEBA-Network™ User accounts. First, open your preferred browser and go to http://localhost/ (or the binding you created, if it is different). Log into ASEBA-Network™ with the initial log in credentials (on the CD case, or if electronically downloaded, in the "Read me first...." file) and follow the instructions for adding users. These instructions can also be found within the application by clicking on "Help" and "ASEBA-Network™ Procedures Manual".

Congratulations, you have now successfully installed and configured ASEBA-Network™. If you have any further questions please visit our help page.

Instructions for Installing and Configuring ASEBA-Network™ on Separate Web and Database Servers

Complete the steps below to install and configure ASEBA-Network™ on a separate web and database servers:

On the web server, Click on the "setup.exe" file to start the installation. Follow the prompts to go through the installation. When the installer is finished, the license manager will open. Enter ALL serial keys.

You need to enter in your NETWORK serial key AND an AGE GROUP MODULE serial key. Enter all serial numbers and fill out the required information.

Click the desktop icon "Configure ASEBA-Network". This will open PowerShell as an administrator. Follow the prompts to configure ASEBA-Network™ on your server.

If the PowerShell script fails or you prefer to install and configure IIS manually, perform the following steps:

  1. Open "Server Manager".
  2. Click "Add Roles and Features".
  3. Click "Next" and then Choose "Role Based or Feature Based Installation".
  4. Select your server.
  5. In server roles, select "Web Server IIS".
  6. Under "Web Server", click "Application Development" and choose "ASP.NET 4.5".
  7. Under "Common HTTP Features", make sure "Static Content" is installed.
  8. Click "Add Features".
  9. Click "Next", then "Install".

If the PowerShell script fails or you prefer to configure the ASEBA-Network™ website manually, perform the following steps:

  1. Open IIS.
  2. Find your server in the list of nodes and click on it to expand.
  3. Select "Sites".
  4. Click "Default Website". Alternatively, you can select or create a different website.
  5. Click "Basic Settings". It is located on the right hand side of the application screen.
  6. Click the "..." button next to the physical path.
  7. Select the folder location where ASEBA-Network™ is installed. Commonly, this is in the "Program Files(x86)" folder.
  8. Click the "ASEBA" folder.
  9. Click the "wwwroot" folder.
  10. Click OK. The file path should look similar to this: C:\ProgramFiles(x86)\ASEBA\ASEBA-Network\2015\wwwroot
  11. Click on "Application Pools" and choose "Default App Pool".
  12. Click "Advanced Settings". It is located on the right hand side of the application screen.
  13. In the "Process Model" section, make sure that "Load User Profile" is set to TRUE.

Now it is time to configure the database server. If you have not already, install SQL Server and SQL Server Management Studio on the database server. Copy the contents of "C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\Scripts\Configuration" and "C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_data\Databases\SQL_Server\" to the database server.

After copying the database files and configuration file over to the database server from the web server, you can now configure the database server. Open SQL Server Management Studio as an Administrator. Find and open the "Configuration.sql" file, which is often located in C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\Scripts\Configuration. **Important** Change the username and the password to match what you made in the PowerShell script.

After making the username and password changes, execute the configuration script by clicking on "Execute" or pressing the "F5" key."

If the configuration script fails or you prefer to configure SQL Server manually, perform the following steps to attach the database files:

  1. Make sure that users have full control of the ASEBA installation folder before starting (read, write, modify, delete). The service account user also needs "modify" access to the database folders if it does not already have that access. See below to check what user account is the service account user if it is not known.
  2. Open SQL Server Management Studio, run as administrator. If your user account is not an administrator, you can elevate your privileges by right-clicking the icon and selecting "Run as Administrator".
  3. If the name of the service account user is needed, this query run in Query Analyzer will return the name: SELECT servicename, service_account FROM sys.dm_server_services.
  4. Under the server list on the left, right-click on "Databases" and select "Attach". Under "Databases to Add", click the "Add" button. Select this file: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_data\Databases\SQL_Server\ASEBA.Database.mdf.
  5. Under "Database Details", select the "ASEBA.Database_log.ldf” file then click "Remove". Afterwards, click "OK" to attach the database.
  6. Under the server list on the left, right-click on "Databases" and select "Attach". Under "Databases to Add", click the "Add" button. Select this file: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_data\Databases\SQL_Server\ASEBA.Logs.mdf.
  7. Under "Database Details", select the "ASEBA.Logs_log.ldf” file then click "Remove". Afterwards, click "OK" to attach the database.
  8. Under the server list on the left, right-click on "Databases" and select "Attach". Under "Databases to Add", click the "Add" button. Select this file: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_data\Databases\SQL_Server\ASEBA.Membership.mdf.
  9. Under "Database Details", select the "ASEBA.Membership_log.ldf” file then click "Remove". Afterwards, click "OK" to attach the database.

If the configuration script fails or you prefer to configure SQL Server manually, perform the following steps to create a SQL Server user account for ASEBA-Network™:

  1. Open SQL Management Studio and the instance of your server where the three ASEBA-Network™ databases have been attached.
  2. Open the "Security" folder and right-click on "Logins". Choose "New Login".
  3. Enter in a login name. Select the radio button for "SQL Server Authentication". Uncheck "Enforce Password Policy".
  4. Select "User Mapping" from the list on the left. Click the "Map" checkbox for each of the three ASEBA-Network™ databases. As you are clicking on each database, also ensure that the user had "db_owner" checked in the list of role memberships in the below window.
  5. Click "OK" to create the new user.

Now that the database is set up, make sure the file permissions on the database folders are correct. Specifically, the service account user needs access to the directory where the database resides. If you need the nName of the service account user, run the following command from a query window in SQL Server Management Studio: SELECT servicename, service_account FROM sys.dm_server_services.

If you know the service account user open the file explorer and go to the directory where the databases reside. Normally the directory is this: C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot\App_Data\Databases. Right-click on that folder, then select "Properties". Select the "Security" tab, find the service account user in the list, then click "Edit". You will need administrator privileges to do so. Add the full control of privileges to the user account, and click "OK".

To point the ASEBA-Network™ front end to use the databases on the database server, go back to the web server and open the “ConnectionStrings.config” file in a text editor (C:\Program Files (x86)\ASEBA\ASEBA-Network\2015\wwwroot).

In the connection string where it says “{myserver}” add your server name and instance of it. Where you see “{my user name}” enter the server user name. Remove the brackets. Where you see “{my password}” enter the server password. Remove the brackets. Save this file.

The final step is to set up Your ASEBA-Network™ User accounts. First, open your preferred browser and go to http://localhost/ (or the binding you created, if it is different). Log into ASEBA-Network™ with the initial log in credentials (on the CD case, or if electronically downloaded, in the "Read me first...." file) and follow the instructions for adding users. These instructions can also be found within the application by clicking on "Help" and "ASEBA-Network™ Procedures Manual".

Congratulations, you have now successfully installed and configured ASEBA-Network™. If you have any further questions please visit our help page.

Instructional Videos for ASEBA-Network™ Installation and Configuration

These videos can walk you through the process of installing and configuring ASEBA-Network™: