SOAPedia Home > Introduction Guides > SOAPware Installation Guides > Installing the SOAPware DataServer
Installing the SOAPware DataServer
Before you Begin
Before Installing the SOAPware DataServer, please read through this guide completely. If you have any questions about any of the steps, please contact SOAPware Support before beginning. If you experience any issues during the installation, please see the SOAPware DataServer Installation Troubleshooting section.
Upgrading Windows
Before installing the SOAPware DataServer, update your system to make sure that you have the latest Windows Updates installed. To update Windows, open Internet Explorer and browse to http://windowsupdate.microsoft.com/
Requirements
The following hardware and software is required for installing the SOAPware DataServer:
Hardware
- CD drive
- 1 GB RAM
- 2 GHz processor or multi core processor
- 1 GB free hard drive space
- Additional free space for database usage/growth
- Internet connection is required for SOAPware activation
Software
- Windows XP, 2003, or Vista
- Communication across port 5432
- Administrative rights for installation
Installation Scenarios
Before beginning any installation of the SOAPware DataServer, it is important to decide what type of installation is appropriate for your computing environment:
- If you have several computers in your clinic and you would like to access the same set of SOAPware databases on the server from each client computer, you will need to follow the steps in this guide only on the server. On each Client computer, you will need to follow the steps in the Installing SOAPware Guide. Most sites will use this option.
OR - If you plan to use SOAPware on one machine and one machine only, you need to follow the instructions in this guide and the Installing SOAPware Guide on the same computer.
If you are unsure what type of installation is appropriate for your environment, please consult your Network Administrator or contact SOAPware Support for assistance.
Installing the SOAPware DataServer
Before starting the SOAPware DataServer installer, log into the Server using the Administrator account; if you do not have access to the Administrator account, please contact your Network Administrator.
To start the SOAPware DataServer installation, insert the SOAPware CD and Click Install DataServer.
If the CD does not auto-run, browse to the FSCommand\SOAPwareDataServerInstaller.exe file on the CD and double click it.
Then do the following:
- The Zip Self-Extractor will want to self-extract the install files to a temporary location. Click Unzip if the default Unzip directory is ok, if not change the location with the Browse button.
Sit back and relax while the installer extracts the files – this can take a few minutes. Once the files have been extracted, the PostgreSQL Installer will automatically begin. - On the Welcome to the PostgreSQL Installation Wizard Screen, Click Next.
- On the Installation Notes Screen, read the installation notes, then Click Next.
- On the Installation Options Screen, select any other additional options that you would like to install. You can also change the installation location by Clicking the Browse button. Once you have set the appropriate options, Click Next.
- On the Service Configuration screen, type and verify the Account Password for the postgres account. This account is used to automatically start and run the Data Server when the computer starts.
Note: If the account doesn’t exist on the system, you will be asked if you would like the installer to automatically create it for you. Click Yes.
If you insert a password that the installer thinks is weak, you will be asked if you would like to replace the password. If you are confident that the password that you have selected is cryptic enough, Click No.
If you Click Yes, the installer will automatically create a password for you, but be warned, it will look fairly cryptic, like this – “XgkqU|._w,o&E!QD:<_aL)N-xtB%=Sz” . If you choose this option, write down the password, you will need it later.
Once you have set the proper passwords, Click Next. - On the Initialize Database Cluster screen, type and verify a password for the database superuser account. You will need this password later on in the installer and to use the Data Manager to make backups of your database.
DO NOT forget this password.
Once you have set the proper passwords, Click Next. - If you have selected to allow remote connections (default), Click Ok on the Remote Connection box that pops up. We will finish setting this up later.
- On the Enable Procedural Languages screen, leave the default options selected and Click Next.
- On the Enable contrib. modules screen, leave the default options selected and Click Next.
- You are now ready to finish the installation, Click Next to begin the installation.
- Postgres will then begin to install.
- During the installation, you will be prompted with a black box that says, “Password for user postgres:” this is the second password that you created, in step 6. Type the correct password into the box. You will not see any cursor movement as you type, so use caution. Once you have entered the correct password, press Enter, and the installation will continue.
The black box will then begin to report its progress:
- Once it is finished, Postgres and the default databases have been installed.
Now that you've successfully installed the SOAPware DataServer, let's take a look at configuring it for use.
Configure the SOAPware DataServer
Before installing and using SOAPware, you will need to configure the server for use. You will first need to configure the connection settings and then the memory usage.
Configure Connections
- Click on the Start Menu, Programs, PostgreSQL 8.x, Stop Service.
- If you enabled remote connections and would like to connect other computers to this data server, you will need to add a line to a configuration file. Click Start, Programs, PostgreSQL 8.x, Configuration Files, and then Edit pg_hba.conf.
- The file will then open in Notepad.
- Scroll down until you see the line:
host all all 127.0.0.1/32 md5
Immediately below this line, add the following:
host all all 0.0.0.0/0 password
Do not alter any other portion of the configuration file.
- Click File, Save.
Configure memory usage
- Click Start, Programs, PostgreSQL 8.x, Configuration Files, and then Edit postgresql.conf.
- The file will then open in Notepad.
- Edit the shared_buffers line to: shared_buffers = 128MB
- Click File, Save.
- Click Start, Programs, PostgreSQL 8.x, Start Service.
Uninstalling the SOAPware DataServer
Before uninstalling the SOAPware DataServer, please make sure that you have a current backup of the SOAPware Databases. In addition, please be aware that if you uninstall the SOAPware DataServer, you will not be able to run SOAPware unless you install the SOAPware DataServer on another system and connect the Client machines to that system.
To uninstall the SOAPware DataServer, Click Start, Control Panel, Add/Remove Programs. If you are unable to find the Windows Control Panel, then Click Start, Run and in the command box, Type, control appwiz.cpl and Click OK.
This will open the Add/Remove Programs dialog. Scroll down and Select PostgreSQL 8.x and Click Remove.
You will then see the Add or Remove Programs confirmation screen.
Confirm the uninstallation by Clicking Yes, and the uninstall process will begin.
Uninstalling PostgreSQL will not delete the data folder, which is by default:
C:\Program Files\PostgreSQL\8.x\data
This is a feature of the installer so databases aren’t accidentally removed from the server.
If you need to fully remove SOAPware DataServer from a system, you will have to manually delete this folder. It is HIGHLY advisable that you make a backup copy of this folder first.
You will also need to remove the postgres User Account from the system. Click Start, Run and in the command box, Type, lusrmgr.msc and Click OK.
Select the Users folder. 
Select the postgres account and press the Delete key.
Click Yes on the confirmation box.
Now the SOAPware Postges DataServer, files, and accounts should all be removed.
Contacting SOAPware Support
If you need any assistance during the SOAPware DataServer installation, or if you would like to schedule a free installation by one of our trained technicians, please feel free to contact SOAPware Support.
It's always a good idea to have the following information immediately available when you contact SOAPware for support. The more of this information that you have available, the faster that they will be able to address your issue.
- Your SOAPware account number (this is usually your main clinic phone number).
- The version of Windows that you have installed and any service packs. To find the version of Windows, Right Click on My Computer and Select Properties. The Version is listed on the General Tab under System.
- The version of SOAPware that you have installed or have a question about. To find the version of SOAPware, Click Help, About SOAPware.
To view all of the options for contacting support, please visit: http://www.soapware.com/support/
SOAPware DataServer Installation Troubleshooting
Windows XP Firewall
If you are running Windows XP Service Pack 2, and you receive a firewall notification when starting SOAPware, please Click Unblock when prompted.
Firewall issues
Edit section
SOAPware requires communication across port 5432 in order to run. If you receive the following error:
Please check that you entered the server name correctly and that the port on the server is not being blocked.
Please refer to the Data Server installation instructions for configuring the server.
You will need to make sure that port 5432 is not blocked by your firewall. Please consult your firewall documentation for information on unblocking this port. You will not be able to run SOAPware while this port is blocked.
