Follow

Installing the server on Linux

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

 

Interactive setup

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.

 

Non-interactive setup

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.

Example:

 

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:

  1. Create a group and user that will run the service. Remember to set a sudo password for this user.
  2. Download the Hansoft Server.
  3. Move the Hansoft Server zip file to the directory of your choice (“opt” for instance).
  4. Unzip the Hansoft Server files in the new location.
  5. Change ownership of the Hansoft Server and all its content to the user and group made in step 1.
  6. Switch to the above mentioned user.
  7. Run the command “./HPMServer -ResetAdminPassword” from the HansoftServer directory. This will allow you to set a Server Administrator password.
  8. Run the command “./HPMServer -Service <service name> &” from the HansoftServer directory. This will add and start the service.

Now use either the command line or the Hansoft Server Administrator client to create a database and setting database administrator passwords.

Next steps

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.

You can also use the command line or the Hansoft Server Administrator client to create additional databases and changing database administrator passwords.

Was this article helpful?
0 out of 1 found this helpful
Have more questions? Submit a request

Comments

  • Avatar
    Marcus Liebhardt (Yujin Robot)

    Installing the sever on Linux. Installation seems to have work fine. Now, it's not clear what to do next?

  • Avatar
    Igor Yampolsky

    Ubuntu 17

    "Successfully installed service at /etc/init/hansoft.conf
    Failed to start service.
    Error starting service hansoft
    Command start hansoft returned with code 1: initctl: Unable to connect to Upstart: Failed to connect to socket /com/ubuntu/upstart: Connection refused
    Failed to start service.
    Service Error

    "

    Edited by Igor Yampolsky
  • Avatar
    Erik Mats

    @Igor This is a known bug which we are tracking as #6147. Hansoft cannot run as a service on Ubuntu 16. Until this is fixed you need to run the server as an application instead:
    sudo ./HPMServer -RunAsProgram

    Please reach out to us at support@hansoft.com if you have continued problems with this.

    Best regards
    Erik (Hansoft)