Installation

The installation of a Standard ERP system is technically simple. If you are used to computers and have some experience of installing software, you will find the installation of Standard ERP very straightforward.

You can use Standard ERP in many environments: Windows, macOS, Linux, iOS, Android and AIX. In this chapter, we describe the installation procedures for Windows, macOS and Linux Server. Please contact your local HansaWorld representative for details about the other environments.

---

In this chapter:

Go back to:

Installation

Please refer to the following pages for details about installing Standard ERP:
---

Go back to:

Installation - Multi-user

This page describes how to create a multi-user Standard ERP installation. Please refer here for details about creating a single-user installation.

---

In a multi-user Standard ERP installation, you can locate the server application and database in one of three places:

  1. In the HansaWorld cloud.

  2. In a non-HansaWorld cloud.

  3. On your premises.
In all three cases, you will control the server remotely from a web page known as your MyStandard page. This allows you to control the server wherever you are from any device. If your server is located in the HansaWorld cloud, it will be connected to your MyStandard page automatically. If your server is located in a non-HansaWorld cloud or on your premises, you will need to install a "Cloud Node" on the server machine to connect it to your MyStandard page. Through your MyStandard page, you will be able to start, stop and restart your server on demand, resolve server issues, manage recoveries and routine backups, securely store important files on your own cloud drive and ensure the version of Standard ERP is always up to date. The MyStandard page is described in more detail here.

After installing the server application, the next step will be to create and configure a new database. This process will depend on where the server will be located. If your server will be located in the HansaWorld cloud, it will be installed for you by your HansaWorld partner or by us at HansaWorld. Please refer to the links at the end of the page for the steps that you should follow after your server has been installed. The remainder of this page will outline the steps that you need to follow to install your server in a non-HansaWorld cloud or on your premises.

The Standard ERP server application is available as a command line application (for Linux and macOS) or a service (for Windows) version of Standard ERP as your server application. These versions do not have graphical interfaces. This allows their speed to be optimised, and also reduces the risk of users causing them to quit accidentally.

It is recommended that you use the Standard ERP client application (with graphical user interface or GUI) to create a new database and carry out the initial configuration work described in this manual, effectively working single-user. When you have completed the configuration work, you can then open the new database using the command line or service applications (depending on platform), making it available to the network and allowing users to log in. You can do this as follows:

  1. If the server machine has a graphical interface and is accessible, you can install both the GUI and command line or service versions of the application in the same folder on the server. Use the GUI application to create the database and carry out the initial configuration work. When you are ready to make the database available to the network, close the GUI application and start the command line or service application. Because both applications are in the same folder, they will both automatically open the same database.

  2. If the server machine does not have a graphical interface and/or is not accessible (e.g. it is in the cloud), you should install the command line or service version of the application on the server remotely. Using the GUI application on a local machine, create the database and carry out the initial configuration work. When you are ready to make the database available to the network, copy it to the folder on the server containing the command line or service application. The file that you should copy will be named "HANSA.HDB". You should also copy the "Attach" folder if you added any Attachments. Then, remove the database from the local machine or at least move it out of the folder containing the GUI application. This will prevent the possibility of saving data in the wrong database. Finally, start the command line or service application on the server remotely.
The diagram below illustrates these two options:

Proceed as follows:
  1. Create a network including all the computers and other equipment you are going to use. Use the Windows, macOS or Linux installation tools to install and configure TCP/IP on each machine.

  2. Click the link to go to our product download website, standardinstall.com.

  3. Choose your platform, country and product (Standard ERP) from the drop-down menus at the top of the page.

  4. Download the appropriate versions for your platform and operating system. The versions you should download and install are as follows:

    Standard ERP Server YYYY-MM-DD
    Use as the server application (for Windows, separate downloads are available for 32- and 64-bit machines. .NET Framework 4.7.2 or later must be installed)

    Standard ERP YYYY-MM-DD
    Use as the client application. Also use as a GUI application (i.e. application with graphical user interface) on the server for initial configuration work only

  5. For Windows, the server version of the Standard ERP application is a service. A service is an application that runs in the background with no user intervention. Services are usually launched automatically when the server starts up.

    The server application is supplied as an installer file. Launch the installer by double-clicking, and follow the instructions on screen. The installer will install the application as a service, so that it appears in the services registry..

  6. If your server is a macOS machine, the command line application is supplied as a .dmg file. Open the .dmg file by double-clicking, and then copy its contents to the 'Applications' folder on your server.

  7. If your server is a Linux machine, install the appropriate command line application as described on the Linux Server Installation page.

  8. For all platforms, if the server machine has a graphical interface and is accessible and you want to create your database and carry out the initial configuration work using that machine, install the relevant GUI version of the application in the same folder or directory as the command line or service application. To do this, follow the procedure described on the Single-user page.

  9. Install the relevant GUI versions of Standard ERP on each of the client machines, again as described on the Single-user page.
Having successfully installed Standard ERP, follow these steps to create the new database and carry out the basic configuration that is needed to get started:
See also:
---

Go back to:

Installation - Linux Server

This page describes installing the Linux version of the Standard ERP server installation. Please refer here for details about creating a multi-user installation as a whole.

---

If your server is a Linux machine, you should use the relevant command line version of the Standard ERP application as your server application. If the machine itself has a graphical interface and is accessible, you can install this application following the procedure described in step 5 on the single-user page. If the machine does not have a graphical interface or you want to use the Terminal, follow these steps:

  1. Download the latest version of Standard ERP that is correct for your platform and operating system (i.e. the Linux Command Line version).

  2. Open a Terminal window using the Terminal icon in the Dock or Panel.

  3. Type the following, remembering that the Terminal environment on Linux is case-sensitive:

    cp /Users/username/Desktop/standarderp.server.tgz /Applications
    Copies the installer file (named standarderp.server.tgz in this example) from the desktop to the "Applications" directory.

    cd /Applications/
    Makes the "Applications" directory the current directory.

    tar -xvzf standarderp.server.tgz
    Expands the standarderp.server.tgz installer file. A new directory will be created in your "Applications" directory. This new directory will be named "StandardERPServer", and will contain the application and the necessary auxiliary files.

    rm standarderp.server.tgz
    Deletes the installer file.
Having successfully installed Standard ERP, follow these steps to create the new database and carry out the basic configuration that is needed to get started:
See also:
---

Go back to:

Installation - Single-user

This page describes how to create a single-user Standard ERP installation. Please refer here for details about creating a multi-user installation.

---

To download and install Standard ERP, follow these steps:

  1. Click the link to go to our product download website, standardinstall.com.

  2. Choose your platform, country and product (Standard ERP) from the drop-down menus at the top of the page.

  3. Download the appropriate version for your platform and operating system. For a single-user installation, download and install "Standard ERP YYYY-MM-DD".

  4. Under Windows, a Standard ERP installer will be saved on your hard disk.

    Launch the installer by double-clicking, and follow the instructions on screen.

  5. Under macOS, a .dmg file will be saved on your hard disk. Open the .dmg file by double-clicking, and then copy the folder it contains to your 'Applications' folder.
On both platforms, make sure you have at least 100 MB available for the Standard ERP application, the associated files and for the data file that will be created the first time you launch the application.

Having successfully installed Standard ERP, follow these steps to create a new database and carry out the basic configuration that is needed to get started:

See also:
---

Go back to:

After Installation

This page describes the files and folders that are required by the Standard ERP application.

---

After installation, the Standard ERP directory or folder will contain a number of files:

Shown is the Windows 10 folder in a single-user installation: its appearance on your computer and the number of files and folders may differ slightly according to the type of machine you are using, its operating system and certain other settings. In the illustration, for example, all file extensions are shown. Additional files and folders (not shown in the illustration) will be created by the application the first time you use it. Some or all of the following files should be present:
  1. The Standard ERP application, named "Standard ERP.exe" (Windows) or "Standard ERP.app" (macOS).

  2. The database, always named "HANSA.HDB". This file will be created by the application the first time you use it.

  3. The "Hob" folder, containing language and other files. This must be present in the same folder or directory as the Standard ERP application.

  4. The file "DBDEF.TXT", which is used by Standard ERP to import some basic settings information to new databases. This file must be present in the same folder or directory as the program when you create a new database.

  5. The file "DEFAULT.TXT", which is used by Standard ERP to import some basic settings information to new Companies. This file must be present in the same folder or directory as the program when you create a new Company in a database. Companies and databases are described here.

  6. The "Setup" folder or directory, which contains a number of set-up files, including Form Template designs and a chart of Accounts. You can import some or all of this set-up information to your database and then modify it to suit your own requirements. Depending on those requirements, it may be easier to do this than to start from scratch. This is especially recommended in the case of Form Template designs. The names and contents of these files will vary according to the country of use. Please refer to the Importing Set-up Data page for details about the contents of these files and importing them.

  7. The "Sample" folder or directory, which contains a back-up of an example database. You can import this file to a new database to test new or unfamiliar Standard ERP features before using them in your "live" database. The name and precise make-up of these files will vary according to the country of use. Please refer to the Creating a New Database - Sample page for details about importing this file.

  8. Two extra folders, "PS" and "Scripts", will be present in Linux installations.

  9. A StandardERPServer-Slave application will be included in installations of the server application only. This is a client application with no interface that can be used as external mail or TAPI gateways. Please refer here for more details about external mail, and here for more details about the TAPI gateway.
The following folders will be created by the application the first time you use it:
  1. An "Attach" folder, which must be present if you want to use the Document Manager to attach files to records. The Document Manager is fully described here. In multi-user installations, this folder should be on the server machine.

  2. The "tmp" folder is used for two purposes. First, if you read an attached file (i.e. a file in the Document Manager), it will be copied to the "tmp" folder on your client machine and then opened in the relevant application. Second, it should be present on the Gateway machine if you will be using the Standard ERP Mail facility to send and receive external mail (i.e. to communicate with standard email programs outside your Standard ERP network). The HansaWorld Gateway uses it to store mail attachments downloaded from the POP3 server before they are transferred to the "Attach" folder and attachments that are to be uploaded to the SMTP server. The Standard ERP Mail facility is described here. This folder will be created by the application the first time you use it.

  3. A "Backup" folder or directory, to be used for storing daily back-up files.

  4. If you are using the Autoscan Import feature, any files placed in the "Import" folder or directory will be imported to your Standard ERP database automatically. Please refer to the Imports page for details of this feature.
The following folders should be present if you wish to use certain features, but otherwise need not be present:
  1. If you would like your company logo to be shown in the Navigation Centre, save the logo as a .png file with the name "companylogo.png" in your Standard ERP folder. The maximum width of the logo should be 80 pixels, and the maximum height 32 pixels. This feature is macOS only.

  2. The "Halcust" and/or "Halpatch" folders contain bespoke (HAL) files (e.g. customised reports). If you have one or both of these folders, they should be on the server and on all clients likely to use the bespoke files.

  3. The "Web" folder contains language and other files required if you wish to use the HansaWorld Web Shop. This folder should be on the server machine.

  4. The "Webcust" folder is used to store images used in the Web Shop (e.g. images of the Items that you sell). This folder should be on the server machine.
---

Multi-user Installation:

Single-user Installation:
See also:
Go back to: