Language:


Loading an Existing Database and Company

Follow the procedures described on this page when you need to launch the HansaWorld Enterprise application when you already have an existing database containing at least one Company.

Server - Command Line and Service Applications
In a multi-user installation, launch HansaWorld Enterprise on the server first.

If your server is a Linux or Mac OS X machine, make sure it is in "Terminal" mode. Type the following into the Terminal window (the examples assume you have retained the default directory structure):

cd /Applications/HansaWorld/hansaworld-linux-release-server (Linux Intel),
cd /Applications/HansaWorld/hansaworld-linuxppc-release-server (Linux PPC) or
cd /Applications/HansaWorld (Mac OS X)

./HansaWorld &
starts the HansaWorld Enterprise server application. The & is optional: it allows you to run the program in the background and to use the Terminal window for other tasks.

This assumes the application is named "HansaWorld". If this is not the case, type the application name after "./"
Remember when typing that the Terminal environment on Linux is case-sensitive.

If your server is a Windows machine, the HansaWorld Enterprise server application is a service that by default will be launched automatically when you start up the server machine. If for some reason the service does not start automatically, open the Control Panel and double-click 'Administrative Tools' and then 'Services'. Find and select 'HansaWorld Enterprise 5.4 Service' in the list and choose to start the service.

Users will now be able to log on to work in any of the Companies stored in the database on the server. To log in, follow the procedure described in the 'Single-user and Client' section below.

You can now leave the server alone.

Launching the Server with Parameters
There will be occasions when you need to launch the server application with parameters. You will need to use a parameter when you want to instruct the server application to carry out a specific task. For example, if you launch the command line server (Mac OS X and Linux) using the --backup parameter as shown below, the HansaWorld server application will open, create a back-up file and then quit:

./HansaWorld --backup
Various parameters are described in the relevant sections of these web pages.

An alternative method that you can use to launch the server application with parameters is to place the parameter in a text file named "parameters.txt" and save this file in the same folder or directory as the server application. Then, launch the server application as described towards the beginning of this page. You should only place the parameter (--backup in this example) in the "parameters.txt" file: do not include ./HansaWorld in the file.

You can place more than one parameter in the "parameters.txt" file. You can place the parameters on the same line in the file, or you can use separate lines. If you do not want the task launched by a particular parameter to be repeated the next time you launch the application, remember to remove that parameter from the “parameters.txt” file once the task has been completed.

You can use the "parameters.txt" file with every version of the HansaWorld Enterprise application (i.e. the command line application (Mac OS X and Linux), the service application (Windows) and the GUI applications). In the case of the service application, the "parameters.txt" file is the only way to launch the server application with parameters. In the case of Linux, which is case-sensitive, the filename "parameters.txt" should be in lowercase as written here.

Single-user and Client
Start HansaWorld Enterprise just like any other Windows, Linux or Mac OS X application, by double-clicking the program icon. HansaWorld Enterprise will load the database named "HANSA.HDB". If this is not present in the folder or directory, a new database will be created automatically.

If you have a single Company in your database, it will be loaded by default and you will be ready to start work. If you have more than one Company, the 'Select Company' window will appear, asking you to choose the Company you want to work in.

In a multi-user system, the 'Select Company' window will always appear, asking you to choose the Company you want to work in, even if there is only one.

Double-click the appropriate Company in the list, or highlight it and press the Enter key on your keyboard. The database is now ready to use.

---

See also: