Installing/Upgrading on Red Hat Enterprise Linux 7

IMPORTANT: The information in this article is specific to Orchid version 1.12.7 or earlier.  Equivalent instructions for Orchid versions 2.0.0 and above are available in the Orchid Core VMS Installation Guide in the chapter "Installation: Working in Red Hat".

Beginning with Orchid 1.4.1, RPM files are provided and tested for Red Hat Enterprise Linux (RHEL) 7.

Installation

1. Install prerequisite packages:
        sudo yum install postgresql-libs tbb.x86_64
2. Install Orchid with the following command:
   • sudo rpm -U ipc-orchid-{VERSION}.rpm
   • Note that this will install all necessary files for the orchid and onvif_autodiscovery services. By default, these programs will NOT be started.
3. Configure Orchid using your favorite text editor.
   • vi /etc/opt/orchid_server.properties
   • The following parameters may be changed at any time, and take effect upon restarting Orchid:
   • webserver.port controls the port on which the Orchid user interface is accessed.  The default port is 80, but if your RHEL system is running an HTTP server such as Apache or Nginx, you will likely need to modify this value.
   • archivecleaner.usedspace.percentage controls the percentage of disk space Orchid will use on the volume specified in webserver.archives.rootpath.
   • The following parameters take effect only when Orchid is started for the first time (typically meaning that the Orchid database at /var/lib/orchid_server/orchid.sqlite does not exist when Orchid starts):
   • webserver.archives.rootpath specifies the directory to which video files are saved.
   • orchid.admin.password sets the admin password used upon first log in.  After the first log in, the admin password can be configured via the user interface.
   • If, during the course of your modifications, the properties file becomes malformed, Orchid may fail to start.  If this happens, check the Orchid logs at /var/log/orchid_server/ for error details.
   • Note: A default Orchid properties file is installed in/opt/orchid/orchid_server.properties.defaults and can be used as reference.
4. Enable services. This will allow the services to automatically start on bootup and restart in the case of failure.
   

   sudo systemctl enable onvif_autodiscovery.service
   sudo systemctl enable orchid.service

5. Start services.
   

   sudo systemctl start onvif_autodiscovery.service
   sudo systemctl start orchid.service

6. Configure firewall.
   
   By default, the firewalld service will block access to Orchid.  See Orchid Firewall/Ports Configuration for a list of the ports used by Orchid, and consult your RHEL 7 documentation for configuring firewalld. The following example will open default ports used by Orchid, but you should understand the security implications of modifying your firewall settings before proceeding.
   
   

   sudo firewall-cmd --zone=public add-port=80/tcp --permanent
   sudo firewall-cmd --zone=public add-port=554/tcp --permanent
   sudo firewall-cmd --zone=public add-port=40000-50000/udp --permanent
   sudo firewall-cmd --zone=public add-port=5565/tcp --permanent
   sudo firewall-cmd --reload

7. Log in to Orchid using a web browser pointed to your server's IP address at the port specified above (default is 80).  Unless changed in step 3, the default log in credentials are admin/pass.

Status

The status of the services can be checked with the following commands:

sudo systemctl status orchid.service
sudo systemctl status onvif_autodiscovery.service

Uninstall

The orchid package can be removed with the following command:

• rpm -e ipc-orchid-{VERSION}.x86_64

Note: This will remove all files installed and created by Orchid with the exception of the "orchives" directory specified at webserver.archives.rootpath in the properties file.