How to install the Web Service

You do not need to install a Web Service on your server if you are using direct database access. For details on server type please read the introduction at the beginning of this documentation. It's also possible to install the web service later, so that you can first check the MemoryLifter database and MemoryLifter client configuration.

1. Software requirements

If you want to make use of MemoryLifter Web Service, your server workstation has to meet following demands:

  • Internet Information Service (IIS) has to be installed (how to, see below)
  • Microsoft® .NET Framework 4.0 or higher has to be installed (how to, see below)

Attention: Please make sure that all requirements are met. If you are not sure, try to install the required software. If you have already installed them, the installation wizard will inform you and you can continue.

2. Prepare MemoryLifter Web Service

Open the MemoryLifter Server Package and copy the folder named "MemoryLifterWebService" to anywhere on your server. Now open the file "web.config", located in the root directory of the "MemoryLifterWebService" folder. Use a simple text editor to open the file (e.g. notepad). Search for the following part in the file:
clip_image002

Now change the "connectionString" to the following and save the file afterwards:

connectionString="Server=localhost;Port=5432;Userid=mlifterUser;password=mlifter;Protocol=3;SSL=false;Pooling=true;MinPoolSize=1;MaxPoolSize=20;Encoding=UNICODE;Timeout=15;SslMode=Disable;database=memorylifter;"

Attention: Userid= and password= should be set to the username and password you defined with PgAdmin III a few sections earlier.

3. Integrate MemoryLifter Web Service into IIS

The following paragraph shows you how to install and integrate the MemoryLifter Web Service into IIS (Internet Information Service), depending on the operating system you use on the server. This documentation explains IIS integration in a very simplified manner. As each server has a unique configuration, use the following only as a rough guideline.

3.1   Install IIS – Internet Information Service (Windows® XP Pro)

For the installation of IIS, you need to have your Windows® XP Pro setup disk ready (or the corresponding "I386" folder on it).

  • Click on "Start" => "Settings" => "Control Panel" and double click on "Add or Remove Programs".
  • Afterwards click on "Add/Remove Windows Components" (on the left side).
  • A new dialog appears. Scroll down the list to the entry "Internet Information Services (IIS)" and check it. If the checkbox is already checked, you can cancel the wizard and continue with the next step.
  • Click on "Next".
  • A new dialog appears and asks for the Windows setup CD. Insert the CD and click on "OK".
  • After the installation has finished, restart your workstation

Now you have successfully installed IIS. For general problems with IIS, contact Microsoft® (Internet Service Provider, etc…) for help.

3.2   Install IIS – Internet Information Service (Windows® Vista / 7)

  • Click on "Start" => "Control Panel" and click on "Programs and Features".
  • Afterwards click on "Turn Windows features on or off".
  • After confirmation of the UAC message, a new dialog appears. Scroll down the list to the entry "Internet Information Services" and check it. Also check its sub-entry "Internet Information Services" / "World Wide Web Services" / "Application Developement Features" / "ASP.NET". If both checkboxes are already checked, you can cancel the wizard and continue with the next step.
  • Confirm with the "OK"-button and wait for the process to complete.
  • Restart the workstation if you are prompted to do so.

Now you have successfully enabled IIS. For general problems with IIS, contact Microsoft® (Internet Service Provider, etc…) for help.

3.3   Install IIS – Internet Information Service (Windows® Server 2003 / 2008)

For the Windows® Server systems, IIS is already pre-installed, but it has to be enabled manually if it is not already active. To do this, you have to configure the server to an appropriate Role (either "Application Server" or "Web Server (IIS)").

Please consult the corresponding manual or online help for more information about Roles and how they can be configured.

3.4   Update your workstation with the Microsoft® .NET 4.0 Framework
Please note: If you know that the "Microsoft® .NET 4.0 Framework" is already installed you can skip this step.

Open a web browser, search for the "Microsoft .NET 4.0 Full Framework" and download it. The .NET 4.0 Framework is free and can be downloaded from the Microsoft® homepage.
After you downloaded the .NET 4.0 Framework, install it on your server workstation. If the .NET Framework is already installed, you can cancel the installation and continue. After the installation is finished, restart your workstation.

Now you have successfully installed the .NET 4.0 Framework. For problems during the installation, contact Microsoft® (Internet, etc…) for help.

3.5   Integrate MemoryLifter Web Service into IIS (Windows® XP Pro / Server 2003)

Open the Computer Management dialog ("Start" => "Settings" => "Control Panel" => "Administrative Tools" => "Computer Management") and expand the "Internet Information Service" tree node.
If there is no tree node "Internet Information Service" you have to install the "Internet Information Service" (IIS) first. See above for how to install it.

Right click on "Default Web Site" … "New" … "Virtual Directory…":

clip_image002[5]

In the following wizard enter this data:

  • Alias: MemoryLifterWebService
  • Directory: (enter the path of the "MemoryLifterWebService" folder)
  • Allow the following: Read; Run scripts (such as ASP)

3.6   Integrate MemoryLifter Web Service into IIS (Windows® Vista / 7 / Server 2008)

Open the Computer Management dialog ("Start" => "Settings" => "Control Panel" => "Administrative Tools" => "Computer Management") and expand the "Internet Information Service" tree node.
If there is no tree node "Internet Information Service" you have to install the "Internet Information Service" (IIS) first. See above for how to install it.

Right click on "Default Web Site" … "Add Application…":

clip_image002[7]

In the following wizard enter this data:

  • Alias: MemoryLifterWebService
  • Physical path: (enter the path of the "MemoryLifterWebService" folder)

Click on OK, and the new application should be visible in the list.

After that, you still have one thing to setup – set the "App_Data" folder to writable:

The application needs to have write permission for the folder App_Data in order to create log files and save cache data.

To do this, open the node "MemoryLifterWebService", right click on "App_Data" and select "Edit Permissions...". In the appearing dialog, navigate to the tab "Security" and click on the button "Edit...".
Click on "Add..." and enter the user the application runs under (by default "NETWORK SERVICE"):

image

After that, close the user selection dialog and check the checkbox "Allow" in the row "Full control":

clip_image002[9]

Then, you can close the dialogs with "OK" and the MemoryLifter Web Service integration is finished.

3.7 Test the MemoryLifter Web Service
Open Internet Explorer (or any other browser) and go to the following address:
http://localhost/MemoryLifterWebService/MLifterLearningModulesService.asmx

clip_image002[11]

If the above page is shown without any errors, the MemoryLifter Web Service has been successfully integrated into IIS.

Last edited Mar 6, 2012 at 12:41 PM by CFI, version 6

Comments

No comments yet.