ASPL Installation Guide v 1.00
© 2025 Bassem W. Jamaleddine


6-3

   How-to Install ASPL as a Collaborative Calculator:
      Adding Users part2

Users using the ASPL calculator can share the same namedspace, and work collaboratively, issuing set operations on the objects defined in that namespace. This capability is only available in ASPL Entreprise where sessions management can be enabled.

In the previous subchapter we showed how euler installed ASPL as a COLLOBARATIVE MASTER installer. euler installed ASPL in the shared directory /opt/euler that has the ACL set to the UNIX group euler. The two users: pascal and moran, want to work collabaratively on the objects saved in the same namedspace as euler's.

Recall, in the previous subchapter, root created the shared directory /opt/euler

mkdir /opt/euler

and changed the directory ACL of /opt/euler as follow

chown euler /opt/euler

chgrp euler /opt/euler

euler installed ASPL in the shared directory /opt/euler

perl asplinstall -foruid euler -forgid euler -homedir /home/euler -shareddir /opt/euler -asplver ASPLv1.00 -itype 4 -gpg



Also recall in the previous subchapter, we added the userid moran, and made the group name euler the user's initial login group.

adduser -g euler moran

su - moran

cd /home/euler/aspldisgnedent

For moran to use euler's ASPL signed-distribution is simple, and require only one step: moran will run the installer using the following command:

perl asplinstall -foruid moran -forgid euler -homedir /home/moran -shareddir /opt/euler -asplver ASPLv1.00 -itype 41 -gpg



In this subchapter, we show how to install the product for pascal as secondary owner of the distribution: pascal installation is performed a COLLOBARATIVE SLAVE installer.

In this subchapter, we add the userid pascal, and make the group name euler the user's initial login group.

adduser -g euler pascal

su - pascal

cd /home/euler/aspldisgnedent

For pascal to use euler's ASPL signed-distribution is simple, and require only one step: pascal will run the installer using the following command:

perl asplinstall -foruid pascal -forgid euler -homedir /home/pascal -shareddir /opt/euler -asplver ASPLv1.00 -itype 41 -gpg



pascal and moran installations are quite similar. In this subchapter, we show how user pascal installed ASPL as COLLOBARATIVE SLAVE installer to use euler's ASPL. In the next subchapter, we show how all three users: euler, pascal, and moran, can work collobaratively using the ASPL calculator.

The following section consists of nine figures detailing the installation procedure for the user pascal as COLLOBARATIVE SLAVE installer.

■ Install ASPL Enterprise as a COLLOBARATIVE SLAVE for pascal


In this section we show in details how to add pascal as a COLLOBARATIVE SLAVE to use euler ASPL installation (that was already done in the previous subchapter "Install ASPL Enterprise as a Collobarative Calculator: Master User").

Login as pascal, then change directory to /home/euler/aspldisgnedent. Since pascal is part of the group euler, then he can run the installer from the directory where euler already downloaded and installed the ASPL distribution.

full view

Image File

 -F- Fig. 6.3.1   [HTI-aspl-install-itype4c-pascal-1][Pascal preparing COLLOBARATIVE SLAVE installation to euler]
ASPL © 2025 by Bassem W. Jamaleddine


pascal does not need to execute any commands shown in the README.TXT, since the product has already been extrated by euler. pascal only needs the EMAIL and the ASSET KEY that are required when invoking the installer. As pascal is installing ASPL, and since ASPL distribution has been registered to the userid euler, then pascal will use euler's binding email and asset key while installing the software.

The following figure show the README.TXT and the two entries for the EMAIL and the ASSET KEY.

full view

Image File

 -F- Fig. 6.3.2   [The README.TXT file for the signed distribution][The README.TXT file for the signed distribution]
ASPL © 2025 by Bassem W. Jamaleddine




The README.TXT shows the installation for a standalone (option -itype 1), so pascal ignores this installer command, and uses the following command to install ASPL as a COLLOBARATIVE SLAVE installation (-itype 41) to share euler's by specifying -shareddir /opt/euler and -forgid euler

perl asplinstall -foruid pascal -forgid euler -homedir /home/pascal -shareddir /opt/euler -asplver ASPLv1.00 -itype 41 -gpg



Notice the option -shareddir /opt/euler so that pascal will share euler ASPL containments. Also -homedir /home/pascal where .aspl will be created.

When running the installer, we used the EMAIL and the ASSET KEY from the README.TXT.

full view

Image File

 -F- Fig. 6.3.3   [Pascal installing as itype 4c][Pascal installing as itype 4c]
ASPL © 2025 by Bassem W. Jamaleddine


Accepting the agreement to start the installation.

full view

Image File

 -F- Fig. 6.3.4   [Pascal installing as itype 4c agreement][Pascal installing as itype 4c agreement]
ASPL © 2025 by Bassem W. Jamaleddine




The software is automatically installed as show in the following figure. When you run the installer, pay special attention to the output written on the screen, where you will find valuable information on how to source ASPL environment, and test your installation. The same output is written to the file HOWTO suffixed with the user name, in this particular case it is in /home/pascal/.aspl/HOWTO-pascal.TXT. In this file, locate the line containing the setaspl command, this will display the command to source the environment and start using ASPL.

full view

Image File

 -F- Fig. 6.3.5   [Pascal installing as itype 4c agreement accepted][Pascal installing as itype 4c agreement accepted]
ASPL © 2025 by Bassem W. Jamaleddine


Now the installation is complete. The user pascal can test the installation. pascal locates the commands to source the ASPL environment into the current bash session ( simply by grepping for setaspl in his HOWTO file). pascal sourced the environment, started ASPL, then issued some commands:

aspl -v
     display the version of ASPL

aspl -vv
     display the license and build of ASPL

Notice the command aspl -vv showing that the binding license of the install is euler's, that is because euler is the COLLOBARATIVE MASTER installer.

full view

Image File

 -F- Fig. 6.3.6   [Pascal souring ASPL environment and testing][Pascal souring ASPL environment and testing]
ASPL © 2025 by Bassem W. Jamaleddine


The following figure shows:
pascal's ~tmp is /home/pascal/.aspl/tmp, pascal's ~ggs is euler's (since pascal ASPL install is using euler's GG-Container), pascal's ~wsp is euler's (since pascal ASPL install is using euler's namedspaces), and when pinging the egC-Container (pascal is using euler's egC-Container).
Starting aspl with -verbose will also reveal ASPL containments.

aspl -verbose



full view

Image File

 -F- Fig. 6.3.7   [pascal itype 41 test2][pascal itype 41 test2]
ASPL © 2025 by Bassem W. Jamaleddine


The tilde command, shown in the figure below, reveal the location of the tilde-expansions of pascal's ASPL installation.
full view

Image File

 -F- Fig. 6.3.8   [pascal tilde definitions][pascal tilde definitions]
ASPL © 2025 by Bassem W. Jamaleddine


To make ASPL environment variables available at login, pascal's .bashrc can be updated with the content of setaspl (as shown in the following figure). In the export ASPL1_00_PROMPT, the promptcolor is set to lightred so that pascal's ASPL prompt can be distinguished from the others.

full view

Image File

 -F- Fig. 6.3.9   [Pascal .bashrc with ASPL environment variables][Pascal .bashrc with ASPL environment variables]
ASPL © 2025 by Bassem W. Jamaleddine


Now we logout from pascal, then login again, and start ASPL. The following subchapter shows how to test euler, pascal, and moran, using the ASPL collaborative calculator.

THIS COMPLETE THE INSTALLATION FOR pascal

 

■ How to Remove ASPL for pascal


Removing ASPLv1.00 is simply done with two commands. For example, userid pascal logins to the UNIX system and issues the following commands to remove ASPLv1.00

su - pascal

rm -rf ~/.aspl