Installation & Configuration

Installation Notes

---

Installation Steps

1. Download and Install "Microsoft Visual C++ 2015 Redistributable Package (x64)" if not already installed. If you have already, skip this step.

Sodium is developed with C language. This package is needed to run C application.

Visual C++ Redistributable for Visual Studio 2015Microsoft Download Center

2. Download Sodium package

Download package is nightly built versions of Sodium. Do not try it on live/production database and web servers.

Please report errors/problems you encounter to the following contact points:

Developer E-Mail: [e-mail]

LinkedIn Profile Page: http://tr.linkedin.com/in/muradkarakas

GitHub - muradkarakas/Sodium-Setup: Sodium is a new Domain-specific language (DSL) especially designed for creating/developing web based CRUD applications. It has been under development at the moment but ready to be evaluated by the developers.GitHub

Youtube playlist for installation (2 videos)

3. If you are a developer, follow the instruction on Development page

Prerequisites

Category	Software	Tested on
Operation System	MS Windows 64 Bit	Windows Server 2012 64Bit Windows 10 64Bit Windows 7 Professional 64Bit
Database Server	Oracle PostgreSQL MySql (See Note No.1)	Oracle Database 18.4 Express Edition 64 Bit PostgreSQL-12.2.1 MySql
Internet Browser	Mozilla Firefox Google Chrome Microsoft Internet Explorer Opera	Latest Versions
System Resource (Port)	​	Installation script installs Sodium on port 8089 by default. If this port is used by another application, please find and open StartSodiumServer.bat file, modify port parameter and save it.

1. For ORACLE: Check the path of the "oci.dll" file is exists in the system environment variable PATH. If not, please add. Setting character encoding to UTF8 on the web server is required for Oracle. Otherwise, characters read from database cannot be seen as expected on the client browser. Please set character encoding part of the NLS_LANG value to UTF8 on web server. (Ex: TURKISH_TURKEY.UTF8). For POSTGRESQL: Check the path of the "libpq.dll" file is exists in the system environment variable PATH. If not, please add.

   For MySql:

   Check the path of the "libmysql.dll" file is exists in the system environment variable PATH. If not, please add.

   Check the "bin" folder in the MySql installation directory is exists in the system environment variable PATH. If not, please add.

2. Do not use space character in installation path. Use only ANSI characters in installation path.

Troubleshooting

If you see that dialog window below when you start SodiumServer.exe, click "Yes" since Sodium requires Administrator privilege.

If you need to change port number, find and open "StartSodiumServer.bat" file, find the http://*:8089/ text and modify the number.

If you get "HttpAddUrl failed with 183" message after you run SodiumServer.exe, this means the port number Sodium uses is already in use by another application or another copy of SodiumServer.exe. You can modify the content of "StartSodiumServer.bat" file to change Sodium port number.

If you get "SodiiumServer.exe <Url1> [Url2] ..." message after you run SodiumServer.exe, this means that you do not provide required command line parameters. Please have a look at the original "StartSodiumServer.bat" file content to learn usage of SodiumServer.exe. It is advised to run StartSodiumServer.bat file to run Sodium.

If SodiumServer.exe stop running, it may print out one of the well-known exit codes listed below;

• Exit code 101: SodiumShared.dll nor found or not accessible.

  Possible Solutions:

  • Add SodiumShared.dll file path to environment path.

  • Check file permission settings.

• Exit code 102: function is not found in SodiumShared.dll

  Solution: add SodiumShared.dll file path to environment path.

• Exit code 103: MySql C client library couldn't initialized. Possible reasons;

  • libmysql.dll is not found or not accessible

  • One of the functions required to run Sodium is not found in libmysql.dll file.

  • MySql client library version is not compatible.

  Possible Solutions:

  • Add libmysql.dll file path to environment path.

  • Check file permission settings.

• Exit code 104: SqlServer C client library couldn't initialized.

• Exit code 105: SodiumApp.dll couldn't loaded.

• Exit code 106: Function in SodiumApp.dll not found: ....