Switch to: V11V10V9V8V7V6V5

Creating a Custom Installer for macOS

Follow these directions for deployment of Valentina Server 4.x and later.

VDN lets you create and distribute Embedded Server with your own custom solutions. You can use the following steps to package and distribute Embedded Server for your customers.

NOTE: we use in this text mostly _Embedded suffix for Valentina Server, but the same is true for _Office.

In order to create a installer, you should review the following steps.

STEP1: Prepare Folder VSERVER

  • You should install Valentina Server to your computer.

Default installation of VServer includes:

  • folder “/Library/VServer_Embedded” (or VServer_Embedded)
  • file “/Library/LaunchDaemons/com.paradigmasoft.vserver_embdded.plist”
  • COPY into other location (e.g. Desktop/PREPARE_VSERVER/Files) folder “/Library/VServer_Embedded”, which looks as
VServer_Embedded
    databases
        masterdb.vdb
        may be some other dbs
   licenses
        license_mac_xxxxxxxx
   projects
        my_project1.vsp
   VServer_Embedded.app
   VServer_Embedded.ini
   VServer_Embedded_xxxxxxxx.log
   dummy.pem
   key.pem
* REPLACE file "license_mac_xxxxxxxx" on your "license_emb_xxxxxx" file if needed. 
  • DELETE all .log files
  • OPTIONALLY but usually: delete database files in the folder “databases”.
  • OPTIONALLY: rename all files and folders to your application name. So you get the following:
MyAppServer
    databases
    licenses
        license_emb_xxxxxxxx
    MyAppServer.app
    MyAppServer.ini
  • IMPORTANT: open ini file and specify the port number for your application.
  • If you are going to use SSL you should create your own SSL keys and replace default dummy keys.

STEP 2: Prepare Folder "Scripts"

  • CREATE new folder PREPARE_VSERVER/Scripts
  • COPY to this folder /Library/LaunchDaemons/com.paradigmasoft.vserver_embedded.plist
    • If you did rename VServer_Embedded to own name, then open this file and change name here also.

As a result you should get folders that looks like this:

DESCRIPTION of Installer Steps

Now you have folders ready for installation on a customer computer. For installation you can use any Installer you prefer or Apple's Packager that is included into each OS X.

To understand better what steps must be executed on a customer computer lets consider MANUAL way to install MyAppServer.

On MacOS X it is quite simple steps. You need just:

  • COPY your folder of “VServer_Embedded” into folder “/Librarary”

So you will get “/Library/VServer_Embedded”

  • COPY 'com.paradigmasoft.vserver_embedded.plist' into folder “/Library/LaunchDaemons”.
  • START Valentina Server using SHELL command
    • sudo launchctl load /Library/LaunchDaemons/com.paradigmasoft.vserver_embedded.plist

DESCRIPTION of Deinstaller Steps

1) STOP Valentina Server using “launchctl unload …”

2) Remove from disk folder /Library/VServer_Embedded and .plist

Installer based on Apple Packager.

You can download and check our own VServer installer.

It is quite trivial. It has two items. First installs /Library/VServer_Embedded folder, second installs plist script for LaunchDeamon.

The first item before installation of a folder executes the 'vsrv_embedded_launchd_stop.sh' script. The second item after installation of plist executes the 'vsrv_embedded_launchd_start.sh' script to start vserver.

NOTE: there is no need to restart MAC OS X.