Installation: Difference between revisions

From ZDN User Guide
m (Prepared the page for translation)
Line 1: Line 1:
<languages/>
<translate>
== Important Note ==
== Important Note ==
Please review the [[Software and Hardware]] requirements before beginning installation.
 
Please review the [[Special:MyLanguage/Software and Hardware|Software and Hardware]] requirements before beginning installation.


== Video Guide ==
== Video Guide ==
7 minutes
7 minutes


Line 9: Line 14:


== Mandatory steps BEFORE installation: ==
== Mandatory steps BEFORE installation: ==
IMPORTANT!  To run this program, you MUST do the following three steps BEFORE you install or run the program:  
IMPORTANT!  To run this program, you MUST do the following three steps BEFORE you install or run the program:  


* Be running Windows and have Microsoft Access installed.  This program will not run on MacOS or any other operating system.
* Be running Windows and have Microsoft Access installed.  This program will not run on MacOS or any other operating system.
* Extract the files from the .zip folder.  The program will not run correctly from inside the .zip file.
* Extract the files from the .zip folder.  The program will not run correctly from inside the .zip file.
* Microsoft blocks all downloads from the internet from running code.  To unblock the file, right-click on the DietNavigator_X.X.accdb file, and choose "Properties". At the bottom of the window, check the box to '''unblock''' the file.[[File:Properties-231x300.png|thumb|Select "unblock" to allow the file to be used]]
* Microsoft blocks all downloads from the internet from running code.  To unblock the file, right-click on the DietNavigator_X.X.accdb file, and choose "Properties". At the bottom of the window, check the box to '''unblock''' the file.</translate>
[[File:Properties-231x300.png|thumb|<translate>Select "unblock" to allow the file to be used</translate>]]
<translate>


== Install ==
== Install ==


=== Single user: ===
=== Single user: ===
* Unzip the files into a folder on your C: drive (such as My Documents or similar)
* Unzip the files into a folder on your C: drive (such as My Documents or similar)


=== Multi-user: ===
=== Multi-user: ===
* Place the "ZDN Support Files" folder on a ''shared'' network drive (usually called H: or J: or similar).  
* Place the "ZDN Support Files" folder on a ''shared'' network drive (usually called H: or J: or similar).  
* Do NOT use file-sharing services such as OneDrive or DropBox to share the Support Files folder.
* Do NOT use file-sharing services such as OneDrive or DropBox to share the Support Files folder.
Line 28: Line 38:
# Open the DietNavigator_X.X.accdb file. You will likely get a few errors right on opening - this is normal. The next steps will fix this.
# Open the DietNavigator_X.X.accdb file. You will likely get a few errors right on opening - this is normal. The next steps will fix this.
# If this is your first time opening ZDN, you will likely see the "Initial Setup" screen.  If you have opened ZDN before, go to Settings to configure.
# If this is your first time opening ZDN, you will likely see the "Initial Setup" screen.  If you have opened ZDN before, go to Settings to configure.
[[File:Initial Setup.png|none|thumb|300x300px]]
</translate>
[[File:Initial Setup.png|none|thumb|<translate>300x300px</translate>]]
<translate>


# Select your "ZDN Support Files" folder (note: select the folder itself, do not actually open the folder)
# Select your "ZDN Support Files" folder (note: select the folder itself, do not actually open the folder)
Line 35: Line 47:


=== Sample Zoo vs. Blank Zoo ===
=== Sample Zoo vs. Blank Zoo ===
The Sample Zoo datafile has demo diets and animals in it so you can explore and test out the program. The Blank Zoo datafile contains the same feed and species data, but no diets or animals are there - a fresh start for you to create your zoo. Make a copy of the Blank Zoo (or rename it) for your zoo, link to it in the Settings (just like in the Configure section above), and begin [[Setting up your zoo: Parks, Areas, Delivery Locations|building your zoo]] from there.
The Sample Zoo datafile has demo diets and animals in it so you can explore and test out the program. The Blank Zoo datafile contains the same feed and species data, but no diets or animals are there - a fresh start for you to create your zoo. Make a copy of the Blank Zoo (or rename it) for your zoo, link to it in the Settings (just like in the Configure section above), and begin [[Setting up your zoo: Parks, Areas, Delivery Locations|building your zoo]] from there.


Line 40: Line 53:


* For a few users (1-3 or so), AFTER you have completed the configuration process above, distribute one copy of just the DietNavigator_X.X.accdb file to each user.  They should put this on a folder on their local hard drive (C: drive location, such as My Documents) and always run it from there.   
* For a few users (1-3 or so), AFTER you have completed the configuration process above, distribute one copy of just the DietNavigator_X.X.accdb file to each user.  They should put this on a folder on their local hard drive (C: drive location, such as My Documents) and always run it from there.   
* For multiple users (3+ people), see the [[Distribution]] section for how to use a batch file to automate the distribution.
* For multiple users (3+ people), see the [[Special:MyLanguage/Distribution|Distribution]] section for how to use a batch file to automate the distribution.
* Only the "ZDN Support Files" ''folder'', not the program itself, should be located on the network.
* Only the "ZDN Support Files" ''folder'', not the program itself, should be located on the network.


== Troubleshooting ==
== Troubleshooting ==


* If you see this red bar at the top, you need to unblock the file.  See the "Mandatory steps before installation" section.[[File:Security-Risk.png|none|frame]]
* If you see this red bar at the top, you need to unblock the file.  See the "Mandatory steps before installation" section.</translate>
* If you see this yellow bar at the top, you should click to "Enable Content". Consider adding your ZDN program and ZDN Support Files folders locations as "trusted locations" in the Options section. [[File:Security-Warning.png|none|frame]]
[[File:Security-Risk.png|none|<translate>frame</translate>]]
<translate>
* If you see this yellow bar at the top, you should click to "Enable Content". Consider adding your ZDN program and ZDN Support Files folders locations as "trusted locations" in the Options section. </translate>
[[File:Security-Warning.png|none|<translate>frame</translate>]]
<translate>


== License ==
== License ==


This software is released under the [https://www.gnu.org/licenses/gpl-3.0.en.html Version 3 of the GNU GPL] or any later version and is free to use and modify. In fact, we hope the community will continue to grow and build this.
This software is released under the [https://www.gnu.org/licenses/gpl-3.0.en.html Version 3 of the GNU GPL] or any later version and is free to use and modify. In fact, we hope the community will continue to grow and build this.


< [[Philosophy]]
< [[Special:MyLanguage/Philosophy|Philosophy]]


> [[Upgrading older datafiles]]
> [[Special:MyLanguage/Upgrading older datafiles|Upgrading older datafiles]]
</translate>

Revision as of 17:57, 9 May 2024

Other languages:
  • English

Important Note

Please review the Software and Hardware requirements before beginning installation.

Video Guide

7 minutes

Mandatory steps BEFORE installation:

IMPORTANT!  To run this program, you MUST do the following three steps BEFORE you install or run the program:

  • Be running Windows and have Microsoft Access installed.  This program will not run on MacOS or any other operating system.
  • Extract the files from the .zip folder.  The program will not run correctly from inside the .zip file.
  • Microsoft blocks all downloads from the internet from running code.  To unblock the file, right-click on the DietNavigator_X.X.accdb file, and choose "Properties". At the bottom of the window, check the box to unblock the file.
Select "unblock" to allow the file to be used

Install

Single user:

  • Unzip the files into a folder on your C: drive (such as My Documents or similar)

Multi-user:

  • Place the "ZDN Support Files" folder on a shared network drive (usually called H: or J: or similar).
  • Do NOT use file-sharing services such as OneDrive or DropBox to share the Support Files folder.

Configure

  1. Open the DietNavigator_X.X.accdb file. You will likely get a few errors right on opening - this is normal. The next steps will fix this.
  2. If this is your first time opening ZDN, you will likely see the "Initial Setup" screen. If you have opened ZDN before, go to Settings to configure.
  1. Select your "ZDN Support Files" folder (note: select the folder itself, do not actually open the folder)
  2. Select the "Sample Zoo" datafile and click "Load datafile"
  3. Click "Exit"

Sample Zoo vs. Blank Zoo

The Sample Zoo datafile has demo diets and animals in it so you can explore and test out the program. The Blank Zoo datafile contains the same feed and species data, but no diets or animals are there - a fresh start for you to create your zoo. Make a copy of the Blank Zoo (or rename it) for your zoo, link to it in the Settings (just like in the Configure section above), and begin building your zoo from there.

Multi-user setup only:

  • For a few users (1-3 or so), AFTER you have completed the configuration process above, distribute one copy of just the DietNavigator_X.X.accdb file to each user.  They should put this on a folder on their local hard drive (C: drive location, such as My Documents) and always run it from there.
  • For multiple users (3+ people), see the Distribution section for how to use a batch file to automate the distribution.
  • Only the "ZDN Support Files" folder, not the program itself, should be located on the network.

Troubleshooting

  • If you see this red bar at the top, you need to unblock the file.  See the "Mandatory steps before installation" section.
  • If you see this yellow bar at the top, you should click to "Enable Content". Consider adding your ZDN program and ZDN Support Files folders locations as "trusted locations" in the Options section.

License

This software is released under the Version 3 of the GNU GPL or any later version and is free to use and modify. In fact, we hope the community will continue to grow and build this.

< Philosophy

> Upgrading older datafiles