Step 1 - Configure ODBC DSN Connection To Framework MyNewHome

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

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)

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.
   
   
   
   
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.

IIS (Internet Information Services) is a set of Internet-based services for servers using Microsoft Windows. IIS assists in configuring websites. Your organisation may already be configured for IIS depending on if the organisation currently runs any web-based software or runs their own website from their local servers.

Different versions exist for different operating systems and, in general, an operating system's IIS cannot be updated to a newer edition.

The implications of the following settings should be carefully considered as a part of the overall web server/site installation and security.

IIS is a Microsoft Windows Component that is installed using the Add/Remove Programs (in Windows XP) and Programs and Features (Windows Vista / Windows 7 / Windows 8).

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.
   
   
   
   
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.
   
   
   
   
8. Edit the following details:
   • Ensure Invoke handler only if request is mapped to: is selected.
   • Click File or folder.
9. Select the Verbs
   
   
   
   
10. Ensure that All verbs is selected.
11. Select the Access
    
    
    
    
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.