astraia CD: Network Installation and Update

Manual

Introduction - CD Contents
Machine requirements for Network Server and Client
astraia Network Server Installation
Installing the Network Client Version
Update an existing astraia Network Server Version
Installing Sybase as a Network Server
Miscellaneous
astraia Contact Details

Introduction - CD Contents
This information will guide you through the installation of the astraia Database.

This installation CD contains:

• astraia installation: The latest Windows setup dialog for the astraia Database. A runtime of
Java 1.4.2 is installed. For users who want the full functionality of a Java Runtime, including the
Internet Explorer plug-in and the ability to run other Java applications, a Sun Java 1.4.2
executable is provided in the /java directory.
• Sybase installation dialog: A copy of Sybase SQL Anywhere Studio 9.0.2 is included. The
installation of this is dependent upon having purchased the required number of concurrent
licenses from astraia. Please note that this is the Authenticated Edition of SQL Anywhere, which
will not work with any software other than astraia. Run the installation program and select
Personal Server.
• astraia manuals in English and German can be found in /docs. These are in PDF format - a
version of Adobe Acrobat Reader version 5 is provided in the /adobe directory.

Machine requirements
The minimum requirements for an astraia reporting and imaging workstation:

1. astraia Network Server with DICOM Image Module

Recommended Hardware
Network Server installation with DICOM Image Module:
The Server should fulfill the following requirements:
• Pentium IV or equivalent
• Windows XP Professional, Windows 2000 or Windows 2003 Server, latest service pack installed
• 1024 or more MB Memory (RAM)
• 80 GByte or more Harddrive
• TCP/IP protocol installed
• back up device or network backup process installed
• remote access for service and maintenance available
• network connection of 100 MBit/s
• capable of installing Sybase SQL Anywhere 9, Oracle 9i/10g or Microsoft SQL Server 2000/2005 as
required
• either a RAID system, a DVD Writer for archiving purposes or a connection to a PACS-System.

Minimum Requirements Hardware

Network Server installation with DICOM Image Module:
The Server should fulfill the following requirements:
• Pentium IV or equivalent
• Windows XP Professional, Win 2000, latest service pack installed
• 512 or more MB Memory (RAM)
• 80 GByte or more Harddrive
• TCP/IP protocol installed
• back up device or network backup process installed
• remote access for service and maintenance available
• network connection of 10 MBit/s
• capable of installing Sybase SQL Anywhere 9, Oracle 9i/10g or Microsoft SQL Server 2000/2005 as
required
• either a RAID system, a DVD Writer for archiving purposes or a connection to a PACS-System.

2. astraia Network Client with DICOM Image Module

Recommended Hardware
Network Client installation with DICOM Image Module:
A Client should fulfill the following requirements:
• Pentium IV or equivalent
• Windows XP Professional, Windows 2000, latest service pack installed
• 1024 or more MB Memory (RAM)
• TCP/IP protocol installed
• remote access for service and maintenance available
• network connection of 100 Mbit/s

Minimum Requirements Hardware

Network Client installation with DICOM Image Module:
A Client should fulfill the following requirements:
• Pentium IV or equivalent
• Windows XP Professional, Windows 2000, latest service pack installed
• 512 or more MB Memory (RAM)
• TCP/IP protocol installed
• network connection of 10 MBit/s

Important note: an astraia network installation requires a license for 2 or more users. Running astraia
on a network without a network license is certain to damage your database.

Important
• If the file server does not meet the above specification (e.g. Linux) please be sure to inform astraia
(astraia Contact Details) before the installation to discuss any questions
• Please inform us which database you want to have installed. For Sybase SQL Anywhere, which has
been purchased directly from astraia, you will get technical support. We can not offer any support for
MS SQL Server or Oracle further than the connection to astraia.

Remote access
For immediate support and system update we strongly recommend you supply us with remote access to
the server.
The current System Requirements and the System Requirements for the Network Server and Client can
be found on our website (www.astraia.com) in Products - System Requirements.

astraia Network Server Installation

Important: Please note an astraia network installation should only be undertaken by the
respective system/network administrators or individuals with equal computer and/or
networking expertise.

Step 1. Insert the astraia 1.17.74 CD into the CD Drive of the computer which is to be the server. It
will start automatically. If not, open the explorer, open the CD drive, which is labeled "Astraia 1.17.74"
and click on "autorun.exe".

After you have chosen to install the full version, you will be asked to select the language to use during
the installation. Select the proper language and click Ok.

On the next screen, you will see which astraia version you are about to install.
Once you have pressed 'next' you will be asked to accept the license agreement shown in order to
continue the installation. Please read it carefully and choose "accept" if you agree. If you do not accept
please press "cancel" and then terminate the installation.

On the next screen, please select "Network server installation". Press "next" to continue.

Choose the installation directory. You can either accept the default path (recommended) or you can
click on "Browse" and select the directory you want to install the astraia application to.
Please specify now, how much memory should be available for the astraia Program (64 MByte for the
program without image viewing, 200 MByte for the program with image viewing). Press "next" to
continue.

In the following screen, you will be asked, which database you want to use. You can chose between
Sybase (European)", "Sybase (Unicode)", which allows all characters,
"MS SQL Server", "Oracle 7/8" and "Oracle 9/10". Press "next" to continue.
Specify the name of the Start Menu folder, where you want to have the astraia shortcuts.

Press "next" again, on the following screen, you will see a summary of your selected options. Press
"install" to finish the installation.
On the next screen you should be told that astraia has successfully been installed. Here you have the
possibility to start astraia directly after the Installation by activating the checkbox. Click on "Finish" to
terminate the installation.

Step 2. Install Sybase as a Network Server and add a Sybase service (see Installing Sybase as a
Network Server).

Step 3. Start astraia and enter your network license (see How to enter the astraia Network License).
Open the "Administrator"-Tab in "Options", and change the database URL so that instead of
'localhost' you specify the name of the database server machine (replace 'localhost' in the URL with
'SERVERNAME').

Step 4. Installing the Network Client Version. On each client on which astraia will run the Network
Client version needs to be installed:

Insert the astraia CD Version 1.17.74. It will start automatically. If not, open the explorer, open the CD
drive, which is labeled "Astraia 1.17.74" and click on "autorun.exe".

After you have chosen to install the full version, you will be asked to select the language to use during
the installation. Select the proper language and click Ok.

On the next screen, you will see which astraia version you are about to install.
Once you have pressed 'next' you will be asked to accept the license agreement shown in order to
continue the installation. Please read it carefully and choose "accept" if you agree. If you do not accept
please press "cancel" and then terminate the installation.

On the next screen, please select "Network client installation". Press "next" to continue.
Choose the installation directory. You can either accept the default path (recommended) or you can
click on "Browse" and select the directory you want to install the astraia application to.

Then you will be prompted to input or browse to the astraia Server path which contains the
"astraia.jar". It could look like this: "\\Server\Astraia\astraia.jar"
Specify the name of the Start Menu folder, where you want to have the astraia shortcuts.

Press "next" again, on the following screen, you will see a summary of your selected options. Press
"install" to finish the installation.
On the next screen you should be told that astraia has successfully been installed. Here you have the
possibility to start astraia directly after the Installation by activating the checkbox. Click on "Finish" to
terminate the installation.

Note: If individual clients do not have a CD drive install the "Network Client" version directly from the
server. In order to do this the setup.exe file (on the CD in the "Windows\VM" Folder) needs to be
copied to a folder on the harddisk of the server. The installation is analogous to the above (Step 5).

Step 5. You must ensure that a backup of your database is run at least daily. Even if your server is
backed up on to tape or DAT the database file is 'live' and cannot be directly copied. The simplest way
to do this is to configure and start the astraia Backup Service.

Therefore you have to open the astraia Services and select "Configure" next to "Database Backup".
Afterwards you have to specify the backup path of your database backup, the name of the database
(normally astraia) and the server name. Then chose how often you want to run a backup, we
recommend daily, and when you want to run it. If possible, the database backup should be done before
the server backup. Now press "Run" in order to test of the backup works. If you now press "Start" in
the Service Manager, the backup service will be installed and run even after restarting the computer.

The description above applies to Sybase, but with the exception of steps 2 and 5, applies to Oracle and
SQL Server installations as well.

The Sybase installation provided includes a Netware version. We have not tested this, although there is
no reason why it should not work perfectly well with astraia.

Update an existing astraia Network Server Version

Everything described in the following section refers to the astraia Server installation:

If you want to update an existing astraia Network Version be sure to stop and start the database
service(s) before running the update. To do this start the Program Sybase Central ("Start",
"Programs", "SQL Anywhere 9", "Sybase Central") find the astraia database service and stop this
via the menu or the right mouse context menu. After you are sure that the service has stopped, please
analogous to the stopping of the service, start it again. Note: A service in Sybase Central is symbolized
as stopped with a red traffic-light, and as started with a green traffic-light. If you have more than one
astraia service running please make sure all of these have been stopped and started.

It is strongly recommended to backup your astraia installation folder before you continue
updating!

If you have a previous astraia Demo or Full version installed on the and have entered and saved any
patient data, reports or similar we strongly recommend that you make a back-up of your entire Folder
"Obgyn" before installation or update. To do this simply copy the Folder "Obgyn" by marking it and
simultaneously pressing "Ctrl" and "C" and then pasting it ("Ctrl" and "V") in a separate 'safe' Folder
(we would prefer you to name this pasted folder 'Obgynxxyyzz' ('xx' being the year, 'yy' the month
and 'zz' the day of the installation e.g. "Obgyn070124" for the 24th of January 2007). Note: If a
database has been installed and a service of this is active, it must be stopped before a back-up can be
made.

Important: Please note that astraia will not be held liable for any data deleted or lost during
the update process or use of the application. If there is any doubt please contact us at
astraia and we will gladly assist you (see astraia Contact Details).

Insert the astraia CD Version 1.17.74. It will start automatically. If not, open the explorer, open the CD
drive, which is labeled "Astraia 1.17.74" and click on "autorun.exe".

To start the installation click on "install". After this please choose "full version", you will be asked to
select the language to use during the installation - click Ok.
The installer wizard appears showing you which version of the astraia software you are updating to.

Once you have pressed 'next' you will be asked to accept the license agreement shown in order to
continue the installation. Please read it carefully and choose "accept" if you agree. If you do not accept
please press "cancel" and then terminate the installation.
On the next screen, activate the "Update a previous installation" option and click on "next".

Choose the directory in which the existing astraia version is installed. You can either accept the default
folder (if this is where your previous astraia installation is) or you can click on "Browse" and select the
respective directory. Press "next" to continue. The installation wizard will tell you the previous
installation type, if it has found an existing astraia installation in the selected path.
Specify the name of the Start Menu folder, where you can find the astraia program.

Press "next" again, the setup will then stop the running services. After having stopped the services,
you will get the summary and information about your services (if they existed and if they have been
stopped).
Press "install" to finish the installation. On the next screen you should be told that astraia has
successfully been installed. Here you have the possibility to start astraia directly after the Installation
by activating the checkbox. Click on "Finish" to terminate the installation.

Start the astraia application; you will be asked if you want to update your database. Click on 'yes' and
the update will start. This may take a few minutes. After the update is finished, click on 'OK' and
proceed as normal.
Installing Sybase as a Network Server
This information will guide you through the installation of a Network Server license of the astraia
application including an authenticated Sybase SQL Anywhere 9 version.

1. Preparation

Insert the astraia CD. It will start automatically. If not, open the explorer, open the CD drive, which is
labeled "Astraia 1.17.74" and click on Autorun.exe.

2. Install Sybase

Click on "browse" and select the Sybase directory in the Explorer - start the Sybase Setup by double
clicking on Setup.exe.

After you selected the Country or region for your Sybase installation, accept the license agreement
and continue the installation with Next. The installation dialogue will start and guide you through the
installation process.

3. Select components

For the installation of a Network database server, please follow the screen shots shown below to install
a network license, click Next when finished.
4. Enter Name, Hospital and number of Network licences

In the next step please enter the your Name, the name of the clinic/hospital and the number of licensed
seats. In addition enter whether these are CPU-based or per/seat licenses. Click Next when finished.
5. Choose Location

Please determine the installation folder for Sybase SQL Anywhere 9. Choose either the default folder or
place it on the same drive of your computer where astraia is installed, click Next when finished.

6. Choose Shared Component Location

Either you choose the proposed folder or follow the same principle as above, click Next when finished.

7. Select Program Folder

The setup will add a program icon to the specified folder. Select the folder proposed and click Next.

8. Review Selection

Before copying files, check the selected settings. If you agree click Next to continue, otherwise click
Back to change the settings.

9. Finish Installation

When the setup is completed click Finish. After the installation is completed you will need to restart
your computer. Remove the CD before you do so.

10. Create a Service to Start the Database

For Windows NT / 2000 and XP :

 • Start Sybase Central: "Start", "Programs", "SQL Anywhere 9 ", "Sybase Central"

• in the left column select Adaptive Server Anywhere 9 (1)

• go to the TAB Services in the right column (2)

• right mouse click in the empty field and select NEW - Service (3)

• name: astraia

• select Network Database Server

• default path is recommended for executable file

• The parameters should be -ct -ti 0 -n astraia -x tcpip{serverport=2638}

"c:\astraia\astraia.db" (which is the normal installation path for astraia, check whether it is
correct for the given installation)

• select local system account

• start: automatically

• allow service to interact with the desktop

• click on "start the service now"

• Finish

How to enter the astraia Network License

In order to enter your network license please follow the following steps:
Step 1: Press the button Register Now if you enter your license for the first time. If you want to re-
license your application please click on the menu Help in the astraia program and choose License.
In this window please click on Re-license application.

Step 2: In the field provided please enter the astraia software license string. If you have received the
string from astraia via e-mail it is possible to enter the key using copy-and-paste by first marking the
entire key, copying it (via "Ctrl + C" or the right mouse button context menu) and then pasting it (with
"Ctrl + V"s) into the license field.

Step 3: In the field Name or Organisation please enter the name of the clinic/hospital or of the
doctor.

Step 4: After pressing Register Application, you can see an overview of the respective modules
licensed.
Miscellaneous
For security, the astraia folder can be made read-only. The folders .config and .log under astraia must
be accessible to all users for reading and writing. Each astraia client machine creates and updates a file
called astraia_XXXX.properties in the .config folder (where XXXX is the client machine name); all
astraia users have a similar file, named user_XXXX.properties.

Error reports are stored in the .log folder.

astraia Contact Details

Please mail tech@astraia.com if you need support, or contact:

astraia software gmbh

Occamstraße 20
D-80802 Munich
Tel: +49 89 127 1147-0
Fax: +49 89 127 1147-17

A log file is used to record program events and errors. You can find this file, astraia_err.log, in the
astraia .log folder (usually C:\Astraia\.log on the Server). If you have e-mail, please send this file with
any problem report, and also send the following details:

• platform (Windows/Mac/Unix)

• operating system

• system RAM in MB

• language used

• database used (Sybase/Microsoft SQL Server/Oracle)

• astraia Version (you can find this in the menu Help - Info)

astraia version 1.17.74 (Date: 24.01.2007) P. Grosselfinger, T.Zellner, S. Kolb