# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bpmflow.gitbook.io/project/installation/gemstone-s/login-to-gemstone-s/login-to-gemstone-s-with-topaz.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
