D3 Windows 9.0 For Windows 2003, Windows Server 2008, Windows XP, Windows Vista and Windows 7 ============================================================================ READ ME Version : May 2011 The installation and upgrade procedure for D3 Windows 9.0 has changed. We strongly recommend that you read this Read Me and the Installation Guide before installing or upgrading. The installation documentation is also available on our Web site at: http://www.tigerlogic.com/tigerlogic/pick/support/documentation/d3server.jsp IMPORTANT: D3 Windows can no longer be installed on any version of Windows 2000. See the Release Notes for other relevant information. For the latest information about this product, see: http://www.tigerlogic.com/tigerlogic/pick/database/index.jsp Service packs for this release are available at: http://www.tigerlogic.com/tigerlogic/pick/support/patches/d3nt.jsp D3 Windows 9.0 is certified on the Windows releases detailed in the Installation Guide under the topic Software Requirements. For Service Pack certifications, see the TigerLogic Web site at: http://www.tigerlogic.com/tigerlogic/pick/support/statussheet/pick.jsp D3 Windows requires that you have Microsoft .NET Framework 2.0 or higher installed on your system. o Upgrading from D3 NT 7.5 -------------------------------------------------------------------------------- If you are upgrading from D3 NT 7.5, then you MUST perform a save on all VME accounts using the h option. o Shutting down Windows -------------------------------------------------------------------------------- Shutting down Windows while D3 is running is strongly discouraged. It is always recommended to cleanly and completely shut down D3 before shutting down Windows. Failure to do so may leave the database in an inconsistent state which could lead to data errors (GFEs) or other data problems. You cannot depend on a Windows shutdown to leave enough time for the database to completely clear all memory and write all data to the file system. It is strongly recommended that automatic Windows updates are disabled on the Windows server running D3. Automatic updates frequently require a reboot of Windows which could interrupt database jobs that are running and may not leave enough time for all write required buffers to be written to disk. Windows updates should be set to "Check for updates but let me choose whether to download and install them". Any updates that are required should be installed after D3 has been shut down. The D3 service should be set to manual start while updates are being installed to be prevent an automatic start of the database if a Windows reboot is required during the installation of the updates. o Decimal Separator In Windows for FlashBASIC -------------------------------------------------------------------------------- An enhancement was added to D3 7.5 to improve the accuracy of results from FlashBASIC math when dealing with numbers greater than a 32 bit integer. This can cause the results returned from a calculation being incorrectly formatted due to the decimal separator not being set to a decimal point (.) for the Windows account D3 is running as. Please ensure that the decimal separator for this Windows account is configured correctly using the ‘Regional and Language Options’ item in the Windows Control Panel. To change the decimal separator, do the following: For the user account that D3 is running as: 1. Open the ‘Regional and Language Options’ item in the Windows Control Panel. 2. Click the Customize button. 3. Change the Decimal Symbol to a decimal point (.). 4. Click Apply. 5. Click OK. If D3 is running as the localsystem account: (For Windows XP and Windows Server 2003) 1. Complete steps 1 through 4 above. 2. Click the Advanced Tab. 3. Select the check box in the ‘Default User Account Setting’ group. 4. Click OK. 5. Click Apply. 6. Click OK. (For Windows Vista, Windows 7 and Windows Server 2008) 1. Complete steps 1 through 4 above (top-most set of instructions). 2. Click the Administrative Tab. 3. Click 'Copy to reserved accounts'. 4. Select 'System accounts (local system, local service, and network service)'. 5. Click OK. 6. Click Apply. 7. Click OK. o Default Location for the D3DATABASE and D3VIRTUAL Directories --------------------------------------------------------- As of D3 Windows 9.0, the default D3DATABASE and D3VIRTUAL directories will be set to the value that exists in the %ALLUSERSPROFILE% environment variable. If you are running D3 Windows on Windows Vista, Windows 7 or Server 2008 with UAC on, do not install the D3DATABASE and D3VIRTUAL directories under program files on the Windows boot drive. o Administrative Rights ----------------------------------------------------------- Administrative rights are required for installing D3 Windows. If the user performing an install does not have admin rights, they will be prompted for a valid user name and password with administrative rights. To uninstall D3 Windows, you must be logged on as a user with administrative rights. Additionally, administrative rights are required when running the D3 service as a user (rather than the local system account). o Windows Desktop Interaction on Windows Vista, Windows 7 & Windows Server 2008 --------------------------------------------------------- For Windows Vista, Windows 7 and Windows Server 2008 implementations, D3 does not interact with the Windows desktop. For example, the D3 boot sequence does not display on the screen when the D3 service starts and doing a !notepad does not work due to Microsoft security changes. o Downgrading from D3 Windows 9.0 to a previous version of D3 Windows --------------------------------------------------------- WARNING: Downgrading from D3 Windows 9.0 to a previous version of D3 Windows is not possible. To revert to a previous version you must: 1. Perform a full file-save. 2. Uninstall D3 Windows 9.0. 3. Reinstall the desired D3 Windows version. 4. Run the restore-accounts command. 5. Recompile Flash compiled programs o Activating Multiple Server Licenses on a Laptop ------------------------------------------------------- On some laptops, you may need to set NumLock on when activating multiple server licenses. o Setup.hlp ------------------------------------------------------- In previous versions of D3 Windows, the splash screen included a Help button that is not included in D3 Windows 9.0. The installation instructions are located on this CD in Install.pdf. o Before Uninstalling a previous release --------------------------------------------------------- Make sure you perform a file-save to save your data files and VME and FSI accounts. All FSI indexes must be recreated after the upgrade by running the 'indexer (o' command. o Configuring the Windows Installer ---------------------------------------------------------- The new version of Windows Installer may request that you reboot your system after configuring the installer. If this occurs, close down all applications and reboot your system. o Accessing the System Debugger ---------------------------------------------------------- Access to the System Debugger from TCL is permitted only if there is a 'd' in the options field of the dm,users, item. o FlashBASIC Code ------------------------------------------------------- All FlashBASIC code must be recompiled on D3 9.0. The new "compile.flash.all" command allows automatic recompiling of all BASIC programs currently compiled with FlashBASIC, either in one or all accounts on the system. If the source code is not available, the programs can be compiled from the object code using the (ow compile option. The ( w option is available for both the "compile" command and the "compile.flash.all" command. o Shutting Down D3 on Windows Vista, Windows 7 or Windows Server 2008 --------------------------------------------------------- If you are running D3 9.0 as a service on Windows Vista, Windows 7 or 2008 and you shut down Windows, you will no longer see a message box indicating that D3 is shutting down. However, D3 is being shut down properly in the background. o Running d3vme.exe on Windows Vista, Windows 7 and Windows Server 2008 --------------------------------------------------------- On Windows Vista, Windows 7 and Windows Server 2008, in order to run the d3vme.exe with the /debug or /start or /fileload or /restore parameters, you need to start the command prompt window using the ‘Run as Administrator’ option. If this is not done, the virtual machine will start, but you will not be able to execute any FlashBASIC programs. o Known issues ---------------------------------------------------------- 1. This version is not able to communicate over RPC with releases of D3 Windows prior to 7.2.0. 2. D3 services failed to install or start. * Check the Event Viewer for any errors that occurred for the D3 services. If the services are set up with a user account, and that user account does not exist, the services will not be installed. * If the password is invalid, or the user account does not have administrator privilege, services will not start. * Verify the D3 has been activated. 3. In certain instances, printers may not be available to D3 until initialized by Windows, depending on the initialization string that is required by the printer driver. 4. Deleting an index while the file is still open will generate errors. All such errors will be logged to the Event log.