The SysOrb Server is a fairly complex piece of software, yet the installation itself is simple. Please refer to Chapter 6 for detailed installation instructions for your particular server platform.
The Server may be able to run with its default configuration right after the install completes, but it is recommended that the configuration section is consulted before actually running the Server.
The SysOrb Server installation also contains the SysOrb Web interface. This section will not describe setup of any specific web-servers. The SysOrb Web Interface consists of CGI programs, which will work with any web-server supporting the CGI standard.
Notice for IIS users: Please make sure that you do not have third-party scripting extensions installed on the web server on which you will run the SysOrb Web interface. It is a common problem that these tools will attempt to interpret the SysOrb CGI programs as scripts written in some interpreted language (such as Perl). This will result in a non-functional SysOrb Web interface installation!
The SysOrb Web interface CGI programs are standard Win32 executables, and unless the configuration is overwritten by third party products, a standard IIS will work out of the box with SysOrb.
It is possible to manually override the third party scripting product configuration in the web server, to work around this problem and run both the scripting product and the SysOrb Web interface on the same web server. Please refer to the IIS documentation, or send an e-mail to
<support@sysorb.com>for assistance in this matter.
You can install the Web Interface wherever you please, you can even run a SysOrb Server on one platform (say, Solaris) and the Web Interface on another (for example Windows). If you do not want to install a Web-server on the SysOrb Server machine, you can install the SysOrb Server package on any other machine, and then disable the SysOrb Server there so that only the web interface remains active.
Note: When the SysOrb Web Interface is installed, you can use it to access and configure the SysOrb Server. The Web Interface will ask you for a username/password. For the default configuration this is:
Username: admin
Password: admtest
Domain: . (or just leave blank)
After you have logged in for the first time, make sure to change at least the password for the admin user. For more information about how to use the Web Interface, please refer to User's guide for the SysOrb Monitoring System.
To install the SysOrb Server on machine running a Microsoft Windows operating system, you must have administrator access to that machine. Please make sure that you are logged on as the Local Administrator, or as another user with administrative privileges on the local machine.
The full Server and Web interface installation is contained in the file:
sysorb-server-3.4.0-4023.win32.ia32.exe
Download and run this file, and follow the instructions on screen during the install process.
Note: On the download page for SysOrb it is also possible to download an installation guide for Windows, which contains a screen for screen walk-through of the installation process.
During the installation you will be asked for a login and password for the user the Server should run as. If, after installation, you get an error page in your browser instead of the SysOrb Login page, or if the installation process cannot start the SysOrb Server, please check that the "SysOrb Server" service is running in the Service Control Manager. If this service is not running, chances are that the password for the service account was mistyped. You can correct this password in the Service Control Manager (by right-clicking on the "SysOrb Server" service and selecting "properties").
When the installation is finished you need to install your license file, if you have purchased SysOrb. See Section 3.2 for more information about how you do this. If you just want to test SysOrb, a test license is included in the installation.
Although the server is normally run with its default configuration from the installation procedure, it is recommended that you consult Chapter 6 for a more thorough description of all available configuration options.
The web-server should allow execution of CGI programs, and should be able to use the file index.cgi as the default for a directory. Apart from that, there are no special requirements for the server to work with the SysOrb web interface.
You should be able to see either an error page (showing a white background and an information-icon) from the SysOrb Web Interface if your SysOrb Server is not running, or you should see the login page.
If you cannot get to the SysOrb Login page, please refer to the "IIS Notice" at the very beginning of Section 3.1 for further information.
Red Hat 6.2 users should acquire the file:
sysorb-server-3.4.0-4023.rh62.ia32.rpm
Users of newer Red Hat releases should acquire the file:
sysorb-server-3.4.0-4023.rh72.ia32.rpm
Note: The Red Hat 7.2 package also works on all newer releases of Red Hat, i.e. 7.2, 8 and 9, Fedora and RHEL.
These files contain the entire SysOrb Server software package, and are available for download from http://www.evalesco.com.
In order to install the SysOrb Server, you must have root access to the system.
Install the SysOrb Server using your favorite RPM utility (for support on the RPM utility, see http://www.redhat.com), or using the plain rpm command:
rpm -Uvh sysorb-server-3.4.0-4023.rh62.ia32.rpm
You now have a SysOrb Server configured on your system. If you have purchased SysOrb, you will need to install your license file (See Section 3.2 for information about how you do this). See Chapter 6 for information on how to configure your newly installed SysOrb Server.
Type /etc/rc.d/init.d/sysorbd start to start the server for the first time. Per default SysOrb is set up to automatically start in runlevel 3 and 5.
The installation script will automatically configure an alias in your apache configuration for the SysOrb Web interface.
Note: The installation script tries to add the Alias to the Apache configuration files in /etc/httpd/conf/. If your system does not have the configuration files in this directory edit them manually to export the directory www in the SysOrb Web Interface installation directory as /sysorb/. Make sure you allow execution of CGI scripts. If you installed the SysOrb Web Interface from the above mentioned RPMs, the SysOrb Web interface installation directory is /var/sysorb/www.
Remember to restart the Apache web server after having installed the SysOrb Web Interface. The web server must re-read its configuration in order to recognize the new /sysorb/ alias.
When this is done, you should be able to see the login page (or an error page if your server is not yet running), by going to the URL http://localhost/sysorb/.
Note: If you are using a SELinux enabled Red Hat distribution, and are using SELinux policies on your web server, you have to perform the following steps for the webinterface to work:
cd /var/sysorb/www chcon -t httpd_sys_content_t *.{png,gif,css,js} chcon -t httpd_sys_script_exec_t *.cgiOnce these commands have been run, the webinterface will work. However, an audit will be generated each time one of the cgi-files are executed. In order to disable this audit, the selinux-policy-targeted-sources package must be installed. Once this is installed, perform the following steps:
cd /etc/selinux/targeted/src/policy/ echo "dontaudit httpd_sys_script_t ld_so_cache_t:file execute;" >> domains/misc/local.te make reloadAfter this the audit message will be disabled.
If you have trouble getting this to work, please take a look in the error and access logs from your web-server. These logs often help by pointing out errors in the configuration files.
Debian users should download the entire SysOrb Server software package named:
sysorb-server-3.4.0-4023.debian22.ia32.deb
In order to install the SysOrb Server, you must have root access to the system.
Install the packages with command:
dpkg -i sysorb-server-3.4.0-4023.debian22.ia32.deb
You now have a SysOrb Server configured on your system. If you have purchased SysOrb, you will need to install you license file (See Section 3.2 for information about how you do this), before starting SysOrb. Please consult Chapter 6 for detailed information about all possible configuration parameters.
Type /etc/init.d/sysorbd start to start the server for the first time. Per default SysOrb is set up to automatically start in runlevel 2.
The installation script will automatically configure an alias in your apache configuration for the SysOrb Web interface.
Note: The installation script tries to add the Alias to the Apache configuration files in /etc/apache/. If your system does not have the configuration files in this directory edit them manually to export the directory www in the SysOrb Web Interface installation directory as /sysorb/. Make sure you allow execution of CGI scripts. If you installed the SysOrb Web Interface from the above mentioned debian package, the Web-interface is located in /var/sysorb/www.
Please remember to restart the Apache web server after having installed the SysOrb Web Interface. The web server must re-read its configuration in order to recognize the new /sysorb/ alias.
Once this is done, you should be able to see the login page (or an error page if your server is not yet running) by going to the URL http://localhost/sysorb/.
If you have trouble making this work, please take a look in the error and access logs from your web-server. These logs often help by pointing out errors in the configuration files.
Mandrake users can acquire the file:
sysorb-server-3.4.0-4023.mdk90.ia32.rpm
This file contains the entire SysOrb Server software package, and is available for download from http://www.evalesco.com.
In order to install the SysOrb Server, you must have root access to the system.
Install the SysOrb Server using the plain rpm command:
rpm -Uvh sysorb-server-3.4.0-4023.mdk90.ia32.rpm
You now have a SysOrb Server configured on your system. If you have purchased SysOrb, you will need to install your license file (See Section 3.2 for information about how you do this). See Chapter 6 for information on how to configure your newly installed SysOrb Server.
Type /etc/init.d/sysorb-server start to start the SysOrb Server for the first time. Per default SysOrb is set up to automatically start in runlevel 3 and 5.
The installation script will automatically configure an alias in your apache configuration for the SysOrb Web interface.
Note: The installation script tries to add the Alias to the Apache configuration files in /etc/httpd/conf/. If your system does not have the configuration files in this directory edit them manually to export the directory www in the SysOrb Web Interface installation directory as /sysorb/. Make sure you allow execution of CGI scripts. If you installed the SysOrb Web Interface from the above mentioned RPMs, the SysOrb Web interface installation directory is /var/opt/sysorb-server/www.
Remember to restart the Apache web server after having installed the SysOrb Web Interface. The web server must re-read its configuration in order to recognize the new /sysorb/ alias.
Once this is done, you should be able to see the login page (or an error page if your server is not yet running), by going to the URL http://localhost/sysorb/.
If you have trouble getting this to work, please take a look in the error and access logs from your web-server. These logs often help by pointing out errors in the configuration files.
SuSE Linux 7.3 users should acquire the file:
sysorb-server-3.4.0-4023.suse73.ia32.rpm
Users of newer SuSE Linux releases should acquire the file:
sysorb-server-3.4.0-4023.suse82.ia32.rpm
Note: The SuSE 8.2 package also works on all newer releases of SuSE.
These files contain the entire SysOrb Server software package, and are available for download from http://www.evalesco.com.
In order to install the SysOrb Server, you must have root access to the system.
Install the SysOrb Server using your favorite RPM utility (for support on the RPM utility, see http://www.redhat.com), or using the plain rpm command:
rpm -Uvh sysorb-server-3.4.0-4023.suse82.ia32.rpm
You now have a SysOrb Server configured on your system. If you have purchased SysOrb, you will need to install your license file (See Section 3.2 for information about how you do this). See Chapter 6 for information on how to configure your newly installed SysOrb Server.
Type /etc/init.d/sysorbd start to start the server for the first time. Per default SysOrb is set up to automatically start in runlevel 3 and 5.
The installation script will automatically configure an alias in your apache configuration for the SysOrb Web interface.
Note: The installation script tries to add the Alias to the Apache configuration files in /etc/httpd/. If your system does not have the configuration files in this directory edit them manually to export the directory www in the SysOrb Web Interface installation directory as /sysorb/. Make sure you allow execution of CGI scripts. If you installed the SysOrb Web Interface from the above mentioned RPMs, the SysOrb Web interface installation directory is /var/sysorb/www.
Remember to restart the Apache web server after having installed the SysOrb Web Interface. The web server must re-read its configuration in order to recognize the new /sysorb/ alias.
When this is done, you should be able to see the login page (or an error page if your server is not yet running), by going to the URL http://localhost/sysorb/.
If you have trouble getting this to work, please take a look in the error and access logs from your web-server. These logs often help by pointing out errors in the configuration files.
FreeBSD users should download the file:
sysorb-server-3.4.0-4023.freebsd4.ia32.tgz
This file contains the SysOrb Server and Web interface software, and it is available from http://www.evalesco.com
In order to install the SysOrb Server, you must have root access to the system. After obtaining root access, follow the instructions below to install the software:
Type:
pkg_add sysorb-server-3.4.0-4023.freebsd4.ia32.tgz
to install the SysOrb Server.
When the installation has finished you need to install the license file, if you have purchased SysOrb. Consult Section 3.2 for information about how you do this. Otherwise a 30 day trial license is included in the package.
You now have SysOrb installed on your system. Please consult Chapter 6 for information on how to configure your SysOrb Server for operation.
To start the SysOrb server type /usr/local/etc/rc.d/sysorbd.sh start
The installation script will automatically configure an Alias in your web-server configuration for the SysOrb Web interface.
Note: The installation script tries to add the Alias to the Apache configuration files in /usr/local/etc/apache/. If your system does not have the configuration files in this directory, you need to edit them manually to export the directory www in the SysOrb Web Interface installation directory as /sysorb/. Make sure you allow execution of CGI scripts. If you installed the SysOrb Web Interface from the above mentioned Debian package, the Web-interface is located in /var/sysorb/www.
Remember to restart the Apache web server after having installed the SysOrb Web Interface. The web server must re-read its configuration in order to recognize the new /sysorb/ alias.
Once this is done, you should be able to see the login page (or an error page if your server is not yet running) by going to the URL http://localhost/sysorb/.
If you have trouble making this work, please take a look in the error and access logs from your web-server. These logs often help by pointing out errors in the configuration files.
Solaris users should download the entire SysOrb Server software package named:
sysorb-server-3.4.0-4023.solaris8.sparcv9.Z
In order to install the SysOrb Server, you must have root access to the system.
First unpack the file using:
uncompress sysorb-server-3.4.0-4023.solaris8.sparcv9.Z
You can now type:
pkgadd -d sysorb-server-3.4.0-4023.solaris8.sparcv9
You now have a SysOrb Server configured on your system. If you have purchased SysOrb, you will need to install you license file (See Section 3.2 for information about how you do this), before starting SysOrb. Please consult Chapter 6 for detailed information about all possible configuration parameters.
Type /etc/init.d/sysorbd start to start the server for the first time. Per default SysOrb is set up to automatically start in runlevel 3.
The SysOrb server must be accessed through a Web-interface, the .cgi and other files are placed in /opt/SYSOsoser/var/sysorb/www/. You must manually configure your web-server to be able to access this directory, and execute .cgi programs. Please remember to set up index.cgi as the default file to show, as the directory contains no index.html file.
Once this is done, you should be able to see the login page (or an error page if your server is not yet running) by accessing your web server.
If you have trouble making this work, please take a look in the error and access logs from your web-server. These logs often help by pointing out errors in the configuration files.