Skip to main content

Installing as Windows service

Preparations

Installation media

Download the installation media, the server zip archive. If you don´t have a download URL, ask your contact at Solme AB to get one. The downloadable unit is entitled  "se.solme.avix.server.product-win32.win32.x86_64.zip" or similarly. 

 

Unzip zip Archive

Unzip the server zip file at the host where you intend to install it. 

Avoid white spaces in the path! 

The unzipped content will look like this:

Bild3.png

 

Carry-over

This is only relevant, if you have an existing server installation, i.e. if you are upgrading to a newer server version. The server has some settings and configuration files, which you will need to carry-over (copy) to the new installation. 

  • The database folder (in case internal h2 db has been used)
  • configuration/se.solme.avix.prefs
  • load_storages.xml
  • repositories.xml
  • host.id
  • Also, check that the jvm parameters are to your liking
    • They are reset when re-installing (as per contents in "register_service.bat" script)
    • Set options for the service can be reviewed by running commons-daemon/SolmeAviXServer.exe service manager application.
      • Should you change say the XMX, a restart of the service is needed.

Before the next step, installing the service, it is recommended to stop the "Solme AviX Server Service" in the Windows Services manager. 

 

Install as Windows Service

  1. Open a command prompt with administrative privileges
    1. Press Windows key to open the Start menu. Start typing "cmd" to get Command Prompt application to appear
    2. Right-click and "Run as administrator"
    3. image-1645695197793.png
  2. In the opened Command prompt, navigate to the unzipped AVIX server directory
    1. Tip: use the change directory command. Example: "cd .." to move one step up. "cd temp" to open a directory called temp.
    2. Tip: The command "dir" will display contents of current directory.
  3. Assert you are in the root directory of the AVIX server. Using the example screenshot from the "Unzip" section above, the "C:\AVIX\Servers\se.solme.avix.server.product-win32.win32.x86_64" directory.
  4. Install the service, by running a batch script file:
    1. Type: commons-daemon\register_service.bat (tip: start typing ”co..” and press TAB)  Press "Enter" to run the installation script. 
    2. image-1645695828633.png

 

Verify service installation

Open Windows Services manager. Locate the "Solme AviX Server Service":

image-1644855304639.jpg

Verify that the service is running the AVIX server you just installed: Right-click and select "Properties":

image-1645696018871.png

 
Verify server installation

Check that ports are open (by default TCP 2036 and 45500)

In case you are working on the host where the server is installed, try: http://localhost:45500/services 

If working as intended, you should see something like this:

Bild4.png