Commit c11370ad authored by Jeffrey Schlitt's avatar Jeffrey Schlitt

new install directions

parent 8773c0ab
......@@ -9,7 +9,7 @@ Installing team consists of accessing and setting up an environment based on an
If you have not yet done so download the software from `here <https://www.aginity.com/pricing/>`_.
Once you register and download the software you can begin the installation process. Upon registration you the software will automatically download. The software should be titled **aginity-team-linux-<version#>-x64.tgz**.
Once you register and download the software you can begin the installation process. Upon registration you the software will automatically download. The software should be titled **aginity-team-<version#>-amd64.deb.
Pre-Requisites and Getting to a Server
==========================================
......@@ -46,60 +46,43 @@ The following steps should be executed in order
ssh parallels@<ip_address>
**Step 2:** Lets create a new user to run the team service from and a directory to hold the software.
.. note:: Aginity recommends you install Aginity Team in the /opt directory on the server. This follows standard practice on where software is typically installed on Ubuntu environments.
.. code-block:: bash
sudo useradd -r aginity-team
# make directory in /opt to hold the software
sudo mkdir /opt/aginity/
# change ownership to the team_svc_admin to administer the software directory
sudo chown aginity-team:aginity-team /opt/aginity/
.. note::
You can use any account or name you wish but from instead of aginity-team replace that with the name you chose.
**Step 3:** Let's get the tar file from Amazon S3 to the user directory using this set of commands
**Step 2:** SFTP the **aginity-team-<version#>-amd64.deb** file to the /opt directory. Below is a sample command to do that.
.. code-block:: bash
sudo su aginity-team
cd /opt/aginity
wget --no-check-certificate https://repository.aginity.com.s3.amazonaws.com/AginityTeam/aginity-team-linux-<version#>-x64.tgz
sftp parallels@<ip_address>
cd /opt
put aginity-team-<version#>-amd64.deb
exit
**Step 4:** Now uncompress and install the software
**Step 3:** Running the install
.. code-block:: bash
Change directories to be in the /opt directory. The you will issue the install command.
# uncompress the file
tar -xvzf aginity-team-linux-<version#>-x64.tgz
.. code-block:: bash
**Step 5:** Generate a key to encrypt the metadata stored in the Team server repository
sudo dpkg -i aginity-team-0.14.170-amd64.deb
.. note::
This image below is what you should see after the install is complete.
Be sure to store it somewhere safe if you ever need to re-install the software from scratch. This key is used to encrypt the metadata in the catalog database.
.. image:: ../../team_images/Team_install.png
:scale: 40
:align: center
:alt: Post Install
.. code-block:: bash
.. note::
cd bin
# this creates the key
bash key-gen.sh
# this registers the key with the software
export AGINITY_ENCRYPTION_KEY="YOUR_KEY_GENERATED_IN_PREVIOUS_STEP"
We will generate an encryption key to ensure all information for connections and your catalog are encrypted. The installation will automatically generate and store that key on the /etc/aginity-team/service.conf file.
**Step 6:** Installing SSL certificate
**Step 4:** Installing SSL certificate
The SSL certificate generation can be called housing
.. code-block:: bash
# this will generate certificate
bash ssl-certificate-gen.sh
sudo /opt/aginity-team/bin/ssl-certificate-gen.sh
You will be asked for the following information
......@@ -111,59 +94,30 @@ You will be asked for the following information
#. Name of Country code
#. Finally when asked to "Enter key password for <aginity_cert> (RETURN if same as keystore password): " press RETURN
To set up the systemctl files:
.. code-block:: bash
vi aginity_team.service
Insert the following in the unit file
.. code-block:: bash
[Unit]
Description=Aginity Team
[Service]
Type=simple
Environment=“AGINITY_ENCRYPTION_KEY=YOUR_KEY_HERE”
ExecStart=/bin/bash /opt/aginity/bin/team-server-start.sh
[Install]
WantedBy=multi-user.target
Then perform the following:
Make sure to exit first from Sudo as aginity-team user by using the **exit** command as shown below.
.. code-block:: bash
exit
sudo cp aginity_team.service /etc/systemd/system/aginity_team.service
sudo chmod 644 /etc/systemd/system/aginity_team.service
sudo systemctl daemon-reload
Starting Aginity Team Server
================================
**Step 7:** You are now ready to start |var_product_name|
**Step 5:** You are now ready to start |var_product_name|
We use the following commands to start |var_product_name| in the background and with logging turned on.
.. code-block:: bash
sudo systemctl start aginity_team
systemctl start aginity-team
You can check if |var_product_name| is running by issuing this command
.. code-block:: bash
sudo systemctl status aginity_team
sudo systemctl status aginity-team
Accessing |var_product_name| for the First Time
=================================================
**Step 8:** Open a browser and navigate to https://<ip or team server name>:8080/app, you will be redirected to https://<ip or team server name>:8080/login. You will see the following image.
**Step 6:** Open a browser and navigate to https://<ip or team server name>:8080/app, you will be redirected to https://<ip or team server name>:8080/login. You will see the following image.
.. image:: ../../team_images/team_login_screen.png
:scale: 40
......@@ -172,7 +126,7 @@ Accessing |var_product_name| for the First Time
* Enter credentials **admin** / **AginityTE@M** - You will be redirected to https://localhost:8080/app
**Step 9:** Apply License Key
**Step 7:** Apply License Key
When you open the application it will ask you to register the software and then you will be asked to apply the license key.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment