Installation Instructions for v7.2.x
|
|
Installation Instructions for v7.2.x |
|
Stuffit Expander is available at http://www.stuffit.com/mac/expander/index.html.
Beginning with version 7.1.2, the WebKIDSS Web Server software has the capability to email forms. In order for this new feature to work, a new folder containing the 4D Internet Commands file(s) is required. For Mac users, this is the Mac4DX folder. For Windows users, this is the Win4DX folder. These folders have been bundled with the WebKIDSS web server software in release 7.1.2. When you replace the KIDSSIEP file(s) in your WebKIDSS folder, also copy the Win4DX or Mac4DX folder into your WebKIDSS folder. On some machines, it may also be necessary to copy the Win4DX or Mac4DX folder into the folder that contains your copy of 4th Dimension 4D program.
When installing version 7.2.7, if you previously installed version 7.1.2 or greater, then you have the Mac4DX or Win4DX folder already installed. These folders are not included in the 7.2.7 release.
If you skipped version 7.1.2, all later 7.1.x versions, and 7.2.x versions prior to 7.2.7, then you will need to download the appropriate folder, either Mac4DX or Win4DX, and install it when you install version 7.2.7. Please note that there are separate versions of the Mac4DX or Win4DX depending on the version of 4th Dimension you are using. Be sure to download the correct one. Copy the Win4DX or Mac4DX folder into your WebKIDSS folder. On some machines, it may also be necessary to copy the Win4DX or Mac4DX folder into the folder that contains your copy of 4th Dimension 4D program.
Version 7.2.4 (07/06/08) was the first version of WebKIDSS released for 4th Dimension v2004. If you are installing the 4D v2004 version for the first time, you will need to download the appropriate folder, either Mac4DX or Win4DX, and install it when you install WebKIDSS version 7.2.7. Please note that there are separate versions of the Mac4DX or Win4DX depending on the version of 4th Dimension you are using. Be sure to download the correct one. Copy the Win4DX or Mac4DX folder into your WebKIDSS folder. On some machines, it may also be necessary to copy the Win4DX or Mac4DX folder into the folder that contains your copy of 4th Dimension 4D program.
On the computer that will be the web server, create a folder that will hold all the web files. Call that folder 'WebKIDSS'. When you install your copy of 4th Dimension for use on the web, install it in a folder called '4D' within the WebKIDSS folder. If you have already installed it somewhere else, move the 4D folder to the WebKIDSS folder. At this point, you should have a WebKIDSS folder which contains only another folder called 4D which contains the 4th Dimension 6.7.x(v6.7.1 or v6.7.2 or v6.7.3 or v6.7.4) as installed from the 4D installation disk. This should be the situation for Windows and for Macintosh.
Download the WebKIDSS program file by clicking on 'Macintosh Web Server v7.2.x' on the WebKIDSS Web Server page. This will get you the file Mac72xweb674.sit.hqx, which will convert to Mac72xweb674.sit, which will expand to a file named 'KIDSSIEP' and a folder named 'Mac4DX' which contains the 4D Internet Commands file(s). Place the file KIDSSIEP and the Mac4DX folder in the WebKIDSS folder you just created. After you do that, you can discard (trash) the files Mac72xweb674.sit.hqx and Mac72xweb674.sit.
Download the Web files by clicking on 'Mac Web Files v7.2.x' on the WebKIDSS Web Server page. This will get you the file Mac72xWebFiles.sit.hqx, which will convert to Mac72xWebFiles.sit, which will expand to a folder named 'Web'. Discard (trash) the files Mac72xWebFiles.sit.hqx and Mac72xWebFiles.sit. Place the 'Web' folder in the WebKIDSS folder. At this point you will have a folder named WebKIDSS which contains the file 'KIDSSIEP' and the folders '4D', 'Mac4DX', and 'Web'. The '4D' folder contains 4th Dimension 6.7.x (and anything else that was installed with it). The 'Mac4DX' folder contains 4D Internet Commands files. The 'Web' folder contains 440 files (of type .htm, .txt, and .gif).
You may also have a data file in the WebKIDSS folder. The data file should have the name of KIDSSIEP.data. If you have not already created a data file and moved it to this folder, then you will be given the option of creating a data file the first time you run the WebKIDSS program.
Please note that it is imperative that you NOT change the names of any of these folders or files. If you do, the WebKIDSS program will not function properly over the web.
Download the WebKIDSS program file by clicking on 'Windows Web Server v7.2.x' on the WebKIDSS Web Server page. This will get you the file 'Win72xweb674.zip', which will expand to the files 'KIDSSIEP.4DC' and 'KIDSSIEP.RSR' plus a folder named 'Win4DX'. Place these two files, 'KIDSSIEP.4DC' and 'KIDSSIEP.RSR', and the folder 'Win4DX' in the WebKIDSS folder you just created. After you do that, you can discard (trash) the file Win72xweb674.zip.
Download the Web files by clicking on 'Windows Web Files v7.2.x' on the WebKIDSS Web Server page. This will get you the file 'Win72xWebFiles.zip', which will expand to a folder named 'Web'. Place the 'Web' folder in the WebKIDSS folder. At this point you will have a folder named WebKIDSS which contains the files 'KIDSSIEP.4DC' and 'KIDSSIEP.RSR', plus the folders '4D', 'Win4DX', and 'Web'. The '4D' folder contains 4th Dimension 6.7.x (and anything else that was installed with it). The 'Win4DX' folder contains 4D Internet Commands file(s). The 'Web' folder contains 440 files (of type .htm, .txt, and .gif). You may discard (trash) the file 'Win72xWebFiles.zip' at this point.
You may also have a data file in the WebKIDSS folder. The data file should have the name of 'KIDSSIEP.4DD'. It may (or may not) be accompanied by a file named 'KIDSSIEP.4DR'. If you have not already created a data file and moved it to this folder, then you will be given the option of creating a data file the first time you run the WebKIDSS program.
Please note that it is imperative that you NOT change the names of any of these folders or files. If you do, the WebKIDSS program will not function properly over the web.
SPECIAL NOTE: The zip files downloaded for Windows can be expanded using PKZIP, WINZIP, or similar programs. When using any of these to expand a file, you should specify an "Extract To:" location that is your WebKIDSS folder.
Before you replace any of the files or folders in your WebKIDSS folder with the new version, it is wise to delete the old versions first. From your WebKIDSS folder, delete the file: KIDSSIEP. Also delete the 'Web' folder and its contents. Although most of the files in the Web folder remain constant from one version to the next, some will change. You should always delete the entire Web folder and download the new one to ensure that you have the correct versions of all those files.
If you have made custom changes to the online user manual, then you should save a backup of the manual files: 'usermancontent.htm' and 'usermanindex.htm' before you delete the 'Web' folder. After a new Web folder has been downloaded and put in place, your copies of the two user manual files can then be moved back into the Web folder to replace the default manual files.
Please do NOT delete your data file, KIDSSIEP.data, or the 4D folder.
Download the WebKIDSS program file by clicking on 'Macintosh Web Server v7.2.x' on the WebKIDSS Web Server page. This will get you the file Mac72xweb674.sit.hqx, which will convert to Mac72xweb674.sit, which will expand to the file 'KIDSSIEP' and a folder named 'Mac4DX'. Place the file KIDSSIEP and the folder Mac4DX in your existing WebKIDSS folder. This new copy of KIDSSIEP will replace the older version of the program (if you have not already deleted it). The Mac4DX folder is new to version 7.1.2. After you do that, you can discard (trash) the files Mac72xweb674.sit.hqx and Mac72xweb674.sit.
Download the Web files by clicking on 'Mac Web Files v7.2.x' on the WebKIDSS Web Server page. This will get you the file Mac72xWebFiles.sit.hqx, which will convert to Mac72xWebFiles.sit, which will expand to a folder named 'Web'. This folder contains 440 files (of type .htm, .txt, and .gif). Move the new 'Web' folder just downloaded into your WebKIDSS folder. Then discard (trash) the files Mac72xWebFiles.sit.hqx and Mac72xWebFiles.sit. At this point your existing WebKIDSS folder will contain the files 'KIDSSIEP' and 'KIDSSIEP.data', and the folders '4D', 'Mac4DX', and 'Web'. The 'Mac4DX' folder contains 4D Internet Commands file(s). The 'Web' folder contains 440 files (of type .htm, .txt, and .gif). Previous versions sometimes have different numbers of files in it.
Do nothing to your data file. It will work just the way it is with the new version of the program.
Before you replace any of the files or folders in your WebKIDSS folder with the new version, it is wise to delete the old versions first. From your WebKIDSS folder, delete the files: KIDSSIEP.4DC and KIDSSIEP.RSR. Also delete the 'Web' folder and its contents. Although most of the files in the Web folder remain constant from one version to the next, some will change. You should always delete the entire Web folder and download the new one to ensure that you have the correct versions of all those files.
If you have made custom changes to the online user manual, then you should save a backup of the manual files: 'usermancontent.htm' and 'usermanindex.htm' before you delete the 'Web' folder. After a new Web folder has been downloaded and put in place, your copies of the two user manual files can then be moved back into the Web folder to replace the default manual files.
Please do NOT delete your data files, KIDSSIEP.4DD and KIDSSIEP.4DR, or the 4D folder.
Download the WebKIDSS program file by clicking on 'Windows Web Server v7.2.x' on the WebKIDSS Web Server page. This will get you the file 'Win72xweb674.zip', which will expand to files named 'KIDSSIEP.4DC' and 'KIDSSIEP.RSR' plus a folder named 'Win4DX'. Place these two files and the Win4DX folder in your existing WebKIDSS folder. They will replace the older version of the program. Note that the Win4DX folder is new in this 7.1.2. version. After you do that, you can discard (trash) the file Win72xweb674.zip.
Download the Web files by clicking on 'Windows Web Files v7.2.x' on the WebKIDSS Web Server page. This will get you the file 'Win72xWebFiles.zip', which will expand to a folder named 'Web'. This folder contains 440 files (of type .htm, .txt, and .gif). Move the new 'Web' folder just downloaded into your WebKIDSS folder. At this point you will have a folder named WebKIDSS which contains the files 'KIDSSIEP.4DC' and 'KIDSSIEP.RSR', plus the folders '4D', 'Win4DX', and 'Web'. The '4D' folder contains 4th Dimension 6.7.x (and anything else that was installed with it). The 'Win4DX' folder contains 4D Internet Commands file(s). The 'Web' folder contains 440 files (of type .htm, .txt, and .gif). Previous versions sometimes have different numbers of files in it. You may discard (trash) the file 'Win72xWebFiles.zip' at this point.
Do nothing to your data file. It will work just the way it is with the new version of the program.
SPECIAL NOTE: The zip files downloaded for Windows can be expanded using PKZIP, WINZIP, or similar programs. When using any of these to expand a file, you should specify an "Extract To:" location that is your WebKIDSS folder.
If you are installing multiple copies to accommodate, say, different grade levels, and you have a separate server machine for each, then just install the second one the same as the first one. If, however, you plan to run multiple copies of the WebKIDSS web server on the same computer, then follow the instructions below.
Install the first copy of the WebKIDSS software according to the instructions above. Then make copies of the software to a different folder, say WebKIDSS2.
Note that the use of multiple copies of the WebKIDSS software requires you to purchase multiple copies of the relevant 4D software.
You should now make a copy of the original 4D folder that is in the WebKIDSS folder containing the first copy of the WebKIDSS program. Copy the entire 4D folder to the WebKIDSS2 folder. Open the copied 4D folder and change the name of the 4th Dimension application so that it is different from the original (e.g., add a '2' to the name). When starting up this second copy of the KIDSS webserver, you must use this second copy of the 4D software.
Copy the KIDSSIEP file from the original WebKIDSS folder into the new WebKIDSS2 folder. Then rename the KIDSSIEP file to be KIDSSIEP2. Copy the Mac4DX folder. DO NOT rename this folder or any of its files.
Copy the 'Web' folder from the original WebKIDSS folder into the new WebKIDSS2 folder. DO NOT rename it. It must keep the name of 'Web'.
You may also have a data file in the WebKIDSS2 folder. The data file should have the name of KIDSSIEP2.data. If you have not already created a data file and moved it to this folder, then you will be given the option of creating a data file the first time you run the WebKIDSS program.
Please note that it is imperative that you NOT change the names of any of these folders or files except as specified here. If you do, the WebKIDSS program will not function properly over the web.
You should now make a copy of the original 4D folder that is in the WebKIDSS folder containing the first copy of the WebKIDSS program. Copy the entire 4D folder to the WebKIDSS2 folder. Open the copied 4D folder and change the name of the 4th Dimension application so that it is different from the original (e.g., add a '2' to the two files 4D.exe and 4D.rsr - make them 4D2.exe and 4D2.rsr). When starting up this second copy of the WebKIDSS webserver, you must use this second copy of the 4D software.
Copy the two files, KIDSSIEP.4DC and KIDSSIEP.RSR, from your WebKIDSS folder into the new WebKIDSS2 folder. Then rename these files to be KIDSSIEP2.4DC and KIDSSIEP2.RSR. Copy the Win4DX folder. DO NOT rename it or any of the files it contains.
Copy the ''Web' folder from your WebKIDSS folder into the new WebKIDSS2 folder. DO NOT rename it. It must keep the name of 'Web'.
You may also have a data file in the WebKIDSS2 folder. The data file should have the name of 'KIDSSIEP2.4DD'. It may (or may not) be accompanied by a file named 'KIDSSIEP2.4DR'. If you have not already created a data file and moved it to this folder, then you will be given the option of creating a data file the first time you run the WebKIDSS program.
Please note that it is imperative that you NOT change the names of any of these folders or files except as specified here. If you do, the WebKIDSS program will not function properly over the web.
SPECIAL NOTE: The zip files downloaded for Windows can be expanded using PKZIP, WINZIP, or similar programs. When using any of these to expand a file, you should specify an "Extract To:" location that is your WebKIDSS folder.
Note that for 4D v2004.x, the 4D Customizer program no longer exists. A new method of assigning the port number has been implemented. The port number can now be set by the user when WebKIDSS is running (all 4D versions, not just v2004.x). The first time a new version of WebKIDSS is installed, a dialog will appear at startup asking for the port number. If you later want to change the port number, start the WebKIDSS program in single-user mode from the server. Log in as Administrator. Use the Set Port Number menu item to change the port number. Note that this port number will now be saved with the data file and will never be requested at startup again.
Port numbers are a way to allow multiple web software servers to operate on the same server hardware. The default port number for a web server is 80.
If your server hardware already has a web server of some sort in operation, it is probably already using port number 80 and you will need to assign a different number to the WebKIDSS software. Note that numbers in the range of 1-1024 are reserved numbers and should not be used by the WebKIDSS software (except for 80, unless it is already in use on your machine).
The port number for the software can be changed by using the 4D Customizer program. For Windows users, any of the versions of this Customizer program will work (v6.7.1, 6.7.2, or 6.7.3). However, for Macintosh users who are using 4D version 6.7.x, only version 6.7.1 of the Customizer will work. Versions 6.7.2 and 6.7.3 do not work with the WebKIDSS program. If you do not have version 6.7.1 of the 4D Customizer for Macintosh, you can download it from the WebKIDSS Web Server page. Note that the Customizer that comes with your 4D software may have a different version number than the rest of the 4D package. To verify the version number of your copy of the Customizer, select the Customizer icon and do a 'Get Info' from the Finder 'File' menu. If you are using 4D v6.8.x or 4D v2003.x, then use the Customizer that came with that version of 4D.
Start up the 4D Customizer (v6.7.1 for Mac 4d6.7.x). Open the file 'KIDSSIEP'. This will display a window with a number of icons in it. Double click the 'Properties' icon. This will display another window of properties. At the bottom of this window is 'Web Server TCP Port Number'. The default value is 80. Change it to the port number you desire for your server. (Change it to 8002 if you wish this version to operate on the same port as the previous version.) After you have changed the port number, select Quit from the File menu. Then select the 'Save' option on the dialog that follows.
Start up the 4D Customizer. Open the file 'KIDSSIEP.4DC'. This will display a window with a number of icons in it. Double click the 'Properties' icon. This will display another window of properties. At the bottom of this window is 'Web Server TCP Port Number'. The default value is 80. Change it to the port number you desire for your server. (Change it to 8002 if you wish this version to operate on the same port as the previous version.) After you have changed the port number, select Quit from the File menu. Then select the 'Save' option on the dialog that follows.
If you are running two or more copies of the WebKIDSS software on the same hardware, they must each have a unique port number. Use the 4D Customizer to set each one separately.
Once you have 4D, the WebKIDSS program, and the web files installed, and the port number set, you will need to have a way to access the program.
If you have installed SSL, then you can access the WebKIDSS program using 'https:' instead of the 'http:' given in the examples above. This will provide secure access. Also please note: DO NOT INCLUDE A PORT NUMBER IN THE URL WHEN USING SSL. A reference similar to the following will allow secure access regardless of the port number assigned to the WebKIDSS program.
<A HREF="https://www.myschool.org">Click here for WebKIDSS web server</A>
If you just use 'http:' (and the port number) you can still access the WebKIDSS program, but it will be in non-secure mode.
Actual use by several school districts indicates that the memory allocated to 4D should be set to about 50MB. Users who have memory set lower that this have been experiencing crashes at the server. However, the frequency of crashes seems to go way down when memory is increased up to about 50MB. If you are running two copies, the memory should be increased on each.
Double-click the 4D icon (or shortcut/alias) to start 4D running. It will present a dialog requesting the selection of the program file (KIDSSIEP) to run. Select the KIDSSIEP program file and then enter a userid and password.
If you are running multiple copies of 4D, you will get the same dialog when starting any of the copies. This is why it is important to rename each copy of 4D uniquely, and to give each copy of the WebKIDSS program a unique name also (KIDSSIEP and KIDSSIEP2).
You may use the web machine in single-user mode by starting up with the administrator userid and password. When the WebKIDSS program is started in this manner, it will not function as a web server. That feature is turned off. The primary reason you would want to use the web machine in this fashion is during the initial setup and the creation and loading of the data file. Once this is accomplished, then the need to run using the administrator userid and password is diminished.
Start the WebKIDSS program in single-user mode with the single user administrator userid and password. Then go to the Setup menu and select the Create Administrator User. Create a web Super Administrator user for yourself. After you have created this web Super Admin user you can quit the program and restart it as a web server.
Calendars can now be uploaded from your browser when logged on as a Super Admin user.
To use the web machine as a web server for WebKIDSS, the program must be started using the Webserver userid. Enter 'Webserver' as the userid and 'Kansas' as the password. Note the capital 'K' in Kansas. When started in this fashion as the web server, the only menu items available (except for the Edit and Help menus) are the items 'About WebKIDSS...' (to display the version number, the port number, and current number of web users) and 'Quit' (to exit the program) under the File menu. No menu items exist for displaying any of the student data, thus ensuring data security.