Fixing issues with services and adding Readme files

Author: textanalyticsman

README.md

@@ -1,2 +1,14 @@
 # ansible-oracledb
-Using Ansible to install an Oracle datatabase 12c, I know this has been done before, but I am learning Ansible.
+Using Ansible to install an Oracle datatabase 12c and configure it. The following steps are executed.
+
+1. The OS is configured with packages and required kernel configurations to install and configure and Oracle database.
+1. The Oracle database is installed and configured using an RSP file. The RSP file is configured using templates in Ansible.
+1. The /etc/oratab is modified to allow the usage of commands to start and to shutdown the database. The file is modified using a regular expresion, through Ansible.
+1. A couple of services, to manage the database and its listener,  are created using templates to create services configuration files and an Ansible module called service to enable the services.
+1. The database and its listener are started using the Ansible module called service.
+
+This can be executed with the following line.
+
+        ansible-playbook --ask-vault-pass -i inventories/dev/hosts site.yml --extra-vars " environment_chosen=dev"
+
+The password for the vault file is Oracle.

roles/create_db_service/README.md

@@ -1,31 +1,51 @@
-Role Name
-=========
+create_db_service
+=================
 
-A brief description of the role goes here.
+This role creates a couple of systemd services to startup and shutdow the Oracle databse service and its listener. As the scripts {{ oracle_home }}/bin/dbstart and {{ oracle_home }}/bin/dbshut are used. The /etc/oratab file is modified to allow the usage of these scripts.
 
 Requirements
 ------------
 
-Any pre-requisites that may not be covered by Ansible itself or the role should be mentioned here. For instance, if the role uses the EC2 module, it may be a good idea to mention in this section that the boto package is required.
+An Oracle database has been installed using the role install_oracle_db.
 
 Role Variables
 --------------
 
-A description of the settable variables for this role should go here, including any variables that are in defaults/main.yml, vars/main.yml, and any variables that can/should be set via parameters to the role. Any variables that are read from other roles and/or the global scope (ie. hostvars, group vars, etc.) should be mentioned here as well.
+#### cdbs_service_path: /usr/lib/systemd/system
+The path used to create the service files used to manage the database and its listener as services.
+
+#### oracle_base
+The oracle base path used by the service.
+
+#### oracle_home
+The Oracle Home used by the service.
+
+#### sid
+The Oracle SID used by the service.
 
 Dependencies
 ------------
 
-A list of other roles hosted on Galaxy should go here, plus any details in regards to parameters that may need to be set for other roles, or variables that are used from other roles.
+Before running using this, the following roles must be executed.
+
+1. os_settings
+1. install_oracle_db
+
+This role depens on some variables located at ANSIBLE-ORACLEDB/inventories/dev/group_vars/oracledb_vars.yml
 
 Example Playbook
 ----------------
 
-Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
+The following example shows how to use this role. It needs root as this will create two services one for the database and the other for the listener.
 
-    - hosts: servers
-      roles:
-         - { role: username.rolename, x: 42 }
+    - hosts: database
+      remote_user: oracle
+      become: yes
+      become_user: root
+      tasks:
+        # Here we will call the role to create Linux Services for Oracle database
+      - include_role:
+          name: create_db_service
 
 License
 -------
@@ -35,4 +55,4 @@ BSD
 Author Information
 ------------------
 
-An optional section for the role authors to include contact information, or a website (HTML is not allowed).
+[Linkedin](https://www.linkedin.com/in/raul-castillo-11051980/)

roles/install_oracle_db/README.md

@@ -1,31 +1,102 @@
-Role Name
-=========
+install_oracle_db
+=================
 
-A brief description of the role goes here.
+This roles installs the Oracle database 12.2.0.1.0 and configures it using an RSP file. 
 
 Requirements
 ------------
 
-Any pre-requisites that may not be covered by Ansible itself or the role should be mentioned here. For instance, if the role uses the EC2 module, it may be a good idea to mention in this section that the boto package is required.
+The role os_setting must be executed before.
 
 Role Variables
 --------------
 
-A description of the settable variables for this role should go here, including any variables that are in defaults/main.yml, vars/main.yml, and any variables that can/should be set via parameters to the role. Any variables that are read from other roles and/or the global scope (ie. hostvars, group vars, etc.) should be mentioned here as well.
+Most of the following variables are used to configure the RSP file through templates.
+
+ #### inst_software_source_dir: /u01/software
+ This is the directory where Oracle database installers are copied from.
+ #### inst_sofware_destiny_dir: /u01/staging/oracledb # create dir, unzip installer, use as source to install
+ This is the directory where Oracle database installers are copied from
+ #### inst_template_dir: "{{ inst_sofware_destiny_dir }}/templates"
+ The directory used to save the template used to generate a RSP file.
+ #### inst_user_home: /home/oracle
+ The directory home for the oracle user.
+ #### inst_root_dir: "{{ inst_user_home }}/database" # database is installed here
+ The directory where the database is installed.
+ #### inst_db_installer: linuxx64_12201_database.zip
+ The name of the Oracle databse installer.
+ #### inst_install_option: INSTALL_DB_AND_CONFIG 
+ The option used on the RSP file to isntall and configure the Oracle database.
+ #### inst_group_name: oinstall
+ The Linux group used to install the database.
+ #### inst_inventory_location: "{{ inst_root_dir }}/oraInventory"
+ The directory where the inventory is saved.
+ #### inst_oracle_home: "{{ oracle_home }}"
+ The oracle home for the database.
+ #### inst_ora_root_file: "{{ inst_oracle_home }}/root.sh"
+ The file generated during the installation that must be executed by root.
+ #### inst_ora_tab_file: /etc/oratab
+ The file that allows us or not the execution of a command to start/shutdown the database.
+ #### inst_oracle_base: "{{ oracle_base }}"
+ The Oracle base directory
+ #### inst_install_edition: SE2
+ The Oracle install edition set within the RSP file.
+ #### inst_dba_group: dba
+ The dba group's name.
+ #### inst_is_rac_install: "false"
+ The flag used to tell the installer we do not need a RAC.
+ #### inst_start_db_type: GENERAL_PURPOSE
+ The type of database we want to create.
+ #### inst_global_db_name: "{{ global_db_name }}"
+ The global database name.
+ #### inst_db_sid: "{{ sid }}"
+ The database sid.
+ #### inst_conf_as_container: "false"
+ The flag used to say we do not want a container.
+ #### inst_db_charset: AL32UTF8
+ The charset we want our database to use.
+ #### inst_automatic_memory: "false"
+ The flag used to say we do not want automatic memory management
+ #### inst_memory_limit: 1024
+ Specify the total memory allocation for the database
+ #### inst_example_schemas: "false"
+ A flag used to tell the installer we do not want example schemas
+ #### inst_management_option: DEFAULT
+ If you want to manage your database using the default Database Express option
+ #### inst_enable_recovery: "false"
+ This variable is to be set to false if database recovery is not required
+ #### inst_storage_type: FILE_SYSTEM_STORAGE
+ The type of storage to use for the database
+ #### inst_data_location: "{{ inst_root_dir }}/databasefilelocation"
+ Specify the database file location which is a directory for datafiles, control files, redo logs
+ #### inst_security_update: "false"
+ Specify whether to enable the user to set the password for My Oracle Support credentials.
+ #### inst_decline_security_update: "true"
+ Specify whether user doesn't want to configure Security Updates
+ #### vault_sys_password
+ The password for sys. Varible configured in ANSIBLE-ORACLEDB/inventories/dev/group_vars/vault.yml
+ #### vault_system_password
+ The password for system. Varible configured in ANSIBLE-ORACLEDB/inventories/dev/group_vars/vault.yml
+ #### vault_dbsnmp_password
+ The password for dbsnmp. Varible configured in ANSIBLE-ORACLEDB/inventories/dev/group_vars/vault.yml
 
 Dependencies
 ------------
 
-A list of other roles hosted on Galaxy should go here, plus any details in regards to parameters that may need to be set for other roles, or variables that are used from other roles.
+This role depends on the exeuction of the role os_settings.
+
+This role uses some variables located at ANSIBLE-ORACLEDB/inventories/dev/group_vars/oracledb_vars.yml.
 
 Example Playbook
 ----------------
 
-Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
+The following example shows how to call this role.
 
-    - hosts: servers
-      roles:
-         - { role: username.rolename, x: 42 }
+- hosts: database
+  remote_user: oracle
+  tasks:
+   - include_role:
+       name: install_oracle_db
 
 License
 -------
@@ -35,4 +106,4 @@ BSD
 Author Information
 ------------------
 
-An optional section for the role authors to include contact information, or a website (HTML is not allowed).
+[RSCC](https://www.linkedin.com/in/raul-castillo-11051980/)

roles/install_oracle_db/tasks/main.yml

@@ -38,8 +38,6 @@
  - name: Installing and configuring the database
    command: "{{ inst_sofware_destiny_dir }}/database/runInstaller \
             -responseFile {{ inst_template_dir }}/db_install.rsp -silent -waitforcompletion -showProgress"
-   args:
-     creates: "{{ inst_ora_inst_root_file }}"
 
  - name: "Executing {{ inst_ora_root_file }}"
    command: "{{ inst_ora_root_file }}"

roles/install_oracle_db/vars/main.yml

@@ -10,7 +10,6 @@
  inst_install_option: INSTALL_DB_AND_CONFIG 
  inst_group_name: oinstall
  inst_inventory_location: "{{ inst_root_dir }}/oraInventory"
- inst_ora_inst_root_file: "{{ inst_inventory_location }}/orainstRoot.sh"
  inst_oracle_home: "{{ oracle_home }}"
  inst_ora_root_file: "{{ inst_oracle_home }}/root.sh"
  inst_ora_tab_file: /etc/oratab

roles/os_settings/README.md

@@ -1,5 +1,5 @@
-Role Name
-=========
+os_settings
+===========
 
 The goal of this roles is to set the Linux Operating System v7 according to the requirements provided by Oracle to install an Oracle database 12.2
 
@@ -18,7 +18,6 @@ os_packages, a list of OS packages installed on target(s) machines.
 sysctl_configurations, a dictionary, which represents the configurations applied on /etc/sysctl.conf before the installation of Oracle database.
 limits, a dictionary, which represents the soft and hard limits for processes and files to be set before installing Oracle database.
 
-
 Dependencies
 ------------
 At this moment this roles does not depend on other roles or external variables.
@@ -28,10 +27,18 @@ Example Playbook
 
 This roles can be executed as is shown below.
 
-   - include_role:
-      name: os_settings
+      - hosts: database
+        remote_user: oracle
+        tasks:
+         - include_role:
+            name: os_settings
 
 License
 -------
 
 BSD
+
+Author Information
+------------------
+
+[RSCC](https://www.linkedin.com/in/raul-castillo-11051980/)

site.yml

@@ -28,12 +28,21 @@
    - include_role:
        name: create_db_service
 
-   - name: Starting Oracle database
-     service:
-       name: oracledb
-       state: started
+- hosts: database
+  remote_user: oracle
+  tasks:
+   - name: Stopping the database listener
+     command: "{{ oracle_home }}/bin/lsnrctl stop"
+
+   - name: Stopping the database
+     command: "{{ oracle_home }}/bin/dbshut {{ oracle_home }}"
 
    - name: Starting Oracle database listener
      service:
        name: oracledblistener
        state: started
+
+   - name: Starting Oracle database
+     service:
+       name: oracledb
+       state: started