Installing on Windows Server 2008 R2 64-bit

From ResourceSpace Documentation Wiki
Jump to: navigation, search

This guide covers installing ResourceSpace on Windows Server 2008 R2 (64-bit only) with IIS 7.5, PHP FastCGI, and MySQL. It is intended to get you started with a basic installation of ResourceSpace.

General Windows settings

Disable the Windows Firewall.

Assign the server a static IP address.

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

Misc software installs

Install the latest versions of both Sun (Oracle) Java 32-bit AND Java 64-bit for Windows: (http://www.java.com/en/download/manual.jsp) Install the latest version of Adobe Flash: (http://get.adobe.com/flashplayer/)

The above are only required if testing batch upload functionality from a browser on the server itself.

Visual C++ was previously stated as a requirement for ImageMagick/FastCGI but this is not the case.

Disable IE Enhanced Security Configuration

Disabling IE ESC is not required, but suggested for a better admin "experience" when using Internet Explorer.

  1. Open Server Manager.
  2. Click "Configure IE ESC".
  3. Click the radio button next to "Off" for the Administrators and Users groups.
  4. Click OK.

Install the IIS Web Server role

  1. Open Server Manager.
  2. Click "Add Roles".
  3. Click Next.
  4. Check the box next to "Web Server (IIS)". Click Next.
  5. Click Next.
  6. Check the box next to "CGI" only. Leave the other prexisting checked boxes alone. Click Next.
  7. Click Install.
  8. Click Close.

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 Internet Information Services (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". Click OK.

Verify IIS settings for index.php as a default document

  1. Open the Internet Information Services (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:
    <?php phpinfo();?>
  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 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 (optional)

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\resourcespace folder.

Configure IIS for ResourceSpace

  1. Open the Internet Information Services (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 servername\Sites\Default Web Site\resourcespace
  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\resourcespace" in the box under "Physical path". Click OK.

Install ImageMagick

Download from (http://www.imagemagick.org/download/binaries)

  1. For a 64-bit Windows install, download the ImageMagick-6.6.1-10-Q16-windows-x64-static 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.XX\bin 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
    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.