Difference between revisions of "Installing Onepoint"

From Onepoint Systems Integration
Jump to: navigation, search
(→‎Links)
(→‎Minimum Software Requirements)
 
(42 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
You have some options for downloading Onepoint Systems Integration.
 
You have some options for downloading Onepoint Systems Integration.
  
−
= Licensing considerations =
+
= Minimum Requirements for Onepoint =
−
After registering on our website (http://onepoint.net.br), you will until 24 hours receive a license file with instructions on how to install. For using and updating the product, and having access to its features, you will need to install this license.
+
Before installing onepoint, you should verify the following requirements for a production or stress-test environment:
  
−
= Package Repository =
+
== Minimum Hardware Requirements (Physical or Virtual) ==
 +
*CPU: At least 4 CPUs
 +
*RAM: At least 1GB per logical CPU recommended
 +
*Disk: At least 100 GB free on the installation/data partition.
  
−
== Fedora 24/25/26/27/28 ==
+
== Minimum Software Requirements ==
 +
*OS: CentOS 7
 +
*Database: MariaDB 10 or later OR MySQL 8 or later
 +
*Third-party repositories:
  
−
Install the repository for your operating system version below. After this, install the onepoint package, through dnf:
+
- epel-release
 +
You can install it running the following command:
 +
  ]# yum install epel-release
  
−
   ]# dnf install <LINK-TO-REPO-FILE>
+
- Remi's Repository
−
   ]# dnf install onepoint
+
You can install it running the following command:
 +
   ]# yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm
 +
*Apache: v2.4 or later
 +
You can install it running the following command:
 +
   ]# yum install httpd
 +
*PHP: v7.2 or later with the following extensions:
 +
**php72-php
 +
**php72-php-common
 +
**php72-php-bz2
 +
**php72-php-curl
 +
**php72-php-ldap
 +
**php72-php-gd
 +
**php72-php-gmp
 +
**php72-php-imap
 +
**php72-php-mbstring
 +
**php72-php-mcrypt
 +
**php72-php-soap
 +
**php72-php-mysqlnd
 +
**php72-php-xml
 +
**php72-php-zip
 +
**php72-php-json
  
−
=== Links ===
+
You can install them running the following command (once Remi is installed):
 +
  ]# yum install php72-php php72-php-common php72-php-bz2 php72-php-curl php72-php-ldap php72-php-gd php72-php-gmp php72-php-imap php72-php-mbstring php72-php-mcrypt php72-php-soap php72-php-mysqlnd php72-php-xml php72-php-zip php72-php-json
 +
 +
*Python: v2.7 with the following packages:
 +
**python
 +
**python-pip
 +
**python-requests
 +
**python-ldap
 +
**python-paramiko
  
−
*[http://repo.onepoint.net.br/yum/fedora/repo/onepoint-repo-0.1-1.fc28.noarch.rpm Fedora 28 Repository RPM]
+
You can install them running the following command:
−
*[http://repo.onepoint.net.br/yum/fedora/repo/onepoint-repo-0.1-1.fc24.noarch.rpm Fedora 24 Repository RPM]
 
  
−
== Red Hat Enterprise Linux 7 ==
+
  ]# yum install python-pip python-ldap python-paramiko
  
−
Install the repository for your operating system version below. After this, install the onepoint package, through yum:
+
*Runtime Libraries:
 +
**curl
 +
**curlpp
  
−
  ]# yum install <LINK-TO-REPO-FILE>
+
You can install them running the following command:
−
  ]# yum install onepoint
 
  
−
=== Links ===
+
  ]# yum install curl http://download-ib01.fedoraproject.org/pub/epel/6/x86_64/Packages/c/curlpp-0.7.3-5.el6.x86_64.rpm
−
*Red Hat Enterprise Linux 7 Repository RPM (SOON)
 
  
−
== CentOS 7 ==
+
**libssh
 +
**json-c
 +
**json-cpp
  
−
Install the repository for your operating system version below. After this, install the onepoint package, through yum:
+
You can install them running the following command:
  
−
   ]# yum install <LINK-TO-REPO-FILE>
+
   ]# yum install libssh json-c jsoncpp
−
  ]# yum install onepoint
 
  
−
=== Links ===
+
*Other tools:
−
*Red Hat Enterprise Linux 7 Repository RPM (SOON)
+
**psutils
 +
**psmisc
 +
**telnet (Client)
 +
**SSH Server
 +
**SSH Client
 +
**SAMBA
  
−
= Virtual Appliance (large OVA) =
+
You can install them running the following command:
−
[http://pam.netbr.com.br/va/releases/v1.0/ONEPOINT.ova Virtual Appliance in OVF format]
 
  
−
= Installation Script =
+
  ]# yum install psutils psmisc telnet ssh samba
−
You can also install Onepoint through its installation script. The video and detailed steps below shows the process.
 
  
−
<youtube width="560" height="315" style="thumb">GAMU4iGgqLQ</youtube>
+
== Minimum Network Requirements ==
 +
*Outbound ports: Onepoint machine needs to access the managed assets in their respective protocols:
 +
** LDAP / Active Directory: 389/tcp, 636/tcp; privileged account for the instance
 +
** Windows Servers: 135/tcp, 445/tcp; privileged local or domain account for the machines
 +
** Linux Servers: 22/tcp; privileged account for the machine
 +
** MySQL/MariaDB: 3306/tcp; privileged account for the instance
 +
** PostgreSQL: 5432: privileged account for the instance
  
−
== Preparing the machine ==
+
= Licensing considerations =
−
* CentOS 7
+
After registering on our website (http://onepoint.net.br), you will until 24 hours receive a license file with instructions on how to install. For using and updating the product, and having access to its features, you will need to install this license.
−
* MariaDB 10 or later, or MySQL 7 or later
 
−
* EPEL Repository (epel-release-7)
 
−
* Python 2.7 + pip (up2date, it depends on) + paramiko (Python Module)
 
−
* Git Client
 
−
* psmisc package
 
−
== Create app folder ==
 
−
Create folder /home/_onepoint_root
 
−
== Create onepoint user ==
 
−
You need to create a onepoint user, give the ownership of /home/_onepoint_root to it, and login with this user to continue.
 
−
== Clone the repository ==
 
−
Clone the repository in /home/_onepoint_root/update
 
  
−
  ]$ cd /home/_onepoint_root
+
= Package Repository =
−
  ]$ git clone git@bitbucket.org:netbr-onepoint-installer.git update
 
−
 
 
−
== Execute the installation script ==
 
−
 
 
−
  ]$ /home/_onepoint_root/update/managed-installer
 
−
 
 
−
Installer will check the pre-reqs, and if anyone is missing, it will install the necessary packages. In this case, after the pre-reqs installation, you will need to run the installer again.
 
−
 
 
−
== Parameter configuration ==
 
−
 
 
−
Need to configure parameters on /home/_onepoint_root/config/web
 
−
 
 
−
== Run the update script ==
 
−
 
 
−
Run the update script (To run this script, you already need to have the license installed - after our team instructions on licensing)
 
−
 
 
−
  ]$ /home/_onepoint_root/update/managed-update
 
−
 
 
−
After updating, this script will return a error message for the connection on the executor app, and this error can be ignored.
 
−
It occurrs because there are still pending configurations to perform.
 
−
 
 
−
== Configure the web server ==
 
−
 
 
−
Create a symbolic link or alias named /onepoint such that the path points to /home/_onepoint_root/web and make sure it's accessible.
 
−
 
 
−
== Initizalize the database ==
 
−
 
 
−
Open a web browser and run http://[SERVER]/onepoint/initialize/zero
 
−
 
 
−
== Test the web endpoint ==
 
−
 
 
−
Open http://<SERVER>/onepoint
 
−
Login screen must appear
 
  
−
== Start task executor ==
+
== Installation ==
  
−
Start executor through script /home/_onepoint_root/update/managed-start-worker
+
#[[Installing Onepoint on CentOS 7 with Hashicorp Vault]] for instructions on how to install it to work together with Hashicorp Vault
 +
#[[Installing Onepoint on CentOS 7]] for using Internal Vault Backend

Latest revision as of 12:34, 12 May 2020

You have some options for downloading Onepoint Systems Integration.

Minimum Requirements for Onepoint

Before installing onepoint, you should verify the following requirements for a production or stress-test environment:

Minimum Hardware Requirements (Physical or Virtual)

  • CPU: At least 4 CPUs
  • RAM: At least 1GB per logical CPU recommended
  • Disk: At least 100 GB free on the installation/data partition.

Minimum Software Requirements

  • OS: CentOS 7
  • Database: MariaDB 10 or later OR MySQL 8 or later
  • Third-party repositories:

- epel-release You can install it running the following command: 

 ]# yum install epel-release

- Remi's Repository You can install it running the following command: 

 ]# yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm
  • Apache: v2.4 or later

You can install it running the following command: 

 ]# yum install httpd
  • PHP: v7.2 or later with the following extensions:
    • php72-php
    • php72-php-common
    • php72-php-bz2
    • php72-php-curl
    • php72-php-ldap
    • php72-php-gd
    • php72-php-gmp
    • php72-php-imap
    • php72-php-mbstring
    • php72-php-mcrypt
    • php72-php-soap
    • php72-php-mysqlnd
    • php72-php-xml
    • php72-php-zip
    • php72-php-json

You can install them running the following command (once Remi is installed): 

 ]# yum install php72-php php72-php-common php72-php-bz2 php72-php-curl php72-php-ldap php72-php-gd php72-php-gmp php72-php-imap php72-php-mbstring php72-php-mcrypt php72-php-soap php72-php-mysqlnd php72-php-xml php72-php-zip php72-php-json
  • Python: v2.7 with the following packages:
    • python
    • python-pip
    • python-requests
    • python-ldap
    • python-paramiko

You can install them running the following command: 

 ]# yum install python-pip python-ldap python-paramiko
  • Runtime Libraries:
    • curl
    • curlpp

You can install them running the following command: 

 ]# yum install curl http://download-ib01.fedoraproject.org/pub/epel/6/x86_64/Packages/c/curlpp-0.7.3-5.el6.x86_64.rpm
    • libssh
    • json-c
    • json-cpp

You can install them running the following command: 

 ]# yum install libssh json-c jsoncpp
  • Other tools:
    • psutils
    • psmisc
    • telnet (Client)
    • SSH Server
    • SSH Client
    • SAMBA

You can install them running the following command: 

 ]# yum install psutils psmisc telnet ssh samba

Minimum Network Requirements

  • Outbound ports: Onepoint machine needs to access the managed assets in their respective protocols:
    • LDAP / Active Directory: 389/tcp, 636/tcp; privileged account for the instance
    • Windows Servers: 135/tcp, 445/tcp; privileged local or domain account for the machines
    • Linux Servers: 22/tcp; privileged account for the machine
    • MySQL/MariaDB: 3306/tcp; privileged account for the instance
    • PostgreSQL: 5432: privileged account for the instance

Licensing considerations

After registering on our website (http://onepoint.net.br), you will until 24 hours receive a license file with instructions on how to install. For using and updating the product, and having access to its features, you will need to install this license.

Package Repository

Installation

  1. Installing Onepoint on CentOS 7 with Hashicorp Vault for instructions on how to install it to work together with Hashicorp Vault
  2. Installing Onepoint on CentOS 7 for using Internal Vault Backend
Retrieved from "http://wiki.onepoint.net.br/index.php?title=Installing_Onepoint&oldid=501"