To install the Hansoft server on a Linux-based OS, start by downloading the installation package from the Hansoft website. The Debian package installation will only work on Debian based Linux distributions.
Run the installation and when asked, install the program where you want the database files to be located. You can later move the database, backup and transaction log location. The default location is however under the server program directory. /opt is a cSommon install location for optional software on Linux.
Installation process break-down
The following actions are performed by the interactive installer:
- Create a server state
- Create a database
- Create user and group to run as unless they already exists
- Register server as a system service allowing it to start at boot
- Start the service
Note that in this example we are installing version 7.1580 of the Hansoft server for Linux. Also when installing make sure that you have the appropriate installation files adjusted for your OS.(32 or 64 bit)
Start by extracting the contents of the zip file
unzip "Hansoft Server 7.1580 Linux2.6 x64.zip"
Once you have extracted the package at a desired location, navigate to the Hansoft server directory.
Run the -Install command from the HPMServer.
sudo ./HPMServer -Install
The sudo command gives you root access, which is required in order to install the server.
|Server name The name of the server|
|Server hostname The server address|
|Server port The port that will be used by the server|
Server admin password This is the password used to login to the server administrator client and is used to perform administrative tasks such as backup and restore.
|Database name The name of the database
Note: You can later create several more databases in order to attain data isolation
|Database admin password The password for the Administrator user of the database. This password is used to login to the Hansoft client and perform administrative actions for this database.|
|Service name The name of the service|
|User to run service as The user that will run the service
If the username you provided is not already associated with an existing user, Hansoft will create one for you.
|Group to run service as
If the groupname you provided is not already associated with an existing group, Hansoft will create one for you.
If you do not wish to install interactively, for example when using an installation script, you can add these commands after -Install in order to pre-define some or all settings.
|-ServerName <name>||Name of server.|
|-ServerHostname <name>||Hostname server is accessed through.|
|-Port <port>||Port server should listen to.|
|-ServerAdminPassword <password>||The password for the server administrator client.|
|-DatabaseName <name>||Create database with name.|
|-DatabaseAdminPassword <password>||Password for 'Administrator' in created database.|
|-SMTPServer <server address>||Email notifications SMTP server.|
|-SMTPPort <port>||Email server port.|
|-EmailFromName <name>||Name appearing as from on emails.|
|-EmailFrom <email address>||Email address appearing on the emails sent from the server.|
|-EmailSubject <subject>||Subject of email notifications.|
|-EmailToEmail <target address>||Email to send notifications to.|
|-Service <name>||The unique name of the service.|
|-RunAsUser <name>||The user to run the service as.|
|-RunAsGroup <name>||The group to run the service as.|
Check the server log for any problems after the installation has finished (see Chapter 2: Logs and Email Notifications).
Setting up the Hansoft service manually
Follow the steps below to manually setup the Hansoft Server as a service on your Linux machine:
- Create a group and user that will run the service. Remember to set a sudo password for this user.
- Download the Hansoft Server.
- Move the Hansoft Server zip file to the directory of your choice (“opt” for instance).
- Unzip the Hansoft Server files in the new location.
- Change ownership of the Hansoft Server and all its content to the user and group made in step 1.
- Switch to the above mentioned user.
- Run the command “./HPMServer -ResetAdminPassword” from the HansoftServer directory. This will allow you to set a Server Administrator password.
- Run the command “./HPMServer -Service <service name> &” from the HansoftServer directory. This will add and start the service.
After the installation is done and the server is listening on a port that you can access (default 50265), you may log in with the Hansoft client using the Administrator account to start creating users and projects.