Windows Server Setup Guide

Transcription

Windows Server Setup Guide
Version 8
Windows Server Setup Guide
Rev. 1.62
Version 8 Server Setup
Table of Contents
Before You Begin ............................................................................................................................ 2
A Note About Progeny Downloads And Updates ......................................................................... 3
Setup Checklist For Upgrading Existing Progeny Systems To Progeny 8 ..................................... 4
Setup Checklist For New Progeny 8 Installations.......................................................................... 5
Section 1: Windows Server Setup .................................................................................................. 6
Updating From Earlier Versions Of Progeny ............................................................................... 7
Windows 2000/2003 Installations .............................................................................................. 8
Progeny Server 8 Installation ...................................................................................................... 9
Section 2: Progeny Server Configuration .................................................................................... 10
Progeny Server Configuration Utility ........................................................................................ 11
Step 1: Create The Progeny Database Service ...................................................................... 11
Step 2: Activate Your New Database Service ........................................................................ 17
Step 3: Configuring Windows Firewall .................................................................................. 18
Section 3: Appendices .................................................................................................................. 20
Appendix A: Software License Agreement ................................................................................ 21
Appendix B: Additional Parameters For Progeny Server Configuration Utility ........................ 24
Appendix C: Up-Converting Progeny Databases To Version 8 Format ..................................... 29
Appendix D: Best Practices for Progeny Backups Using the Automated Backup Utility .......... 34
Appendix E: Common Ports Used By Other Software............................................................... 36
800-PROGENY | 561-859-0773 | support@progenygenetics.com
1
Version 8 Server Setup
Before You Begin…
1. IMPORTANT - If you are upgrading from a previous version of Progeny Server, you will
need to install the Progeny Desktop Client on a PC with Administrative Rights to upgrade
the databases before you install the Progeny Server software.
a. Please refer to Appendix: C of this manual for instructions on up-converting your
database(s)
2. Make sure you are using an ADMINISTRATOR account on your server. Progeny Server
requires Administrative Rights to properly install.
3. Your server should have Windows Server 2000/2003/2008 /2008R2 installed.
4. Make sure your server is connected to the Internet and is fully updated before
beginning installation.
5. Please take note of your customer number and installed Progeny software versions. This
information will help Progeny technicians to assist you more quickly.
Customer Number: _____________________________
Installed Progeny Software (Please check all that apply):
Clinical
LIMS
Lab
Suite
Web-Enabled
800-PROGENY | 561-859-0773 | support@progenygenetics.com
2
Version 8 Server Setup
A Note About Progeny Downloads And Updates
Progeny no longer ships physical media for its software. All software is delivered via
secure download. You will receive credentials and hyperlinks to download the various
components of Progeny 8 from your Progeny Representative. When updates are issued, your
company contact will receive an email from Progeny with a hyperlink to the update and
instructions for updating.

Always keep a backup of your license files on the server or a removable storage drive
(Preferred)

Updates to the Progeny Windows Client are provided in the form of a setup.exe file
which is downloaded to and run on the end users' PC. No action is required by the
Progeny Server.

Progeny Windows Client update notices will be sent to anyone on our "Windows Client
Update Notices" contact list. All current Progeny Windows client users have been added
to this list.
o If you have not been receiving updates and wish to be added to this list, send an
email with your name and customer number to support@progenygenetics.com.
Please use “Add To Windows Client Update Notice List” as the header.
o Updated versions are also available from the login screen of the Windows client
via [Acct Info...]|[Update...].

IMPORTANT NOTE: All updates to the Windows client will require a web update as well
to ensure the two client versions are in sync. Additionally, Windows client updates must
be made for all Windows client end users to ensure that each PC using the Windows
client application is also in sync. If your organization uses the Progeny Web Server,
notify your IT administrator before updating your Progeny Clients.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
3
Version 8 Server Setup
Setup Checklist for Upgrading Existing Progeny Systems
to Progeny 8
 Stop / Disable all services related to your current Progeny Server
installation.
 Refer to Appendix: C for up-converting your database files to the new
Progeny 8 format.
 Complete Progeny Server installation/upgrade and load up-converted
database
 Update Java Runtime Environment (if necessary)
 Create the new database service.
 Create Windows Advanced Firewall traffic rules on the server.
 Install Progeny 8 on client PC’s (See Progeny 8 Client Setup)
 Register client PC’s with Progeny and obtain license file.
 Input the server connection settings into each Progeny 8 client.
 Uninstall Progeny 7 from server once Progeny 8 is up and running.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
4
Version 8 Server Setup
Setup Checklist For New Progeny 8 Installations
(No existing database)
 Complete Progeny Server installation.
 Install Java Runtime Environment.
 Create the new database service.
 Create Windows Advanced Firewall traffic rules on the server.
 Install Progeny 8 on client PC’s (See Progeny 8 Client Setup).
 Register client PC’s with Progeny and obtain license file.
 Input the server connection settings into each Progeny 8 client.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
5
Version 8 Server Setup
Section 1:
Windows Server Setup
800-PROGENY | 561-859-0773 | support@progenygenetics.com
6
Version 8 Server Setup
Upgrading From Earlier Versions of Progeny
Upgrading to Progeny 8 Server from previous versions of Progeny Server is now simpler
than ever – most installation steps are now handled by the Progeny 8 installer. To upgrade:
1. Stop/Disable all services and processes used by Progeny Server. These can include,
depending on your Progeny version and modules purchased
(** denotes wildcard character):
a. Processes
i. Dbsrv**.exe
ii. Scjview.exe
iii. Tomcat**.exe
iv. Tomcat**w.exe
b. Services
i. SQLANYs_**
ii. Tomcat**
2. Up-Convert your database files to the Progeny 8 format. Refer to Appendix: C for
detailed instructions.
3. Complete the installation process for Progeny 8. DO NOT UNINSTALL PREVIOUS
VERSIONS YET. Once the installation is complete, restart the server (optional, but
recommended).
4. If you want to uninstall the previous version of Progeny, you may do so at this point.
a. Progeny recommends that you thoroughly test your new database services
before you remove previous versions of Progeny Server. As long as the database
services are set to use different computer ports, Progeny 8 can run right
alongside your previous installation. Once the new system is running smoothly
you can go ahead and remove the previous versions of Progeny Server.
5. Make sure to uninstall all previous versions of the Progeny Desktop client AFTER you
uninstall the server. Make this your last step.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
7
Version 8 Server Setup
Windows Server 2000/2003 Installations
New Installation:
1. When running a new installation of Windows Server 2000 or 2003, or if this is the first
time you are installing any version of Progeny, there are no major settings to change or
roles to add.
a. The only changes from a basic installation we recommended are to add the
following Networking Components in Server 2003:
i. Microsoft TCP/IP version 6
1. NOTE: While not necessary for Progeny Server’s operation, IPv6 is
beginning to take over internet addressing from its predecessor,
IPv4. Since you’re doing a new installation, now is as good a time
as any to future-proof your server.
b. The server can otherwise be set up in any manner you wish
i. CAUTION: If running multiple databases, web/FTP/email servers or any
other web services off the same server, make sure that Progeny Server
has each has its own unique communication ports.
1. Overlapping services can clog ports and can cause Progeny Server
to malfunction.
ii. Again, each Progeny 8 database service MUST have its own unique,
dedicated port for proper operation.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
8
Version 8 Server Setup
Progeny Server 8 Installation
1. Install the Progeny Server application by double-clicking Progeny8Server.exe and
accepting the license agreement on the next screen.
a. A copy of the Software License Agreement may be found in Appendix: A of this
manual.
2. On the following screen enter your User Name and Organization.
a. Note: This information is completely optional and may be completed at your
discretion. None of this information is transmitted to any outside party.
b. Do not change the installation directory from its default. The server application
should install to C:\Program Files\Progeny Software\Progeny8\Server\
c. Click Install to complete the process.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
9
Version 8 Server Setup
Section 2:
Progeny Server Configuration
800-PROGENY | 561-859-0773 | support@progenygenetics.com
10
Version 8 Server Setup
Progeny Server Configuration Utility
Step 1: Create the Progeny Database Service
1. Double-click the Progeny 8 Server Configuration Utility, located on the desktop.
2. Dismiss the welcome screen popup, then click View  Folders.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
11
Version 8 Server Setup
3. Click on SQL Anywhere in the left pane, then select the Services Tab in the right pane.
Navigate into the open space in the right pane, right click, then select New  Service…
4. Choose a name for your new service. No spaces are allowed, and the name is case
sensitive, so write down the name EXACTLY as you type it in. In our example, we are
calling this Progeny8Demo. Click Next.
5. On the next screen, select Network Database Server (It’s the first option – you do not
have to do anything!), then click Next.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
12
Version 8 Server Setup
6. This next screen tells the Server Configuration Utility where the server executable is.
a. If you did a custom install, locate the dbsrv11.exe file within the Progeny
Software\Progeny8\Server\Bin32\ folder and type in the full file path.
i. Click Next.
b. If you did a standard install, leave this just the way it is and click Next.
7. This screen is the true guts of the database service. There are dozens of available
parameters that power users can take advantage of, though more novice users can
quickly become overwhelmed.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
13
Version 8 Server Setup
8. The basic database parameters looks like this:
-x (connection type) –n (service name) “(file path
of database file)”
a. If you are creating only one service, it is a good idea to use the default port.
i. If you do not specify a port in the configuration, you will use the default
port of 2638:
-x tcpip or –x tcpip(PORT=2638)
ii. Otherwise you can specify a new port in the following format:
-x tcpip(PORT=2642)
b. The service name identifies the service to the server and client computers. It is
simplest to make the service name EXACTLY the same as the database name.
c. Spaces are not allowed in the file path. Since Windows automatically introduces
spaces in the file paths, you MUST enclose the file path in “quotation marks.”
d. Make sure to separate each component with a space. Spaces tell the
Configuration Utility how to separate the different parameters. In the picture
below, we use the following sample parameters:
-x tcpip(PORT=2638) -n Progeny8Demo "C:\Program Files\Progeny
Software\Progeny 8\Server\Progeny8Demo.db"
800-PROGENY | 561-859-0773 | support@progenygenetics.com
14
Version 8 Server Setup
9. The next screen needs no alterations. The Server Configuration Utility needs to have
access to the Local system account. Just click Next.
10. For the startup type, make sure Automatic is selected. If you do not choose Automatic,
you will have to restart the service every time the server is turned off, rebooted, or
otherwise quits. Click Next.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
15
Version 8 Server Setup
11. In the final screen, DO NOT click the “Start the service now” button. If you made any
mistakes in the installation process and click this button, can freeze the application. Just
click Finish.
*INSTALLATION NOTE: If using more than one database service, each service must use
its own unique port to prevent interference.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
16
Version 8 Server Setup
Step 2: Activate Your New Progeny Database Service
1. Back on the main screen of the Server Configuration Utility, you should now see the
service you created listed in the right pane. The red box next to the name denotes that
the service is stopped. Right click the service name, then select Start. If the service was
properly configured, the red square will become a green triangle. If not, go back
through the instructions again.
Good configuration running properly:
Bad configuration NOT RUNNING:
800-PROGENY | 561-859-0773 | support@progenygenetics.com
17
Version 8 Server Setup
Step 3: Configuring Windows Firewall to Add Incoming and
Outgoing Firewall Exceptions
1. Open Windows Firewall with Advanced Security as an Admin by going Start Menu  All
Programs  Administrative Tools  Right-click on Windows Firewall with Advanced
Security  select Run as Administrator.
2. In the left pane, select Inbound Rules, then go to Action  New Rule…
3. We need to open specific ports in the server, so select Port, then click Next.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
18
Version 8 Server Setup
4. On the next screen, the only thing we want to do is enter the port number of the
database service. Select Specific local ports and enter 2638. Click Next.
5. The next two screens do not have anything that needs changing. Click Next through
both.
6. In this last screen, you can give your new rule a name and description. Be descriptive in
the name, forget the description. In our sample, we called the inbound rule
Progeny8ServerInboundPortOpening
7. Repeat steps 1-6 for the Outbound Rule. When you reach step 6, just change Inbound
to Outbound for the name.
Firewall Rule Reference:
1. Inbound firewall rule: <Database Service Name>InboundPortOpening
2. Outbound firewall rule: <Database Service Name>OutboundPortOpening
800-PROGENY | 561-859-0773 | support@progenygenetics.com
19
Version 8 Server Setup
Section 3:
Appendices
800-PROGENY | 561-859-0773 | support@progenygenetics.com
20
Version 8 Server Setup
Appendix A:
Software License Agreement
PLEASE READ THIS SOFTWARE LICENSE AGREEMENT CAREFULLY
BEFORE INSTALLING THE SOFTWARE.
1. Single User License Grant: PROGENY SOFTWARE, LLC. ("Progeny") hereby grants to
Customer ("Customer") a nonexclusive and nontransferable license to use the Progeny
software ("Software") in object code form solely on a single PC owned or leased by
Customer. Customer may install the software to a home computer or laptop provided it
is solely used by Customer and no-one else (the same person for both the work PC and
home PC or laptop).
2. Multiple-Users License Grant: Progeny grants to Customer a nonexclusive and
nontransferable license to use the Progeny software in object code form, installed on a
per PC basis for up to the number of PC’s the Customer has paid a license fee
("Permitted Number of Computers"). Customer may only use the programs contained in
the Software (i) for which Customer has paid a license fee (or in the case of an
evaluation copy, those programs Customer is authorized to evaluate) and (ii) for which
Customer has received a license file (xxx.lic). Customer grants to Progeny the right to
audit the number of PC’s installed with Progeny software during Customer's normal
business hours to verify compliance with the above provisions. In the event such audit
discloses that the Permitted Number of Computers is exceeded, Customer shall
promptly pay to Progeny the appropriate license fee for the additional computers. At
Progeny’s option, Progeny may terminate this license for failure to pay the required
license fee.
3. Customer may make one (1) archival copy of the Software provided Customer affixes to
such copy all copyright, confidentiality, and proprietary notices that appear on the
original.
4. EXCEPT AS EXPRESSLY AUTHORIZED ABOVE, CUSTOMER SHALL NOT: COPY, IN WHOLE
OR IN PART, SOFTWARE OR DOCUMENTATION; MODIFY THE SOFTWARE; REVERSE
COMPILE OR REVERSE ASSEMBLE ALL OR ANY PORTION OF THE SOFTWARE; OR RENT,
LEASE, DISTRIBUTE, SELL, OR CREATE DERIVATIVE WORKS OF THE SOFTWARE.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
21
Version 8 Server Setup
5. Customer agrees that aspects of the licensed materials, including the specific design and
structure of individual programs, constitute trade secrets and/or copyrighted material of
Progeny. Customer agrees not to disclose, provide, or otherwise make available such
trade secrets or copyrighted material in any form to any third party without the prior
written consent of Progeny. Customer agrees to implement reasonable security
measures to protect such trade secrets and copyrighted material. Title to Software and
documentation shall remain solely with Progeny.
6. LIMITED WARRANTY. Progeny warrants that for a period of ninety (90) days from the
date of shipment from Progeny: (i) the media on which the Software is furnished will be
free of defects in materials and workmanship under normal use; and (ii) the Software
substantially conforms to its published specifications. Except for the foregoing, the
Software is provided AS IS. This limited warranty extends only to Customer as the
original licensee. Customer's exclusive remedy and the entire liability of Progeny under
this limited warranty will be limited to a complete refund of the purchase price of the
Software paid by Customer. In no event does Progeny warrant that the Software is error
free or that Customer will be able to operate the Software without problems or
interruptions.
7. This warranty does not apply if the software (a) has been altered, except by Progeny, (b)
has not been installed, operated, repaired, or maintained in accordance with
instructions supplied by Progeny, (c) has been subjected to abnormal physical or
electrical stress, misuse, negligence, or accident…
8. DISCLAIMER. EXCEPT AS SPECIFIED IN THIS WARRANTY, ALL EXPRESS OR IMPLIED
CONDITIONS, REPRESENTATIONS, AND WARRANTIES INCLUDING, WITHOUT
LIMITATION, ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING,
USAGE, OR TRADE PRACTICE, ARE HEREBY EXCLUDED TO THE EXTENT ALLOWED BY
APPLICABLE LAW.
9. IN NO EVENT WILL PROGENY BE LIABLE FOR ANY LOST REVENUE, PROFIT, OR DATA, OR
FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL, OR PUNITIVE DAMAGES
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY ARISING OUT OF
THE USE OF OR INABILITY TO USE THE SOFTWARE EVEN IF PROGENY HAS BEEN ADVISED
OF THE POSSIBILITY OF SUCH DAMAGES. In no event shall Progeny’s liability to
Customer, whether in contract, tort (including negligence), or otherwise, exceed the
price paid by Customer for the Software. The foregoing limitations shall apply even if the
above-stated warranty fails of its essential purpose.
10. The above warranty DOES NOT apply to any beta software, any software made available
for testing or demonstration purposes, any temporary software modules or any
software for which Progeny does not receive a license fee. All such software products
are provided AS IS without any warranty whatsoever.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
22
Version 8 Server Setup
11. This License is effective until terminated. Customer may terminate this License at any
time by destroying all copies of Software including any documentation. This License will
terminate immediately without notice from Progeny if Customer fails to comply with
any provision of this License. Upon termination, Customer must destroy all copies of
Software.
12. Software, including technical data, is subject to U.S. export control laws, including the
U.S. Export Administration Act and its associated regulations, and may be subject to
export or import regulations in other countries. Customer agrees to comply strictly with
all such regulations and acknowledges that it has the responsibility to obtain licenses to
export, re-export, or import Software.
13. If the Software, or any part thereof, is, or in the opinion of Licensor may become, the
subject of any claim, suit or proceeding for infringement of any United States or foreign
patent, trademark or copyright, or in the event of any adjudication that the Software, or
any part thereof, infringes any United States or foreign patent. Trademark or copyright,
or of the sublicense or Use of the Software, or any part thereof, is enjoined, Licensor
shall protect and hold harmless Licensee; and Licensor shall at its option and expense:
(1) procure for Licensee the right under such patent; trademark or copyright to Use or
sublicense as appropriate, the Software or such part thereof; or (ii) replace the
Software, or part thereof, with other suitable Software or parts; or (iii) suitably modify
the Software, or part thereof; or (iv) if the Use of the Software, or part thereof, shall be
prevented by injunction, refund the aggregate payments paid therefore by Licensee,
less a reasonable sum for Use. Licensor shall not be liable for any costs or expenses
incurred without its prior written authorization.
14. This License shall be governed by and construed in accordance with the laws of the
State of Indiana, United States of America, as if performed wholly within the state and
without giving effect to the principles of conflict of law. If any portion hereof is found to
be void or unenforceable, the remaining provisions of this License shall remain in full
force and effect. This License constitutes the entire License between the parties with
respect to the use of the Software.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
23
Version 8 Server Setup
Appendix B:
Additional Parameters for Progeny Server Configuration
Utility
These parameters provide additional functionality and
flexibility with your database services. These tools are
designed for the advanced user, database developer, or IT
support staff.
Users who do not have at least a working knowledge of the
Sybase system should not attempt to work with these
additional parameters without FIRST making a complete
backup of their databases ON AN EXTERNAL DRIVE.
For added safety and security, please do not keep the
database backup on the server.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
24
Version 8 Server Setup
dbsrv9 - Server options (apply to server and all databases):
-b
run in bulk operations mode
-c <size>
-ca 0
make initial cache a maximum of <size> bytes <size> may be specified as nnnK,
nnnM, nnnG, nnnP
disable automatic cache resizing
-cc[+|-]
enable/disable page collection for cache warming (default is enabled)
-ch <size>
-cr[+|-]
set maximum cache size of <size> bytes <size> may be specified as nnnK, nnnM,
nnnG, nnnP
set minimum cache size of <size> bytes <size> may be specified as nnnK, nnnM,
nnnG, nnnP
enable/disable cache warming (default is enabled)
-cs
display cache sizing statistics
-ct[+|-]
enable/disable client-server character translation (default is enabled)
-cv[+|-]
enable/disable cache warming status messages (default is disabled)
-ec <list>
-ep
comma-separated list of communication encryption types supported types: none,
simple, ecc_tls(params), rsa_tls(params), rsa_tls_fips(params)
prompt for encryption keys if necessary
-fc <file>
filename of DLL with filesystem full callback function
-ga
automatically shutdown after last database closed
-gc <num>
set checkpoint timeout period to <num> minutes
-gd <level>
-ge <size>
set starting database permission to <level>; <level> may be one of "dba", "all" or
"none"
set external DLL thread stack size to <size>
-gf
disable firing of triggers
-gk <level>
-gm <num>
set "stopping database server" permission to <level>; <level> may be one of "dba",
"all" or "none"
set LOAD/UNLOAD permission to <level>; <level> may be one of "dba", "all" or
"none"
set maximum number of server connections (up to licensed maximum)
-gn <num>
set maximum number of concurrent server requests (up to gm)
-gp <size>
set maximum page size of <size> bytes <size> must be power of 2 >= 1024 and
<= 32768
set maximum recovery time to <num> minutes
-cl <size>
-gl <level>
-gr <num>
-gss <size>
-gt <num>
-gu <level>
set engine thread stack size of <size> bytes <size> may be specified as nnnK or
nnnM
set maximum number of CPUs to use (up to licensed maximum)
et utility commands (e.g., DROP DATABASE) permission to <level>; <level> may be
one of "utility_db", "dba", "all" or "none"
800-PROGENY | 561-859-0773 | support@progenygenetics.com
25
Version 8 Server Setup
-k
do not collect performance statistics
-m
truncate transaction log after checkpoint
-n <name>
name the database server (will be truncated to 40 characters)
-o <file>
filename for copy of message window
-oe <file>
filename to log startup errors, fatal errors and assertions
-os <size>
maximum size for file specified by -o <size> may be specified as nnnK, nnnM, nnnG
-p <size>
set maximum communication packet size (>300, <16000) -- default 1460
-pc
compress communication packets
-pt <size>
set compression threshold (minimum packet size to compress)
-qp
suppress performance warnings
-qw
do not display database server screen
-r
read-only mode -- database modifications not allowed
-s <id>
syslog facility id (none,user,daemon,local0,...,local7) (default is user)
-sb <level>
set broadcast level 0=Ignore all broadcasts, 1=Ignore dblocate broadcasts
-ti <min>
client idle time before disconnect (default is 240 minutes)
-tl <sec>
client liveness timeout in seconds (default is 120 seconds)
-tq <time>
set quitting time
-u
use buffered disk I/O
-ua
disable use of asynchronous I/O
-uc
use console UI
-ud
run as a daemon
-uf <action>
-ui
action to take upon a fatal error <action> may be one of "abort", "default", or
"defunct"
automatically choose UI
-ut <min>
touch temporary files -- default every 30 minutes
-ux
use X Windows GUI
-v
display product version information
-x <list>
comma-separated list of network drivers to run (TCPIP)
-xs <list>
comma-separated list of web protocols to accept (http, https, https_fips)
800-PROGENY | 561-859-0773 | support@progenygenetics.com
26
Version 8 Server Setup
-z
display debugging information
-ze
display server environment variables
-zl
remember last statement for each connection
-zn <num>
number of request log files to keep (used with -zs)
-zo <file>
redirect request logging information to file
-zr <level>
set request logging level <level> may be one of "all", "sql", "sql+hostvars", or
"none"
maximum size for file specified by -zo <size> may be specified as nnnK, nnnM, nnnG
-zs <size>
Recovery options:
-a <logfile>
apply named transaction log file
-f
force database to start without transaction log
Database options (apply only to preceding database):
-ek <key>
specify database file encryption key
-m
truncate transaction log after checkpoint
-n <name>
name the database
-r
read-only mode -- database modifications not allowed
800-PROGENY | 561-859-0773 | support@progenygenetics.com
27
Version 8 Server Setup
Protocol options:
TCP/IP:
Broadcast, BroadcastListener, DoBroadcast, Host, LDAP, LocalOnly, MyIP,
ReceiveBufferSize, SendBufferSize, ServerPort, TDS, Timeout
HTTP:
DatabaseName, LocalOnly, LogFile, LogFormat, LogMaxSize, LogOptions,
MaxConnections, MaxRequestSize, MyIP, ServerPort, Timeout
HTTPS:
Certificate, Certificate_password, DatabaseName, LocalOnly, LogFile, LogFormat,
LogMaxSize, LogOptions, MaxConnections, MaxRequestSize, MyIP, ServerPort,
Timeout
dbstop [options] [name]
@<data>
expands <data> from environment variable <data> or file <data>
-c
"keyword=value;..."
-d
supply database connection parameters
-o <file>
log output messages to file
-q
do not print messages
-x
if there are connections, do not stop
-y
if there are connections, do not prompt, stop anyway
stop only the specified database
800-PROGENY | 561-859-0773 | support@progenygenetics.com
28
Version 8 Server Setup
Appendix C:
Up-Converting Progeny Databases to Version 8 Format
1. Install the Progeny 8 Client on a desktop with administrative rights and register this
installation with Progeny. This will be your administrative client (See Progeny 8 Client
Setup).
2. Locate your existing database file on the server (If using Progeny 7, you would likely go
to C:\Program Files\Progeny Software\Progeny 7\Server\). Copy the database file to
external media and load it into your administrative client.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
29
Version 8 Server Setup
3. Start Progeny 8, and under the local database radio button, click browse.
4. Navigate to your existing database file and double-click it.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
30
Version 8 Server Setup
5. Back at the main login screen, log into the database file as you normally would. The
next box lets you know that the database needs to be updated to the Version 8 format.
Click Ok.
6. The next box asks you to create a name for the new database file. Create a folder in the
Progeny root folder (C:\Program Files\Progeny Software\) called “Progeny Databases”,
then give the new database a name and save it to this folder.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
31
Version 8 Server Setup
7. This next screen confirms the file path of the new database file and gives you the option
of encrypting the new database.
a. NOTE: While the option is available, we DO NOT recommend you encrypt your
database unless required to. Encrypting the database can negatively impact the
database’s performance.
8. The system will run for a minute or so, and you may see several windows pop up and
disappear. When this preparatory process is finished, a new window will appear asking
you to click OK to perform the database upgrade. Click OK.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
32
Version 8 Server Setup
9. In the next screen click OK to begin the database upgrade maintenance process.
a. Depending on the relative size of your database, this process can take several
minutes.
10. When the upgrade process is complete, Progeny 8 will open, and you should have full
access to your database.
a. If you do not see your database information, close Progeny 8, delete the new
database files, and begin the process again.
b. Close the Progeny client and copy the updated database back onto your external
media.
c. Once your server has been updated to the newest version of Progeny Server,
reload the new database file into the server, placing it in the Progeny Server root
folder (usually C:\Program Files\Progeny Software\Progeny 8\Server\)
11. Continue on to Section 2: Progeny Server Configuration.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
33
Version 8 Server Setup
Appendix D: Best Practices for Progeny Backups Using the
Automated Backup Utility
Progeny has its own Automated Backups utility, specifically designed for use with server-integrated
environments. Using Automated Backups, Progeny can create as many incremental backups as you
need (provided you allocate enough disk space), each working on its own independent schedule. For
each scheduled backup instance, Progeny will create one (1) copy of the database and overwrite this
copy with each scheduled backup.
The best way to make use of this feature is to create a minimum of two backup instances – one set
every 2-4 hours and another one time daily event. If disk space allows, you can create a daily backup for
each day of the week, allowing you to roll back the database to a previous day should a serious error
occur.
To configure Automated Backups, open your database using the Progeny user name, right click the root
icon in your folder list, and select Automated Backups…
800-PROGENY | 561-859-0773 | support@progenygenetics.com
34
Version 8 Server Setup
This will bring up the Automated Backups window. Select new, and give the backup instance a name
that contains no spaces.
NOTE: It is best to use the Backup Database + Log File option.
The “To Path” is the file path local to the server. The best place for the backups is right in the root folder
of the server drive. We recommend C:\ProgenyAutoBackups. You will need to create a subfolder for
each backup instance. For example, the setup for the two backups will look like this:
C:\ProgenyAutoBackups\Hourly
C:\ProgenyAutoBackups\Daily
For the Backup Frequency option, leave the setting on Every Day unless your backup instance is for a
specific day (if you were doing Monday-Friday separate daily backups for example). Automated Backups
works on the server and does not use any network resources.
There are two options for scheduling the backup frequency – “Once At” and “Every”.
Once At is designed for single daily backups.
Every is designed for incremental backups on a minute or hour based schedule
NOTE: When using the “Every” option, it is recommended to select a frequency of at least 2 Hours as
this gives you enough time to retrieve your latest backup copy before it is overwritten by your current
instance, in which case you would have to roll back to the previous day. This is entirely optional and
should be arrange to best suite your needs.
800-PROGENY | 561-859-0773 | support@progenygenetics.com
35
Version 8 Server Setup
Appendix E:
Common Ports Used By Other Software
(A.K.A. – The Ports Not To Use!)
The following list details many of the ports commonly used by other software packages.
For Progeny to operate properly, it needs to be configured to a port which is not used by any
other service. If there is only one database used by Progeny, please use the default port 2638.
Every additional database will require its own port for use. For each of these additional
databases please select a port that IS NOT on this list.
Service
echo
echo
discard
discard
systat
systat
daytime
daytime
qotd
qotd
chargen
chargen
ftp-data
ftp
ssh
telnet
smtp
time
time
rlp
nameserver
nameserver
nicname
Port
7/tcp
7/udp
9/tcp
9/udp
11/tcp
11/udp
13/tcp
13/udp
17/tcp
17/udp
19/tcp
19/udp
20/tcp
21/tcp
22/tcp
23/tcp
25/tcp
37/tcp
37/udp
39/udp
42/tcp
42/udp
43/tcp
Name
Description
sink null
sink null
users
users
#Active users
#Active users
quote
quote
ttytst source
ttytst source
#Quote of the day
#Quote of the day
#Character generator
#Character generator
#FTP, data
#FTP. control
#SSH Remote Login Protocol
mail
timserver
timserver
resource
name
name
whois
#Simple Mail Transfer Protocol
#Resource Location Protocol
#Host Name Server
#Host Name Server
800-PROGENY | 561-859-0773 | support@progenygenetics.com
36
Version 8 Server Setup
domain
domain
bootps
bootpc
tftp
gopher
finger
http
hosts2-ns
hosts2-ns
kerberos
kerberos
hostname
iso-tsap
rtelnet
pop2
pop3
sunrpc
sunrpc
auth
uucp-path
sqlserv
nntp
ntp
epmap
epmap
netbios-ns
netbios-ns
netbios-dgm
netbios-ssn
imap
sql-net
sqlsrv
pcmail-srv
snmp
snmptrap
print-srv
bgp
53/tcp
53/udp
67/udp
68/udp
69/udp
70/tcp
79/tcp
80/tcp
81/tcp
81/udp
88/tcp
88/udp
101/tcp
102/tcp
107/tcp
109/tcp
110/tcp
111/tcp
111/udp
113/tcp
117/tcp
118/tcp
119/tcp
123/udp
135/tcp
135/udp
137/tcp
137/udp
138/udp
139/tcp
143/tcp
150/tcp
156/tcp
158/tcp
161/udp
162/udp
170/tcp
179/tcp
dhcps
dhcpc
#Domain Name Server
#Domain Name Server
#Bootstrap Protocol Server
#Bootstrap Protocol Client
#Trivial File Transfer
www-http
#World Wide Web
#HOSTS2 Name Server
#HOSTS2 Name Server
kerberos-sec #Kerberos
kerberos-sec #Kerberos
hostnames
#NIC Host Name Server
#ISO-TSAP Class 0
#Remote Telnet Service
postoffice
#Post Office Protocol - Version 2
#Post Office Protocol - Version 3
rpcbind
#SUN Remote Procedure Call
rpcbind
#SUN Remote Procedure Call
ident tap
#Identification Protocol
usenet
loc-srv
loc-srv
nbname
nbname
nbdatagram
nbsession
imap4
snmp-trap
#SQL Services
#Network News Transfer Protocol
#Network Time Protocol
#DCE endpoint resolution
#DCE endpoint resolution
#NETBIOS Name Service
#NETBIOS Name Service
#NETBIOS Datagram Service
#NETBIOS Session Service
#Internet Message Access Protocol
#PCMail Server
#SNMP
#SNMP trap
#Network PostScript
#Border Gateway Protocol
800-PROGENY | 561-859-0773 | support@progenygenetics.com
37
Version 8 Server Setup
irc
ipx
rtsps
rtsps
mftp
mftp
ldap
https
https
microsoft-ds
microsoft-ds
kpasswd
kpasswd
isakmp
crs
crs
exec
biff
login
who
cmd
syslog
printer
talk
ntalk
efs
router
ulp
ulp
timed
tempo
irc-serv
irc-serv
courier
conference
netnews
netwall
uucp
194/tcp
213/udp
322/tcp
322/udp
349/tcp
349/udp
389/tcp
443/tcp
443/udp
445/tcp
445/udp
464/tcp
464/udp
500/udp
507/tcp
507/udp
512/tcp
512/udp
513/tcp
513/udp
514/tcp
514/udp
515/tcp
517/udp
518/udp
520/tcp
520/udp
522/tcp
522/udp
525/udp
526/tcp
529/tcp
529/udp
530/tcp
531/tcp
532/tcp
533/udp
540/tcp
#Internet Relay Chat Protocol
#IPX over IP
MCom
MCom
ike
#Lightweight Directory Access Protocol
#HTTP over TLS/SSL
#HTTP over TLS/SSL
# Kerberos (v5)
# Kerberos (v5)
#Internet Key Exchange
#Content Replication System
#Content Replication System
#Remote Process Execution
comsat
#Remote Login
whod
shell
spooler
#Extended File Name Server
route routed
timeserver
newdate
rpc
chat
readnews
#For emergency broadcasts
uucpd
800-PROGENY | 561-859-0773 | support@progenygenetics.com
38
Version 8 Server Setup
klogin
543/tcp
kshell
544/tcp
dhcpv6-client 546/tcp
dhcpv6-client 546/udp
dhcpv6-server 547/tcp
dhcpv6-server 547/udp
afpovertcp
548/tcp
afpovertcp
548/udp
new-rwho
550/udp
rtsp
554/tcp
rtsp
554/udp
remotefs
556/tcp
rmonitor
560/udp
monitor
561/udp
nntps
563/tcp
nntps
563/udp
whoami
565/tcp
whoami
565/udp
ms-shuttle
568/tcp
ms-shuttle
568/udp
ms-rome
569/tcp
ms-rome
569/udp
http-rpc-epm 593/tcp
http-rpc-epm 593/udp
hmmp-ind
612/tcp
hmmp-ind
612/udp
hmmp-op
613/tcp
hmmp-op
613/udp
ldaps
636/tcp
doom
666/tcp
doom
666/udp
msexch
691/tcp
msexch
691/udp
kerberos-adm 749/tcp
kerberos-adm 749/udp
kerberos-iv 750/udp
mdbs_daemon 800/tcp
mdbs_daemon 800/udp
krcmd
#Kerberos login
#Kerberos remote shell
#DHCPv6 Client
#DHCPv6 Client
#DHCPv6 Server
#DHCPv6 Server
#AFP over TCP
#AFP over TCP
new-who
#Real Time Stream Control Protocol
#Real Time Stream Control Protocol
rfs_server
rmonitord
snntp
snntp
sldap
#NNTP over TLS/SSL
#NNTP over TLS/SSL
#Microsoft shuttle
#Microsoft shuttle
#Microsoft rome
#Microsoft rome
#HTTP RPC Ep Map
#HTTP RPC Ep Map
#HMMP Indication
#HMMP Indication
#HMMP Operation
#HMMP Operation
#LDAP over TLS/SSL
#Doom Id Software
#Doom Id Software
#MS Exchange Routing
#MS Exchange Routing
#Kerberos administration
#Kerberos administration
#Kerberos version IV
800-PROGENY | 561-859-0773 | support@progenygenetics.com
39
Version 8 Server Setup
ftps-data
989/tcp
ftps
990/tcp
telnets
992/tcp
imaps
993/tcp
ircs
994/tcp
pop3s
995/tcp
pop3s
995/udp
kpop
1109/tcp
nfsd-status 1110/tcp
nfsd-keepalive 1110/udp
nfa
1155/tcp
nfa
1155/udp
activesync
1034/tcp
phone
1167/udp
opsmgr
1270/tcp
opsmgr
1270/udp
ms-sql-s
1433/tcp
ms-sql-s
1433/udp
ms-sql-m
1434/tcp
ms-sql-m
1434/udp
ms-sna-server 1477/tcp
ms-sna-server 1477/udp
ms-sna-base 1478/tcp
ms-sna-base 1478/udp
wins
1512/tcp
wins
1512/udp
ingreslock
1524/tcp
stt
1607/tcp
stt
1607/udp
l2tp
1701/udp
pptconference1711/tcp
pptconference1711/udp
pptp
1723/tcp
msiccp
1731/tcp
msiccp
1731/udp
winsock
1745/tcp
winsock
1745/udp
ms-streaming 1755/tcp
spop3
spop3
#FTP data, over TLS/SSL
#FTP control, over TLS/SSL
#Telnet protocol over TLS/SSL
#IMAP4 protocol over TLS/SSL
#IRC protocol over TLS/SSL
#pop3 protocol over TLS/SSL (was spop3)
#pop3 protocol over TLS/SSL (was spop3)
#Kerberos POP
#Cluster status info
#Client status info
#Network File Access
#Network File Access
#ActiveSync Notifications
#Conference calling
#Microsoft Operations Manager
#Microsoft Operations Manager
#Microsoft-SQL-Server
#Microsoft-SQL-Server
#Microsoft-SQL-Monitor
#Microsoft-SQL-Monitor
#Microsoft Windows Internet Name Service
#Microsoft Windows Internet Name Service
ingres
#Layer Two Tunneling Protocol
#Point-to-point tunnelling protocol
800-PROGENY | 561-859-0773 | support@progenygenetics.com
40
Version 8 Server Setup
ms-streaming
msmq
msmq
radius
radacct
msnp
msnp
ssdp
ssdp
close-combat
close-combat
nfsd
knetd
mzap
mzap
qwave
qwave
directplay
directplay
ms-olap3
ms-olap3
ms-olap4
ms-olap4
ms-olap1
ms-olap1
ms-olap2
ms-olap2
ms-theater
ms-theater
wlbs
wlbs
ms-v-worlds
ms-v-worlds
sms-rcinfo
sms-rcinfo
sms-xfer
sms-xfer
sms-chat
1755/udp
1801/tcp
1801/udp
1812/udp
1813/udp
1863/tcp
1863/udp
1900/tcp
1900/udp
1944/tcp
1944/udp
2049/udp
2053/tcp
2106/tcp
2106/udp
2177/tcp
2177/udp
2234/tcp
2234/udp
2382/tcp
2382/udp
2383/tcp
2383/udp
2393/tcp
2393/udp
2394/tcp
2394/udp
2460/tcp
2460/udp
2504/tcp
2504/udp
2525/tcp
2525/udp
2701/tcp
2701/udp
2702/tcp
2702/udp
2703/tcp
#Microsoft Message Queue
#Microsoft Message Queue
#RADIUS authentication protocol
#RADIUS accounting protocol
nfs
#NFS server
#Kerberos de-multiplexor
#Multicast-Scope Zone Announcement Protocol
#Multicast-Scope Zone Announcement Protocol
#QWAVE
#QWAVE Experiment Port
#DirectPlay
#DirectPlay
#Microsoft OLAP 3
#Microsoft OLAP 3
#Microsoft OLAP 4
#Microsoft OLAP 4
#Microsoft OLAP 1
#Microsoft OLAP 1
#Microsoft OLAP 2
#Microsoft OLAP 2
#Microsoft Windows Load Balancing Server
#Microsoft Windows Load Balancing Server
#Microsoft V-Worlds
#Microsoft V-Worlds
#SMS RCINFO
#SMS RCINFO
#SMS XFER
#SMS XFER
#SMS CHAT
800-PROGENY | 561-859-0773 | support@progenygenetics.com
41
Version 8 Server Setup
sms-chat
2703/udp
sms-remctrl 2704/tcp
sms-remctrl 2704/udp
msolap-ptp2 2725/tcp
msolap-ptp2 2725/udp
icslap
2869/tcp
icslap
2869/udp
cifs
3020/tcp
cifs
3020/udp
xbox
3074/tcp
xbox
3074/udp
ms-dotnetster 3126/tcp
ms-dotnetster 3126/udp
ms-rule-engine 3132/tcp
ms-rule-engine 3132/udp
msft-gc
3268/tcp
msft-gc
3268/udp
msft-gc-ssl
3269/tcp
msft-gc-ssl
3269/udp
ms-cluster-net 3343/tcp
ms-cluster-net 3343/udp
ms-wbt-server 3389/tcp
ms-wbt-server 3389/udp
ms-la
3535/tcp
ms-la
3535/udp
pnrp-port
3540/tcp
pnrp-port
3540/udp
teredo
3544/tcp
teredo
3544/udp
p2pgroup
3587/tcp
p2pgroup
3587/udp
ws-discovery 3702/udp
ws-discovery 3702/tcp
dvcprov-port 3776/tcp
dvcprov-port 3776/udp
msfw-control 3847/tcp
msdts1
3882/tcp
sdp-portmap 3935/tcp
#SMS CHAT
#SMS REMCTRL
#SMS REMCTRL
#MSOLAP PTP2
#MSOLAP PTP2
#Microsoft Xbox game port
#Microsoft Xbox game port
#Microsoft .NET ster port
#Microsoft .NET ster port
#Microsoft Business Rule Engine Update Service
#Microsoft Business Rule Engine Update Service
#Microsoft Global Catalog
#Microsoft Global Catalog
#Microsoft Global Catalog with LDAP/SSL
#Microsoft Global Catalog with LDAP/SSL
#Microsoft Cluster Net
#Microsoft Cluster Net
#MS WBT Server
#MS WBT Server
#Microsoft Class Server
#Microsoft Class Server
#PNRP User Port
#PNRP User Port
#Teredo Port
#Teredo Port
#Peer to Peer Grouping
#Peer to Peer Grouping
#WS-Discovery
#WS-Discovery
#Device Provisioning Port
#Device Provisioning Port
#Microsoft Firewall Control
#DTS Service Port
#SDP Port Mapper Protocol
800-PROGENY | 561-859-0773 | support@progenygenetics.com
42
Version 8 Server Setup
sdp-portmap
net-device
net-device
ipsec-msft
ipsec-msft
llmnr
llmnr
wsd
wsd
rrac
rrac
dccm
dccm
ms-licensing
ms-licensing
directplay8
directplay8
man
rasadv
rasadv
imip-channels
imip-channels
directplaysrvr
directplaysrvr
3935/udp
4350/tcp
4350/udp
4500/tcp
4500/udp
5355/tcp
5355/udp
5357/tcp
5358/tcp
5678/tcp
5678/udp
5679/tcp
5679/udp
5720/tcp
5720/udp
6073/tcp
6073/udp
9535/tcp
9753/tcp
9753/udp
11320/tcp
11320/udp
47624/tcp
47624/udp
#SDP Port Mapper Protocol
#Net Device
#Net Device
#Microsoft IPsec NAT-T
#Microsoft IPsec NAT-T
#LLMNR
#LLMNR
#Web Services on devices
#Web Services on devices
#Remote Replication Agent Connection
#Remote Replication Agent Connection
#Direct Cable Connect Manager
#Direct Cable Connect Manager
#Microsoft Licensing
#Microsoft Licensing
#DirectPlay8
#DirectPlay8
#Remote Man Server
#IMIP Channels Port
#IMIP Channels Port
#Direct Play Server
#Direct Play Server
800-PROGENY | 561-859-0773 | support@progenygenetics.com
43