Creating Customized Installer on Mac OS X

VALID FOR v4.x and newer.

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 VSERVER, but the same is true for _Office.

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

• You need 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.

• 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.

• Drop into Scripts folder two more small script files, which will use your installer. Uncompress files from ZIP archive.
  • vsrv_embedded_launchd_start
  • vsrv_embedded_launchd_stop
  • IF you did rename VServer_Embedded, then open these files and change names here also.

As result you should get folders that looks like this:

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 better understand 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

1) STOP Valentina Server using “launchctl unload …”

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

You can download and check our own VServer installer.

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

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

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