> For the complete documentation index, see [llms.txt](https://bpmflow.gitbook.io/project/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bpmflow.gitbook.io/project/installation/gemstone-s/login-to-gemstone-s/login-to-gemstone-s-with-topaz.md).

# Login to GemStone/S with Topaz

Topaz is a command line interface to interact with GemStone/S. The Topaz functionalities includes:

* Login into GemStone/S
* Query object model
* Execute GemStone/S code
* Creating and changing methods
* Debugging

This is short list of Topaz capabilities for a full view check [Topaz manual](https://gemtalksystems.com/products/gs64/)\
&#x20;To run Topaz just type "startTopaz devKit\_34" in the Linux terminal:<br>

![](/files/-LmG62Mh9Za_sPTndm5a)

There is **no** user logged yet.\
&#x20;Execute the following Topaz commands:

```
topaz> set username DataCurator
topaz> set password swordfish
topaz> set gemstone devKit_34
topaz> set gemnetid !#netldi:50378!gemnetobject
topaz> login
```

The name of the GemStone/S server in this case "devKit\_329" depends on which version has been download. The *netldi* service is running on port 50378.\
&#x20;The password for the user "DataCurator" is the default password and it **MUST** be changed (for security reasons).\
&#x20;Now the user DataCurator is logged in GemStone/S (the number 1 depict the session number).\
&#x20;To run the any script type:

```
topaz 1> run
"text of the script"
%
```

Do not forget the percentage **%** character.\
&#x20;For example to run the first part of the installation script:

```
topaz 1> run
Gofer new
  package: 'GsUpgrader-Core';
  url: 'http://ss3.gemtalksystems.com/ss/gsUpgrader';
  load.
(Smalltalk at: #GsUpgrader) upgradeGrease.
%
```

![](/files/-LH9jFp2Lhw_T-p5UXX-)

After the installation has finished the Transaction has to be commited.\
&#x20;To commit a transaction in Topaz:

```
topaz 1> run
System commit.
%
```

![](/files/-LH9jQY9MBXdCbVuM-zm)