Difference between revisions of "Installing Onepoint"

From Onepoint Systems Integration
Jump to: navigation, search
(→‎Minimum Software Requirements)
 
(53 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.
  
−
= Package Repository =
+
= Minimum Requirements for Onepoint =
 +
Before installing onepoint, you should verify the following requirements for a production or stress-test environment:
  
−
== Fedora 24/25/26/27/28 ==
+
== 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.
  
−
Install the repository for your operating system version below. After this, install the onepoint package, through dnf:
+
== Minimum Software Requirements ==
 +
*OS: CentOS 7
 +
*Database: MariaDB 10 or later OR MySQL 8 or later
 +
*Third-party repositories:
  
−
   ]# dnf install onepoint
+
- epel-release
 +
You can install it running the following command:
 +
   ]# yum install epel-release
  
−
=== Links ===
+
- 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
  
−
[http://link/to/repository.rpm Fedora 28 Repository RPM]
+
You can install them running the following command (once Remi is installed):
−
[http://link/to/repository.rpm Fedora 27 Repository RPM]
+
  ]# 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
−
[http://link/to/repository.rpm Fedora 26 Repository RPM]
+
−
[http://link/to/repository.rpm Fedora 25 Repository RPM]
+
*Python: v2.7 with the following packages:
−
[http://link/to/repository.rpm Fedora 24 Repository RPM]
+
**python
 +
**python-pip
 +
**python-requests
 +
**python-ldap
 +
**python-paramiko
  
−
== Red Hat Enterprise Linux 7 ==
+
You can install them running the following command:
  
−
Install the repository for your operating system version below. After this, install the onepoint package, through yum:
+
  ]# yum install python-pip python-ldap python-paramiko
  
−
  ]# yum install onepoint
+
*Runtime Libraries:
 +
**curl
 +
**curlpp
  
−
=== Links ===
+
You can install them running the following command:
−
[http://link/to/repository.rpm Red Hat Enterprise Linux 7 Repository RPM]
 
  
−
== CentOS 7 ==
+
  ]# yum install curl http://download-ib01.fedoraproject.org/pub/epel/6/x86_64/Packages/c/curlpp-0.7.3-5.el6.x86_64.rpm
  
−
Install the repository for your operating system version below. After this, install the onepoint package, through yum:
+
**libssh
 +
**json-c
 +
**json-cpp
  
−
  ]# yum install onepoint
+
You can install them running the following command:
  
−
=== Links ===
+
  ]# yum install libssh json-c jsoncpp
−
[http://link/to/repository.rpm Red Hat Enterprise Linux 7 Repository RPM]
 
  
−
= Virtual Appliance (large OVA) =
+
*Other tools:
−
[http://link/to/machine.ova Virtual Appliance in OVF format]
+
**psutils
 +
**psmisc
 +
**telnet (Client)
 +
**SSH Server
 +
**SSH Client
 +
**SAMBA
  
−
= Installation Script =
+
You can install them running the following command:
−
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>
+
  ]# yum install psutils psmisc telnet ssh samba
  
−
== Preparing the machine ==
+
== Minimum Network Requirements ==
−
* CentOS 7
+
*Outbound ports: Onepoint machine needs to access the managed assets in their respective protocols:
−
* MariaDB 10 or later, or MySQL 7 or later
+
** LDAP / Active Directory: 389/tcp, 636/tcp; privileged account for the instance
−
* EPEL Repository (epel-release-7)
+
** Windows Servers: 135/tcp, 445/tcp; privileged local or domain account for the machines
−
* Python 2.7 + pip (up2date, it depends on) + paramiko (Python Module)
+
** Linux Servers: 22/tcp; privileged account for the machine
−
* Git Client
+
** MySQL/MariaDB: 3306/tcp; privileged account for the instance
−
* psmisc package
+
** PostgreSQL: 5432: privileged account for the instance
−
== 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
+
= Licensing considerations =
−
  ]$ git clone git@bitbucket.org:netbr-onepoint-installer.git update
+
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.
  
−
== Execute the installation script ==
+
= Package Repository =
−
 
 
−
  ]$ /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"