Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

Installation of required additional software

Install GITGIT 

Git is required, to checkout the software and the default mysql-client is required (for running the update scripts).

Warning

If you are installing STORE on a machine which will contain the role DATA too, then do not install the default mysql client, as this will collide with MySQL. Instead, install the MySQL software first (see role DATA).


Translations Ignore


Code Block
languagebash
apt-get -y install git default-mysql-client
su jtel
cd
git config --global user.name "jtel Support"
git config --global user.email "support@jtel.de"
git config --global http.postBuffer 1048576000


Configure GIT proxy server (optional)

If you need a proxy for GIT:

Translations Ignore


Code Block
languagebash
git config --global http.proxy http://<proxy_server>:<port>


Downloading the jtel software for the first time

Note: for redundant systems, do this on the ACTIVE storage node.

Change to jtel User

The following operations are no longer performed in the context of the root user but must be performed in the context of the jtel user. To do this, you can either log in as user jtel in a separate SSH session or, if you are already logged in as user root, you can switch to the context of the jtel user. This is done with the following command:

Translations Ignore


Code Block
languagebash
su jtel
cd


Clone jtel Software

Next, the jtel Software is cloned. This will be done in 2 steps, as a user name and password is required for each one.

Translations Ignore


Code Block
languagebash
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/jtel.git JTEL


Code Block
languagebash
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/jtelcarrierportal.git JTELCarrierPortal


Code Block
languagebash
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/jtel-system-java-services.git jtel-system-java-services


Clone Customer Software

If specific software has been programmed for the customer, the customer-specific software repository must also be downloaded. This is done by a command which is structured as follows, for the example customer acme:

Translations Ignore


Code Block
languagebash
titleDownload a custom repository
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/cacme-software.git acme


Change to required Software Release

In the downloaded software repositories, the software release to be used must now be selected. In this case it is release 3.2029:

Translations Ignore


Code Block
languagebash
titleSelect the desired release
cd /srv/jtel/shared/JTELCarrierPortal
git config pull.rebase false
git checkout release/stable-3.2232

cd /srv/jtel/shared/JTEL
git config pull.rebase false
git checkout release/stable-3.2232

cd /srv/jtel/shared/jtel-system-java-services
git config pull.rebase false
git checkout release/stable-3.32

# For customer specific software only
# cd /srv/jtel/shared/acme
# git checkout develop
cd /srv/jtel/shared


Note, that the customer specific release is usually develop, as customer releases are not branched or tagged when the jtel Software is branched or tagged.

Create Required Directories

The last step is to create the directories for central logging, standard data import and the main data directory:. This uses a basic data directory download which fits the Init.sql script (used later in role DATA). 

Translations Ignore


Code Block
languagebash
cd /srv/jtel/shared
mkdir -p LogFiles LogFilesCall Import/{Clients,ServiceNumbers}/{Done,In,Problems}
wget https://cdn.jtel.de/downloads/Data/Data.zip
unzip Data.zip
rm -f Data.zip
cp -a JTELCarrierPortal/Data .
cp -a JTEL/Data/system/gui Data/system
cd /srv/jtel/shared/JTELCarrierPortal/Update
bash ./get_binaries.sh


Cleaner processes

A CRON job is used to clean up the directories of the portal. 

With redundancy, configure this on both STORE. Since the directory is only mounted on one, but we don't know which one is active, the command must be executed on both.

Note: execute as ROOT.

Translations Ignore


Code Block
languagebash
titleCleaner processes in /etc/cron.daily
# Make Directory
mkdir -p /home/jtel/jtel_dailyjobs

# Does the dailyjobs script exist? If not, create.
if [ ! -f /home/jtel/jtel_dailyjobs/jtel_dailyjobs.sh ]; then
# No - so create it
cat << EOFF > /home/jtel/jtel_dailyjobs/jtel_dailyjobs.sh
#!/bin/bash
EOFF
# Create cron script
cat << EOF > /home/jtel/jtel_dailyjobs/jtel_dailyjobs
#!/bin/bash
su - jtel -c '/home/jtel/jtel_dailyjobs/jtel_dailyjobs.sh'
EOF
# Link to cron.daily
ln -s /home/jtel/jtel_dailyjobs/jtel_dailyjobs /etc/cron.daily
# Make executable
chmod +x /home/jtel/jtel_dailyjobs/jtel_portal_cleaner << EOFF dailyjobs
chmod +x /home/jtel/jtel_dailyjobs/jtel_dailyjobs.sh
fi

# Create the cleaner script
cat << 'EOFF' > /home/jtel/jtel_dailyjobs/jtel_portal_cleaner.sh
#!/bin/bash
find /srv/jtel/shared/Data/clients/*/reports -type f -mtime +2 -delete
EOFF

# Make executable
chmod +x /home/jtel/jtel_dailyjobs/jtel_portal_cleaner.sh

# Append job to jtel_dailyjobs.sh
cat << EOFF >> /etc/cron.daily/home/jtel/jtel_dailyjobs/jtel_dailyjobs.sh
bash /home/jtel/jtel_dailyjobs/jtel_portal_cleaner.sh
EOFF

# Change ownership of everything to jtel
chown -R jtel:jtel /home/jtel/jtel_dailyjobs




Sv translation
languagede

Status
colourRed
titleThis page is only available in English

Sv translation
languagefr

Installation des logiciels supplémentaires nécessaires

Installer GIT

Il est nécessaire d'avoir un Git pour vérifier le logiciel

GIT 

Git est requis, pour vérifier le logiciel et le client mysql par défaut est requis (pour exécuter les scripts de mise à jour).

Warning

Si vous installez STORE sur une machine qui contiendra aussi le rôle DATA, alors n'installez pas le client mysql par défaut, car il entrera en collision avec MySQL. Au lieu de cela, installez d'abord le logiciel MySQL (voir le rôle DATA).


Translations Ignore


Code Block
languagebash
apt-get -y install git default-mysql-client su jtel cd git config --global user.name "jtel Support" git config --global user.email "support@jtel.de" git config --global http.postBuffer 1048576000


Configurer le serveur proxy GIT (facultatif)

Si vous avez besoin d'une procuration pour le TIG :

Translations Ignore


Code Block
languagebash
git config --global http.proxy http://<proxy_server>:<port>


Téléchargement du logiciel jtel pour la première fois

Note : pour les systèmes redondants, faites-le sur le nœud de stockage ACTIF.

Passage à l'utilisateur jtel

Les opérations suivantes ne sont plus effectuées dans le contexte cadre de l'utilisateur root mais doivent doit être effectuée dans le contexte cadre de l'utilisateur jtel. Pour ce faire, vous pouvez soit vous connecter en tant qu'utilisateur jtel dans une session SSH séparée, soitdistincte ou, si vous êtes déjà connecté en tant qu'utilisateur root,vous pouvez passer au basculer vers le contexte de l'utilisateur jtel. Pour ce faire, utilisez Cela se fait avec la commande suivante :

Translations Ignore


Code Block
languagebash
su jtel cd


Cloner le logiciel jtel

Ensuite, le logiciel jtel est cloné. Cela se fera en deux étapes, puisqu'un nom d'utilisateur et un mot de passe sont nécessaires pour chacune d'entre elles.

Translations Ignore


Code Block
languagebash
cd /srv/jtel/shared git clone https://bitbucket.org/jtelgmbh/jtel.git JTEL


Code Block
languagebash
cd /srv/jtel/shared git clone https://bitbucket.org/jtelgmbh/jtelcarrierportal.git JTELCarrierPortal


Cloner le logiciel client

Si un logiciel spécifique a été programmé pour le client, le dépôt de logiciels spécifiques au client doit également être téléchargé. Cela se fait par une commande qui est structurée comme suit, pour l'exemple acme client :

Translations Ignore


Code Block
languagebash
titleTélécharger un dépôt personnalisé
cd /srv/jtel/shared git clone https://bitbucket.org/jtelgmbh/cacme-software.git acme


Modification de la version du logiciel requise

Dans les dépôts de logiciels téléchargés, il faut maintenant sélectionner la version du logiciel à utiliser. Dans ce cas, il s'agit de la version 3.20 :

Translations Ignore


Code Block
languagebash
titleSélectionnez la release souhaitée
cd /srv/jtel/shared/JTELCarrierPortal git checkout release/stable-3.2223 cd /srv/jtel/shared/JTEL git checkout release/stable-3.2223 # For customer specific software only # cd /srv/jtel/shared/acme # git checkout develop cd /srv/jtel/shared


Il est à noter que la version spécifique au client est généralement développée, car les versions clients ne sont pas branchées ou étiquetées lorsque le logiciel jtel est branché ou étiqueté.

Créer les répertoires nécessaires

La dernière étape consiste à créer les répertoires pour l'enregistrement central, l'importation de données standard et le répertoire de données principal :

Translations Ignore


Code Block
languagebash
cd /srv/jtel/shared mkdir -p LogFiles LogFilesCall Import/{Clients,ServiceNumbers}/{Done,In,Problems} cp -a JTELCarrierPortal/Data . cp -a JTEL/Data/system/gui Data/system cd /srv/jtel/shared/JTELCarrierPortal/Update bash ./get_binaries.sh


Des processus plus propres

Un travail de CRON est nécessaire pour nettoyer les répertoires du portail. 

En cas de redondance, configurez-le sur les deux MAGASINS. Comme le répertoire n'est monté que sur un seul, mais que nous ne savons pas lequel est actif, la commande doit être exécutée sur les deux.

Note : exécuter en tant que ROOT.

Translations Ignore


Code Block
languagebash
titleDes processus plus propres dans /etc/cron.daily
cat > /etc/cron.daily/jtel_portal_cleaner << EOFF #!/bin/bash find /srv/jtel/shared/Data/clients/*/reports -type f -mtime +2 -delete EOFF chmod +x /etc/cron.daily/jtel_portal_cleaner