Installation‎ > ‎

Installer

SSD includes an installer that will gather all required information about your environment by asking several questions and will then fully install/configure SSD.  Each numbered step below corresponds to a question the installer will ask.  Before beginning, you should read through the questions and gather all of your answers.

Note that during installation, default answers (if available), will be placed within brackets [] for you.  Press enter to select the default option, if present.  

It may be helpful for you to review the sample installer answers for your particular operating system before getting started.   Not all operating systems and software versions are represented here but reviewing these samples should give you a good idea of how to answer the installer questions for your environment.  After the installer is run, it will output an install.txt file in the same location as the installer script - if your particular os/software environment is not yet listed in the sample installer answers, please post install.txt to the Google group and it will be added so that it can help others.

Most of this tutorial assumes that you will place the SSD source in /opt on your system.  Unless there is a compelling reason to do otherwise, it is advised that you place the source in /opt.

To get started with the installer, download the latest source file to /opt and unzip it.  Change into /opt/<SOURCE DIR>/src/install and execute install.py.  Select the install option and proceed to answer the following questions.


 Step      Installer Question  Description / Explanation  Notes
 1 Enter the path to the SSD source This is the full path to the SSD source files, including the source file directory.  For example,  if you downloaded SSD-REL-2.1.tar.gz and unzipped it into /opt as recommended, then the answer to this question would be: /opt/SSD-REL-2.1
The installer should pre-select the correct path.  Just press enter. 
 2 Enter the desired local directory location The local directory includes all of the custom settings for your SSD installation.  This directory is maintained separately so that you can easily upgrade SSD without having to modify any of your customizations.  It is recommended that you also keep this directory in /opt.  Assuming you follow this recommendation, the answer to this question would be: /opt The installer should pre-select the correct path.  Just press enter. 
 3 Enter the Apache configuration directory The Apache configuration directory is the location where Apache will read additional *.conf files as part of its startup process.  On RedHat/CentOS systems, this is typically the conf.d directory but other distributions may vary.  As an example, if your configuration directory was /etc/httpd/conf.d, then the answer to this question would be: /etc/httpd/conf.d  
 4 Enter the database username This is the MySQL database user that will have access to the SSD database.  You are advised to create a MySQL user with access only to the SSD database.  
 5 Enter the database password This is the password for the user in step 4.  
 6 Enter the database server fully qualified hostname or IP address This is the database server IP address or fully qualified host name.  If the database is running locally, then enter localhost.  
 7 Enter the database port The port that MySQL is listening on.  If you have a standard MySQL installation, then enter 3306.  
 8 Enter the path to the DJango admin static files The DJango web framework includes a basic administrative interface that SSD makes use of to perform all post installation configuration.  In order for SSD to use this interface, you need to input the location of the static DJango html assets.  The location will depend on where DJango was installed.   The installer should pre-select the correct path.  Just press enter. 
 9 Enter the uid of the apache user The user account that runs the Apache web server needs access to the SSD local settings files so that it can read the database credentials and write certain files.  The installer will ensure that only this user account can read the configuration files.  
 10 Enter the path to the Apache mod_wsgi.so module The location of the Apache mod_wsgi.so module.  Depending on your version of Apache, this module will be located in different places on the file system.  If you are unsure, perform a file system search for mod_wsgi.so.  The installer will ask you if it may search for the files, select y.  Once found the installer will pre-select the correct path.  Just press enter.
 11 Enter the path to the screenshot upload directory When users report incidents, they will have the option to upload screenshots, which must be stored on the local filesystem.  This directory will be made writeable by the user entered in step 9.

NOTE: On multi server SSD installations (2 or more Apache serves), this location will need to be shared via NFS or another file serving/sharing technology.
The installer should pre-select the correct path.  Just press enter.