WebDocs Windows Installation Version 1.0.34 and above - Support

WebDocs Windows Installation Version 1.0.34 and above

From Support

Jump to: navigation, search

The following instructions can be used to install WebDocs for Windows V1.0.34 and above.

Contents

WebDocs Installation Prerequisites

Server or PC running Windows 2000, XP Professional or 2003

IIS Web Server 5.0 or above

Install Microsoft .Net Runtime 1.1 (http://msdn.microsoft.com/netframework/downloads/updates/version1/default.aspx)

Install Microsoft .Net Runtime 2.0 (http://msdn.microsoft.com/netframework/downloads/updates)

Install MDAC 2.8 (If you will be installing SQL Server Express 2005) (http://msdn.microsoft.com/data/ref/mdac/downloads/)

Install Microsoft SQL Server 2000, MSDE 2000 or SQL Server 2005

SQL Server 2005 Express and SQL Server Management Studio Express installers can be downloaded from the Microsoft Web Site: http://msdn.microsoft.com/vstudio/express/sql/download


Installing SQL Express 2005 (Optional if you have no SQL Server Already)

(Note: When installing SQL 2005 Express, it may fail when trying to install the SQL Native Client.

If so, go to Add/Remove Programs and uninstall the SQL Native Client and re-run the SQL Server 2005 Setup.)

After SQL Express 2005 installation, start the "SQL Server Configuration Manager" via "Start/Programs/Microsoft SQL Server 2005" program group.

SQL2005 - The TCP/IP protocol must get enabled so remote ODBC/ADO clients can talk to the SQL Express Server

In the left tree pane, expand the "SQL Server 2005 Network Configuration" option and click on the "Protocols for SQLEXPRESS" section.

In the right pane, double-click the TCP/IP protocol and change the Enabled setting to "Yes".

Click OK to save the setting.

SQL2005- The following must be done so the TCP/IP Protocal gets enabled

In the left tree pane, click on the "SQL Server 2005 Services" option.

In the right pane, double-click on the "SQL Server (SQLEXPRESS)" option.

Click the "Restart" button. Then click OK to complete the SQL Server restart.

SQL2005 - The following must be done so remote ODBC/ADO clients can talk to the SQL Express Server

In the right pane, double-click on the "SQL Server Browser" option.

Click on the "Service" tab.

Change the "Start Mode" to "Automatic".

Click on the "Log On" tab.

Click the "Start or Restart" button.

Then click OK to complete the SQL Server Browser start.

SQL2005: Installing SQL Server Management Studio Express

If installng SQL 2005 Express, also install the "SQL Server Management Studio Express".

This is the equivalent to the SQL Enterprise Manager in SQL Server 2000.

Install WebDocs Server

Select all options from the WebDocs installer.

Note: When installing on a server with SQL Server 2005 Express, make sure to specify "localhost\SQLEXPRESS" for the database server host info instead of just "localhost". This is because SQL Server 2005 supports multiple named server instances on a single PC.

When util.asp displays for editing, set the webdocs user and password to match your SQL server user info for the "sa" user.

When Web.Config displays for editing, you will need to set your DSN info for the "sa" user. Also set a valid Windows User ID and password in the <identity impersonate> setting.

At end of install, license entry is shown. No need to enter anything. WebDocs auto-licenses for 30 days. Click Cancel to exit license entry if shown.

Create or Update WebDocs Database

After WebDocs installation, run the following program to create or update the WebDocs database: Start/Programs/WebDocs/WebDocs Database Update

This program is used to create a new webdocs database or update an existing one.

Entry parameters:

SQL Server = Select the SQL Server instance or enter the SQL Server host name UID = sa PWD = password for sa user Database = Type in "webdocs" for the database name. Version Query = No changes needed.

Click the "Test Connection" option to test the SQL connection.

Click the "Determine Version" button to determine version of WebDocs database already installed.

Click the "Create Database" button if the webdocs database does not exist and Current Version = Unknown.

In the "Update Script Info" section, check the scripts you need to run based on what version you already have. Example: If you are at version 1.0.16, check the 1.0.18 and all the rest of the script versions to get current.

Note: Make sure the "Perform backup prior to running first script" option is selected if the SQL Server instance is on the same PC as the WebDocs server. Otherwise make sure to perform a SQL Server backup of the webdocs database manually via SQL Enterprise Manager prior to running the database updates.

Once all the scripts are selected for the database creation or update, click the "Run Scripts" option to create or update the webdocs database.

Install Soap SDK and Microsoft Web Service Extensions

Install Microsoft Soap SDK 3.0 - C:\program files\webdocs\soapsdk.exe

Install Microsoft WSE V2.0 SP3 - C:\program files\webdocs\Microsoft WSE 2.0 SP3 Runtime.msi

Install Microsoft WSE V3.0 - C:\program files\webdocs\Microsoft WSE 3.0 Runtime.msi


Set up Web Site in IIS

In IIS Admin program, go to the "Home Directory" tab for the default site and change the local path to: c:\inetpub\webdocsite

Then go to the "ASP.NET" tab and make sure it says: 1.1.4322

Then go to the "Documents" tab and remove all documents from the list.

Then add "login.asp" to the document list.

Apply the settings.

Testing to See if WebDocs Web Site Works

From the server launch Internet Explorer and go to http://localhost and see if the WebDocs login page displays.

Log in to see if the web login works.

Default user is: admin password is: abc

If you get to the WebDocs home page, the base web site is ready to use.

Set up and test the WebDocs Web Service

In IIS Admin program, find the RJS_WD_Service virtual directory.

Right click and select properties.

Under application settings, click the "Create" button.

This should create an application named "RJS_WD_Service".

From the server launch Internet Explorer and go to http://localhost/RJS_WD_Service/webdocs.asmx

You should see a page that says: WebDocs at the top and lists all the web service methods.

Click the Login link.

For pUID enter: admin

For pPWD enter: abc

Click the "Invoke" button

In the browser an XML response window should open that has a value of: true.

If the return value says: true then the web service login worked.

If return = false, you may need to set the <identity impersonate> setting to be a valid Windows user in the c:\inetpub\webdocsite\RJS_WD_Service\Web.Config XML file.

Note: You will also probably have to remove the comment tags around the <identity impersonate> tag in Web.Config.

After setting the Windows user info, try invoking the web service again.

If the return comes back true, you are good to go.

If not, you may need some assistance from RJS Support.

Personal tools