Knowledge Base

Installing on Windows 7

General Windows settings

Assign the server a static IP address.

Log in as a user who is a member of the local administrators's group.

Install IIS components

1. Navigate to the Control Panel -> Programs and Features
2. Click "Turn Windows features on or off".
3. Click inside the checkbox next to "Internet Information Services". The box should become completely filled, not just checked.
4. Navigate to Internet Information Services -> World Wide Web Services -> Application Development Features
5. Check the box next to CGI. Click OK. The IIS components will then be installed.

Install 7-zip

Download the 64-bit version from (http://www.7-zip.org/download.html)

1. Run setup.
2. Click Next.
3. Accept the agreement. Click Next.
4. Change the install directory to c:\7-zip. Click OK.
5. Click Next.
6. Click Install.
7. Click Finish.

Install PHP

Download from (http://windows.php.net/download)

1. Download the installer (.MSI) version of PHP VC9 x86 Non Thread Safe (example: php-5.3.2-nts-Win32-VC9-x86). There is no x64 version yet.
2. Run the PHP installer.
3. Click Next.
4. Accept the agreement. Click Next.
5. Change the install directory to "c:\php". Click Next.
6. Choose "IIS FastCGI". Click Next.
7. The "Items to Install" default selections are fine. Click Next.
8. Click Install.
9. Click Finish.
10. Open the c:\php\php.ini file in notepad.exe. At a minimum, uncomment and set the following values:
    Note: Adjust the max sizes and limits suitable for your server hardware configuration.

    short_open_tag = on

    memory_limit = 2000M

    post_max_size = 1000M

    upload_max_filesize = 1000M

    max_file_uploads = 5000

    SMTP = "mail server name"

    smtp_port = 25
    
    For the following values, all of them should be set correctly by default. However, double-check and make sure there is at least one uncommented entry for each of these values:
    
    

    default_socket_timeout = 60

    upload_tmp_dir = "c:\windows\temp"

    session.save_path = "c:\windows\temp"

    error_log = "c:\windows\temp\php-errors.log"

    cgi.force_redirect = 0

    fastcgi.impersonate = 1

    fastcgi.logging = 0

    extension_dir = "c:\php\ext"

11. Save and close the file.

Install the php_ldap.dll PHP extension

1. Download the (http://windows.php.net/downloads/releases/php-5.3.2-nts-Win32-VC9-x86.zip) file or similar release.
2. Extract the files to a temporary folder.
3. Copy the php_ldap.dll file to the c:\php\ext folder.
4. Open the c:\php\php.ini file in notepad.exe and add the following text at the end:

   [PHP_LDAP]

   extension=php_ldap.dll

5. Save and close the file.

Verify IIS settings with PHP FastCGI

1. Open the IIS Manager.
2. With the server name selected in the left pane, double-click the entry in the right pane for "FastCGI Settings".
3. Verify the "Full Path" is set to "C:\php\php-cgi.exe".

Verify IIS settings for index.php as a default document

1. Open the IIS Manager.
2. In the left pane, navigate to servername -> Sites -> Default Web Site
3. Open "Default Document" in the right pane.
4. Verify "index.php" appears in the list. If not, add it.

Test PHP functionality

1. Open notepad.exe.
2. Type the following code:
   

3. Save the file as test.php in the c:\inetpub\wwwroot folder.
4. Open a web browser.
5. Navigate to http://servername/test.php
6. Verify the "PHP Version" page appears.

Install third-party SMTP server (optional)

Windows 7 no longer includes an SMTP service that can be optionally installed. A third-party SMTP server program needs to be installed if you are going to configure ResourceSpace with sending email. Here are several free options:

hMailServer (http://www.hmailserver.com)

Free SMTP Server (http://www.softstack.com/freesmtp.html)

AfterLogic XMail Server Lite (http://www.afterlogic.com/community-editions/mailsuite-lite) - requires IIS and ASP.NET to be installed

Install MySQL

Download from (http://www.mysql.com/downloads/mysql)

1. Download the latest version of MySQL Community Server. There are several variants. Download the mysql-essential x64 version.
2. Run the MySQL installer.
3. Click Next.
4. Choose "Custom". Click Next.
5. Change the install folder location to c:\mysql. Click OK. Click Next.
6. Click Install.
7. Click Next.
8. Click Next.
9. Leave the "Configure the MySQL Server now" box checked. Uncheck the "Register the MySQL Server now" box, if there is one. Click Finish.
10. Click Next.
11. Choose "Detailed Configuration". Click Next.
12. Choose "Developer Machine". Click Next.
13. Choose "Non-Transactional Database Only". Click Next.
14. Choose "Manual Setting". Change level of concurrent connections to 100. Click Next.
15. Check the box for "Enable TCP/IP Networking". Choose 3306 for the port number. Check the box next to "Add firewall exception for this port". Uncheck the box for "Enable Strict Mode". Click Next.
16. Choose "Standard Character Set". Click Next.
17. Check the box for "Install As Windows Service". The default service name is fine. Check the box for "Launch the MySQL Server automatically". Check the box for "Include Bin Directory in Windows PATH". Click Next.
18. Check the box for "Modify Security Settings". Type a password twice. Leave the other boxes unchecked. Click Next.
19. Click Execute.
20. Click Finish.

Install PHPMyAdmin

Download from (http://www.phpmyadmin.net/home_page/downloads.php)

1. Extract the zip file contents to the c:\inetpub\wwwroot\phpmyadmin folder.
2. Using WordPad (not Notepad), open config.sample.inc.php file from C:\inetpub\wwwroot\phpmyadmin
3. Add or edit the following variables:

   $cfg['blowfish_secret'] = '84jfdfg5dmf40jdojf8949jf984';   # you can use any random string you want for the secret

   $cfg['Servers'][$i]['auth_type'] = 'cookie';

   $cfg['Servers'][$i]['host'] = '127.0.0.1';

   $cfg['Servers'][$i]['connect_type'] = 'tcp';

   $cfg['Servers'][$i]['compress'] = false;

   $cfg['Servers'][$i]['extension'] = 'mysql';

   $cfg['Servers'][$i]['AllowNoPassword'] = false;

4. Save and rename the file as config.inc.php.
5. Open Internet Explorer and navigate to http://(server IP)/phpmyadmin
6. Login with "root" as the username and the same password used for the MySQL installation.

Create a database for ResourceSpace

1. Open Internet Explorer and navigate to http://(server IP)/phpmyadmin
2. Login with "root" as the username and the same password used for the MySQL installation.
3. On the home page, click in the box underneath "Create new database". Type "resourcespace". The collation box can usually be left as is (saying "collation") or you can specify UTF8_general_ci collation. Click Create.
4. On the following page, verify the database was successfully created.

Install ResourceSpace

Download from (http://www.resourcespace.org/download.php)

Extract the contents of the zip file to the c:\inetpub\wwwroot esourcespace folder.

Configure IIS for ResourceSpace

1. Open the IIS Manager.
2. Navigate to servername - Application Pools on left.
3. Click "Add Application Pool".
4. Give it a name of "ResourceSpace". Leave the other settings as they are. Click OK.
5. Right-click the new ResourceSpace pool name and choose "Advanced Settings...".
6. Click the drop-down menu next to "Enable 32-Bit Applications" and select "True".
7. Click the box to the right of "Identity" then click the small box with "...".
8. Click the drop-down menu under "Built-in account" and choose "LocalSystem". Click OK.
9. Click OK.
10. Navigate to servernameSitesDefault Web Site esourcespace
11. Right-click the "resourcespace" folder and choose "Add Application..."
12. Type "ResourceSpace" in the box under "Alias". Click Select.
13. Click the drop-down menu under "Application pool" and choose "ResourceSpace". Click OK.
14. Type "c:\inetpub\wwwroot esourcespace" in the box under "Physical path". Click OK.

Install ImageMagick

Download from (http://www.imagemagick.org/script/download.php#windows)

1. For a 64-bit Windows install, download the latest ImageMagick-7.0.7-31-Q16-x64-dll.exe version or similar (build may be newer).
2. Run setup.
3. Click Next.
4. Accept the agreement. Click Next.
5. Click Next.
6. Change the install directory to c:\imagemagick (all lowercase). Click Next.
7. Click Next.
8. Click Next.
9. Click Install.
10. Click Next.
11. Uncheck the box next to "View index.html". Click Finish.

Install Ghostscript

Download the 64-bit executable installer from (http://code.google.com/p/ghostscript/downloads/list)

1. Open the installer file.
2. Click Setup.
3. Change the "Install to directory" box to "c:\gs". Click Install.
4. Navigate to the C:\gs\gsX.XXbin folder.
5. Copy and paste the the gswin32c.exe into the same folder to make a duplicate. It should also have a new name (with -copy or similar).
6. Rename the newly created .EXE file to gs.exe.

Install FFmpeg

Download from (http://ffmpeg.arrozcru.org/autobuilds)

1. Download the static x64 version.
2. Extract the contents of the FFmpeg 7z file to c:\ffmpeg

Install EXIFTOOL

Download from (http://www.sno.phy.queensu.ca/~phil/exiftool)

1. Download the "Windows Executeable" zip package.
2. Open the exiftool zip archive file.
3. Extract the contents to the c:\exiftool folder.
4. Navigate to the c:\exiftool folder.
5. Rename "exiftool(-k).exe" to "exiftool.exe"

Edit folder permissions for ResourceSpace setup

1. Navigate to the C:\inetpub\wwwroot\resourcespace folder.
2. Right-click the "filestore" folder and choose "Properties".
3. Click the "Security" tab.
4. Click Edit.
5. Click Add.
6. Click Locations.
7. Navigate to and select the local machine name. Click OK.
8. Type "Everyone" in the box under "Enter the object names to select". Click OK.
9. With the "Everyone" group selected in the "Groups or user names" section, check the box under the "Allow" column next to "Modify". Click OK.
10. Click OK.
11. Right-click the "include" folder and choose "Properties".
12. Click the "Security" tab.
13. Click Edit.
14. Click Add.
15. Click Locations.
16. Navigate to and select the local machine name. Click OK.
17. Type "Everyone" in the box under "Enter the object names to select". Click OK.
18. With the "Everyone" group selected in the "Groups or user names" section, check the box under the "Allow" column next to "Modify". Click OK.
19. Click OK.

Configure initial ResourceSpace settings

1. Open Internet Explorer
2. Navigate to http://127.0.0.1/resourcespace/
3. Enter the following parameters:

   MySQL Server -------> 127.0.0.1

   MySQL Username -------> root

   MySQL Password -------> same as MySQL installation

   MySQL Database -------> resourcespace

   MySQL Binary Path -------> "make blank"

   Application Name -------> "Name of Company"

   Base URL -------> http://(name-of-server)/resourcespace

   Admin username -------> first user of the system (part of "Super Admins" user group)

   Admin password -------> password for the above user (cannot be empty and needs to respect the password policy which is set by default)

   Email from address -------> valid-address@domainname.com

   Email notify -------> valid-address@domainname.com

   Spider Password -------> leave as is or change to anything you like

   Scramble Key -------> leave as is or change to anything you like

   Secure (https) mode -------> leave unchecked
   
   Note: Be sure to use a forward slash (/) for the following directory paths, not backslashes ():
   
   

   Imagemagick Path -------> c:/imagemagick

   Ghostscript Path -------> c:/gs/gsx.xx/bin (specify the actual folder name for the version)

   FFMpeg Path -------> c:/ffmpeg/bin

   Exiftool Path -------> c:/exiftool

   AntiWord Path -------> leave blank

   PDFtotext Path -------> leave blank
   
   

4. Click Begin Installation button.

Final configuration steps

1. Open Internet Explorer.
2. Navigate to http://servername/resourcespace
3. Login with "admin" as the username and "admin" as the password.
4. Once everything is verified to be working remove the "everyone" group from modify/write access list for the C:\inetpub\wwwroot\resourcespace\include folder.