Versions Compared

Version Old Version 3 New Version Current
Changes made by

Matthew Garrett

Matthew Garrett

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
FWINST HEAD
FWINST HEAD
nopaneltrue

Article Index

Table of Contents

Step 1 - Configure ODBC DSN Connection To Framework MyNewHome

Provides the web server with access to the Framework MyNewHome database.

Warning

Microsoft 64-Bit Operating Systems include two ODBC Data Source Administrator executable files.

Depending on the operating system, use the following to open the correct ODBC Data Source:

On 32-Bit Operating Systems: Use either:

Start Menu > Control Panel > Administrative Tools > Data Sources (ODBC)
OR
\\%SystemRoot%\system32\odbcad32.exe (e.g., C:\Windows\system32\odbcad32.exe).

On 64-Bit Operating System: Use:

\\%SystemRoot%\SysWOW64\odbcad32.exe (e.g., C:\Windows\SysWOW64\odbcad32.exe).

ODBC DSN Configuration - Framework MyNewHome

  1. Open Data Sources (ODBC).

  2. Select the System DSN

  3. Click the Add The Create New Data Source dialog will be displayed.

  4. Select SQL Native Client.

  5. Click the Finish The Create a New Data Source to SQL Server dialog will be displayed.

  6. Enter the following details:

    • Name: FworkSQLMNH
      Critical: For security reasons this should not be given the standard name FworkMyNewHome.

    • Description (optional): Enter a description for the database connection. For example, Framework MyNewHome.

    • Server: Select the SQL Server from the Server drop-down list.
      OR
      Enter the SQL Server name.
      If there is an error following Step 8, change the server name above to: \[server name]\SQLEXPRESS

  7. Click the Next

  8. Click the Next

  9. Tick Change the default database to.

  10. From the drop-down list select: FworkSQLMNH

  11. Click the Next

  12. Click the Finish The ODBC Microsoft SQL Server Setup dialog will be displayed.

  13. Click the Test Data Source...

  14. If successful, click the OK

  15. Click the OK The ODBC Microsoft SQL Server Setup dialog will close.

  16. Click the OK The Data Sources (ODBC) dialog will close.

Step 2 - Copy Ixed File

The Ixed file procedure is not required if another, working Framework portal has been configured on the same server.

The ixed file contains decompile scripts for the Framework MyNewHome Portal.

  1. Open Windows Explorer.

  2. Browse to: \[fw folder]\Setup\Framework MyNewHome Portal\Ixed\

  3. Right-click on the win file and select Copy.

  4. Browse to: C:\php\ext\ folder and select Paste.

  • If the file already exists, overwrite it. The folder structure should look like:
    x:\[php folder]\ext\

  • The ext folder MUST contain the file win.

Step 3 - Implement Framework MyNewHome Files

Copies the Framework MyNewHome Portal files to the web server.

  1. Open Windows Explorer.

  2. Browse to: \[fw folder]\Setup\Framework MyNewHome Portal\WebSiteFiles\

  3. Select and copy all of the files and folders contained in the WebSiteFiles

  4. Browse to: x:\inetpub\wwwroot\[portalWebsiteFolder]\

    Where:
    - x is the local target drive, and
    - [portalWebsiteFolder] is the folder name of the web portal software (e.g., mynewhome, mnh, etc.).

  5. Paste the files and folders into the [portalWebsiteFolder], overwriting any files in the process.

The folder structure should look like:

x:\inetpub\wwwroot\[portalWebsiteFolder]\contacts
x:\inetpub\wwwroot\[portalWebsiteFolder]\css
x:\inetpub\wwwroot\[portalWebsiteFolder]\design
x:\inetpub\wwwroot\[portalWebsiteFolder]\documents
x:\inetpub\wwwroot\[portalWebsiteFolder]\gallery
x:\inetpub\wwwroot\[portalWebsiteFolder]\help
x:\inetpub\wwwroot\[portalWebsiteFolder]\home
x:\inetpub\wwwroot\[portalWebsiteFolder]\images\banner
x:\inetpub\wwwroot\[portalWebsiteFolder]\images\body
x:\inetpub\wwwroot\[portalWebsiteFolder]\images\common
x:\inetpub\wwwroot\[portalWebsiteFolder]\images\header
x:\inetpub\wwwroot\[portalWebsiteFolder]\images\help
x:\inetpub\wwwroot\[portalWebsiteFolder]\images\menu
x:\inetpub\wwwroot\[portalWebsiteFolder]\images\title
x:\inetpub\wwwroot\[portalWebsiteFolder]\inc_files
x:\inetpub\wwwroot\[portalWebsiteFolder]\kit
x:\inetpub\wwwroot\[portalWebsiteFolder]\mh
x:\inetpub\wwwroot\[portalWebsiteFolder]\scripts
x:\inetpub\wwwroot\[portalWebsiteFolder]\sessions

Step 4 - Configure Folder Permissions

The following folders must have their security permissions updated for the following group or user names:

  • Users ([systemname]\users)

  • IIS_IUSRS ([systemname]\IIS_IUSRS)

Folder

Permissions

x:\inetpub\wwwroot\[portalWebsiteFolder]\sessions

Read
Write
Modify

Where:
- x is the local target drive, and
- [portalWebsiteFolder] is the folder name of the Web Portal software (e.g., mynewhome).

Configure Folder Permissions

  1. Browse to the folder: x:\inetpub\wwwroot\[portalWebsiteFolder]\

  2. Right-click on the sessions folder and select Properties. The Properties dialog will be displayed.

  3. Select the Security

  4. Click ... The Permissions for... dialog will be displayed.

    Image Removed


    Image Added


  5. Select the Users ([systemname]\users) and in the Permissions for Users list, ensure Read, Write, and Modify is allowed.

  6. Select the IIS_IUSRS ([systemname]\IIS_IUSRS) and in the Permissions for Users list, ensure Read, Write, and Modify is allowed.

  7. Click OK. The dialog will close.

  8. Click OK. The dialog will close.

Step 5 - Portal Configuration

Configures the logon and configuration files for the Framework MyNewHome Portal.

Configure Config.php File

  1. Open Windows Explorer.

  2. Browse to: x:\Inetpub\wwwroot\[portalWebsiteFolder]\
    Where:
    - x is the local target drive, and
    - [portalWebsiteFolder] is the folder name of the web portal software (e.g., mynewhomeportal, mnhp, etc.).

  3. Right-click on php and select Open With....
    When opening the following files, untick Always use the selected program to open this kind of file.

  4. From the Open With... dialog, select Notepad. This opens the file for editing.

  5. Locate the text $dsn = "[Insert DSN]";

  6. Replace [Insert DSN] with the server's Framework ECM DSN.
    FworkSQLECM

  7. Locate the text $user = "";

  8. Within the inverted commas, enter the username of a user who can connect to the Framework ECM Microsoft SQL database.
    A username is required if your ODBC connection to the Framework ECM database requires SQL Authentication.

  9. Locate the text $pass = "";

  10. Within the inverted commas, enter the password of user who can connect to the Framework ECM Microsoft SQL database.
    A password is required if your ODBC connection to the Framework ECM database requires SQL Authentication.

  11. Locate the text $dsn1 = "[Insert DSN]";

  12. Replace [Insert DSN] with the server's Framework MyNewHome DSN.
    FworkSQLMNH

  13. Locate the text $user1 = "";

  14. Within the inverted commas, enter the username of a user who can connect to the Framework MyNewHome Microsoft SQL database.
    A username is required if your ODBC connection to the Framework MyNewHome database requires SQL Authentication.

  15. Locate the text $pass1 = "";

  16. Within the inverted commas, enter the password of a user who can connect to the Framework MyNewHome Microsoft SQL database.
    A password is required if your ODBC connection to the Framework MyNewHome database requires SQL Authentication.

  17. Locate the text $footer = "Copyright Framework Homes";

  18. Replace Copyright Framework Homes with your organisation's copyright details.
    Copyright Acme Homes. All Rights Reserved.

  19. Save and close the file.

Configure Config_logon.php File

  1. Open Windows Explorer.

  2. Browse to: x:\Inetpub\wwwroot\[portalWebsiteFolder]\
    Where:
    - x is the local target drive, and
    - [portalWebsiteFolder] is the folder name of the Web Portal software (e.g., mynewhomeportal, mnhp, etc.).

  3. Right-click on php and select Open With....
    When opening the following files, untick Always use the selected program to open this kind of file.

  4. From the Open With... dialog, select Notepad. This opens the file for editing.

  5. Locate the text $dsn = "[Insert DSN]";

  6. Replace [Insert DSN] with the server's Framework ECM DSN.
    FworkSQLECM

  7. Locate the text $user = "";

  8. Within the inverted commas, enter the username of a user who can connect to the Framework ECM Microsoft SQL database.
    A username is required if your ODBC connection to the Framework ECM database requires SQL Authentication.

  9. Locate the text $pass = "";

  10. Within the inverted commas, enter the password of a user who can connect to the Framework ECM Microsoft SQL database.
    A password is required if your ODBC connection to the Framework ECM database requires SQL Authentication.

  11. Save and close the file.

Step 6 - Configure Internet Information Services

Proceed to the next step if a Framework portal has already been configured and working on the same server.

...

The following guide details the steps required for IIS 7.5.

Configure IIS 7.5

  1. Open IIS 7.5.

  2. From the Connections list, expand: [server_name] > Sites.

  3. Highlight Default Web Site, ensuring that the Features View is selected.

  4. Open Handler Mappings.

  5. From the Actions list (on the right-hand side of the screen), click Add Module Mapping. The Add Module Mapping dialog will be displayed.

    Image Removed


    Image Added

  6. Enter the following details:

    • Request Path: *.php

    • Module: From the drop-down list, select FastCgiModule

      If FastCGIModule is not available, ensure CGI has been installed.

    • Executable: Using the browse button, browse to the location of the php-cgi.exe file.

    • Name: PHP

  7. Click Request Restrictions.... The Mapping tab of the Request Restrictions dialog will be displayed.

    Image Removed


    Image Added

  8. Edit the following details:

    • Ensure Invoke handler only if request is mapped to: is selected.

    • Click File or folder.

  9. Select the Verbs

    Image Modified

  10. Ensure that All verbs is selected.

  11. Select the Access

    Image Modified

  12. Ensure that Script is selected.

  13. Click OK.

  14. Click OK.

Step 7 - Test Framework MyNewHome Portal

Once Framework MyNewHome Portal is installed and configured, the website must be tested.

  1. Open IIS.

  2. From the Connections list, expand: [server_name] > Sites > Default Web Site > [newportalname].

  3. Highlight home, ensuring that the Content View is selected.

  4. Right-click on logon.php and click Browse. The website will open using your system's default browser.